Deep Code CLI
专为 deepseek-v4 模型优化的终端 AI 编码助手，支持深度思考、推理强度控制、Agent Skills 与 MCP 集成。
证据显示有权限控制机制（permissions 字段，可配置 always allow/ask/deny），但未提供默认策略或最小权限原则的详细说明，因此 least_privilege 得 1 分。用户确认机制存在（AskUserQuestion 工具、权限询问），测试覆盖了相关逻辑，得 2 分。数据流透明度不足：README 提到配置和通知脚本，但未说明数据如何发送到外部 API 或本地存储，得 1 分。敏感数据处理：API_KEY 存储在 settings.json 中，但未说明加密或保护措施，得 1 分。依赖安全：package.json 中依赖版本较新，但未提供安全审计或漏洞扫描证据，得 1 分。外部影响：支持 shell 命令、文件读写、网络访问，但权限控制可限制，得 1 分。回滚：提供 /undo 命令，但未说明其实现细节或可靠性，得 2 分。来源归属：README 和 LICENSE 明确归属 lessweb，但发布者未验证，得 1 分。
自一致性：README 与 package.json 中的名称和描述一致，但存在版本不一致（README 提到 @vegamo/deepcode-cli，package.json 为 @vegamo/deepcode），得 2 分。依赖可用性：依赖项均为常见包，但未提供锁定文件或完整性校验，得 1 分。失败消息：测试覆盖了错误处理，但未提供用户可见的错误消息示例，得 1 分。
受众与场景：面向开发者，提供 CLI 和 VSCode 扩展，场景明确，得 2 分。能力边界：README 列出了支持的模型和功能，但未明确限制，得 2 分。触发精度：斜杠命令和快捷键定义清晰，得 2 分。环境适配：支持多平台（CI 矩阵），但未提供系统要求，得 2 分。
信息架构：文档结构清晰，有 README、docs 目录，得 2 分。安装说明：提供 npm 安装命令，得 2 分。命名稳定性：包名在 README 和 package.json 中不一致，得 1 分。示例与 FAQ：提供多个 FAQ 和配置示例，得 2 分。已知限制：未明确列出，得 1 分。许可证：MIT 许可证文件存在，得 2 分。版本与变更日志：有版本号但无 CHANGELOG，得 1 分。维护责任：有 CI 和贡献指南，但发布者未验证，得 1 分。
输出可用性：提供交互式 CLI 和多种命令，输出格式未详细说明，得 2 分。边际价值：针对 DeepSeek 优化，提供独特功能，得 2 分。成本效益：声称降低成本，但无具体数据，得 1 分。
声明可追溯：README 引用架构文章和基准测试，但未提供详细数据，得 1 分。跨来源佐证：引用外部项目，但未提供独立验证，得 1 分。事实与推断分离：README 区分了事实和观点，但不够明确，得 1 分。
- API_KEY 明文存储在 settings.json 中，建议使用环境变量或密钥管理服务。
- 包名在 README 和 package.json 中不一致，可能导致安装混淆。
- 未提供 CHANGELOG，版本变更不透明。
- 权限控制的默认策略未明确，建议审查默认配置。
这个 Agent 能做什么，适合哪些场景？
Deep Code CLI 是一款面向 DeepSeek 模型深度调优的终端 AI 编码助手，通过 npm 全局安装后可在任意项目目录运行。它支持 DeepSeek 的思考模式、推理强度控制以及上下文缓存以降低成本，并提供丰富的斜杠命令管理对话、模型和技能。工具内置 Agent Skills 扫描机制（支持项目级与用户级目录），并集成 MCP 协议以连接外部服务。配置通过 ~/.deepcode/settings.json 完成，与同名 VSCode 插件共享配置。项目采用 MIT 许可，并包含权限控制、通知脚本等扩展能力。
Deep Code CLI 在终端中提供交互式 AI 编码辅助，核心操作包括：读取 ~/.deepcode/settings.json 配置（包含 MODEL、BASE_URL、API_KEY、thinkingEnabled、reasoningEffort 等），调用 DeepSeek API（默认 deepseek-v4-pro 或 deepseek-v4-flash）进行对话。支持上下文缓存与思考模式，通过 /model 切换模型和推理强度。提供 /new、/resume、/fork、/continue 管理会话，/undo 恢复代码和对话历史。Agent Skills 按 .deepcode/skills 和 .agents/skills 的多层目录扫描，并以 /skills 列出。集成 MCP 服务器（通过 mcpServers 配置），用 /mcp 查看状态。支持从剪贴板粘贴图片（Ctrl+V），并可配置 notify 脚本在任务完成后通知。权限控制基于 permissions 字段，允许对 Shell 命令、文件读写、网络访问设置策略。
- 使用 DeepSeek 模型的开发者希望获得专门调优的终端编码助手，以提升代码生成质量与效率。
- 需要在终端中进行多轮对话式编程，且希望利用深度思考模式应对复杂编码任务的用户。
- 希望通过 Agent Skills 扩展助手能力，例如集成自定义工具或脚本的开发者。
- 需要连接外部服务（如 GitHub、浏览器、数据库）并通过 MCP 协议在编码工作流中使用的用户。
- 喜欢使用 VSCode 编辑器，但希望 CLI 与 VSCode 插件共享配置、无缝切换的开发者。
- 希望通过权限控制限制 AI 助手执行危险操作（如 Shell 命令、文件修改）的安全意识用户。
这个 Agent 有哪些优点和局限？
- 专为 DeepSeek 模型深度优化，支持上下文缓存降低成本和原生思考模式，相比通用工具的 DeepSeek 组合更具优势（有基准测试佐证）。
- 支持 Agent Skills 和 MCP 集成，可扩展性高，满足多样化的编码工作流。
- 细粒度权限控制与通知脚本机制，增强了安全性和自动化能力。
- 与 VSCode 插件共享配置，支持终端与编辑器无缝切换。
- 深度绑定 DeepSeek 模型生态，对其他模型（如 OpenAI）支持有限，可能无法完全发挥特性。
- 依赖 DeepSeek API 作为主要后端，需要网络连接和 API 密钥，存在外部服务依赖。
- 作为较新项目，文档可能不够全面，高级配置（如 MCP、权限）需要查阅额外 docs 文件。
- CLI 仅面向终端，不提供图形界面，对不熟悉命令行的用户有学习成本。
如何安装或部署这个 Agent？
使用 npm 全局安装：npm install -g @vegamo/deepcode-cli。需要 Node.js 环境。
如何使用这个 Agent？
在任意项目目录下运行 deepcode 启动集成终端界面。首次使用需创建配置文件：在 ~/.deepcode/settings.json 中填写 env.MODEL（如 deepseek-v4-pro）、env.BASE_URL（如 https://api.deepseek.com）、env.API_KEY，以及可选的 thinkingEnabled 和 reasoningEffort。启动后可用斜杠命令（如 /new、/model、/skills）和快捷键（Enter 发送，Shift+Enter 换行，Ctrl+V 粘贴图片，Esc 中断）进行交互。
这个 Agent 与同类方案有什么区别？
相较于通用编码工具（如 Claude Code），Deep Code 在 DeepSeek 模型上通过针对性调优可能在性能和效果上更优，但功能生态和社区规模可能较小。