Files
goodbuddy/docs/features/direct-model-agent
mesalogo 25e897c22b chore: prepare GoodBuddy 0.12.7 and Agent 0.11.21 releases
Set the approved Desktop and Agent versions and package the approved Chinese
and English notes without changing published release history. Keep OpenCode
pinned to 1.18.29 and require Desktop 0.12.7 before the new Agent package.

Align both feature lists and affected design documents with reference-image
editing, inherited expert work modes, preview boundaries, and remaining
release acceptance. Application navigation remains design-only. No LoongArch
preview is planned for this release; Agent publication remains non-Latest.

The first candidate full run exposed a browser test clicking Send before it
was enabled. Wait for startup readiness using the existing test convention;
production code is unchanged by this release-preparation commit.

Validation: final full suite 3597 passed, 0 failed, 61 skipped across 338 files.
Typecheck, lint, bilingual release-note validation, version consistency,
unchanged historical notes, whitespace and relative-link checks passed.
No additional real model calls, local production builds, pushes or tags.
Concurrent navigation, workbar and roadmap design edits are not included.
2026-09-08 12:29:49 +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 执行,绝不能回退到 桌面本机。

相关功能