DeepSeek CLI 是一款由 DeepSeek 驱动、可在本地终端运行的开源编码智能体。它支持从规划到执行的智能体式编码，提供含六种主题、九种界面语言的 Codex 风格终端界面、持久会话、MCP 集成，以及面向终端、无头自动化与 Web UI 的插件化配置。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-02
许可证
MIT
01它能帮你完成什么？
在终端中运行从规划到执行的智能体式编码任务
一个本地运行的 DeepSeek 编码智能体，具备 Codex 风格终端界面、持久会话与插件化配置
希望在本地终端使用 DeepSeek 驱动编码智能体的开发者
在脚本与 CI 中自动化执行非交互任务
运行如 `deepseek exec "run the tests"` 的任务并返回结果（支持 JSON 输出）
CI/CD 流水线及自动化脚本
通过 MCP 服务器与受管插件扩展 CLI
经 `deepseek mcp` 与 `deepseek plugin` 接入的 MCP 服务器及启用/禁用的 Cordis 插件包
需要定制工具链、集成外部服务的团队
02如何接入 DeepSeek Harness？
前置条件
- 一个 DeepSeek API Key（首次启动粘贴，或启动前设置 DEEPSEEK_API_KEY）
- macOS、Linux 或 Windows，且具备 curl / PowerShell
- Node.js ^22.19 或 >=24 及 pnpm 11.7.0（仅源码构建时需要）
安装步骤
- 01
macOS/Linux：执行 curl -fsSL https://raw.githubusercontent.com/peiyuwang54/deepseek-harness-cli/master/apps/cli/install/install.sh | sh
- 02
Windows：在 PowerShell 中执行 irm https://raw.githubusercontent.com/peiyuwang54/deepseek-harness-cli/master/apps/cli/install/install.ps1 | iex
- 03
或通过 npm 安装：npm install -g @peiyu_wang/deepseek-harness-cli
- 04
或通过 Homebrew 安装：brew install --cask peiyuwang54/dsh/deepseek-harness-cli
- 05
进入项目目录并运行 `deepseek`（或简写 `dsh`）即可开始
$ dsh
验证接入成功
- Web UI 默认在 http://127.0.0.1:3080 启动并打开默认浏览器
- 运行 `deepseek doctor` 诊断安装情况并报告已启用的 MCP 连接
03DSH 适配与能力边界
DeepSeek Harness CLI，与官方 DeepSeek Harness 保持同步
终端中的智能体式编码
自然语言提示、计划与 shell 命令→修改后的代码、shell 执行、网页搜索、技能与子智能体结果
MCP 服务器集成
MCP 服务器命令与配置→会话内可用的 MCP 工具
启动被配置的 MCP 服务器时会以 5000 毫秒的每请求超时进行探测插件化配置
tui 配置的插件包名称→启用/禁用的 Cordis 插件包
`install`、`update` 与 `remove` 使用 pnpm 解析依赖持久会话与凭据
恢复中的会话与 DeepSeek API Key→恢复的上下文与经共享凭据提供方存储的 API Key
API Key 由共享凭据提供方存储，不会写入聊天历史
04适合谁？何时不该用？
适合
- 希望在本地终端使用 DeepSeek 驱动编码智能体的开发者
- CI/CD 流水线及自动化脚本
- 需要定制工具链、集成外部服务的团队
不适合
- 首次启动需要 DeepSeek API Key，由共享凭据提供方存储
- `--yolo` 会同时关闭隔离与审批提示，仅可在隔离环境中使用
05兼容性、维护与安全提示
- 首次启动需要 DeepSeek API Key，由共享凭据提供方存储
- `--yolo` 会同时关闭隔离与审批提示，仅可在隔离环境中使用
- 源码构建需要 Node.js ^22.19 或 >=24 以及 pnpm 11.7.0
active
06常见问题
如何安装 DeepSeek CLI？
macOS/Linux 运行 curl 安装脚本，Windows 运行 PowerShell 安装脚本，也可通过 npm（`npm install -g @peiyu_wang/deepseek-harness-cli`）或 Homebrew 安装，随后在项目目录运行 `deepseek` 或 `dsh`。
需要 DeepSeek API Key 吗？
需要。首次启动在掩码提示中粘贴 DeepSeek API Key，或启动前设置 DEEPSEEK_API_KEY。密钥由共享凭据提供方存储，不会写入聊天历史。
如何在 CI 中运行非交互任务？
使用 `deepseek exec "你的任务"` 在无会话状态下运行任务，支持 `--json` 输出结构化结果，也可 `resume --last` 继续上一次运行。
如何添加 MCP 服务器或插件？
用 `deepseek mcp add <名称> -- <命令>` 添加 MCP 服务器，用 `deepseek plugin --profile tui <list|verify|install|enable|disable|update>` 管理插件；插件的 install/update/remove 使用 pnpm 解析依赖。
07相关的 DSH 工作流
deepseek-reasonix
作者 esengine
专为 DeepSeek 打造的终端 AI 编程智能体，围绕前缀缓存稳定性设计，可常驻运行。
mnemon
作者 mnemon-dev
LLM 监督的持久记忆系统，基于图结构召回、跨会话知识共享，单个二进制文件，兼容 DeepSeek Harness 等运行时。
sivtr
作者 ariestar
面向人类与智能体的统一智能体记忆工作区。
phi
作者 pulseaiclub
来自 pi 的编码智能体，支持无限提供方、子智能体、行内编辑与权限门控。
08数据与来源
This is DeepSeek Harness CLI. We keep iterating in sync with the official [DeepSeek Harness](https://github.com/deepseek…
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-02。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。