本文档整理了 DeepSeek Harness（DSH）最常用的三个操作——全局安装、Web 端启动、安装本地插件，方便快速查阅。
一、全局安装（Node 版）
想用桌面版的话请直接从官网下载安装包安装。
使用 npm 将 DSH 安装到全局环境中，这样可以直接通过 dsh 命令调用，而无需每次都使用 npx。
npm install -g @deepseek-ai/dsh@latest
提示：安装后确保 npm 的全局 bin 目录已加入系统的 PATH。可通过 npm prefix -g 查看全局前缀路径。
二、启动 Web 界面
关于
dsh.cmd与dsh的区别：在 Windows 系统上，npm 全局安装的可执行文件会生成.cmd批处理包装文件。这是 npm 在 Windows 上的标准机制。直接使用dsh.cmd可以确保在 CMD 和 PowerShell 中都能正确调用，避免dsh因缺少.cmd后缀而无法识别的问题。如果你的环境配置良好，dsh命令通常也能正常工作。
DSH 内置了 Web UI，支持通过浏览器访问。以下命令用于在指定 IP 地址上启动 Web 服务，并跳过自动打开浏览器。
dsh.cmd web --host 192.168.1.10 --trusted-host 192.168.1.10 --no-open
| 参数 | 作用 |
|---|---|
--host 192.168.1.10 |
绑定到指定 IP 地址，使局域网内其他设备可访问 |
--trusted-host 192.168.1.10 |
将该 IP 标记为可信主机 |
--no-open |
启动后不自动打开浏览器 |
提示：如需更换端口，可添加 --port <端口号> 参数。默认端口为 3080。
三、安装本地插件
3.1 Web 环境的本地插件
dsh.cmd plugin --profile web add <package-name>
此命令在 web profile 中安装一个 npm 插件。<package-name> 可以是 npm 上的包名，也可以是本地路径。
3.2 桌面环境的本地插件
dsh plugin --profile desktop add <path>
关于桌面版启用
dsh命令的方法：
官网下载安装的 DSH 桌面版，请在 DSH 主界面点击左上“应用 – 管理 dsh 命令…”开启系统dsh命令。
四、命令速查表
| 用途 | 命令 |
|---|---|
| Web 版全局安装 | npm install -g @deepseek-ai/dsh@latest |
| Web 版启动（局域网） | dsh.cmd web --host <IP> --trusted-host <IP> --no-open |
| 安装本地路径插件（Web 版） | dsh plugin --profile web add <路径> |
| 卸载本地路径插件（Web 版） | dsh plugin --profile web remove <路径> |
| 列出本地路径插件（Web 版） | dsh plugin --profile web list <路径> |
| 安装本地路径插件（桌面版） | dsh plugin --profile desktop add <路径> |