DeepCopilot

如何填入 · How to set them

中文：

1. 安装扩展后，点击侧边栏活动栏的 🐋 图标打开 Deep Copilot 面板
2. 点击面板右下角 🔑 按钮 → 粘贴 DeepSeek API Key → 保存
3. 若需要联网搜索，在同一弹窗里继续填入 Tavily API Key

English:

1. After installing, click the 🐋 icon in the activity bar to open the Deep Copilot panel
2. Click the 🔑 button in the bottom-right of the panel → paste your DeepSeek API Key → save
3. For web search, fill in your Tavily API Key in the same dialog

> 国内用户：若 api.deepseek.com 连接不稳定，在 🔑 弹窗中将 Base URL 改为 https://api.deepseeki.com。 > China users: if api.deepseek.com is slow, set Base URL to https://api.deepseeki.com in the 🔑 dialog.

📑 Table of Contents · 目录

• [API Keys · 需要配置的 Key](#-api-keys-required--需要配置的-api-key)
• [Highlights · 亮点](#-highlights--亮点)
• [Quick Start · 快速开始](#-quick-start--快速开始)
• [Build from Source · 源码构建](#-build-from-source--源码构建)
• [Configuration · 配置](#%EF%B8%8F-configuration--配置)
• [Keybindings · 快捷键](#%EF%B8%8F-keybindings--快捷键)
• [Tools · 工具列表](#-tools--工具列表)
• [Architecture · 架构](#%EF%B8%8F-architecture--架构)
• [Project Structure · 项目结构](#-project-structure--项目结构)
• [Development · 开发](#-development--开发)
• [Troubleshooting · 故障排查](#-troubleshooting--故障排查)
• [Changelog · 更新日志](#-changelog--更新日志)
• [Star History](#-star-history)
• [License](#-license)

✨ Highlights · 亮点

| English | 中文 | | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | | Agentic loop with multi-turn tool calling on DeepSeek V4 (Pro / Flash / Reasoner) | 与 DeepSeek V4（Pro / Flash / Reasoner）多轮tool-calling 循环 | | File tools: read, write, str-replace, applypatch, list dir, find files, ripgrep search | 文件工具：读 / 写 / 精准替换 / applypatch / 列目录 / 查找 / 全文搜索 | | Shell tool with configurable approval policy | 终端工具，按审批策略弹窗确认 | | Web search via Tavily (optional API key) | 网络搜索（Tavily，可选 Key） | | Plan & Todos panel — agent maintains a structured plan you can watch tick off | Plan & Todos 面板，Agent 自维护结构化任务并实时勾选 | | Revert last turn — one-click rollback of all file edits in the current agent turn | 一键回滚当前 Agent 轮次对文件的所有修改 | | Pending edits panel — GH-Copilot-style review popover above the composer: per-file +N/-M, hover Keep/Discard, click row to open native diff editor; survives turn end | 待审编辑面板—输入框上方弹出 GH Copilot 风格的复检面板：逐文件 +N/-M、悬停保留/丢弃、点击行打开原生 Diff 编辑器；对话结束后仍可继续点击 | | User memory (~/.deepcopilot/memory.md) — cross-project preferences in every system prompt | 用户记忆（~/.deepcopilot/memory.md），跨项目偏好自动注入系统提示词 | | MCP client — connect any MCP-compatible tool server via deepseekAgent.mcp.servers | MCP 客户端，通过 deepseekAgent.mcp.servers 连接任意 MCP 工具服务器 | | Post-tool hooks — run scripts after any tool call; output injected into model context | 工具后置钩子，工具调用后自动执行脚本，输出注入模型上下文 | | Post-edit LSP diagnostics appended to every edit so the model can self-verify | 每次编辑后自动附加LSP 诊断，模型可自行校验 | | Per-workspace session history with search, rename, delete | 每工作区独立的会话历史，可搜索 / 重命名 / 删除 | | Parallel sessions — switch away from a running task and start another; live replay on return | 多会话并行：任务跑着可以切走开新对话，回来自动回放进度 | | Streaming output with reasoning expander, blinking cursor, top progress bar | 流式输出：思维链可展开、闪烁光标、顶部进度条 | | HTML rendering — model responses render full Markdown + HTML; math via KaTeX | HTML 渲染：响应支持完整 Markdown + HTML + KaTeX 数学公式 | | Account balance display in footer (click to refresh) | 账户余额实时显示在底栏（点击刷新） | | Auto-grow input — textarea grows with content, GH Copilot style | 自适应输入框：随内容自动增高，对齐 GH Copilot 体验 | | Approval modes: Manual / Auto-Edit / Autopilot / Read-Only | 审批模式：手动 / 自动编辑 / 全自动 / 只读 | | Cost telemetry in CNY shown in the footer | 底栏显示token 数与人民币成本 | | Slash commands (/explain, /fix, /tests …), @ file refs and # context refs — pick #file, #selection, #editor, #problems, #changes, #terminal, #symbol:Foo, #fetch:URL from the input | 斜杠命令 + @ 文件引用 + # 上下文引用（在输入框键入 # 即可挑选文件 / 选区 / 编辑器 / 诊断 / Git 改动 / 终端 / 符号 / 抓取 URL） | | Smart code-block actions: Run in terminal · Insert · Copy · Fold long blocks | 代码块操作：在终端运行 / 插入 / 复制 / 长代码折叠 | | Bilingual UI + locale-aware fonts: auto follows VS Code locale (zh-cn / en) — Chinese font stack for CJK, Latin font stack for EN | 中英双语 UI + 语言感知字体：跟随 VS Code 语言自动切换界面文案与字体（中文环境使用微软雅黑/苹方，英文环境使用 Segoe UI/Inter） | | Skills system — define reusable SKILL.md packs in ~/.deepcopilot/skills (or ~/.claude/skills, ~/.copilot/skills); YAML frontmatter for workspace gating, invoke via /skill or the model's skill_invoke tool | 技能系统：在 ~/.deepcopilot/skills 等目录放置 SKILL.md 技能包，支持 YAML 元数据与工作区门控，/skill 命令或 skill_invoke 工具均可唤起 | | Inline FIM completions — DeepSeek ghost-text suggestions as you type; Tab to accept; off by default (deepCopilot.inlineCompletion.enable) | 行内 FIM 补全：基于 DeepSeek 的编辑器幽灵文字建议，Tab 接受；默认关闭，开关：deepCopilot.inlineCompletion.enable | | Plan mode — read-only investigation mode; agent can read/search but never write or run shell commands | Plan 只读模式：仅允许读文件/搜索，拒绝任何写操作，适合调查代码结构时使用 | | Ecosystem AI-rule discovery — auto-injects DEEPCOPILOT.md, .github/copilot-instructions.md, AGENTS.md, .cursor/rules/*.mdc, CLAUDE.md | 项目规则自动发现：自动注入工作区下的主流 AI 规则文件（GitHub Copilot / Cursor / Claude 等），让模型了解项目约定 | | Context window management (new in 0.41.0) — structure-aware truncation, per-file dedup, rolling summary; /compact [focus] force-compacts, /context opens a token breakdown, /fork [name] branches a new session from any message | 上下文窗口管理 (0.41.0 新增)：结构感知截断、同文件去重、滚动摘要；/compact [focus] 立即压缩，/context 查看 token 占用细分，/fork [name] 从任一消息派生新会话 | | Footer context ring (new in 0.41.0) — ring indicator next to the footer ramps green → yellow → orange → red across 60 / 85 / 100% thresholds; click to open the same breakdown as /context | 底部 Context Ring (0.41.0 新增)：底栏环形进度指示，按 60% / 85% / 100% 阈值由绿渐变到红；点击展开与 /context 一致的占用细分 | | Archive = pure export (updated in 0.41.6) — "Archive" now writes a Markdown snapshot under .deep-copilot/archives/ and leaves the session alone; old soft-hidden sessions are auto-unarchived on first launch | 存档 = 纯导出 (0.41.6 调整)：点「存档」只生成 .deep-copilot/archives/ 下的 Markdown 快照，不再隐藏会话；老版本被隐藏的会话升级后首次启动自动还原。 | | Watchdog turns stay on duty (new in 0.41.6) — when the agent monitors a long-running background job (training, build, dev server) via read_terminal, the turn refuses to end until the job finishes or the 4 h per-turn budget elapses | 值守任务不提前退出 (0.41.6 新增)：模型用 read_terminal 盯住某个后台任务（训练 / 构建 / 开发服务）后，turn 不会在“我会持续盯”之后静默断开，直到任务结束或命中 4h 本轮预算 |

🚀 Quick Start · 快速开始

Option 1 — VS Code Marketplace · 从扩展商城安装（推荐）

1. Open VS Code → Extensions (Ctrl/Cmd+Shift+X) → Search Deep Copilot → Install.

打开 VS Code → 扩展面板（Ctrl/Cmd+Shift+X）→ 搜索 Deep Copilot → 安装。

Option 2 — Install the prebuilt VSIX · 安装预构建 VSIX

# 从 GitHub Releases 下载最新版 / Download from GitHub Releases:
# https://github.com/ZhouChaunge/DeepCopilot/releases

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

Or in VS Code: Extensions view → ⋯ menu → Install from VSIX... and pick the file. 或在扩展面板右上角 ⋯ → Install from VSIX... 选择文件。

Step 2 — Set the API key · 配置 API Key

1. Click the 🐋 Deep Copilot icon in the activity bar to open the chat panel.点击活动栏中的 🐋 Deep Copilot 图标，打开聊天面板。
2. Click the 🔑 button at the bottom right of the panel, paste your DeepSeek API key.点击面板右下角 🔑 按钮，粘贴你的 DeepSeek API Key。
3. Start chatting! 开始对话！

🛠 Build from Source · 源码构建

Prerequisites · 前置依赖

| Tool | Version | Note | | ----------------- | ------- | ------------------ | | Node.js | ≥ 18 | esbuild + vsce | | npm | ≥ 9 | comes with Node | | VS Code | ≥ 1.95 | extension host | | Git | any | optional, to clone |

Steps · 构建步骤

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

# 2. Install dependencies · 安装依赖
#    (only devDependencies: esbuild + vsce + @types — runtime is pure VS Code API)
#    （只有开发依赖；运行时仅用 VS Code API，无运行时 npm 依赖）
npm install

# 3. Build the bundle · 编译为单文件
npm run build
# -> outputs out/extension.js (~105 KB minified)
# -> 产出 out/extension.js（约 105 KB，已压缩）

# 4. Package as VSIX · 打包 VSIX
npm run package
# -> outputs deep-copilot-0.41.6.vsix
# -> 产出 deep-copilot-0.41.6.vsix

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

Watch mode · 监听模式（开发期）

npm run watch
# Rebuilds out/extension.js on every src/ change.
# 修改 src/ 任何文件即增量重建 out/extension.js。
# Then: F5 in VS Code (with the repo opened) launches the Extension Development Host.
# 然后在 VS Code 里按 F5 启动“扩展开发宿主”加载本地构建。

What gets built · 构建产物说明

| Path | Tracked? | Purpose | | --------------------- | ---------- | -------------------------------------------------------------------------------- | | src/ | ✅ yes | Source modules (entry:src/extension.js) · 源码（入口 src/extension.js） | | media/ | ✅ yes | Webview assets (chat.css / chat.js / icons) · Webview 静态资源 | | esbuild.config.js | ✅ yes | Bundler config · 打包配置 | | package.json | ✅ yes | Manifest + scripts · 清单与脚本 | | package-lock.json | ✅ yes | Locked dep versions · 锁定依赖版本 | | out/extension.js | ❌ ignored | Built bundle (regenerated by npm run build) · 构建产物 | | release/*.vsix | ❌ ignored | Packaged extension (regenerated by npm run package) · 打包后的 VSIX | | node_modules/ | ❌ ignored | npm cache · npm 依赖缓存 |

> 🇬🇧 Everything required to compile is in the repo. out/ and *.vsix are reproducible artifacts. > 🇨🇳 编译所需文件全部在仓库里。out/ 和 *.vsix 是可重现的产物，已 .gitignore。

⚙️ Configuration · 配置

All settings live under the deepseekAgent.* namespace in settings.json. 所有设置都在 settings.json 的 deepseekAgent.* 命名空间下。

| Setting | Default | EN | 中文 | | ------------------------------------- | ----------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------- | | deepseekAgent.defaultModel | deepseek-v4-pro | Default model | 默认模型（deepseek-v4-pro / deepseek-v4-flash / deepseek-reasoner） | | deepseekAgent.apiBaseUrl | (empty → api.deepseek.com) | API endpoint | API 入口（国内可填 https://api.deepseeki.com） | | deepseekAgent.approvalMode | manual | Tool-call approval policy | 工具调用审批策略 | | deepseekAgent.interactionMode | agent | agent / ask | 交互模式（Agent 可调工具，Ask 纯聊天） | | deepseekAgent.autoApproveTools | [] | Tool names to always allow | 始终自动允许的工具名 | | deepseekAgent.denyTools | [] | Tool names to always deny | 始终拒绝的工具名 | | deepseekAgent.maxIterations | 15 | Hard ceiling on tool-call rounds | 单次发送的工具调用迭代上限 | | deepseekAgent.compactBudgetTokens | 600000 | Token budget before auto-compaction | 自动压缩历史前的 token 预算 | | deepseekAgent.postEditDiagnostics | true | Append LSP diagnostics after every file edit | 每次编辑后追加 LSP 诊断结果 | | deepseekAgent.mcp.servers | [] | MCP server list (see MCP section below) | MCP 工具服务器列表（见下方 MCP 小节） | | deepseekAgent.enableDebugLog | true | Log thought / tool / API events to .deep-copilot/logs/ | 写思维链 / 工具 / API 事件日志 |

Approval Modes · 审批模式

| Mode | EN behavior | 中文行为

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: deep-copilot
• Source: deep-copilot/DeepCopilot
• License: MIT
• Homepage: https://marketplace.visualstudio.com/items?itemName=ZhouChaunge.deep-copilot

Install and usage instructions live in the source repository linked above.