DeepSeek Harness CLI 命令参考

dsh 是 DSH 的命令行入口。命令不多，但有几条"顺序规则"必须懂，否则参数会被误解。这一篇是可查的速查表，覆盖日常会用到的全部命令。

核心命令速查

命令	作用
`dsh web`	启动 Web UI（即`--profile web`），默认 http://127.0.0.1:3080
`dsh --profile <name>`	启动指定 profile（见Profile 是什么？）
`dsh --profile headless "任务"`	一次性任务：跑完打印最终回答并退出
`dsh plugin --profile <name> <pnpm args>`	管理 profile 插件（转发给 pnpm）
`dsh --help`	启动器自己的帮助
`dsh --dump-default-config`	打印内置默认配置（未叠加 patch）
`dsh --dump-config`	打印叠加所有层后的最终配置
`dsh --patch <file>`	用一次性覆盖层启动（不改文件）

最重要的规则：flag 必须写在最前面

启动器只认识自己的 flag（--profile、--patch、配置 dump），从第一个不认识的内容开始，后面全部属于应用参数：

dsh --profile web --port 8080        # --port 是 web 应用的参数 ✓
dsh --port 8080 --profile web        # 错：--port 会成为……应用的第一个参数，启动器看不到 --profile
dsh --profile headless "run the tests"   # 任务文本是应用参数
dsh --profile web --help             # 看 web 应用自己的参数
dsh --help                           # 看启动器的参数

判断口诀：启动器的东西在最前，应用的东西在后。

常用组合示例

# 日常：开 Web UI
dsh web

# 一次性：让 agent 总结仓库
dsh --profile headless "Summarize this repository and identify its main packages."

# 排查：看当前配置到底长什么样
dsh --dump-config

# 加插件：给 web profile 装社区插件
dsh plugin --profile web add dsh-some-plugin

退出码的含义

headless 任务正常完成（最终轮次结束）→ 退出码 0
其余情况（配置错误、启动失败、任务失败）→ 非零退出

写脚本时可以直接用退出码判断成败。

常见问题

问题	解答
`--help` 显示的不是我要的命令？	加`--profile <name>` 后 `--help` 显示的是该应用参数；裸 `--help` 是启动器
想临时改配置不影响文件？	用`--patch` 一次性覆盖层
headless 任务卡住？	它等 agent 完成全部工作才退出，长任务属正常