Fix docs links for GitHub Pages routes

sanbuphy · sanbuphy · commit 47dc3484a67f · 2026-04-02T13:25:27.000+08:00
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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)

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-01-why-capable-agents-still-fail/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-01-why-capable-agents-still-fail/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-01-why-capable-agents-still-fail/code/)`
`4`	`4`	`> Practice project: [Project 01. Prompt-only vs. rules-first](./../../projects/project-01-baseline-vs-minimal-harness/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-02-what-a-harness-actually-is/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-02-what-a-harness-actually-is/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-02-what-a-harness-actually-is/code/)`
`4`	`4`	`> Practice project: [Project 01. Prompt-only vs. rules-first](./../../projects/project-01-baseline-vs-minimal-harness/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-03-why-the-repository-must-become-the-system-of-record/)`
`2`	`2`
`3`	`3`	`> 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/)`
`4`	`4`	`> Practice project: [Project 02. Agent-readable workspace](./../../projects/project-02-agent-readable-workspace/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-04-why-one-giant-instruction-file-fails/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-04-why-one-giant-instruction-file-fails/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-04-why-one-giant-instruction-file-fails/code/)`
`4`	`4`	`> Practice project: [Project 02. Agent-readable workspace](./../../projects/project-02-agent-readable-workspace/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-05-why-long-running-tasks-lose-continuity/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-05-why-long-running-tasks-lose-continuity/code/)`
`4`	`4`	`> Practice project: [Project 03. Multi-session continuity](./../../projects/project-03-multi-session-continuity/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-06-why-initialization-needs-its-own-phase/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-06-why-initialization-needs-its-own-phase/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-06-why-initialization-needs-its-own-phase/code/)`
`4`	`4`	`> Practice project: [Project 03. Multi-session continuity](./../../projects/project-03-multi-session-continuity/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-07-why-agents-overreach-and-under-finish/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-07-why-agents-overreach-and-under-finish/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-07-why-agents-overreach-and-under-finish/code/)`
`4`	`4`	`> Practice project: [Project 04. Runtime feedback and scope control](./../../projects/project-04-incremental-indexing/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-08-why-feature-lists-are-harness-primitives/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-08-why-feature-lists-are-harness-primitives/code/)`
`4`	`4`	`> Practice project: [Project 04. Runtime feedback and scope control](./../../projects/project-04-incremental-indexing/index.md)`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-[中文版本 →](/zh/lectures/lecture-09-why-agents-declare-victory-too-early/)`
	`1`	`+[中文版本 →](../../../zh/lectures/lecture-09-why-agents-declare-victory-too-early/)`
`2`	`2`
`3`	`3`	`> Code examples: [code/](https://github.com/walkinglabs/learn-harness-engineering/blob/main/docs/en/lectures/lecture-09-why-agents-declare-victory-too-early/code/)`
`4`	`4`	`> Practice project: [Project 05. Self-verification and role separation](./../../projects/project-05-grounded-qa-verification/index.md)`