Tianyi Cui
231d5a311e
`collectCliHelp` stops propagating an alias when it reaches a page already on the current path, so a `help [command]` row that prints its parent's help no longer recurses until the stack overflows. `serve|s` command rows are split into separately collected names. The CLI reference and upgrade guide describe the forwarded-argument boundary that Commander applies, including a leading pnpm option, and args.spec.ts pins that `--profile` placed after a leading pnpm option is forwarded. Generated pages use the repository's two-line generated header, and docs/AGENTS.md lists the CLI help among the generated references. Refs #4114
6.2 KiB
6.2 KiB
dsh 命令行帮助
English | 中文
此参考收录启动器、子命令和随附 profile 的完整帮助。同一份帮助只展示一次，并列出所有调用方式。帮助输出保留原文。
运行 pnpm run gen-cli-help 重新生成；运行 pnpm run verify-cli-help 检查是否与当前命令一致。
目录
dsh
调用方式: dsh --help
Usage: dsh [--profile] <name> [options] [app-args...]
dsh plugin --profile <name> <pnpm-args...>
dsh: boot a DeepSeek Harness profile — an ordered stack of plugin-bundle patch
layers under your own overrides.
Arguments:
args arguments for the booted profile's app (see:
dsh --profile <name> --help)
Options:
-V, --version output the version number
--profile <name> the profile under $DSH_HOME/profiles to boot
--from-default-profile <name> initialize a new custom profile from a shipped
profile template
--patch <path> extra patch-list overlay applied after the
profile layer (repeatable)
--dump-config print the composed profile tree and exit
--dump-config-schema print JSON Schema for profile entries and
patches without mounting
--dump-default-config print the profile tree without its user layer
or --patch overlays and exit
Examples:
dsh web boot the web profile (same as: dsh --profile web)
dsh rescue --from-default-profile web
create rescue from the shipped web template, then boot it
dsh headless "run the tests" answer one task, print the result, and exit
dsh tui --patch ./extra.yml boot a custom profile with one extra overlay
dsh tui --resume <session> arguments after the launcher flags reach the app
dsh web --help the web app's own flags and help
dsh plugin --profile tui add <package> install a plugin into the tui profile
dsh plugin
调用方式: dsh plugin --help
Usage: dsh plugin [options] [args...]
manage a profile's plugins by forwarding the remaining arguments to pnpm in the
profile directory
Arguments:
args pnpm arguments, forwarded verbatim (add <pkg>, remove <pkg>,
why <pkg>, ...)
Options:
--profile <name> the profile whose plugins to manage (initialized on first
use)
-h, --help show this help
dsh acp
调用方式: dsh acp --help, dsh --profile acp --help
Usage: dsh --profile acp [options]
Serve automation clients over Agent Client Protocol stdio.
Options:
-h, --help show this help
Example:
dsh --profile acp serve ACP until the client disconnects
dsh headless
调用方式: dsh headless --help, dsh --profile headless --help
Usage: dsh --profile headless [options] [task...]
Answer one task and exit; the answer goes to stdout and diagnostics to stderr.
Arguments:
task the task text; multiple words are joined by spaces, and `-`
reads stdin
Options:
--json write newline-delimited run events to stdout instead of the
final message
--session-id <id> adopt the persisted Session with this id; an unknown id is
an error
-h, --help show this help
Examples:
dsh --profile headless "run the tests" answer one task and exit
echo "run the tests" | dsh --profile headless read the task from stdin
dsh --profile headless --json "run the tests" emit machine-readable run events
dsh --profile headless --session-id session-… "continue" resume an existing Session
dsh sdk
调用方式: dsh sdk --help, dsh --profile sdk --help
Usage: dsh --profile sdk [options]
Serve DeepSeek Harness SDK clients over stdio JSON-RPC.
Options:
-h, --help show this help
Example:
dsh --profile sdk serve one SDK runtime until its client disconnects
dsh sdk-minimal
调用方式: dsh sdk-minimal --help, dsh --profile sdk-minimal --help
Usage: dsh --profile sdk-minimal [options]
Serve DeepSeek Harness SDK clients over stdio JSON-RPC.
Options:
-h, --help show this help
Example:
dsh --profile sdk-minimal serve one SDK runtime until its client disconnects
dsh web
调用方式: dsh web --help, dsh --profile web --help
Usage: dsh --profile web [options]
Serve the DeepSeek Harness browser UI.
Options:
--host <host> bind host
--no-open do not open the Web UI in the default browser
--port <port> listen port; pass 0 to let the OS pick a free
one
--public-url <url> advertise this HTTP(S) root in the printed,
opened, web-surface, and DSH_WEB_URL forms;
grants no trust
--trusted-host <authority...> extra authority the /api browser-trust fence
accepts (host or host:port; repeatable)
-h, --help show this help
Examples:
dsh --profile web serve on the composed host and port
dsh --profile web --no-open serve without opening a browser
dsh --profile web --port 8080 serve on another port
dsh --profile web --public-url https://app.example/ui/ --trusted-host app.example
advertise a prefix-stripping HTTPS proxy entry and admit its authority