文章总结： DSH是DeepSeekHarness的命令行工具，用于启动各种profile应用。安装需Node.js，通过npm全局安装。常用命令包括dshweb启动网页版和dsh–profileheadless跑一次性任务。支持插件扩展和API密钥配置。新手常见问题有端口占用和密钥缺失。 综合评分： 85 文章分类： 安全工具
DSH Deepseek Harness安装教程及命令介绍
原创
Thanatos Thanatos
星宇Sec
2026年8月13日 21:32 山东
在小说阅读器读本章
去阅读
@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. 常用环境变量
| 变量 | 作用 |
| — | — |
| DSH_HOME | 指定数据目录，默认 ~/.dsh |
| DEEPSEEK_API_KEY | DeepSeek API 密钥 |
| DSH_TELEMETRY_DISABLED | 设为任意非空值（如 1）可关闭遥测上报 |
7. 新手常见问题
| 问题 | 解决办法 |
| — | — |
| 提示 --profile <name> is required | 命令里漏了 profile 参数，直接用 dsh web 即可 |
| 提示 pnpm not found | 用 npm install -g pnpm 安装 pnpm |
| 浏览器打不开网页 | 确认地址是 http://127.0.0.1:3080，注意是 http 不是 https |
| 执行任务时报缺少密钥 | 先设置环境变量 DEEPSEEK_API_KEY |
| 网页端口被占用 | 换一个端口，例如 dsh web --port 8080 |
8. 全部命令一览
入口模式
| 命令 | 作用 |
| — | — |
| dsh web | 启动网页版（等价于 dsh --profile web） |
| dsh --profile <name> | 启动指定名字的 profile |
| dsh --profile headless "任务描述" | 跑一次性任务，打印结果后退出 |
| dsh plugin --profile <name> <pnpm 参数> | 管理 profile 的插件（转发给 pnpm） |
启动器参数
| 参数 | 作用 |
| — | — |
| --profile <name> | 指定要启动的 profile 名称 |
| --patch <路径> | 额外叠加一个 patch 配置层，可重复使用多次 |
| --dump-config | 打印组合后的配置树后退出（不启动） |
| --dump-default-config | 只打印内置配置层后退出（不启动） |
| -V, --version | 显示版本号 |
| --help | 显示帮助 |
dsh plugin 常用子命令
| 命令 | 作用 |
| — | — |
| dsh plugin --profile <name> add <包名> | 安装插件（会自动创建 profile） |
| dsh plugin --profile <name> remove <包名> | 卸载插件 |
| dsh plugin --profile <name> update | 更新插件 |
| dsh plugin --profile <name> why <包名> | 查看某个依赖的来源 |
dsh plugin的其余参数与 pnpm 保持一致，add、remove、update、why等 pnpm 子命令都直接可用。
网页版参数
| 参数 | 作用 |
| — | — |
| dsh web --port <端口> | 修改端口（默认 3080） |
| dsh web --host <地址> | 指定监听地址 |
| dsh web --trusted-host <名称> | 添加受信任的域名，可重复 |
| dsh web --patch <路径> | 叠加 patch 配置层 |
| dsh web --dump-config | 打印配置树后退出 |
| dsh web --help | 显示网页版自身的帮助 |
想深入了解（自定义 profile、开发插件、修改配置），可以参考官方文档：https://github.com/deepseek-ai/deepseek-harness
免责声明：
本文所载程序、技术方法仅面向合法合规的安全研究与教学场景，旨在提升网络安全防护能力，具有明确的技术研究属性。
任何单位或个人未经授权，将本文内容用于攻击、破坏等非法用途的，由此引发的全部法律责任、民事赔偿及连带责任，均由行为人独立承担，本站不承担任何连带责任。
本站内容均为技术交流与知识分享目的发布，若存在版权侵权或其他异议，请通过邮件联系处理，具体联系方式可点击页面上方的联系我。
本文转载自：星宇Sec Thanatos Thanatos《DSH Deepseek Harness安装教程及命令介绍》
版权声明
本站仅做备份收录，仅供研究与教学参考之用。
读者将信息用于其他用途的，全部法律及连带责任由读者自行承担，本站不承担任何责任。
评论