mesalogo
ff746bdc1a
Replace the restricted workspace_rg parameter mapping with native args and optional cwd. Preserve rg output and exit codes, and reuse process cancellation and output_read pagination so large search results remain accessible. Ask remains read-only within the workspace; Execute uses current-account permissions. Validation: focused regression 169 passed, 1 skipped; typecheck and lint passed. Real DeepSeek Ask and Execute pagination scenarios passed with six counted requests in the successful run; an earlier failed fixture run has no retained request count. Full-suite validation is not green: the recorded run had unrelated failures and the latest run timed out without a summary. The remote Agent does not use this local execution path. Release note: 直连模型可使用 ripgrep 原生参数搜索文件并保留原生结果，大输出可通过 output_read 完整续读。Ask 保持工作区只读，Execute 使用当前账号权限。
直连模型 Agent 能力
本目录是 GoodBuddy“直连模型 Agent 能力”的唯一文档入口。本功能为直连文本模型补齐 高效工作区搜索、分页读取、补丁编辑、跨平台进程执行和编程 Subagent，使其能够完成 “搜索、读取、修改、运行、验证”的开发闭环，同时避免向已经拥有原生 Shell 或 Agent 能力的 Runtime 重复注入工具。
文档导航
| 文档 | 权威职责 |
|---|---|
| PRD | 用户问题、产品范围、功能需求、非目标和产品验收 |
| User Stories | 本机开发、失败恢复、委派和 Runtime 边界场景 |
| 功能逻辑 | 能力矩阵、不变量、状态转换、继承规则和失败结果 |
| UI 设计 | 设置能力目录、聊天活动、Subagent 状态和无障碍行为 |
| 技术设计 | Main 服务、工具契约、平台适配、Subagent、生命周期和测试 |
| 功能进度 | 当前实现事实、待实施阶段、阻塞项和验证证据 |
术语
| 术语 | 定义 |
|---|---|
| 直连模型 | Runtime provider 为 model、由 GoodBuddy 直接调用模型协议的文本模型 |
| 进程执行 | GoodBuddy 在当前执行空间启动一个前台 Shell 命令并返回有界结果 |
| 工作区搜索 | 通过安装包内置 ripgrep 搜索内容或列出文件，接受原生参数并返回原生输出及退出码 |
| 工作区补丁 | 通过 *** Begin Patch 格式新增、修改或删除工作区文本文件 |
| 输出续读 | 通过 output_read 分页读取当前会话保留的搜索、进程或 Subagent 输出 |
| 平台 Shell | Windows 上的 PowerShell，macOS/Linux 上的 Bash 或 POSIX Sh |
| 编程 Subagent | 由直连模型临时委派、使用直连模型 Runtime 执行一个有界子任务的执行者 |
| 父请求 | 发起进程调用或 Subagent 委派的当前直连模型请求 |
| 子任务 | 父请求内部的一项委派工作，对应 Job/Subjob 语义，不是新的顶层 Task |
Task、Job、Subjob、Run 和 Subagent 的对象关系以 Task 与 Job 统一领域模型 为准。本功能不重新定义 这些对象。
功能边界
workspace_rg、workspace_read_text、workspace_apply_patch、process_execute、subagent_delegate和output_read是 GoodBuddy 直连模型内置工具，不是外部 MCP。- 直连文本模型的普通问答、工具轮次和上下文摘要会在尚无可见输出时，对瞬时网络错误或 单次请求超时最多自动重试 3 次。
- OpenCode、Continue 和 DeepSeek Harness 继续使用各自原生执行与委派能力。
- Ask 可搜索和分页读取工作区，但不允许补丁写入或进程执行；Subagent 若在 Ask 中使用， 只能继承 Ask 的只读能力。
- 搜索、进程和 Subagent 的长输出返回预览与续读位置，完整内容保留到所属会话或 Runtime 释放。 Ask 和 Execute 均可续读当前会话已取得的输出，详见 输出契约。
- Execute 表示用户授权当前执行空间账号的完整能力，不增加第二套工具审批或权限档位。
- 首版跨平台指桌面本机 Windows、macOS 和 Linux。托管 SSH 项目当前继续使用远端 OpenCode；未来若向远端直连模型开放本工具，命令必须由 Host Agent 执行，绝不能回退到 桌面本机。
相关功能
- 模型连接请求定制：定义连接级 Header/Body、合并优先级和 Runtime 支持矩阵。
- 本机工具环境：为新进程提供 Node、Python 和 PATH。
- 助手工作栏与执行空间：定义本机/SSH 执行位置和活动归属。
- 远程主机与远程执行：定义当前托管 SSH Runtime 边界。
- DeepSeek Harness Runtime：已经拥有平台 Shell 的独立 Runtime。