dsh-plugin-guide 0.3.42 → 0.4.1

package/references/official-docs/docs/cli-help.i18n.yaml

@@ -1,34 +0,0 @@
-# Bilingual-pair consistency record for cli-help.md (docs/i18n/README.md): per heading
-# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
-# After editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write docs/cli-help.md
-/:
-  en: d11ca88bdc409249
-  zh: d11ca88bdc409249
-/dsh-cli-help:
-  en: b7174eab3476579d
-  zh: 5ddab967320e3cff
-/dsh-cli-help/contents:
-  en: 00308bcc6dc90afd
-  zh: 16f7442b76686a02
-/dsh-cli-help/dsh:
-  en: e0695abcf7d8b521
-  zh: 712c23b3c8a115ca
-/dsh-cli-help/dsh-plugin:
-  en: adad99c125d0ac51
-  zh: f11024971184f737
-/dsh-cli-help/dsh-acp:
-  en: bcb0f84577ce5f03
-  zh: 4382e617006849db
-/dsh-cli-help/dsh-headless:
-  en: 878a1dd78017964d
-  zh: bb43d91b4beb9bda
-/dsh-cli-help/dsh-sdk:
-  en: 701f239c5157dedb
-  zh: ee11be2932b05ce4
-/dsh-cli-help/dsh-sdk-minimal:
-  en: 8f0d7548d299ffd3
-  zh: fa2262e70d6819a0
-/dsh-cli-help/dsh-web:
-  en: 5d073104e8954cc8
-  zh: 91cd28f7c6ac96ac

package/references/official-docs/docs/cli-help.md

