mesalogo
56b8b10d46
Return ordinary tool exceptions as paired error results so the model can decide how to recover. Preserve cancellation, existing recovery guidance, and failed tool activities without adding automatic retries or retry limits. Validate all three text protocols with real process execution and cover bounded errors and cancellation. Focused tests: 161 passed, 1 skipped; typecheck and lint passed. Full suite: 6230 passed, 87 skipped, 1 Obsidian temporary-directory assertion failed. Release note: Direct-model conversations can continue after a tool fails, allowing the model to use the reported error to choose its next step.
直连模型 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 继续使用各自原生执行与委派能力。
- 正常请求可使用已注册的搜索、读取、补丁与进程工具；Subagent 继承父请求能力范围。
- 搜索、进程和 Subagent 的长输出返回预览与续读位置，完整内容保留到所属会话或 Runtime 释放。 可续读当前会话已取得的输出，详见 输出契约。
- 使用当前执行空间账号权限，不增加第二套工具审批或权限档位。
- 首版跨平台指桌面本机 Windows、macOS 和 Linux。托管 SSH 项目当前继续使用远端 OpenCode；未来若向远端直连模型开放本工具，命令必须由 Host Agent 执行，绝不能回退到 桌面本机。
相关功能
- 模型连接请求定制：定义连接级 Header/Body、合并优先级和 Runtime 支持矩阵。
- 本机工具环境：为新进程提供 Node、Python 和 PATH。
- 助手工作栏与执行空间：定义本机/SSH 执行位置和活动归属。
- 远程主机与远程执行：定义当前托管 SSH Runtime 边界。
- DeepSeek Harness Runtime：已经拥有平台 Shell 的独立 Runtime。