Skip to content

CLI 参数 ​

dsh-cc 是一个可选的轻量包装器:它翻译少量参数,然后启动规范命令 dsh --profile tui。首次运行时,它通过安装三个 CC bundle(固定为启动器 版本的 @dsh-cc/bundle-permissions、@dsh-cc/bundle-shell、 @dsh-cc/bundle-tui)来引导 $DSH_HOME/profiles/tui。安装两个包即可开始:

sh
$ npm install -g @deepseek-ai/dsh @dsh-cc/cli
$ dsh-cc

启动器在引导时会强制检查 harness 下限:已安装的 dsh 必须 >= 0.2.0-rc.2,否则拒绝启动。

参数 ​

所有参数都由启动器处理;resume 模式参数会在转发给 dsh 之前从 argv 中 剥离。不识别组合短参数(例如 -cn)——每个参数必须是独立的 token。

参数作用
--version / -V输出启动器自身的包版本并退出。
--new / -n开始全新会话:TUI 全新启动,不读取任何 resume 标记。
--resume <id>恢复指定 id 的会话。--resume=<id> 形式效果相同。
--continue / -c继续上一个会话;当标记不存在时,TUI 会显示 "no previous session to continue" 提示。
--worktree [name]在位于 <repoRoot>/.claude/worktrees/<slug>、分支为 worktree-<slug> 的 git worktree 内启动会话(未给名称时使用随机 slug)。新建的 worktree 会开始全新会话(等价于 --new);当目录已存在时再次执行 --worktree <name> 会复用它,并回退到默认的自动恢复。也支持 PR 引用:--worktree '#12'(给 # 加引号)、GitHub PR URL 或 GitLab MR URL 会在分支 worktree-pr-<n> 上创建 .claude/worktrees/pr-<n>,在 github.com 上抓取 pull/<n>/head,在 gitlab.com 上抓取 merge-requests/<n>/head(其他主机按顺序两者都试)。要求 git 仓库中至少有一个提交。
--profile启动器本身不消费它:它总是转发 dsh --profile tui,即规范命令。

如果没有做出明确选择,TUI 会读取自己的项目 resume 标记,并在存在时自动 恢复该项目的上一个会话。--resume / --new 优先于 worktree 的回退行为。

每次启动都会对过期的 worktree-* worktree 运行一次有上限的启动期清扫, 并依据 settings 选择 worktree 基底——详见 /guide/worktrees。

退出时,TUI 会打印会话 id 和恢复命令,方便下次接着聊;设 DSH_CC_DISABLE_EXIT_TIP='1' 可关闭该提示(/reference/env-vars)。

dsh-cc acp —— ACP 通道 ​

dsh-cc acp [<args>] 把 cc-acp profile(安装在 ~/.dsh/profiles/cc-acp 下)作为 Agent Client Protocol(ACP,v1)服务器经 stdio 启动,让 Zed 之类的 ACP 客户端通过 JSON-RPC 驱动 dsh-cc 的 agent。该服务器是 harness @deepseek-ai/dsh-acp 插件的逐项移植,叠加 CC preset 组合;其 presetId 配置默认为 'cc'。在编辑器中接入这一通道,把 agent server 指向 dsh-cc:

json
{"command": "dsh-cc", "args": ["acp"]}

工作目录由编辑器提供。与上文 TUI 启动相同的 harness 下限检查与 bootstrap/reconcile 行为在这里同样适用。

参数如何传递给 TUI ​

启动器是一个薄参数翻译层:它推导出 TUI 插件消费的会话模式环境变量 (例如 DSH_CC_PROFILE=tui、DSH_CC_RESUME_SESSION=<id> 或 ''、 DSH_CC_CONTINUE='1'、DSH_CC_AUTO_RESUME='1',以及 DSH_CC_WORKTREE 中的 worktree 描述符),然后启动 dsh --profile tui。 启动器自己从不读取 resume 标记——标记的读取和写入由 TUI 插件负责。 启动器拥有的 resume 变量会在入口处从继承的环境中清除,只根据本次调用 的 argv 重新推导,因此启动 dsh-cc 时请勿手动设置它们。

TIP

DSH_CC_* 变量的完整细节见 /reference/env-vars。

下一步 ​

dsh-cc 不是 Claude Code,也不是 Claude Code 的包装器。与 Anthropic 无关联,亦未获其背书。