Files
goodbuddy/docs/features/direct-model-agent
mesalogo c82d0161a9
GoodBuddy Agents / Validate Agent source (push) Canceled after 0s
GoodBuddy Agents / Build darwin arm64 Agent (push) Canceled after 0s
GoodBuddy Agents / Build linux arm64 Agent (push) Canceled after 0s
GoodBuddy Agents / Build linux x64 Agent (push) Canceled after 0s
Cross-platform packages / Validate source (push) Canceled after 0s
Cross-platform packages / Authorize desktop packaging (push) Canceled after 0s
Cross-platform packages / linux arm64 (push) Canceled after 0s
Cross-platform packages / macos arm64 (push) Canceled after 0s
Cross-platform packages / windows arm64 (push) Canceled after 0s
Cross-platform packages / linux x64 (push) Canceled after 0s
Cross-platform packages / macos x64 (push) Canceled after 0s
Cross-platform packages / windows x64 (push) Canceled after 0s
Cross-platform packages / Publish GitHub and OSS release (push) Canceled after 0s
fix: show accurate request status in message footers
Requests could appear to keep working while OpenCode waited to retry, and
retry backoff was described as an active attempt. Report native OpenCode
retry timing, distinguish direct-model backoff from dispatch, and show
preparation, tool activity, pending input, and terminal states accurately.

Keep only the message-footer indicator static. Conversation-list activity
indicators, send/stop controls, retry limits, and command replay behavior
remain unchanged. Align the feature documentation with verified behavior.

Validation: 3618 tests passed, 61 skipped; typecheck and lint passed.
Isolated desktop validation used five real text-model calls across three
profiles, with controlled local fault injection for retry transitions.

Release note: 消息底部现在准确区分请求准备、等待重试、开始重试和需要回答的状态,不再用闪烁暗示仍有进展;会话列表闪点及发送、停止行为保持不变。
2026-09-08 22:47:06 +08:00
..

直连模型 Agent 能力

本目录是 GoodBuddy“直连模型 Agent 能力”的唯一文档入口。本功能为直连文本模型补齐 跨平台进程执行和编程 Subagent,使其能够在 Execute 模式完成读取、修改、运行和验证组成的 编程闭环,同时避免向已经拥有原生 Shell 或 Agent 能力的 Runtime 重复注入工具。

文档导航

文档 权威职责
PRD 用户问题、产品范围、功能需求、非目标和产品验收
User Stories 本机开发、失败恢复、委派和 Runtime 边界场景
功能逻辑 能力矩阵、不变量、状态转换、继承规则和失败结果
UI 设计 设置能力目录、聊天活动、Subagent 状态和无障碍行为
技术设计 Main 服务、工具契约、平台适配、Subagent、生命周期和测试
功能进度 当前实现事实、待实施阶段、阻塞项和验证证据

术语

术语 定义
直连模型 Runtime provider 为 model、由 GoodBuddy 直接调用模型协议的文本模型
进程执行 GoodBuddy 在当前执行空间启动一个前台 Shell 命令并返回有界结果
平台 Shell Windows 上的 PowerShell,macOS/Linux 上的 Bash 或 POSIX Sh
编程 Subagent 由直连模型临时委派、使用直连模型 Runtime 执行一个有界子任务的执行者
父请求 发起进程调用或 Subagent 委派的当前直连模型请求
子任务 父请求内部的一项委派工作,对应 Job/Subjob 语义,不是新的顶层 Task

Task、Job、Subjob、Run 和 Subagent 的对象关系以 Task 与 Job 统一领域模型 为准。本功能不重新定义 这些对象。

功能边界

  • process_execute 和 subagent_delegate 是 GoodBuddy 直连模型内置工具,不是外部 MCP。
  • 直连文本模型的普通问答、工具轮次和上下文摘要会在尚无可见输出时,对瞬时网络错误或 单次请求超时最多自动重试 3 次。
  • OpenCode、Continue 和 DeepSeek Harness 继续使用各自原生执行与委派能力。
  • Ask 不允许进程执行;Subagent 若在 Ask 中使用,只能继承 Ask 的只读能力。
  • Execute 表示用户授权当前执行空间账号的完整能力,不增加第二套工具审批或权限档位。
  • 首版跨平台指桌面本机 Windows、macOS 和 Linux。托管 SSH 项目当前继续使用远端 OpenCode;未来若向远端直连模型开放本工具,命令必须由 Host Agent 执行,绝不能回退到 桌面本机。

相关功能