mesalogo
ec100f8176
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 搜索项目、分页读取任意大小的文本，并通过多文件补丁修改代码；设置中的相关能力统一显示为工作区文件和开发工具。
直连模型 Agent 能力
本目录是 GoodBuddy“直连模型 Agent 能力”的唯一文档入口。本功能为直连文本模型补齐 高效工作区搜索、分页读取、补丁编辑、跨平台进程执行和编程 Subagent，使其能够完成 “搜索、读取、修改、运行、验证”的开发闭环，同时避免向已经拥有原生 Shell 或 Agent 能力的 Runtime 重复注入工具。
文档导航
| 文档 | 权威职责 |
|---|---|
| PRD | 用户问题、产品范围、功能需求、非目标和产品验收 |
| User Stories | 本机开发、失败恢复、委派和 Runtime 边界场景 |
| 功能逻辑 | 能力矩阵、不变量、状态转换、继承规则和失败结果 |
| UI 设计 | 设置能力目录、聊天活动、Subagent 状态和无障碍行为 |
| 技术设计 | Main 服务、工具契约、平台适配、Subagent、生命周期和测试 |
| 功能进度 | 当前实现事实、待实施阶段、阻塞项和验证证据 |
术语
| 术语 | 定义 |
|---|---|
| 直连模型 | Runtime provider 为 model、由 GoodBuddy 直接调用模型协议的文本模型 |
| 进程执行 | GoodBuddy 在当前执行空间启动一个前台 Shell 命令并返回有界结果 |
| 工作区搜索 | 通过安装包内置 ripgrep 搜索内容或列出文件，并返回紧凑结果 |
| 工作区补丁 | 通过 *** Begin Patch 格式新增、修改或删除工作区文本文件 |
| 平台 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是 GoodBuddy 直连模型内置工具，不是外部 MCP。- 直连文本模型的普通问答、工具轮次和上下文摘要会在尚无可见输出时，对瞬时网络错误或 单次请求超时最多自动重试 3 次。
- OpenCode、Continue 和 DeepSeek Harness 继续使用各自原生执行与委派能力。
- Ask 可搜索和分页读取工作区，但不允许补丁写入或进程执行；Subagent 若在 Ask 中使用， 只能继承 Ask 的只读能力。
- Execute 表示用户授权当前执行空间账号的完整能力，不增加第二套工具审批或权限档位。
- 首版跨平台指桌面本机 Windows、macOS 和 Linux。托管 SSH 项目当前继续使用远端 OpenCode；未来若向远端直连模型开放本工具，命令必须由 Host Agent 执行，绝不能回退到 桌面本机。
相关功能
- 模型连接请求定制：定义连接级 Header/Body、合并优先级和 Runtime 支持矩阵。
- 本机工具环境：为新进程提供 Node、Python 和 PATH。
- 助手工作栏与执行空间：定义本机/SSH 执行位置和活动归属。
- 远程主机与远程执行：定义当前托管 SSH Runtime 边界。
- DeepSeek Harness Runtime：已经拥有平台 Shell 的独立 Runtime。