@@ -1,203 +0,0 @@
-<!-- Generated by scripts/gen-cli-help.ts — do not edit by hand.
-     Run `pnpm run gen-cli-help` to regenerate. -->
-
-# dsh CLI help
-
-This reference contains complete help for the launcher, subcommands, and shipped profiles. Identical help appears once with every invocation listed. Help output retains its original language.
-
-Run `pnpm run gen-cli-help` to regenerate; run `pnpm run verify-cli-help` to check freshness.
-
-## Contents
-
-- [`dsh`](#dsh)
-- [`dsh plugin`](#dsh-plugin)
-- [`dsh acp`](#dsh-acp)
-- [`dsh headless`](#dsh-headless)
-- [`dsh sdk`](#dsh-sdk)
-- [`dsh sdk-minimal`](#dsh-sdk-minimal)
-- [`dsh web`](#dsh-web)
-
-<a id="dsh"></a>
-## `dsh`
-
-Invocations: `dsh --help`
-
-```text
-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>  replace a custom profile with a fresh copy of 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
-                                            recreate 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
-
-```
-
-<a id="dsh-plugin"></a>
-## `dsh plugin`
-
-Invocations: `dsh plugin --help`
-
-```text
-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
-```
-
-<a id="dsh-acp"></a>
-## `dsh acp`
-
-Invocations: `dsh acp --help`, `dsh --profile acp --help`
-
-```text
-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
-
-```
-
-<a id="dsh-headless"></a>
-## `dsh headless`
-
-Invocations: `dsh headless --help`, `dsh --profile headless --help`
-
-```text
-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
-
-```
-
-<a id="dsh-sdk"></a>
-## `dsh sdk`
-
-Invocations: `dsh sdk --help`, `dsh --profile sdk --help`
-
-```text
-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
-
-```
-
-<a id="dsh-sdk-minimal"></a>
-## `dsh sdk-minimal`
-
-Invocations: `dsh sdk-minimal --help`, `dsh --profile sdk-minimal --help`
-
-```text
-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
-
-```
-
-<a id="dsh-web"></a>
-## `dsh web`
-
-Invocations: `dsh web --help`, `dsh --profile web --help`
-
-```text
-Usage: dsh --profile web [options]
-
-Serve the DeepSeek Harness browser UI.
-
-Options:
-  --host <host>                  bind address: one concrete IPv4 or IPv6 literal
-                                 of a local interface; wildcard addresses are
-                                 rejected
-  --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, runtime-context, and DSH_WEB_URL forms;
-                                 grants no trust
-  --trusted-host <authority...>  extra authority the /api browser-trust fence
-                                 accepts (host or host:port; repeatable)
-  --tls-cert <file>              PEM server certificate chain; requires
-                                 --tls-key
-  --tls-key <file>               unencrypted PEM private key; requires
-                                 --tls-cert
-  -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 --host 10.0.0.7          bind one local interface address
-  dsh --profile web --public-url https://app.example/ui/ --trusted-host app.example
-                                             advertise a prefix-stripping HTTPS proxy entry and admit its authority
-  dsh --profile web --tls-cert ./server-chain.pem --tls-key ./server-key.pem
-                                             serve HTTPS with an existing certificate and key
-
-```

package/references/official-docs/docs/cli-help.zh.md

@@ -1,205 +0,0 @@
-<!-- Generated by scripts/gen-cli-help.ts — do not edit by hand.
-     Run `pnpm run gen-cli-help` to regenerate. -->
-
-# dsh 命令行帮助
-
-[English](cli-help.md) | 中文
-
-此参考收录启动器、子命令和随附 profile 的完整帮助。同一份帮助只展示一次，并列出所有调用方式。帮助输出保留原文。
-
-运行 `pnpm run gen-cli-help` 重新生成；运行 `pnpm run verify-cli-help` 检查是否与当前命令一致。
-
-## 目录
-
-- [`dsh`](#dsh)
-- [`dsh plugin`](#dsh-plugin)
-- [`dsh acp`](#dsh-acp)
-- [`dsh headless`](#dsh-headless)
-- [`dsh sdk`](#dsh-sdk)
-- [`dsh sdk-minimal`](#dsh-sdk-minimal)
-- [`dsh web`](#dsh-web)
-
-<a id="dsh"></a>
-## `dsh`
-
-调用方式: `dsh --help`
-
-```text
-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>  replace a custom profile with a fresh copy of 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
-                                            recreate 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
-
-```
-
-<a id="dsh-plugin"></a>
-## `dsh plugin`
-
-调用方式: `dsh plugin --help`
-
-```text
-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
-```
-
-<a id="dsh-acp"></a>
-## `dsh acp`
-
-调用方式: `dsh acp --help`, `dsh --profile acp --help`
-
-```text
-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
-
-```
-
-<a id="dsh-headless"></a>
-## `dsh headless`
-
-调用方式: `dsh headless --help`, `dsh --profile headless --help`
-
-```text
-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
-
-```
-
-<a id="dsh-sdk"></a>
-## `dsh sdk`
-
-调用方式: `dsh sdk --help`, `dsh --profile sdk --help`
-
-```text
-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
-
-```
-
-<a id="dsh-sdk-minimal"></a>
-## `dsh sdk-minimal`
-
-调用方式: `dsh sdk-minimal --help`, `dsh --profile sdk-minimal --help`
-
-```text
-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
-
-```
-
-<a id="dsh-web"></a>
-## `dsh web`
-
-调用方式: `dsh web --help`, `dsh --profile web --help`
-
-```text
-Usage: dsh --profile web [options]
-
-Serve the DeepSeek Harness browser UI.
-
-Options:
-  --host <host>                  bind address: one concrete IPv4 or IPv6 literal
-                                 of a local interface; wildcard addresses are
-                                 rejected
-  --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, runtime-context, and DSH_WEB_URL forms;
-                                 grants no trust
-  --trusted-host <authority...>  extra authority the /api browser-trust fence
-                                 accepts (host or host:port; repeatable)
-  --tls-cert <file>              PEM server certificate chain; requires
-                                 --tls-key
-  --tls-key <file>               unencrypted PEM private key; requires
-                                 --tls-cert
-  -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 --host 10.0.0.7          bind one local interface address
-  dsh --profile web --public-url https://app.example/ui/ --trusted-host app.example
-                                             advertise a prefix-stripping HTTPS proxy entry and admit its authority
-  dsh --profile web --tls-cert ./server-chain.pem --tls-key ./server-key.pem
-                                             serve HTTPS with an existing certificate and key
-
-```

package/references/official-docs/docs/config-catalog.i18n.yaml

@@ -1,19 +0,0 @@
-# Bilingual-pair consistency record for config-catalog.md (docs/i18n/README.md): per heading
-# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
-# After editing either side, bring the other along and re-record with:
-#   pnpm run verify-translation-pairing --write docs/config-catalog.md
-/:
-  en: 0977df2d5eaa10e9
-  zh: de18ef966e262873
-/plugin-config-catalog:
-  en: e372950a550bc4a7
-  zh: 43ac5df440879eb1
-/plugin-config-catalog/loadable-plugins-with-no-config:
-  en: 171d45e5a8385abc
-  zh: 0fc1aa514caea442
-/plugin-config-catalog/seam-packages-not-directly-loadable:
-  en: 4555f0e0510d8c80
-  zh: b05727ed838f4570
-/plugin-config-catalog/library-packages-no-plugin-entry:
-  en: 2efa9041cc87895c
-  zh: d5f13c9c77bd5593