copilot-agent-deepseek-custom：支持按模型自定义端点与百炼托管的 Copilot 插件安装与使用指南

项目背景

用 DeepSeek 驱动 GitHub Copilot 的开发者，常会遇到一个痛点：官方 DeepSeek 端点和企业自建 / 第三方托管（比如阿里云百炼 Bailian 上托管的 DeepSeek V4 Pro）往往需要不同的 API 地址和密钥，而普通 Copilot 接入插件只支持一个全局 baseUrl，无法"一个模型走官方、另一个模型走百炼"。

copilot-agent-deepseek-custom 由 Mindock 团队开发，是开源项目 DeepSeek V4 for Copilot Chat 的一个定制 Fork。它保留了原项目"不替换 Copilot、只往模型选择器加选项"的优雅设计，把每一层都做成可配置：每个模型入口都可以有自己的 baseUrl、apiKey、temperature、topP、maxTokens。你可以在同一个 Copilot Chat 选择器里，同时使用官方 DeepSeek 的 Flash/Pro，以及百炼托管的 DeepSeek V4 Pro。

它面向"追求最高自由度 Agent 开发"的用户：既要 Copilot 成熟的 Agent 循环、工具调用和精致 UI，又要按模型级别精细控制端点与采样参数。

核心特性

• 四个 DeepSeek 模型同框：Flash、Pro、实验性 Flash Vision Exp，以及百炼托管的 DeepSeek V4 Pro，官方与托管模型可在同一选择器共存。
• 按模型端点覆盖：每个模型入口可单独设置 baseUrl、apiKey、temperature、topP、maxTokens，留空则回退全局配置。
• 自由注册新模型：任何非空的 vscodeModelId 都会在选择器注册为新条目——同一个底层模型可以不同温度/端点多次出现。
• 原生视觉 + Vision Proxy：Flash Vision Exp 原生接收图片；Flash / Pro 通过可配置 Vision Proxy 把图片转描述。
• 思考强度四档：none / low / high（默认）/ max，从选择器直接调节。
• Prompt Hub：在 Copilot Chat 内搜索、下载、分享提示词，无需离开编辑器。
• 继承 Copilot 全家桶：Agent 模式、工具调用、指令文件、Skills、MCP、prompt 缓存统计全部可用。
• 密钥安全：全局 Key 存于 OS 钥匙串；按模型覆盖里的 apiKey 为可选明文（用于 CI/自动化场景）。

环境要求

• VS Code：1.116 或更高版本。
• GitHub Copilot：已安装并登录 Copilot Chat（Free / Pro / Enterprise 均可）。
• API Key：DeepSeek 官方 Key，或百炼（Bailian）托管端点的兼容 Token。

详细部署步骤

第一步：安装扩展

在 VS Code 扩展面板（Ctrl+Shift+X）搜索 copilot-agent-deepseek-custom（发布者 Mindock）安装；Open VSX 系编辑器从 Open VSX 安装。

第二步：设置全局 API Key

1. 命令面板（Ctrl+Shift+P）运行 DeepSeek V4 Custom: Set API Key。
2. 粘贴你的 DeepSeek 官方 API Key（sk-...），回车。此 Key 作为全局默认凭据存入钥匙串。

第三步：在模型选择器中选用

1. 打开 Copilot Chat（Ctrl+Alt+I）。
2. 点击模型选择器，选择 DeepSeek V4 Flash、DeepSeek V4 Pro、DeepSeek V4 Flash Vision Exp 或 DeepSeek V4 Pro (Bailian)。
3. 悬停模型调整思考强度。

第四步（关键）：配置按模型端点覆盖

运行命令面板 DeepSeek V4 Custom: Configure Model Overrides 可图形化管理；或直接编辑 settings.json。下面是一个"混用官方 DeepSeek 与百炼托管模型"的完整示例：

{
  "deepseek-v4-custom.modelIdOverrides": [
    {
      "vscodeModelId": "deepseek-v4-pro-bailian",
      "apiModelId": "vanchin/deepseek-v4-pro-0813",
      "baseUrl": "https://ws-hjupuk4sp6qrwi05.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
      "apiKey": "sk-ws-你的百炼密钥",
      "temperature": 0.7,
      "topP": null,
      "maxTokens": 4096
    }
  ]
}

你还可以把同一个底层模型注册成多个不同温度的入口，并排出现在选择器里：

{
  "deepseek-v4-custom.modelIdOverrides": [
    { "vscodeModelId": "deepseek-v4-pro-self-0.2", "apiModelId": "deepseek-v4-pro", "temperature": 0.2 },
    { "vscodeModelId": "deepseek-v4-pro-self-0.8", "apiModelId": "deepseek-v4-pro", "temperature": 0.8 }
  ]
}

配置项说明：vscodeModelId 是选择器里显示的模型 ID；apiModelId 是真正发给 API 的模型名；留空的 baseUrl/apiKey/maxTokens 会回退到全局设置。若某条配置无法解析（如 vscodeModelId 为空），扩展会弹窗报错并暂时隐藏 DeepSeek 模型，直到你修正。

常见坑与解决办法

• 选择器里看不到 DeepSeek：说明有一条 override 配置无法解析，按弹窗提示修正后重载窗口。
• 百炼模型连不上：确认百炼端点 baseUrl 完整（含 /compatible-mode/v1）、apiModelId 与百炼控制台里的模型名一致。
• 401 / 403：Key 错误或失效。
• 402：DeepSeek 官方账户余额不足（注意百炼和官方是两个独立账单）。
• VS Code 升级后异常：该扩展依赖 Copilot 非公开 API，遇到不兼容先去 Marketplace 看是否有新版。

使用方法示例

日常开发用 DeepSeek V4 Flash 快速迭代；复杂 Agent 任务切到 DeepSeek V4 Pro (Bailian)；需要直接看截图就开 Flash Vision Exp。Prompt Hub 可在 Chat 标题栏点书本图标搜索公开提示词，选中后自动填充输入框（不自动发送），按 Enter 再发送。

常见问题 FAQ

Q1：和原版 DeepSeek V4 for Copilot Chat 是什么关系？
A：本扩展是它的定制 Fork，感谢 Vizards 原作者。本版额外提供按模型端点覆盖与百炼托管支持。

Q2：可以同时用官方 DeepSeek 和百炼吗？
A：可以。官方模型走全局 baseUrl/Key，百炼模型在 override 里单独指定 baseUrl/Key，两者在同一选择器共存。

Q3：同一个模型能配多个温度吗？
A：能。注册多个不同 vscodeModelId、指向同一 apiModelId 即可，会作为多个独立选项出现。

Q4：API Key 明文写在 settings.json 安全吗？
A：全局 Key 强烈建议用命令 Set API Key 存入钥匙串；只有 CI/自动化等场景才在 override 里用明文 apiKey。

Q5：支持 MCP 和 Skills 吗？
A：完整继承 Copilot 的 MCP、Skills、指令文件能力。

跳转链接

• VS Code Marketplace：https://marketplace.visualstudio.com/items?itemName=mindock.copilot-agent-deepseek-custom
• 上游开源项目：https://github.com/Vizards/deepseek-v4-for-copilot
• DeepSeek 官方接入文档：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/github_copilot/
• API Key 申请：https://platform.deepseek.com/api_keys