mesalogo
c037d7fb20
Restore Ask workspace reads and output paging without granting write access, and let programming Subagents reuse their parent's browser page. Allocate browser resources only when used, keep Agent pages aligned with workbar tabs, recover released bindings, and remove unused automatic screenshot work. Preserve inherited Runtime selections during remote usage persistence and manual compression. Keep viable channel model fallbacks, display the actual scheduled-task mode and Harness model source, and avoid rediscovery delays when calling healthy MCP tools. Fix directory/history refresh, case-only renames, rename-aware commit diffs, and FastGPT probe success reporting. Add regression coverage and align feature documentation. The Agent-side connection timeout fix requires deploying an updated Agent; existing Ask read-only and Execute authorization boundaries remain unchanged. Final validation: 3839 tests passed, 66 skipped; typecheck, lint, development build, and diff checks passed. Isolated Electron UI/MCP workflows passed with a loopback model fixture. Current-source Linux x64 Host checks passed with three successful real model requests. Chromium loadURL rejection was not reproduced in the UI; released-binding recovery has automated coverage. Release note: 修复 Ask 读取项目文件、浏览器页面显示与恢复、文件管理及模型配置跟随中的不一致，并减少无用截图和 MCP 等待。定时任务显示实际工作模式，远程会话可正常保存继承 Runtime 的用量；远端连接超时修复需更新 Agent 后生效。
直连模型 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。