docs(v3): T25 文档收口（工作区选择 + harness 工具，274 测试全绿）

2026-09-01 10:16:58 +08:00
parent da5dfb0ef3
commit b08e0bb5d7
3 changed files with 44 additions and 9 deletions
@@ -106,3 +106,19 @@
 4. 中文文献知网核对仍待完成（定稿前必做）。

 *记录人：DSH Agent（2026）。*
+
+### 5.4 增补（同日）：工作区选择 + harness 级工具（T22–T25）
+
+- **需求来源**：智能体原先只能固定操作 `agent_workspace/`，"不能选择工作区"。
+  参考 `deepseek-harness/`（DeepSeek 开源 agent harness）的"打开文件夹"体验与工具集设计。
+- **落地**：① 工作目录可选——`/agent/fs` 磁盘目录浏览（Windows 盘符枚举）+
+  最近工作区列表（持久化），运行记录所用目录，左侧文件面板跟随切换；
+  ② 工具升级到 harness 级——`edit_file`（old_string 唯一命中才替换，防误改）、
+  `search_files`（跨文件内容搜索，跳过 .git/node_modules 等）、
+  `run_command`（**默认关闭**，UI 开关 allow_shell，超时+输出截断+Windows 无窗口）；
+  ③ 前端 edit_file 渲染为红/绿 diff 卡，命令卡展示 `$ 命令` 与退出码输出。
+- **实测**：选定 `E:\agent_demo\greet_app`，模型完成"读文件 → edit_file 加参数校验 →
+  运行 python greet.py 验证"，磁盘文件真实变更（出现 __pycache__ 证明命令在工作区内执行）。
+- **测试**：全量 274 passed（新增 12：tools 扩展 7 + 工作区选择 5）。
+- **安全边界（论文可写）**：文件操作相对所选根关押；shell 独立开关默认关；
+  唯一性约束防覆盖式误编辑——"能力开放 + 边界收窄"的设计权衡可作一节。