终端编码代理 peiyuwang54/deepseek-harness-cli

DeepSeek CLI 是由 DeepSeek 驱动、在本地终端运行的开源编码代理。

9 种界面语言 · 6 套主题配色 · 从规划到执行的智能体编程

说明： 这是 DeepSeek Harness CLI。我们会与官方 DeepSeek Harness 同步迭代，期待你的 fork 和 star。

快速开始

安装

macOS 或 Linux：

curl -fsSL https://raw.githubusercontent.com/peiyuwang54/deepseek-harness-cli/master/apps/cli/install/install.sh | sh

Windows：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/peiyuwang54/deepseek-harness-cli/master/apps/cli/install/install.ps1 | iex"

也可以使用以下包管理器安装 DeepSeek CLI：

Install using npm
npm install -g @peiyu_wang/deepseek-harness-cli

Install using Homebrew
brew install --cask peiyuwang54/dsh/deepseek-harness-cli

然后进入项目目录并运行 deepseek 开始使用，也可以使用较短的 dsh 别名：

deepseek
or
dsh

使用 deepseek web 启动 Web UI：

deepseek web

该命令默认会在 http://127.0.0.1:3080 启动 Web UI，本机启动时还会用默认浏览器打开页面。通过 SSH 启动时只打印宿主机 URL，因为本地转发地址由 SSH 客户端或编辑器持有。传入 --no-open 可仅运行服务器而不打开浏览器。详见 Web UI 指南。

脚本与 CI 可用 deepseek exec 运行非交互任务：

deepseek exec "run the tests"
deepseek exec --json "review this repository"
deepseek exec resume --last "continue"

首次启动时，将 DeepSeek API Key 粘贴到掩码输入框。Key 由共享凭据服务保存，不会进入聊天记录。之后可用 /credentials 查看来源、更换 Key 或删除已保存的值。

自动化场景可在启动前设置 DEEPSEEK_API_KEY；PowerShell 使用 $env:DEEPSEEK_API_KEY="your-key"。从启动环境继承的值在 CLI 内只读。

权限模式

deepseek
deepseek --full-auto
deepseek --yolo

运行中可用 /permissions 切换权限，也可以用 --sandbox 和 --ask-for-approval 指定精确策略。--yolo 会同时关闭沙箱限制和审批提示，只应在隔离环境中使用。详见 CLI 行为参考 与权限预设。

MCP 服务器

deepseek mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
deepseek mcp list

在运行中的会话里用 /mcp 查看已连接的服务器；HTTP OAuth 使用 deepseek mcp auth <name>。传输方式、凭据、重连与能力详情见 MCP 服务器管理 和 MCP 客户端参考。

可以在不启动 profile 的情况下诊断安装，也可以为两个命令名安装 Shell 补全：

deepseek doctor
deepseek doctor --json
deepseek completion zsh > ~/.zsh/completions/_deepseek

doctor 还会检查随附的 profile overlay 与预置目录、可选 Web 前端资产、安装渠道、沙箱执行器、真彩色、鼠标输入、剪贴板支持和每个已启用的受管 MCP 连接。MCP 探测会以 5000 毫秒的单次请求超时启动已配置服务器；--mcp-timeout-ms 可以修改该值。可选服务器失败与主机能力检查属于警告；必需 MCP 服务器失败、缺少运行时资产或 Node 版本不受支持会阻断启动。

可以在不启动 profile 的情况下查看并验证已安装的插件组合包：

deepseek plugin --profile tui list
deepseek plugin --profile tui verify --json
deepseek plugin --profile tui source <package>
deepseek plugin --profile tui disable <package>
deepseek plugin --profile tui enable <package>
deepseek plugin --profile tui install <package>
deepseek plugin --profile tui update

source 会显示包目录和声明的仓库。enable 与 disable 会修改生效的 Cordis 组合包列表，并在下次启动时生效；install、update 和 remove 使用 pnpm 解析依赖。

核心能力

- 代码读取、编辑、Shell、Web 搜索、Skills、MCP 与子代理。
- 持久会话、恢复、Plan、Goal、消息排队与上下文自动压缩。
- Codex 风格终端 UI，支持 6 套主题配色，以及英语、简体中文、繁体中文、阿拉伯语、法语、俄语、西班牙语、日语和韩语。
- 基于插件的终端、Headless 自动化与 Web UI profile。

从源码运行

git clone https://github.com/peiyuwang54/deepseek-harness-cli.git
cd deepseek-harness-cli
pnpm install --frozen-lockfile
pnpm run build
pnpm dsh

源码构建需要 Node.js ^22.19 或 >=24，以及 pnpm 11.7.0。

pnpm run build 会准备仓库产物。pnpm dsh web 会直接使用这些已构建产物，不会重新构建。

文档

- CLI 命令与 profile
- 终端 UI 与斜杠命令
- 配置参考
- 架构
- 开发

请在 GitHub Issues 报告问题。

许可证

本项目采用 MIT 协议。恢复的 TUI 代码保留 BSD-3-Clause 声明；详见 THIRD_PARTY_NOTICES.md。

社区友链

- LinuxDo — <https://linux.do>