README.zh-cn.md

September 11, 2026 · View on GitHub

DeepSeek V4 for Copilot Chat

从 VS Code Marketplace 安装 从 Open VSX 安装
版本 安装量

English | 简体中文

在 Copilot Chat 模型选择器中直接使用 DeepSeek V4——无需离开你熟悉的 Copilot 工作流。

DeepSeek V4 Flash、Flash Vision Exp 和 Pro 出现在 Copilot Chat 模型选择器中,并展示思考深度菜单

喜欢 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 端点。

上下文缓存命中需要完整匹配已有的缓存前缀。

将图片拖入 Copilot Chat,DeepSeek 通过视觉代理响应

思考模式与思考强度控制

支持 DeepSeek 的思考模式和 reasoning_content停用关闭思考模式;开启后可选择轻量low)、标准high,默认)或深度max)。

继承全部 Copilot 能力

由于本扩展接入的是 Copilot 的原生 provider API,你免费获得完整能力栈:

  • Agent 模式——自主执行多步骤任务
  • 工具调用——文件编辑、终端操作、工作区搜索、Git、测试
  • Instructions & Skills——你的 .instructions.mdAGENTS.md 和各项 Skills 开箱即用
  • Prompt 缓存统计——在输出通道中记录 DeepSeek 缓存命中率,直观看到成本节省

DeepSeek V4 Pro 运行 Copilot 的 Agent 模式,执行工具调用

安全优先

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

安装方式

根据你所使用的编辑器选择对应的注册表安装:

  1. Microsoft VS Code — 从 VS Code Marketplace 安装。
  2. 使用 Open VSX 的编辑器 — 从 Open VSX 安装。

使用步骤

  1. 通过命令面板(Cmd+Shift+P)运行 DeepSeek: 设置 API Key
  2. 粘贴你的 Key 或兼容的 provider token(官方 DeepSeek Key 通常以 sk- 开头)
  3. 打开 Copilot Chat,点击模型选择器,选择 DeepSeek V4.1 FlashDeepSeek V4 Pro
  4. 搞定——开始聊天

模型

模型入口图片处理思考强度官方 API 状态
DeepSeek V4.1 Flash原生图片输入停用 / 轻量 / 标准 / 深度使用模型名 deepseek-flash 调用
DeepSeek V4 Pro视觉代理停用 / 轻量 / 标准 / 深度继续提供 API 调用服务,计费方式保持不变
DeepSeek V4 Flash视觉代理停用 / 轻量 / 标准 / 深度原模型已下线;旧模型名仍可调用
DeepSeek V4 Flash Vision Exp原生图片输入停用 / 轻量 / 标准 / 深度原模型已下线;旧模型名仍可调用

在官方 API 中,两个旧模型名(deepseek-v4-flashdeepseek-v4-flash-vision-exp)的请求均由 DeepSeek-V4.1-Flash 提供服务,按 Flash 价格计费。

四个入口均支持思考模式、工具调用和 1M Token 上下文。官方 API 的下线、路由和计费说明见模型与价格文档

设置项

设置项默认值说明
deepseek-copilot.baseUrlhttps://api.deepseek.comAPI 端点——可改为自托管或代理部署地址
deepseek-copilot.requestHeaders{}聊天补全请求的自定义请求头。配置说明
deepseek-copilot.maxTokens0最大输出 Token 数(0 = API 默认值)。可用于成本控制
deepseek-copilot.modelIdOverrides预填官方 ID 映射各 DeepSeek 模型入口对应的 API 模型 ID。仅在使用模型名不同的兼容第三方 API 时修改
deepseek-copilot.debugModeminimal诊断模式: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.stabilizeToolListfalse实验性设置。尝试预先激活 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 存系统密钥链⚠️ 各异

许可证

MIT