docs: 区分 AgentRun source 与 trans target

2026-07-13 03:46:23 +02:00
parent 73c96f00b6
commit 654dd6992b
2 changed files with 19 additions and 5 deletions
@@ -31,10 +31,12 @@ AipodSpec/Artificer、task manifest 和 queue 渐进披露见 [references/resour

 - AgentRun 与调用方之间的契约版本、源码/镜像版本和 `commitId` 对齐只能产生非阻塞 warning；可安全归一化的请求继续 admission/dispatch，不得因版本或契约漂移阻止用户任务、session、run、command 或 runner。
 - 新写入口不要用 `codex submit/steer/resume`；这些 legacy mutation 已冻结。
- Artificer task prompt 只引用 task 自身的 primary workspace：
-  - 默认写当前工作区 `.`，需要子目录时写相对路径；
-  - 禁止写入宿主 `/root/unidesk`、主代理 worktree 或其他 task 外部绝对路径；
-  - 路径不可见时先用 `agentrun events run/<runId> --detail-seq <seq>` 核对 durable workspace 物化事实，不让 Artificer 搜索或切换到旁路仓库。
+- Artificer 的 primary source workspace 与远端 tool target 必须分开判定：
+  - task prompt 引用待修改源码时，默认写 primary workspace `.`，需要子目录时写相对路径；
+  - 禁止把宿主 `/root/unidesk`、主代理 worktree 或其他 task 外部绝对路径当成 source workspace；
+  - 用户明确授权的 `trans <route> ...` 远端范围属于 `unidesk-ssh` tool target，不是旁路 source workspace；
+  - 访问远端 tool target 必须使用已投影的受控 `trans`，并继续遵守 route allowlist、SecretRef、脱敏和短连接边界；
+  - primary source 路径不可见时，先用 `agentrun events run/<runId> --detail-seq <seq>` 核对 durable workspace 物化事实，不让 Artificer 搜索或切换到旁路仓库。
 - 默认输出保持低噪声表格/摘要；机器消费显式 `-o json|yaml` 或 `--raw`。
 - 读取 task 的可重建输入：
  - 使用 `agentrun describe task/<taskId> --input -o json`；