From 87729563aca07c0fbc69b5145ab3c6cd11e2fbbc Mon Sep 17 00:00:00 2001
From: hy <xiaoyuan9816@gmail.com>
Date: Wed, 9 Sep 2026 14:51:30 +0800
Subject: [PATCH] refactor: clarify assistant delivery process and link access
 handling in documentation

---
 doc/ai-harness/human-harness.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/ai-harness/human-harness.md b/doc/ai-harness/human-harness.md
index d70ebf38..3807693c 100644
--- a/doc/ai-harness/human-harness.md
+++ b/doc/ai-harness/human-harness.md
@@ -167,7 +167,7 @@ append-only 伙伴消息转录；模型上下文、UI、resume 均由此投影
 }
 ```
 
-**`assistant`（交付）** — 仅 `finalizeDelivery`（或内容安全 fallback）写入；`toolCalls` 为空数组；正常交付含 `linkAccess` sidecar（**仅本地文件**可达性；不改写 `content`；`http(s)` 不探测、渲染侧默认可点）。
+**`assistant`（交付）** — 仅 `finalizeDelivery`（或内容安全 fallback）写入；`toolCalls` 为空数组；正常交付含 `linkAccess` sidecar（不改写 `content`）。
 
 ```json
 {
@@ -839,7 +839,7 @@ Main **不**强制计划全部 `done` 才允许交付。
 applyDeliverySideEffects
   → docx/ppt 落盘、汇总 ai_file_change
   → finalizing_started（annotation，清空 plan 投影）
-  → 扫描交付 markdown 中的本地文件链接、去重检查可达性，写入 `linkAccess` sidecar（不改写正文；`http(s)` 不进 sidecar）
+  → 扫描交付 markdown 链接、去重检查访问，写入 `linkAccess` sidecar（不改写正文）
   → append 交付 assistant（toolCalls: []，含 linkAccess）
   → ai_run.status = completed
 ```