Merge remote-tracking branch 'upstream/main' into copilot/resolve-code-branch-conflicts

# Conflicts:
#	README-zh.md
#	docs/zh/s01-the-agent-loop.md
#	docs/zh/s04-subagent.md

docs/zh/s01-the-agent-loop.md

@@ -3,6 +3,8 @@
 `[ s01 ] s02 > s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"One loop & Bash is all you need"* -- 一个工具 + 一个循环 = 一个 Agent。
+>
+> **Harness 层**: 循环 -- 模型与真实世界的第一道连接。
 
 ## 问题
 

docs/zh/s02-tool-use.md

@@ -3,6 +3,8 @@
 `s01 > [ s02 ] s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"加一个工具, 只加一个 handler"* -- 循环不用动, 新工具注册进 dispatch map 就行。
+>
+> **Harness 层**: 工具分发 -- 扩展模型能触达的边界。
 
 ## 问题
 

docs/zh/s03-todo-write.md

@@ -3,6 +3,8 @@
 `s01 > s02 > [ s03 ] s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"没有计划的 agent 走哪算哪"* -- 先列步骤再动手, 完成率翻倍。
+>
+> **Harness 层**: 规划 -- 让模型不偏航, 但不替它画航线。
 
 ## 问题
 

docs/zh/s04-subagent.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > [ s04 ] s05 > s06 | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"大任务拆小, 每个小任务干净的上下文"* -- Subagent 用独立 messages[], 不污染主对话。
+>
+> **Harness 层**: 上下文隔离 -- 守护模型的思维清晰度。
 
 ## 问题
 

docs/zh/s05-skill-loading.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > [ s05 ] s06 | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"用到什么知识, 临时加载什么知识"* -- 通过 tool_result 注入, 不塞 system prompt。
+>
+> **Harness 层**: 按需知识 -- 模型开口要时才给的领域专长。
 
 ## 问题
 

docs/zh/s06-context-compact.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > [ s06 ] | s07 > s08 > s09 > s10 > s11 > s12`
 
 > *"上下文总会满, 要有办法腾地方"* -- 三层压缩策略, 换来无限会话。
+>
+> **Harness 层**: 压缩 -- 干净的记忆, 无限的会话。
 
 ## 问题
 

docs/zh/s07-task-system.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | [ s07 ] s08 > s09 > s10 > s11 > s12`
 
 > *"大目标要拆成小任务, 排好序, 记在磁盘上"* -- 文件持久化的任务图, 为多 agent 协作打基础。
+>
+> **Harness 层**: 持久化任务 -- 比任何一次对话都长命的目标。
 
 ## 问题
 

docs/zh/s08-background-tasks.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | s07 > [ s08 ] s09 > s10 > s11 > s12`
 
 > *"慢操作丢后台, agent 继续想下一步"* -- 后台线程跑命令, 完成后注入通知。
+>
+> **Harness 层**: 后台执行 -- 模型继续思考, harness 负责等待。
 
 ## 问题
 

docs/zh/s09-agent-teams.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | s07 > s08 > [ s09 ] s10 > s11 > s12`
 
 > *"任务太大一个人干不完, 要能分给队友"* -- 持久化队友 + JSONL 邮箱。
+>
+> **Harness 层**: 团队邮箱 -- 多个模型, 通过文件协调。
 
 ## 问题
 

docs/zh/s10-team-protocols.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | s07 > s08 > s09 > [ s10 ] s11 > s12`
 
 > *"队友之间要有统一的沟通规矩"* -- 一个 request-response 模式驱动所有协商。
+>
+> **Harness 层**: 协议 -- 模型之间的结构化握手。
 
 ## 问题
 

docs/zh/s11-autonomous-agents.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > [ s11 ] s12`
 
 > *"队友自己看看板, 有活就认领"* -- 不需要领导逐个分配, 自组织。
+>
+> **Harness 层**: 自治 -- 模型自己找活干, 无需指派。
 
 ## 问题
 

docs/zh/s12-worktree-task-isolation.md

@@ -3,6 +3,8 @@
 `s01 > s02 > s03 > s04 > s05 > s06 | s07 > s08 > s09 > s10 > s11 > [ s12 ]`
 
 > *"各干各的目录, 互不干扰"* -- 任务管目标, worktree 管目录, 按 ID 绑定。
+>
+> **Harness 层**: 目录隔离 -- 永不碰撞的并行执行通道。
 
 ## 问题