Deep Copilot：基于 DeepSeek API 的独立 VS Code 对话式 AI 编程助手安装与使用指南

项目背景

GitHub Copilot Chat 虽然强大，但它依赖微软自己的模型与订阅；而很多开发者只想纯粹地使用便宜、强悍的 DeepSeek API，又不想被绑定到某个厂商的封闭生态。Deep Copilot 就是这样一个"轻装上阵"的选择：它在 VS Code 侧边栏提供一个基于大语言模型的对话式编程面板，通过 DeepSeek 官方 API（兼容 OpenAI 协议）与模型交互。

它最大的特点是完全不需要后端服务：整个扩展只有一个约 94KB 的单文件构建产物 out/extension.js，全部跑在 VS Code 扩展主机里，基于 VS Code Extension API 与 Node.js 内置模块实现，运行时零 npm 依赖。你不用装 Python、不用跑 Docker、不用维护本地代理，装上扩展填个 Key 就能用。

该扩展采用黑底白色小鲸鱼的品牌形象，目前累计安装量已超过 4700 次，并保持高频迭代，0.41 系列新增了上下文窗口管理、底部 Context Ring、值守任务（Watchdog）等实用能力。

核心特性

• 无后端、零依赖：单文件 bundle 约 94KB，无需在宿主机部署任何额外服务。
• 完整 Agent 工具链：支持文件读写、代码搜索、Shell 命令执行，结果以 SSE 流式实时渲染。
• 斜杠命令 + @文件 + #上下文：内置 /explain、/fix、/tests 等命令，支持 #file、#selection、#editor、#problems、#changes、#terminal 等上下文引用。
• Plan 只读模式：调查代码结构时只允许读与搜索，拒绝任何写操作和 Shell 执行，安全无副作用。
• Skills 技能系统：在 ~/.deepcopilot/skills、~/.claude/skills、~/.copilot/skills 放置 SKILL.md 技能包即可复用。
• 项目规则自动发现：自动注入 DEEPCOPILOT.md、.github/copilot-instructions.md、AGENTS.md、CLAUDE.md、.cursor/rules/*.mdc。
• 上下文窗口管理：结构感知截断、同文件去重、滚动摘要，支持 /compact、/context、/fork。
• 成本与多模型：底栏实时显示 token 数与人民币成本，可在 deepseek-v4-pro / deepseek-v4-flash / deepseek-reasoner 间切换。

环境要求

• VS Code：≥ 1.95。
• DeepSeek API Key：从 platform.deepseek.com/api_keys 获取（必填）。
• Tavily API Key：可选，仅在需要联网搜索 web_search 工具时从 app.tavily.com 获取。
• 从源码构建时：Node.js ≥ 18、npm ≥ 9、Git。

详细部署步骤

方式一：从扩展商城安装（推荐）

1. 打开 VS Code，进入扩展面板（Ctrl+Shift+X / Cmd+Shift+X）。
2. 搜索 Deep Copilot（发布者 ZhouChaunge），点击安装。
3. 或者使用快速安装：按 Ctrl+P，粘贴 ext install ZhouChaunge.deep-copilot 回车。

方式二：安装预构建 VSIX

从 GitHub Releases 下载最新版 .vsix 文件后：

code --install-extension deep-copilot-0.41.6.vsix

也可以在扩展面板右上角 ⋯ 菜单选择 Install from VSIX... 选择文件。

方式三：从源码构建（开发者）

# 1. 克隆仓库
git clone https://github.com/ZhouChaunge/DeepCopilot.git
cd DeepCopilot

# 2. 安装依赖（只有 devDependencies，运行时纯 VS Code API）
npm install

# 3. 编译为单文件（产出 out/extension.js，约 105KB）
npm run build

# 4. 打包为 VSIX（产出 deep-copilot-0.41.6.vsix）
npm run package

# 5. 本地安装
code --install-extension deep-copilot-0.41.6.vsix --force

开发期可使用 npm run watch 监听源码变化增量重建，再在 VS Code 里按 F5 启动扩展开发宿主调试。

配置 API Key

1. 安装后，点击左侧活动栏的 🐋 Deep Copilot 图标打开聊天面板。
2. 点击面板右下角的 🔑 按钮。
3. 在弹出的统一设置面板中粘贴 DeepSeek API Key 并保存。
4. 如需联网搜索，在同一面板继续填入 Tavily API Key。

国内用户如果 api.deepseek.com 连接不稳定，在 🔑 弹窗中把 Base URL 改为 https://api.deepseeki.com 即可。

配置文件与进阶设置

所有设置都在 settings.json 的 deepseekAgent.* 命名空间下，默认模型为 deepseek-v4-pro：

{
  "deepseekAgent.defaultModel": "deepseek-v4-pro",
  "deepseekAgent.inlineCompletion.enable": false,
  "deepseekAgent.mcp.servers": [
    { "name": "my-db", "command": "npx", "args": ["my-db-mcp-server"] }
  ]
}

还可在工作区根目录新建 DEEPCOPILOT.md 写入项目约定（自动注入系统提示词），在家目录新建 ~/.deepcopilot/memory.md 写入跨项目个人偏好（最多 4KB）。

常见坑与解决办法

使用方法示例

打开 Deep Copilot 面板后，直接用自然语言下达任务：

# 解释当前选中的代码
/explain #selection

# 自动修复问题并补测试
/fix #problems
/tests

# 引用文件与上下文
帮我重构 @src/utils/request.js，参考 #changes 里的改动

# 只读调查模式（Plan）
切换到 Plan 模式，先摸清 #editor 所在模块的调用关系，不要改任何文件

代码块支持"在终端运行 / 插入 / 复制 / 折叠"快捷操作；底栏会实时显示 token 消耗与人民币成本，以及从绿到红的上下文占用环形指示器。

常见问题 FAQ

Q1：需要自己搭后端服务吗？
A：完全不需要。整个扩展跑在 VS Code 扩展主机里，单文件 bundle 约 94KB，直接调 DeepSeek 官方 API。

Q2：免费吗？
A：扩展本身免费，你只需为 DeepSeek API 调用按量付费。

Q3：支持联网搜索吗？
A：填入 Tavily API Key 后即可启用 web_search 工具；不填也不影响日常编码对话。

Q4：如何接入 MCP 外部工具？
A：在 deepseekAgent.mcp.servers 中配置任意 stdio MCP 服务器，工具会以 mcp__<server>__<tool> 形式出现。

Q5：会乱改我的代码吗？
A：所有 write_file 操作都在扩展端强制审批，未经策略或用户放行不会真正写盘；也可切换到 Plan 只读模式只调查不改。

跳转链接

• GitHub 仓库：https://github.com/ZhouChaunge/DeepCopilot
• VS Code Marketplace：https://marketplace.visualstudio.com/items?itemName=ZhouChaunge.deep-copilot
• API Key 申请：https://platform.deepseek.com/api_keys
• Tavily Key（可选）：https://app.tavily.com