DeepSeek Harness Hub
← 返回列表

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

DeepSeek Harnessspec-screenedcode在 GitHub 查看 ↗
需源码安装

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

暂不能直接安装(需源码编译或环境不满足):缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装。 · 最近上游提交 2026/9/13 · 已提供中文文档

DeepSeek CLI(非官方)

综合分
52.8
GitHub 分
52.8
用户评分
★ Stars
62
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add peiyuwang54/deepseek-harness-cli
缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装,改用 GitHub 源安装
数据截至 2026/9/18(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查需源码安装

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

npm 包@deepseek-ai/dsh-root(未发布到 npm,仅可源码安装)
Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
dsh CLI 依赖未声明 dsh 版本约束
入口文件缺少入口声明

缺少 main/exports/bin 入口声明;仓库 package.json 标记 private,未发布到 npm,需从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/17 15:49:26

依赖的 DSH / Cordis 模块
@deepseek-ai/dsh-tool-session-query
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

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

​English | 中文

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

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

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

脚本与 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 。传输方式、凭据、重连与能力详情见 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
deepseek plugin --profile tui disable
deepseek plugin --profile tui enable
deepseek plugin --profile tui install
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 —

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群