feat: improve direct model workspace tools

Direct models now use bundled ripgrep for workspace discovery, read files through resumable pages, and edit multiple files with apply_patch. Ask can search and read while Execute retains write access, and fixed total input limits no longer constrain these tools. Release note: 直连模型现可使用随包 ripgrep 搜索项目、分页读取任意大小的文本，并通过多文件补丁修改代码；设置中的相关能力统一显示为工作区文件和开发工具。
2026-09-10 00:45:03 +08:00
parent c1f8ba80ee
commit ec100f8176
28 changed files with 1542 additions and 171 deletions
@@ -5,8 +5,8 @@
 | 项目 | 内容 |
 | --- | --- |
 | 状态 | 已实施，跨平台 CI 待验证 |
-| 版本 | 0.3 |
-| 日期 | 2026-09-03 |
+| 版本 | 0.4 |
+| 日期 | 2026-09-09 |
 | 适用产品 | GoodBuddy 桌面端 |
 | 目标平台 | Windows、macOS、Linux，x64 与 arm64 |
 | 关联领域 | [Task 与 Job 统一领域模型](../task-and-job/task-and-job-model.md) |
@@ -22,10 +22,11 @@ Git 或项目脚本，因此无法独立验证结果。
 工具，与本功能的 `subagent_delegate` 仍为不同入口。OpenCode、Continue 和 DeepSeek Harness 一般已经提供
 Shell、Agent 或 Task 能力，再向它们注入 GoodBuddy 同名工具只会造成重复入口和语义冲突。

-本功能只补齐直连模型缺少的基础 Agent 能力：
+本功能补齐直连模型缺少的基础 Agent 能力：

-1. 一个按平台适配的进程执行接口。
-2. 一个单层、继承父请求范围的编程 Subagent 接口。
+1. 一组工作区搜索、分页读取和补丁编辑接口。
+2. 一个按平台适配的进程执行接口。
+3. 一个单层、继承父请求范围的编程 Subagent 接口。

 ## 2. 产品目标

@@ -34,6 +35,7 @@ Shell、Agent 或 Task 能力，再向它们注入 GoodBuddy 同名工具只会
 3. 让直连模型可以把独立工作委派给临时 Subagent，并取得有界、可核验的结果。
 4. 保持 Ask 只读、Execute 完整授权、执行空间、取消、有界输出和进程回收语义不变。
 5. 不向已有原生执行能力的 Agent Runtime 重复注入 GoodBuddy 进程或 Subagent 工具。
+6. 使用安装包内置 ripgrep 提供跨平台一致的快速代码搜索，不依赖用户预装命令。

 ## 3. 核心产品决策

@@ -76,6 +78,12 @@ Subagent 使用父请求的项目、执行空间、工作模式、直连模型
 Ask 禁止命令和写入。Execute 是用户对当前执行空间账号的完整授权。进程和 Subagent 不增加
 “受控执行”“仅测试”“可信命令”或逐命令风险等级，也不重复弹出第二套确认。

+### 3.6 精简工作区工具
+
+直连模型使用 `workspace_rg` 发现文件和搜索内容，使用 `workspace_read_text` 按行分页读取，
+使用 `workspace_apply_patch` 新增、修改或删除文本文件。新请求不再注入低效的单层目录列表和
+整文件覆盖工具。Ask 提供前两个只读工具；Execute 额外提供补丁工具。
+
 ## 4. 功能范围

 ### 4.1 包含
@@ -88,6 +96,7 @@ Ask 禁止命令和写入。Execute 是用户对当前执行空间账号的完
 - 直连模型单层 Subagent 委派、排队、运行、部分结果、失败和取消。
 - 父子请求的工具、模型用量、活动和成果归属。
 - 桌面聊天和选择直连模型的消息通道项目使用相同 Runtime 能力矩阵。
+- 安装包按目标平台和架构携带固定版本 ripgrep，并将其提供给工作区搜索和命令 PATH。

 ### 4.2 不包含

@@ -180,6 +189,19 @@ Ask 禁止命令和写入。Execute 是用户对当前执行空间账号的完
 - 一旦本次模型调用已经显示文本或推理内容，不自动重放该调用，避免重复回答。
 - 非网络类 Provider 错误、协议错误和用户取消不进入自动重试。

+### FR-12 高效工作区工具
+
+- `workspace_rg` 同时支持内容搜索和文件列表，遵循项目忽略规则，并以
+  `path:line:column:text` 紧凑格式返回匹配。
+- `workspace_read_text` 接受起始行和行数，大文件通过续读完成，不因超过旧的整文件上限而
+  完全不可读；超长单行可使用返回的字节位置继续读取。
+- `workspace_apply_patch` 支持一个补丁新增、修改和删除多个 UTF-8 文件；执行前验证全部
+  路径和 hunk，执行失败时准确报告已完成文件。
+- 搜索和读取在 Ask/Execute 均可用；补丁只在 Execute 可用，Main 调用边界再次检查模式。
+- `workspace_rg` 使用固定参数调用随包 ripgrep，不向模型开放 `--pre` 或任意命令参数。
+- 工作区工具不限制文件总大小、补丁总大小、搜索表达式长度、glob 数量或模型请求的结果
+  数量。单次返回按上下文容量截断或分页；读取结果提供续读位置，搜索结果提示模型缩小查询。
+
 ## 6. 产品验收

 - [ ] Windows 直连模型 Execute 使用 PowerShell 创建文件、运行测试并读取退出码。
@@ -195,4 +217,7 @@ Ask 禁止命令和写入。Execute 是用户对当前执行空间账号的完
 - [ ] 子任务不进入 Task Center，不创建独立可导航 Conversation。
 - [ ] TLS 建连重置和请求超时在未输出内容时最多自动重试 3 次，成功后继续原请求。
 - [ ] 重试等待可取消，已显示部分内容的失败不自动重放。
+- [ ] Ask 可使用 ripgrep 搜索和分页读取，但不能应用补丁。
+- [ ] Execute 可通过一个补丁新增、修改和删除多个工作区文件，并运行测试验证。
+- [ ] Windows、macOS、Linux 的 x64/arm64 安装包均携带对应 ripgrep，且无需系统预装。
 - [ ] 全量测试、类型检查、Lint 和生产构建通过。