lessweb/deepcode-cli

Deep Code CLI – 基于终端的 AI 编码助手

简介 – 一款 Node-JS 命令行工具，让您可以直接在任何项目文件夹中与 DeepSeek LLM（例如 deepseek-flash、deepseek-v4‑pro）进行对话。它针对 DeepSeek 的 thinking mode 和缓存感知推理进行了调优，同时也可与任何兼容 OpenAI 的模型配合使用。

安装

npm install -g @vegamo/deepcode-cli

全局安装后，在项目目录中运行 deepcode 即可启动交互式会话。

配置 – 创建 ~/.deepcode/settings.json（与配套的 VS Code 扩展功能共享）。示例：

{
  "env": {
    "MODEL": "deepseek-flash",
    "BASE_URL": "https://api.deepseek.com",
    "API_KEY": "sk-…"
  },
  "thinkingEnabled": true,
  "reasoningEffort": "max"
}

该文件支持分层覆盖（项目级、用户级、环境变量）– 请参阅 docs/configuration.md。

核心功能

功能	说明
Agent Skills	从 ./.deepcode/skills/、./.agents/skills/、~/.deepcode/skills/ 或 ~/.agents/skills/ 加载自定义“技能”（插件）。技能通过额外的指令或工具扩展助手功能。
DeepSeek 专属优化	使用 DeepSeek 的 KV-cache 来降低 Token 成本，启用模型的 thinking mode 并允许您控制推理强度（max、medium 等）。
斜线指令与快捷键	快速操作，例如 /new（新对话）、/resume（选择过去的对话）、/model（切换模型或思考设置）、/mcp（查看已连接的 Model-Context-Protocol 服务）、/undo 等。
多模态支持	当所选模型支持图像（deepseek-flash）时，您可以粘贴图像（Ctrl+V）或提供文件路径；CLI 将通过 base64 或 DeepSeek Files API 发送。
MCP 整合	通过 Model Context Protocol 连接外部服务（GitHub、浏览器、数据库等）；通过 mcpServers 字段管理服务器并使用 /mcp 调用。
权限控制	针对 Shell 执行、文件 I/O、网络访问的细粒度原则 – 可针对每种操作类型设置为 allow、ask 或 deny。
任务后通知	在任务完成后执行用户提供的脚本（例如 Slack webhook），通过 notify 字段设置。
跨客户端共享	VS Code 扩展功能使用相同的 settings.json，让您可以在终端与编辑器之间无缝切换。

典型工作流程

1. deepcode → 启动 REPL。
2. 输入提示（代码问题、错误描述、设计需求）。
3. 使用 /model 选择模型或切换 thinking mode。
4. 使用 / 菜单或斜线指令调用技能。
5. 根据您的权限设置接受或拒绝任何生成的代码文件或 Shell 操作。
6. 完成 – 自动执行选用的通知脚本。

扩展工具 – 将 JavaScript/TypeScript 模块放入上述四个技能目录中的任何一个。CLI 会按照表格中显示的顺序扫描它们，允许在不重建核心的情况下进行项目特定或全局的扩展。

相关项目 – 配套的 VS Code 扩展功能 (vegamo.deepcode-vscode) 共享相同的配置文件，而基准测试仓库 (deepcode-qrcode-benchmark) 展示了 Deep Code + DeepSeek 在实际 Python 任务中的性能优势。

开发与贡献

git clone https://github.com/lessweb/deepcode-cli.git
cd deepcode-cli
npm install
npm test          # 运行测试
npm run build      # lint、类型检查、编译
npm link           # 链接至全局以进行本地测试

在提交 PR 之前，请运行 npm run check（类型检查 + lint）和 npm run format。

授权 – MIT。

---

所有详细信息均直接取自仓库的 README。