Skip to content

Harness engineering beginner tutorial, from 0 to 1

Fix docs links for GitHub Pages routes

sanbuphy47dc3484a67f
diff --git a/docs/en/index.md b/docs/en/index.md
index b0273b9..bedfe73 100644
--- a/docs/en/index.md
+++ b/docs/en/index.md
@@ -13,15 +13,15 @@ Through systematic environment design, state management, verification, and contr
Choose your learning path to get started. The course is divided into theoretical lectures, hands-on projects, and a copy-ready resource library.
<div class="card-grid">
- <a href="/en/lectures/lecture-01-why-capable-agents-still-fail/" class="card">
+ <a href="./lectures/lecture-01-why-capable-agents-still-fail/" class="card">
<h3>Lectures</h3>
<p>Understand why strong models still fail and learn the theory behind effective harnesses.</p>
</a>
- <a href="/en/projects/" class="card">
+ <a href="./projects/" class="card">
<h3>Projects</h3>
<p>Hands-on practice building a reliable agentic environment from scratch.</p>
</a>
- <a href="/en/resources/" class="card">
+ <a href="./resources/" class="card">
<h3>Resource Library</h3>
<p>Copy-ready templates (AGENTS.md, feature_list.json) to use in your own repositories.</p>
</a>
@@ -67,7 +67,7 @@ Here are some of the key concepts you will master:
Once you understand the core concepts, these guides help you go deeper:
<ul class="index-list">
- <li><a href="/en/lectures/lecture-01-why-capable-agents-still-fail/">Lecture 01: Why Capable Agents Still Fail</a>: Start with the theory behind harness engineering.</li>
- <li><a href="/en/projects/project-01-baseline-vs-minimal-harness/">Project 01: Baseline vs Minimal Harness</a>: Walk through your first real task.</li>
- <li><a href="/en/resources/templates/">Templates</a>: Grab the minimal harness pack (AGENTS.md, feature_list.json, claude-progress.md) for your own projects.</li>
+ <li><a href="./lectures/lecture-01-why-capable-agents-still-fail/">Lecture 01: Why Capable Agents Still Fail</a>: Start with the theory behind harness engineering.</li>
+ <li><a href="./projects/project-01-baseline-vs-minimal-harness/">Project 01: Baseline vs Minimal Harness</a>: Walk through your first real task.</li>
+ <li><a href="./resources/templates/">Templates</a>: Grab the minimal harness pack (AGENTS.md, feature_list.json, claude-progress.md) for your own projects.</li>
</ul>
diff --git a/docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md b/docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md
index dddcf8f..3590124 100644
--- a/docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md
+++ b/docs/en/lectures/lecture-01-why-capable-agents-still-fail/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-01-why-capable-agents-still-fail/)
+[中文版本 →](../../../zh/lectures/lecture-01-why-capable-agents-still-fail/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-01-why-capable-agents-still-fail/code/)
> Practice project: [Project 01. Prompt-only vs. rules-first](./../../projects/project-01-baseline-vs-minimal-harness/index.md)
diff --git a/docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md b/docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md
index 9f6de41..2350e5a 100644
--- a/docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md
+++ b/docs/en/lectures/lecture-02-what-a-harness-actually-is/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-02-what-a-harness-actually-is/)
+[中文版本 →](../../../zh/lectures/lecture-02-what-a-harness-actually-is/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-02-what-a-harness-actually-is/code/)
> Practice project: [Project 01. Prompt-only vs. rules-first](./../../projects/project-01-baseline-vs-minimal-harness/index.md)
diff --git a/docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md b/docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
index b5c265d..7b90b56 100644
--- a/docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
+++ b/docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)
+[中文版本 →](../../../zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/code/)
> Practice project: [Project 02. Agent-readable workspace](./../../projects/project-02-agent-readable-workspace/index.md)
diff --git a/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md b/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
index 35ef925..44714fa 100644
--- a/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
+++ b/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/)
+[中文版本 →](../../../zh/lectures/lecture-04-why-one-giant-instruction-file-fails/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/code/)
> Practice project: [Project 02. Agent-readable workspace](./../../projects/project-02-agent-readable-workspace/index.md)
diff --git a/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md b/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
index 29fa1cb..d13f8a3 100644
--- a/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
+++ b/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/)
+[中文版本 →](../../../zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/code/)
> Practice project: [Project 03. Multi-session continuity](./../../projects/project-03-multi-session-continuity/index.md)
diff --git a/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md b/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
index 840ce36..4ec900f 100644
--- a/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
+++ b/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/)
+[中文版本 →](../../../zh/lectures/lecture-06-why-initialization-needs-its-own-phase/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/code/)
> Practice project: [Project 03. Multi-session continuity](./../../projects/project-03-multi-session-continuity/index.md)
diff --git a/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md b/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
index bde8876..037e355 100644
--- a/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
+++ b/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/)
+[中文版本 →](../../../zh/lectures/lecture-07-why-agents-overreach-and-under-finish/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/code/)
> Practice project: [Project 04. Runtime feedback and scope control](./../../projects/project-04-incremental-indexing/index.md)
diff --git a/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md b/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
index 1191526..02600ee 100644
--- a/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
+++ b/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/)
+[中文版本 →](../../../zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/code/)
> Practice project: [Project 04. Runtime feedback and scope control](./../../projects/project-04-incremental-indexing/index.md)
diff --git a/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md b/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
index 2b8c43a..f2e6a29 100644
--- a/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
+++ b/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-09-why-agents-declare-victory-too-early/)
+[中文版本 →](../../../zh/lectures/lecture-09-why-agents-declare-victory-too-early/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/code/)
> Practice project: [Project 05. Self-verification and role separation](./../../projects/project-05-grounded-qa-verification/index.md)
diff --git a/docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md b/docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
index 5f9a826..557d69e 100644
--- a/docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
+++ b/docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/)
+[中文版本 →](../../../zh/lectures/lecture-10-why-end-to-end-testing-changes-results/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-10-why-end-to-end-testing-changes-results/code/)
> Practice project: [Project 05. Self-verification and role separation](./../../projects/project-05-grounded-qa-verification/index.md)
diff --git a/docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md b/docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
index 42a16a4..9767f01 100644
--- a/docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
+++ b/docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/)
+[中文版本 →](../../../zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/code/)
> Practice project: [Project 06. Complete harness (Capstone)](./../../projects/project-06-runtime-observability-and-debugging/index.md)
diff --git a/docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md b/docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
index 1d57867..96501e8 100644
--- a/docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
+++ b/docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/)
+[中文版本 →](../../../zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/)
> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/code/)
> Practice project: [Project 06. Complete harness (Capstone)](./../../projects/project-06-runtime-observability-and-debugging/index.md)
diff --git a/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md b/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md
index d95939e..80aba98 100644
--- a/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md
+++ b/docs/en/projects/project-01-baseline-vs-minimal-harness/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-01-baseline-vs-minimal-harness/)
+[中文版本 →](../../../zh/projects/project-01-baseline-vs-minimal-harness/)
> Related lectures: [Lecture 01. Strong models don't mean reliable execution](./../../lectures/lecture-01-why-capable-agents-still-fail/index.md) · [Lecture 02. What harness actually means](./../../lectures/lecture-02-what-a-harness-actually-is/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/en/projects/project-02-agent-readable-workspace/index.md b/docs/en/projects/project-02-agent-readable-workspace/index.md
index 16b11d4..70b4985 100644
--- a/docs/en/projects/project-02-agent-readable-workspace/index.md
+++ b/docs/en/projects/project-02-agent-readable-workspace/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-02-agent-readable-workspace/)
+[中文版本 →](../../../zh/projects/project-02-agent-readable-workspace/)
> Related lectures: [Lecture 03. Make the repository your single source of truth](./../../lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md) · [Lecture 04. Split instructions across files](./../../lectures/lecture-04-why-one-giant-instruction-file-fails/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/en/projects/project-03-multi-session-continuity/index.md b/docs/en/projects/project-03-multi-session-continuity/index.md
index a771a33..856e5cf 100644
--- a/docs/en/projects/project-03-multi-session-continuity/index.md
+++ b/docs/en/projects/project-03-multi-session-continuity/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-03-multi-session-continuity/)
+[中文版本 →](../../../zh/projects/project-03-multi-session-continuity/)
> Related lectures: [Lecture 05. Keep context alive across sessions](./../../lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md) · [Lecture 06. Initialize before every agent session](./../../lectures/lecture-06-why-initialization-needs-its-own-phase/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/en/projects/project-04-incremental-indexing/index.md b/docs/en/projects/project-04-incremental-indexing/index.md
index 0c69a44..38fe462 100644
--- a/docs/en/projects/project-04-incremental-indexing/index.md
+++ b/docs/en/projects/project-04-incremental-indexing/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-04-incremental-indexing/)
+[中文版本 →](../../../zh/projects/project-04-incremental-indexing/)
> Related lectures: [Lecture 07. Draw clear task boundaries for agents](./../../lectures/lecture-07-why-agents-overreach-and-under-finish/index.md) · [Lecture 08. Use feature lists to constrain what the agent does](./../../lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/en/projects/project-05-grounded-qa-verification/index.md b/docs/en/projects/project-05-grounded-qa-verification/index.md
index fb509f0..23f79db 100644
--- a/docs/en/projects/project-05-grounded-qa-verification/index.md
+++ b/docs/en/projects/project-05-grounded-qa-verification/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-05-grounded-qa-verification/)
+[中文版本 →](../../../zh/projects/project-05-grounded-qa-verification/)
> Related lectures: [Lecture 09. Stop agents from declaring victory early](./../../lectures/lecture-09-why-agents-declare-victory-too-early/index.md) · [Lecture 10. Only a full-pipeline run counts as real verification](./../../lectures/lecture-10-why-end-to-end-testing-changes-results/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/en/projects/project-06-runtime-observability-and-debugging/index.md b/docs/en/projects/project-06-runtime-observability-and-debugging/index.md
index 568936d..34072cf 100644
--- a/docs/en/projects/project-06-runtime-observability-and-debugging/index.md
+++ b/docs/en/projects/project-06-runtime-observability-and-debugging/index.md
@@ -1,4 +1,4 @@
-[中文版本 →](/projects/project-06-runtime-observability-and-debugging/)
+[中文版本 →](../../../zh/projects/project-06-runtime-observability-and-debugging/)
> Related lectures: [Lecture 11. Make the agent's runtime observable](./../../lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md) · [Lecture 12. Clean handoff at the end of every session](./../../lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md)
> Template files: [templates/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/resources/templates/)
diff --git a/docs/zh/index.md b/docs/zh/index.md
index e9c1a4c..999b45c 100644
--- a/docs/zh/index.md
+++ b/docs/zh/index.md
@@ -13,15 +13,15 @@ Learn Harness Engineering 是一门专注于 AI 编程智能体工程化落地
选择适合你的学习路径。本课程分为理论讲义、实战项目和开箱即用的资料库。
<div class="card-grid">
- <a href="/zh/lectures/lecture-01-why-capable-agents-still-fail/" class="card">
+ <a href="./lectures/lecture-01-why-capable-agents-still-fail/" class="card">
<h3>讲义</h3>
<p>理解为什么强大的模型依然会失败,掌握构建有效 Harness 的理论基础。</p>
</a>
- <a href="/zh/projects/" class="card">
+ <a href="./projects/" class="card">
<h3>项目</h3>
<p>动手实践,从零开始搭建一个可靠的 Agent 工作环境。</p>
</a>
- <a href="/zh/resources/" class="card">
+ <a href="./resources/" class="card">
<h3>资料库</h3>
<p>开箱即用的模板(AGENTS.md、feature_list.json 等),可直接复制到你自己的代码仓库中。</p>
</a>
@@ -67,7 +67,7 @@ graph TD
了解核心概念后,可以通过以下内容深入学习:
<ul class="index-list">
- <li><a href="/zh/lectures/lecture-01-why-capable-agents-still-fail/">L01. 模型能力强,不等于执行可靠</a>:从理论开始。</li>
- <li><a href="/zh/projects/project-01-baseline-vs-minimal-harness/">P01. 提示词 vs 规则驱动</a>:完成你的第一个对比实战任务。</li>
- <li><a href="/zh/resources/templates/">中文模板</a>:获取最小 Harness 模板包(AGENTS.md、feature_list.json 等),直接用于你的项目。</li>
+ <li><a href="./lectures/lecture-01-why-capable-agents-still-fail/">L01. 模型能力强,不等于执行可靠</a>:从理论开始。</li>
+ <li><a href="./projects/project-01-baseline-vs-minimal-harness/">P01. 提示词 vs 规则驱动</a>:完成你的第一个对比实战任务。</li>
+ <li><a href="./resources/templates/">中文模板</a>:获取最小 Harness 模板包(AGENTS.md、feature_list.json 等),直接用于你的项目。</li>
</ul>
diff --git a/docs/zh/lectures/lecture-01-why-capable-agents-still-fail/index.md b/docs/zh/lectures/lecture-01-why-capable-agents-still-fail/index.md
index 4147f5b..bfbc05c 100644
--- a/docs/zh/lectures/lecture-01-why-capable-agents-still-fail/index.md
+++ b/docs/zh/lectures/lecture-01-why-capable-agents-still-fail/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-01-why-capable-agents-still-fail/)
+[English Version →](../../../en/lectures/lecture-01-why-capable-agents-still-fail/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-01-why-capable-agents-still-fail/code/)
> 实战练习:[Project 01. 只写提示词让 agent 做,和定好规则再让它做,差多少](./../../projects/project-01-baseline-vs-minimal-harness/index.md)
diff --git a/docs/zh/lectures/lecture-02-what-a-harness-actually-is/index.md b/docs/zh/lectures/lecture-02-what-a-harness-actually-is/index.md
index aa85a80..3ca4aa2 100644
--- a/docs/zh/lectures/lecture-02-what-a-harness-actually-is/index.md
+++ b/docs/zh/lectures/lecture-02-what-a-harness-actually-is/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-02-what-a-harness-actually-is/)
+[English Version →](../../../en/lectures/lecture-02-what-a-harness-actually-is/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-02-what-a-harness-actually-is/code/)
> 实战练习:[Project 01. 只写提示词让 agent 做,和定好规则再让它做,差多少](./../../projects/project-01-baseline-vs-minimal-harness/index.md)
diff --git a/docs/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md b/docs/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
index 91d5fa2..f814f9f 100644
--- a/docs/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
+++ b/docs/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)
+[English Version →](../../../en/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/code/)
> 实战练习:[Project 02. 让 agent 看懂项目、接住上次的工作](./../../projects/project-02-agent-readable-workspace/index.md)
diff --git a/docs/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md b/docs/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
index 96c88f9..35a90f7 100644
--- a/docs/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
+++ b/docs/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-04-why-one-giant-instruction-file-fails/)
+[English Version →](../../../en/lectures/lecture-04-why-one-giant-instruction-file-fails/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/code/)
> 实战练习:[Project 02. 让 agent 看懂项目、接住上次的工作](./../../projects/project-02-agent-readable-workspace/index.md)
diff --git a/docs/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md b/docs/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
index 2d4669b..4b9c733 100644
--- a/docs/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
+++ b/docs/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/)
+[English Version →](../../../en/lectures/lecture-05-why-long-running-tasks-lose-continuity/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/code/)
> 实战练习:[Project 03. 让 agent 关掉再打开还能接着干](./../../projects/project-03-multi-session-continuity/index.md)
diff --git a/docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md b/docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
index 476fc41..ec7059d 100644
--- a/docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
+++ b/docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-06-why-initialization-needs-its-own-phase/)
+[English Version →](../../../en/lectures/lecture-06-why-initialization-needs-its-own-phase/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/code/)
> 实战练习:[Project 03. 让 agent 关掉再打开还能接着干](./../../projects/project-03-multi-session-continuity/index.md)
diff --git a/docs/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md b/docs/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
index 90d3ce3..69d54b5 100644
--- a/docs/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
+++ b/docs/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-07-why-agents-overreach-and-under-finish/)
+[English Version →](../../../en/lectures/lecture-07-why-agents-overreach-and-under-finish/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/code/)
> 实战练习:[Project 04. 用运行反馈修正 agent 的行为](./../../projects/project-04-incremental-indexing/index.md)
diff --git a/docs/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md b/docs/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
index e903496..c141b66 100644
--- a/docs/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
+++ b/docs/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/)
+[English Version →](../../../en/lectures/lecture-08-why-feature-lists-are-harness-primitives/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/code/)
> 实战练习:[Project 04. 用运行反馈修正 agent 的行为](./../../projects/project-04-incremental-indexing/index.md)
diff --git a/docs/zh/lectures/lecture-09-why-agents-declare-victory-too-early/index.md b/docs/zh/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
index eb49912..027f179 100644
--- a/docs/zh/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
+++ b/docs/zh/lectures/lecture-09-why-agents-declare-victory-too-early/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-09-why-agents-declare-victory-too-early/)
+[English Version →](../../../en/lectures/lecture-09-why-agents-declare-victory-too-early/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-09-why-agents-declare-victory-too-early/code/)
> 实战练习:[Project 05. 让 agent 自己检查自己做的对不对](./../../projects/project-05-grounded-qa-verification/index.md)
diff --git a/docs/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md b/docs/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
index 7a55f6b..28ce210 100644
--- a/docs/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
+++ b/docs/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-10-why-end-to-end-testing-changes-results/)
+[English Version →](../../../en/lectures/lecture-10-why-end-to-end-testing-changes-results/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-10-why-end-to-end-testing-changes-results/code/)
> 实战练习:[Project 05. 让 agent 自己检查自己做的对不对](./../../projects/project-05-grounded-qa-verification/index.md)
diff --git a/docs/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md b/docs/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
index c6af5a5..5311215 100644
--- a/docs/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
+++ b/docs/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-11-why-observability-belongs-inside-the-harness/)
+[English Version →](../../../en/lectures/lecture-11-why-observability-belongs-inside-the-harness/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-11-why-observability-belongs-inside-the-harness/code/)
> 实战练习:[Project 06. 搭建一套完整的 agent 工作环境](./../../projects/project-06-runtime-observability-and-debugging/index.md)
diff --git a/docs/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md b/docs/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
index 544d8c9..fab57e8 100644
--- a/docs/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
+++ b/docs/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/index.md
@@ -1,4 +1,4 @@
-[English Version →](/en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/)
+[English Version →](../../../en/lectures/lecture-12-why-every-session-must-leave-a-clean-state/)
> 本篇代码示例:[code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/zh/lectures/lecture-12-why-every-session-must-leave-a-clean-state/code/)
> 实战练习:[Project 06. 搭建一套完整的 agent 工作环境](./../../projects/project-06-runtime-observability-and-debugging/index.md)