DSH 启动命令速查
先复制启动命令，再按需要查找 DeepSeek Harness 的端口、Profile 和任务参数。
本页内容
启动本机 Web UI
npx @deepseek-ai/dsh web在 PowerShell 或终端中运行，保持这个终端打开，再使用它打印的完整地址进入 DSH。默认本机地址为 http://127.0.0.1:3080。
常用启动选项
换一个端口
3080 被占用时，改用 8080，并打开终端打印的新地址。
npx @deepseek-ai/dsh web --port 8080手动打开浏览器
启动服务后手动打开终端打印的完整地址。SSH 使用还需检查端口转发。
npx @deepseek-ai/dsh web --no-open
命令速查
| 用途 | 命令 | 什么时候用 |
|---|---|---|
| 启动 Web UI | npx @deepseek-ai/dsh web | 从命令行启动浏览器界面；web 是内置配置环境的快捷入口。 |
| 启动但不自动打开浏览器 | 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。 |
| 检查 Node.js | node --version | 运行 DSH 前确认 Node.js 已可用。 |
| 检查 npm | npm --version | 确认 npm / npx 已随 Node.js 正常安装。 |
| 运行源码仓库 | pnpm dsh web | 仅在克隆官方仓库、安装依赖并运行 pnpm run build 后使用。 |
第一次运行会发生什么
第一次启动时，npx 可能需要先下载 DSH 包，因此会比之后启动更慢。如果终端没有明确报错，安装过程出现短暂停顿属于正常现象。
本机正常启动时，DSH 默认会在 http://127.0.0.1:3080 提供 Web UI，并自动打开默认浏览器。SSH 启动时只打印主机 URL，因为本地转发地址由 SSH 客户端或编辑器负责。
请使用 DSH 终端打印的地址。明确不希望自动打开浏览器时可传入 --no-open；SSH 场景仍可能需要在客户端或编辑器中配置端口转发。
Profile 与应用参数
Profile 是一套具名的配置环境。内置的 web、headless 等 Profile 首次使用时会从发行版模板初始化；自定义环境也可以通过 --from-default-profile 从模板创建，再按需要添加插件。
dsh web 等价于 dsh --profile web。启动器自己的 flag 必须放在前面；进入应用参数后，剩余参数由当前 profile 处理。例如 --port 8080 是 Web 应用参数。
npx @deepseek-ai/dsh --profile web --port 8080npx @deepseek-ai/dsh --profile headless "summarize this repository"Headless 命令在当前项目目录中执行，先确认工作区与模型已配置。回答结束不代表任务验收通过，仍需查看实际结果。
npx @deepseek-ai/dsh --profile web --dump-default-config--dump-default-config 展示 Bundle 层；--dump-config 还包含 Profile、本机和 --patch 配置。两者都不启动应用，但首次调用仍可能初始化 Profile 目录。分享输出前检查并移除敏感信息。
从 DeepSeek Harness 官方源码运行
以下用于修改或调试 DSH 本身。执行前按源码运行指南检查 Node 和 pnpm 版本；只需安装使用时可查看安装教程。
git clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm installpnpm run buildpnpm dsh webpnpm run build 会准备仓库产物；之后的 pnpm dsh web 直接使用这些构建结果，不会再次自动执行 build。
DSH 启动后做什么
DeepSeek Harness 官方 README、DSH CLI 中文 README、CLI 行为参考。DSH 仍处于开发者预览阶段，不同 RC 版本之间可能继续出现兼容性变化。