Files
goodbuddy/docs/features/model-connections
mesalogo 9836a4cc9d
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: keep question order and streamline contextual help
Keep interactive questions and answered cards at their original position in
conversation history, including remote reception, recovery, and reopening.
Preserve legacy history placement without a database migration.

Move supplementary guidance into shared accessible contextual-help popovers
across pages and settings. Add keyboard, modal, accessibility, and Electron
regressions, plus bounded opt-in live canvas-analysis validation.

Remove unused Agent, Runtime, and in-memory graph-search helpers, obsolete
mocks and browser copy; reuse the existing package-size formatter. Keep
production execution paths, protocol schemas, and released data migrations.

Validation: targeted cleanup tests, typecheck, lint, shared Linux Host
attach/read/re-attach, and added help/Electron checks passed. Final full-suite
verification passed 4,858 tests with 67 skipped and zero failures (412 files
passed, 9 skipped). Focused help checks passed 54 tests, including Electron
style comparisons and Chromium accessibility descriptions. Details and
validation boundaries are recorded in feature docs.

Release note: 修复交互式问答在回答后排到后续输出末尾的问题,重新打开会话仍保留提问位置。页面和设置中的补充说明改为标题或字段旁的按需帮助,支持鼠标与键盘操作。
2026-09-20 01:26:36 +08:00
..

模型连接请求定制

本功能负责 LLM 模型连接的自定义请求头和自定义请求体。用户可以在同一个连接中保存 Provider 要求的附加元数据;GoodBuddy 只在直连链路或 Runtime 明确原生支持的链路中应用 这些值,不为不支持的 Runtime 伪造透传能力。

文档导航

文档 权威职责
UI 设计 编辑入口、校验反馈、兼容性说明和无障碍行为
技术设计 契约、持久化、合并优先级、Runtime 支持矩阵和验证
功能进度 已验证实现、剩余工作和验证证据

模型连接选择准确性也在本目录维护:技术设计第 8 节定义通道直连回退修复, UI 设计末节定义 Harness 来源标签和公开设置展示;Harness 的实际解析顺序由其 技术设计唯一维护。

本次改动是现有模型连接的有界扩展,不新增独立业务对象或工作流,因此不单独建立 PRD、 User Stories 和逻辑设计;本页定义产品边界,技术设计定义唯一的请求合并规则。

术语

术语 定义
自定义请求头 用户为一个 LLM 模型连接保存的附加 HTTP Header 字符串映射
自定义请求体 用户为一个 LLM 模型连接保存的附加 JSON 顶层字段
Runtime 字段 GoodBuddy 或 Runtime 为模型、消息、工具、流式、认证和协议生成的字段
直连 GoodBuddy Main 直接向模型 Provider 发出请求
受管远程 OpenCode 模型请求通过 GoodBuddy Agent 的可信模型网关发出的远程 OpenCode

产品边界

  • 两项设置都位于“设置 → 模型连接 → LLM → 连接详情”底部,以 JSON 对象编辑。
  • 直连模型支持请求头和请求体,包括连接测试、文本、工具、摘要和图像生成请求。
  • Continue 原生支持请求头和请求体。
  • 本地 OpenCode 原生支持请求头,不使用自定义请求体。
  • DeepSeek Harness 的 Pi-AI Provider 原生支持请求头,不使用自定义请求体。
  • 受管远程 OpenCode 的可信模型网关支持请求头和请求体。
  • 使用 Runtime 自有配置时不引用 GoodBuddy 模型连接,因此不会应用连接级请求定制。
  • Runtime、协议和认证字段始终优先。用户不能用请求定制替换模型、消息、工具、流式或 认证信息。
  • 自定义值作为普通连接设置保存。API Key 和其他密钥必须使用专用凭据字段,不应写入 自定义请求头或请求体。

相关功能