想咨询下是否有适配其余 api 接入的计划

[TIANXUAN13]

因为有使用 new api 来接入 deepseek （公司的），所以统一入口都是 new api 的 https://url/v1这样接入的，能适配这样来调用 deepseek v4 的模型方式吗

[ZhouChaunge]

非常感谢，我们会在下个版本更新多个模型厂商（包括中转站），然后也提供自定义api接口。估计这周会更新这个功能，但是目前有一些设计是需要进行调整的，比如说当前界面下显示的余额和缓存命中率都是针对ds官网爬取的数据，我们还在思考这个问题要怎么设计。请给一些时间，我们尽快完善这个公

[ZhouChaunge]

feat: 支持自定义 OpenAI 兼容 API 端点（New-API / 企业网关）

把这个 issue 升级成一份正式的跟踪条目，方便后续拆 PR。原始诉求来自 @TIANXUAN13，结合现有代码现状整理如下。

---

1. 背景

公司统一通过 New-API（OpenAI 兼容中转网关）管理大模型流量，希望 DeepCopilot 能通过 https://<corp-gw>/v1 接入 DeepSeek，而不是强制直连官方域名。

这是中型团队 / 国内合规环境的普遍诉求：统一鉴权、集中计费、quota 限流、限流降级。本 issue 只解决"让企业用户能在非官方端点上跑通核心对话与工具调用"，不涉及多厂商管理 UI、不涉及对第三方网关做计费 / 余额估算。

2. 现状差距（已基于代码核对）

#	模块	现状	处置
1	src/api/deepseek.js streamDeepSeek	已支持任意 baseUrl	✅ 无需改动
2	src/api/deepseek.js fetchBalance	走 DS 私有 /user/balance	❌ 非官方 host 时跳过调用
3	package.json defaultModel / subAgentModel	硬 enum 仅 4 个 id	❌ 放宽为自由文本 + 推荐列表
4	src/pricing.js / 成本展示	按硬编码 id 算价	❌ 非官方 host 时完全不展示金额、cache 命中率、用量 pill
5	出站请求 headers	仅 Authorization: Bearer	⚠️ 本期可选：是否引入 extraHeaders（见 §4）
6	footer 余额 pill	已有 b.unsupported 隐藏分支	✅ 复用

3. 设计

3.1 端点类型判定

新增 isOfficialEndpoint(baseUrl)（位于 src/api/deepseek.js）：

• host ∈ { api.deepseek.com, api.deepseeki.com } 视为 official；
• 其余一律 non-official；
• apiBaseUrl 为空时按默认 api.deepseek.com 处理，视为 official。

3.2 非官方端点的行为差异

行为	official	non-official
/chat/completions 流式	✅	✅
工具调用 / spawn_agent	✅	✅
/user/balance 查询	✅	❌ 跳过，不发起请求
footer 余额 pill	显示	隐藏（下发 { unsupported: true }）
单次消息的成本 / 价格 / cache 命中率 / token pill	显示	全部不显示
src/pricing.js 调用	正常	跳过

决策：非官方端点下不显示任何用量/计费统计。原因：

• token 计数虽是标准字段，但缺少价格信息时单独展示意义不大；
• 企业用户通常在网关侧自有用量看板，UI 简洁优先；
• 避免任何"估算 vs 实际账单"的歧义。

3.3 配置项变更（package.json）

• deepseekAgent.defaultModel / subAgentModel：去掉 enum 限制（改为 type: \"string\"，保留示例与描述）。
• 配置说明里注明：官方端点请使用预置 id；自定义端点请填写网关侧的 model 别名。

3.4 代码改动点

• src/api/deepseek.js
  • 新增 isOfficialEndpoint(baseUrl) 工具函数；
  • fetchBalance：非官方 host 立即 resolve({ unsupported: true })。
• src/chat/provider.js（推送 usage / cost 给 webview 的位置）：在非官方端点时，不推送 cost_cny、pricing、cache_hit_tokens 等字段，或推送时附带 endpointKind: 'custom'。
• media/chat.js：当 webview 收到 endpointKind === 'custom' 时，跳过 token pill / cost 文案的渲染。
• src/webview/html.js：余额 pill 初始 display:none 已就绪，无需结构调整。

4. 待决

本期是否引入 extraHeaders？

• 选项 A：本期带上，配合 New-API 常见的 x-team-id 等场景；
• 选项 B：本期不做，仅 Authorization: Bearer，由后续 issue 跟进。

倾向 A，但仅暴露字符串 map，禁止覆盖 Authorization / Content-Type / Accept，日志需 redact value。

5. 任务拆分

• T1 package.json：放宽 defaultModel / subAgentModel 的 enum
• T2 src/api/deepseek.js：isOfficialEndpoint + fetchBalance 短路
• T3 src/chat/provider.js + media/chat.js：非官方端点下不渲染用量/cost
• T4 文档：README + release note 新增"对接 OpenAI 兼容网关"小节
• T5 验收（见 §6）
• T6（取决于 §4 决策）extraHeaders 配置与日志 redact

依赖：T1 / T2 可并行；T3 依赖 T2 的 isOfficialEndpoint。

6. 验收

场景	期望
默认 / 官方域名	余额、cost、cache 命中率、token pill 全部正常显示
apiBaseUrl = https://<new-api-gw>/v1 + 自定义 model id	对话、工具调用、spawn_agent 正常；footer 余额 pill 隐藏；消息下不显示 cost / cache / token pill；Output 面板无 /user/balance 报错
切换回官方域名	上述展示全部恢复
defaultModel 填入未在原 enum 中的字符串	VS Code 设置页不再报红，运行时按填写值透传

7. 风险

• 配置迁移：原 enum 值 (deepseek-v4-pro 等) 必须保持兼容，已有用户配置不应失效。
• 日志泄露：若实现 §4 的 extraHeaders，header value 在 logger / Output / debug log 中必须 redact。
• UI 一致性：非官方端点下隐藏统计后，要确保 footer 高度 / 消息底栏布局没有空洞（注意 visibility vs display 的选择）。

8. 关联

• 源 issue：本 issue
• 后续候选：多厂商 UI、自定义价格表、Qwen / Kimi / Claude 原生协议接入

---

cc @TIANXUAN13 —— MVP 合入后欢迎参与 beta 验证。