@deepseek-ai/dsh 是 DeepSeek Harness 的命令行工具。

1. DSH是什么？

dsh 是一个命令行程序，用来启动 DeepSeek Harness 的各种"应用"（官方叫 profile，可以理解为一个独立的运行环境）。

它的工作方式大致是：

• 你用一条命令启动某个 profile；
• dsh 负责把该 profile 需要的插件和配置组装起来；
• 然后你就能用对应的界面或命令行来完成任务。

你不需要了解内部的组装细节，只需要记住几个命令即可。

2. 安装

npm install -g @deepseek-ai/dsh

安装完成后，检查是否成功：

dsh --version   # 会显示版本号，例如 0.1.0-rc.6

前置条件：

• 需要 Node.js（建议使用较新版本）；
• 要用插件管理功能的话，还需要安装 pnpm：npm install -g pnpm。

3. 常用命令

① 启动网页版

dsh web

这是最常用的入口。启动后，在浏览器打开 http://127.0.0.1:3080 即可使用。第一次运行会自动完成初始化。

修改端口：

dsh web --port 8080

查看网页版支持哪些参数：

dsh web --help

② 跑一次性任务（不用网页）

dsh --profile headless "帮我把 tests 跑一遍"

它会创建一次全新的会话执行这个任务，把最终结果打印到终端后自动退出。适合写脚本、做自动化。

③ 查看 dsh 自身的帮助与版本

dsh --help# 列出所有入口模式和参数
dsh --version   # 显示版本号

4. 安装插件

dsh 的功能通过"插件"扩展。安装插件要使用 dsh plugin 命令，它会帮你在 profile 里装好插件并自动加入配置。

示例：

# 创建一个名为 tui 的 profile，并安装插件
dsh plugin --profile tui add 插件包名

# 启动这个 profile
dsh --profile tui

删除插件：

dsh plugin --profile tui remove 插件包名

注意：

• 从 Git 仓库安装的插件，首次安装时可能会要求你在 pnpm-workspace.yaml 里添加 allowBuilds 配置，按提示操作即可；
• 装完插件后，profile 的配置会热更新，通常不需要重启。

5. 配置密钥

要让 dsh 真正干活（例如执行 headless 任务、在网页里对话），需要配置 DeepSeek 的 API 密钥：

export DEEPSEEK_API_KEY="你的密钥"

之后启动即可正常联网工作。

6. 常用环境变量

7. 新手常见问题

8. 全部命令一览

入口模式

启动器参数

dsh plugin 常用子命令

dsh plugin 的其余参数与 pnpm 保持一致，add、remove、update、why 等 pnpm 子命令都直接可用。

网页版参数

想深入了解（自定义 profile、开发插件、修改配置），可以参考官方文档：https://github.com/deepseek-ai/deepseek-harness