mesalogo
9c88ca20f3
- Store runtime selection as { provider?, model? } layers and resolve them per
field (conversation -> project -> global); drop the legacy auto provider.
- Migrate stored selections (database v49) and clear deleted profile ids.
- Re-resolve selections in Main per request and at queue dispatch.
- Add ProjectRuntimeSelector and a two-column RuntimeModelPicker; manage
link opens model connections; restore per-runtime default model tabs.
- Stop duplicating trusted instructions and history across OpenCode,
Continue and DeepSeek Harness runtimes.
- Document the layered design, global provider removal plan and planned
purpose-specific models.
54 lines
3.1 KiB
Markdown
54 lines
3.1 KiB
Markdown
# 模型连接请求定制
|
|
|
|
本功能负责 LLM 模型连接的自定义请求头和自定义请求体。用户可以在同一个连接中保存
|
|
Provider 要求的附加元数据；GoodBuddy 只在直连链路或 Runtime 明确原生支持的链路中应用
|
|
这些值，不为不支持的 Runtime 伪造透传能力。
|
|
|
|
## 文档导航
|
|
|
|
| 文档 | 权威职责 |
|
|
| --- | --- |
|
|
| [UI 设计](./ui-design.md) | 编辑入口、校验反馈、兼容性说明和无障碍行为 |
|
|
| [技术设计](./technical-design.md) | 契约、持久化、合并优先级、Runtime 支持矩阵和验证 |
|
|
| [执行方式与模型选择](./runtime-selection-design.md) | 会话/项目/全局分层解析、选择器行为、存储迁移、全局 `provider` 移除计划和用途模型规划 |
|
|
| [功能进度](./progress.md) | 已验证实现、剩余工作和验证证据 |
|
|
|
|
模型连接选择准确性也在本目录维护：技术设计第 8 节定义通道直连回退修复，
|
|
UI 设计末节定义 Harness 来源标签和公开设置展示；Harness 的实际解析顺序由其
|
|
[技术设计](../deepseek-harness/technical-design.md#121-配置来源)唯一维护。
|
|
|
|
本次改动是现有模型连接的有界扩展，不新增独立业务对象或工作流，因此不单独建立 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 和其他密钥必须使用专用凭据字段，不应写入
|
|
自定义请求头或请求体。
|
|
- LLM 连接可以复制，已保存的 API Key 由 Main 进程安全复制到新连接。
|
|
|
|
## 相关功能
|
|
|
|
- [直连模型 Agent](../direct-model-agent/README.md)
|
|
- [图片生成与连续修改](../image-generation/README.md)
|
|
- [DeepSeek Harness Runtime](../deepseek-harness/README.md)
|
|
- [远程主机与远程执行](../remote-host/README.md)
|