首页›指南

DeepSeek Harness 常用命令

当前 DSH 的 Web UI、Profile、Headless、插件管理与配置检查命令速查。

本页内容

命令速查

用途	命令	什么时候用
启动 Web UI	`npx @deepseek-ai/dsh web`	推荐给新手。`web` 是内置 web profile 的快捷别名。
启动但不自动打开浏览器	`npx @deepseek-ai/dsh web --no-open`	适合希望手动打开终端打印 URL 的情况；SSH 启动本身不会在远端自动打开浏览器。
修改 Web UI 端口	`npx @deepseek-ai/dsh web --port 8080`	启动器先选择 web profile，再把 --port 参数交给 Web 应用。
运行一次 Headless 任务	`npx @deepseek-ai/dsh --profile headless "run the tests"`	运行一个新的持久化会话，打印最终回答后退出，不启动 Web 服务器。
查看组合后的配置	`npx @deepseek-ai/dsh --profile web --dump-config`	打印 web profile 叠加 profile、home 与命令行 patch 后的配置。
管理 Profile 插件	`npx @deepseek-ai/dsh plugin --profile <name> add <package>`	通过 pnpm 为自定义 profile 安装或扩展树外插件。
检查 Node.js	`node --version`	运行 DSH 前确认 Node.js 已可用。
检查 npm	`npm --version`	确认 npm / npx 已随 Node.js 正常安装。
运行源码仓库	`pnpm dsh web`	仅在克隆官方仓库、安装依赖并运行 pnpm run build 后使用。

npx @deepseek-ai/dsh web

第一次启动时，npx 可能需要先下载 DSH 包，因此会比之后启动更慢。如果终端没有明确报错，安装过程出现短暂停顿属于正常现象。

本机正常启动时，DSH 默认会在 http://127.0.0.1:3080 提供 Web UI，并自动打开默认浏览器。SSH 启动时只打印主机 URL，因为本地转发地址由 SSH 客户端或编辑器负责。

远程或纯终端环境

请使用 DSH 终端打印的地址。明确不希望自动打开浏览器时可传入 --no-open；SSH 场景仍可能需要在客户端或编辑器中配置端口转发。

当前 DSH 通过具名 profile 启动。内置的 web 与 headless profile 会在第一次使用时从随发行版提供的模板自动初始化；其他 profile 需要通过 dsh plugin 创建或扩展。

dsh web 等价于 dsh --profile web。启动器自己的 flag 必须放在前面；进入应用参数后，剩余参数由当前 profile 处理。例如 --port 8080 是 Web 应用参数。

npx @deepseek-ai/dsh --profile web --port 8080

npx @deepseek-ai/dsh --profile headless "summarize this repository"

npx @deepseek-ai/dsh --profile web --dump-default-config

--dump-default-config 只展示发行版自带的 bundle 层；--dump-config 还会叠加 profile、home 级以及 --patch overlay，且不会真正启动应用。

这部分面向需要开发或修改 DeepSeek Harness 本身的人。普通使用不需要走源码安装。

git clone https://github.com/deepseek-ai/deepseek-harness.git

cd deepseek-harness

pnpm install

pnpm run build

pnpm dsh web

pnpm run build 会准备仓库产物；之后的 pnpm dsh web 直接使用这些构建结果，不会再次自动执行 build。

主要来源

DeepSeek Harness 官方 README · DSH CLI 中文 README · CLI 行为参考。DSH 仍处于开发者预览阶段，不同 RC 版本之间可能继续出现兼容性变化。