README.zh-cn.md
September 11, 2026 · View on GitHub
DeepSeek V4 for Copilot Chat
English | 简体中文
在 Copilot Chat 模型选择器中直接使用 DeepSeek V4——无需离开你熟悉的 Copilot 工作流。
喜欢 DeepSeek 的性价比,但不想放弃 GitHub Copilot 的 Agent 模式、工具调用和成熟的交互体验?本扩展将 DeepSeek V4.1 Flash 等模型直接接入 Copilot Chat 模型选择器,支持原生视觉或视觉代理、思考模式,并使用你自己的 API Key。
为什么选这个扩展?
- 不是替换 Copilot,而是增强它。 没有新的侧边栏,没有新的聊天界面需要学习。只是在你已经在用的模型选择器中多了一个选项。
- Agent 模式、工具调用、Instructions、MCP、Skills——全部正常运作。 Copilot 的完整能力栈,现在跑在 DeepSeek 上。
- 两种图片处理方式。 V4.1 Flash 和 Flash Vision Exp 会原生接收图片附件;V4 Flash 和 Pro 则保留原有文本上下文,由可配置的视觉代理将图片转换为文字描述。
- 需自行提供 API Key,直接向 DeepSeek 付费。 你的 API Key,你的账单,你的速率限制。密钥存储在操作系统密钥链中,不会以明文形式写入磁盘。
功能特性
DeepSeek 模型出现在模型选择器中
选择器包含 V4.1 Flash、V4 Pro,并保留旧 Flash 模型名对应的入口,支持长上下文、工具调用和可配置的思考强度。
原生视觉与视觉代理
可以根据对话需要选择不同的图片处理路径:
- DeepSeek V4.1 Flash 和 Flash Vision Exp 直接处理图片附件,不经过视觉代理。
- DeepSeek V4 Flash 和 Pro 入口使用视觉代理:先由支持图片输入的模型描述附件,再将描述连同对话内容交给 DeepSeek 主模型。自动模式会在可用时选择 Flash Vision Exp,同时继续支持显式配置其他 VS Code 模型或 API 端点。
上下文缓存命中需要完整匹配已有的缓存前缀。
思考模式与思考强度控制
支持 DeepSeek 的思考模式和 reasoning_content。停用关闭思考模式;开启后可选择轻量(low)、标准(high,默认)或深度(max)。
继承全部 Copilot 能力
由于本扩展接入的是 Copilot 的原生 provider API,你免费获得完整能力栈:
- Agent 模式——自主执行多步骤任务
- 工具调用——文件编辑、终端操作、工作区搜索、Git、测试
- Instructions & Skills——你的
.instructions.md、AGENTS.md和各项 Skills 开箱即用 - Prompt 缓存统计——在输出通道中记录 DeepSeek 缓存命中率,直观看到成本节省
安全优先
API Key 存储在 VS Code 的 SecretStorage 中(macOS 钥匙串 / Windows 凭据管理器 / Linux 密钥环)。绝不会出现在 settings.json 中,也不会被提交到 Git 历史。
零运行时依赖
纯 VS Code API + Node.js 内置模块。无需 Python、Docker 或本地代理进程。
快速开始
前置条件
- VS Code 1.116 及以上版本。本扩展依赖非公开的 Copilot Chat API,较新的 VS Code 版本可能存在兼容性问题——如遇到请提交 Issue。
- GitHub Copilot 订阅(Free / Pro / Enterprise——免费版即可使用)
- DeepSeek API Key,从 platform.deepseek.com 获取;使用自定义
deepseek-copilot.baseUrl时也可使用兼容的 provider token
安装方式
根据你所使用的编辑器选择对应的注册表安装:
- Microsoft VS Code — 从 VS Code Marketplace 安装。
- 使用 Open VSX 的编辑器 — 从 Open VSX 安装。
使用步骤
- 通过命令面板(
Cmd+Shift+P)运行 DeepSeek: 设置 API Key - 粘贴你的 Key 或兼容的 provider token(官方 DeepSeek Key 通常以
sk-开头) - 打开 Copilot Chat,点击模型选择器,选择 DeepSeek V4.1 Flash 或 DeepSeek V4 Pro
- 搞定——开始聊天
模型
| 模型入口 | 图片处理 | 思考强度 | 官方 API 状态 |
|---|---|---|---|
| DeepSeek V4.1 Flash | 原生图片输入 | 停用 / 轻量 / 标准 / 深度 | 使用模型名 deepseek-flash 调用 |
| DeepSeek V4 Pro | 视觉代理 | 停用 / 轻量 / 标准 / 深度 | 继续提供 API 调用服务,计费方式保持不变 |
| DeepSeek V4 Flash | 视觉代理 | 停用 / 轻量 / 标准 / 深度 | 原模型已下线;旧模型名仍可调用 |
| DeepSeek V4 Flash Vision Exp | 原生图片输入 | 停用 / 轻量 / 标准 / 深度 | 原模型已下线;旧模型名仍可调用 |
在官方 API 中,两个旧模型名(deepseek-v4-flash 和 deepseek-v4-flash-vision-exp)的请求均由 DeepSeek-V4.1-Flash 提供服务,按 Flash 价格计费。
四个入口均支持思考模式、工具调用和 1M Token 上下文。官方 API 的下线、路由和计费说明见模型与价格文档。
设置项
| 设置项 | 默认值 | 说明 |
|---|---|---|
deepseek-copilot.baseUrl | https://api.deepseek.com | API 端点——可改为自托管或代理部署地址 |
deepseek-copilot.requestHeaders | {} | 聊天补全请求的自定义请求头。配置说明 |
deepseek-copilot.maxTokens | 0 | 最大输出 Token 数(0 = API 默认值)。可用于成本控制 |
deepseek-copilot.modelIdOverrides | 预填官方 ID 映射 | 各 DeepSeek 模型入口对应的 API 模型 ID。仅在使用模型名不同的兼容第三方 API 时修改 |
deepseek-copilot.debugMode | minimal | 诊断模式:minimal 仅上报 token 用量,metadata 输出隐私安全日志,verbose 将完整请求 dump 和 pipeline snapshot 写入扩展 global storage。完整 dump 可能包含敏感提示词文本、工具定义、文件片段和图片描述。使用 DeepSeek: 打开请求 Dump 目录 打开 dump 位置 |
deepseek-copilot.visionModel | (自动) | V4 Flash 和 Pro 使用的视觉代理。自动模式会在可用时选择 Flash Vision Exp;也可通过 DeepSeek: 配置视觉代理 改用其他 VS Code 模型或 API 端点 |
deepseek-copilot.visionPrompt | (内置) | V4 Flash/Pro 的视觉代理用于描述图片附件的提示词,不影响 V4.1 Flash 或 Flash Vision Exp 的原生图片请求 |
deepseek-copilot.experimental.stabilizeToolList | false | 实验性设置。尝试预先激活 VS Code/Copilot 的虚拟工具,让传给 DeepSeek API 的 tools 参数在多轮对话中更完整、更稳定。当已启用工具跨轮次变化时,可能提高上下文缓存命中率。代价是 input tokens 可能增加;缓存命中的 input tokens 单价更低,但仍会计入用量。64 个或更少已启用工具时通常无需开启,除非工具列表仍在跨轮次变化;超过 128 个已启用工具时不建议开启 |
思考强度可通过 Copilot Chat 的模型选择器对每个 DeepSeek 模型单独设置。
兼容 API 代理的 settings.json 配置示例:
{
"deepseek-copilot.modelIdOverrides": {
"deepseek-flash": "your-v4.1-flash-model-id",
"deepseek-v4-flash": "your-flash-model-id",
"deepseek-v4-pro": "your-pro-model-id",
"deepseek-v4-flash-vision-exp": "your-vision-model-id"
}
}
方案对比
| 本扩展 | 本地代理(如 LiteLLM) | 独立 DeepSeek 扩展 | |
|---|---|---|---|
| 在 Copilot Chat 内使用 | ✅ | ✅ | ❌ 独立界面 |
| Agent 模式、工具、Skills | ✅ | ✅ | ⚠️ 自行实现 |
| 视觉支持 | ✅ 原生 + 代理 | ❌ | ❌ |
| 无需额外运行进程 | ✅ | ❌ | ✅ |
| 一键安装 | ✅ | ❌ | ✅ |
| API Key 存系统密钥链 | ✅ | ❌ | ⚠️ 各异 |