gem-hunter
Language: TypeScript
Deep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制以及 Agent Skills。
Deep Code 是专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 以及 MCP 集成。
npm install -g @vegamo/deepcode-cli
在任意项目目录下运行 deepcode 即可启动。
创建 ~/.deepcode/settings.json 文件，内容如下：
{
"env": {
"MODEL": "deepseek-flash",
"BASE_URL": "https://api.deepseek.com",
"API_KEY": "sk-..."
},
"thinkingEnabled": true,
"reasoningEffort": "max"
}配置文件与 Deep Code VSCode 插件 共享，无需重复配置。
完整配置说明（多层级优先级、环境变量等）请参阅 docs/configuration.md。
Deep Code CLI 支持 agent skills，允许您扩展助手的能力：
Skills 会按以下优先级扫描：
| Scope | Path | Purpose |
|---|---|---|
| Project | ./.deepcode/skills/ |
Deep Code 原生位置 |
| Project | ./.agents/skills/ |
跨客户端互操作 |
| User | ~/.deepcode/skills/ |
Deep Code 原生位置 |
| User | ~/.agents/skills/ |
跨客户端互操作 |
| 斜杠命令 | 操作 |
|---|---|
/ |
打开 skills / 命令菜单 |
/new |
开始新对话 |
/resume |
选择历史对话继续 |
/fork |
从当前对话创建独立的新会话 |
/continue |
继续当前对话，或选择历史对话恢复 |
/compact |
手动压缩当前对话上下文 |
/model |
切换模型、思考模式和推理强度 |
/raw |
切换显示模式（Normal / Lite / Raw 滚动回溯） |
/init |
初始化 AGENTS.md 文件 |
/skills |
列出可用 skills |
/mcp |
查看 MCP 服务器状态和可用工具 |
/undo |
将代码和/或对话恢复到之前的状态 |
/exit |
退出（也可用连续 Ctrl+D） |
| 按键 | 操作 |
|---|---|
Enter |
发送消息 |
Shift+Enter |
插入换行（也可用 Ctrl+J） |
Ctrl+V |
从剪贴板粘贴图片 |
Esc |
中断当前模型回复 |
连续 Ctrl+D |
退出 |
deepseek-flash（推荐使用）deepseek-v4-prodeepseek-v4-flashdeepseek-v4-flash-vision-expArmin Ronacher 在《Better Models: Worse Tools》中指出，工具 schema 不是「中立的」：模型（LLM）会继承训练和强化学习中形成的工具使用习惯，因此可能在某个主流 harness 中表现很好，却在另一套工具形态下变得不稳定。这正是 Deep Code 的架构出发点：只为 DeepSeek 量身调优，从而让 harness 本身持续贴合 DeepSeek 的行为特点。
Deep Code 的收益来自于工具约束、上下文管理、Agent Skills 和权限策略等多项设计叠加后的结果。deepcode-qrcode-benchmark 项目展示了在一个真实且有难度的 Python 需求上，Deep Code + DeepSeek + /plan 模式相较 Claude Code + DeepSeek 的组合具有效果优势。
详见：Deep Code 架构
有的。Deep Code 提供功能完整的 VSCode 插件，可在 VSCode Marketplace 安装。插件与 CLI 共享 ~/.deepcode/settings.json 配置文件，可以在终端和编辑器之间无缝切换。
支持。deepseek-flash 模型支持直接读取本地图片或使用ctrl+v从剪贴板粘贴图片，让模型直接看到图片内容。
deepseek-v4-pro、deepseek-v4-flash 等非多模态模型仍会使用 UnderstandImage 识图工具。Deep Code 会自动判断模型能力，也可通过 multimodal 配置项手动覆盖。
默认情况下，图片会以 base64 内联发送给模型。启用 filesApiEnabled 后，Deep Code 会使用 DeepSeek Files API 上传图片并在请求中复用 file_id。详见 docs/configuration.md。
Deep Code自带免费的、且大部分情况够用的Web Search工具。如果你希望使用自定义脚本进行联网搜索，可以在 ~/.deepcode/settings.json 中将 webSearchTool 设为脚本的完整路径即可。详细步骤可参考：https://github.com/qorzj/web_search_cli
Deep Code 支持 MCP（Model Context Protocol），可以连接 GitHub、浏览器、数据库等外部服务。在 settings.json 中配置 mcpServers 字段即可启用，启动后使用 /mcp 命令查看已配置的 MCP 服务器状态和可用工具。
详细配置指南：docs/mcp.md
在 ~/.deepcode/settings.json 中，将 notify 字段设为可执行通知脚本的完整路径。AI 助手完成一轮任务后，Deep Code 会自动执行该脚本，向 Slack 等渠道发送消息或弹出系统通知。
详细配置指南：docs/notify.md
不是。Deep Code 内置了细粒度的权限控制机制，支持在 AI 助手执行 Shell 命令、读写文件、访问网络等操作前进行确认。你可以通过 settings.json 中的 permissions 字段按需配置每种权限范围的策略：始终允许、始终询问、或直接拒绝。详见 docs/permission.md。
支持。只要把 ~/.deepcode/settings.json 的 env.BASE_URL 配置为 OpenAI 兼容的接口地址就行。以火山方舟的 Coding Plan 为例：
{
"env": {
"MODEL": "ark-code-latest",
"BASE_URL": "https://ark.cn-beijing.volces.com/api/coding/v3",
"API_KEY": "**************"
},
"thinkingEnabled": true
}DeepCode Plus 旨在提供一站式的 AI 编程与创作体验。它提供 DeepSeek 模型订阅套餐，并支持图片理解、联网搜索、图片生成和视频生成等增强功能。它完全可选，使用 Deep Code 并不需要订阅 Plus。
欢迎贡献代码！以下是参与方式：
# 克隆仓库 git clone https://github.com/lessweb/deepcode-cli.git cd deepcode-cli # 安装依赖 npm install # 运行测试 npm test # CLI本地开发（类型检查 + lint + 格式检查 + 构建） npm run build # CLI链接到全局（即本地全局安装） npm link # VSCode插件本地开发 npm run build:vscode
npm run check 通过（类型检查 + lint + 格式检查）npm run format 自动格式化代码，避免构建报错如果你觉得这个工具对你有帮助，请考虑通过以下方式支持我们：