快速开始

dsh-cc 面向希望在 DeepSeek Harness 运行时上使用熟悉的 Claude Code 风格工作流——斜杠命令、.claude/ 项目资产、hooks、会话恢复——并自由选择模型的开发者。读完本页，你将完成启动器安装、启动一个可用的终端会话，并把它指向自己的模型供应商。

前置要求

Node.js ^22.19 || >=24
npm（随 Node 一起安装）

安装

安装 DeepSeek Harness 和 dsh-cc 启动器，然后直接启动：

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

dsh-cc 要求 dsh >= 0.2.0-rc.2；默认的 npm install -g @deepseek-ai/dsh 目前满足该要求（截至 2026-09-29），启动器会在引导时强制检查这一下限。该下限随 dsh-cc 的开发线变动，各发布版本对应的已验证配对见“升级”一节中的表格。

如果已经安装 dsh >= 0.2.0-rc.2，只需安装启动器：

$ npm install -g @dsh-cc/cli
$ dsh-cc

TIP

官方软件包只来自 @dsh-cc npm scope。

可选：官方插件

以上安装就是完整的快速开始。另有五个可选官方插件——通过 dsh-cc 仓库自带的 dsh-cc marketplace 分发——提供预配置好的子代理通道、一套文档写作工具包，以及外部模型桥接：

dsh-cc-agents — dsh-cc-agents:critic（推理与方案评审）、dsh-cc-agents:executor（机械执行）和 dsh-cc-agents:marathon（长周期、全仓库级工作）三个子代理，外加编排路由 skill，以及 vwa-writing 和 formal-design 两个 skill（证据核验的文档评审与有界 TLA+ 设计检查）。
dsh-cc-writing — 文档写作工具包：面向中英文文章的写作、评审与语言编辑，运行协议会把简报、计划、评审和保真检查都留在磁盘上。
dsh-cc-shunt — 把大批量文件读取和模板代码生成重定向到廉价通道的工作子代理，让大文件语料不进入主上下文。
cc-codex-bridge — 一条免审批的 Codex 救援通道：PreToolUse hook 会在每次会话运行中自动放行唯一一条规范化、锁定参数的 Codex 调用，让卡住的会话可以把任务交给 Codex，而无需经过权限检查点。
cc-grok-bridge — 同样的模式用于 Grok 评审通道：自动放行唯一一条规范化调用，外部 Grok 评审无需逐次审批。

在会话内安装：

text

/plugin marketplace add dsh-cc/dsh-cc
/plugin install dsh-cc-agents@dsh-cc
/plugin install dsh-cc-writing@dsh-cc
/plugin install dsh-cc-shunt@dsh-cc

安装后重启会话，新的 agent 和 hook 才会被加载。细节与配置见插件。需要证据核验的文档写作与评审，见 VWA 写作与评审。

升级

$ npm install -g @dsh-cc/cli@latest
$ dsh-cc

升级后的首次启动，启动器会以新版本重新执行 profile 的 bundle 安装（记录在 ~/.dsh/profiles/tui/.dsh-cc-bootstrap.json），profile 会自动收敛——无需手动操作。对账失败（网络问题，或新版本仍在 npm/pnpm 的 minimum-release-age 窗口内）只会警告并照常启动，下次启动时重试。通过 scripts/sync-local-profile.sh 同步的 dev profile（dsh-cc --version 显示 -dev+<commit>[.dirty]）永远不会被启动器对账。

dsh 版本兼容性

dsh-cc release	Verified dsh
v0.9.0-rc.1 – v0.9.2	0.2.0-rc.2
v0.8.3	0.2.0-rc.2
v0.8.2	0.1.7-rc.2
v0.6.3 – v0.8.1	0.1.5-rc.1
v0.6.0 – v0.6.2	0.1.2-rc.1
v0.5.0	0.1.1-rc.2 (no launcher version gate)

每个 dsh-cc 发布版本都针对一个确定的 dsh 版本开发并通过 CI 验证，启动器会在引导时将其强制为下限。没有强制的版本上限，但只有上表列出的配对经过 CI 验证。当新的 dsh-cc 发布迁移到更新的 dsh 时，请先升级 dsh，再升级 dsh-cc——一方的 @latest 未必是另一方 @latest 的已验证配对。

首次运行

运行 dsh-cc。首次启动时会创建并运行面向 CC 工作流的 tui profile，无需其他配置即可开始：

在 tui profile 上，CC Mode 是默认的 agent preset。
终端 profile 默认以全屏模式启动。单次关闭全屏模式：

$ DSH_CCTUI_UI_MODE=regular dsh --profile tui

全新安装且未配置模型时，TUI 会自动打开 provider 面板：选一个预设，粘贴 API 密钥（只存入凭据存储 ~/.dsh/.credentials.yaml），并设置默认模型。按 Esc 关闭只跳过当前会话——下次启动会再次提供。要永久关闭，在 ~/.dsh/settings.json 的用户设置命名空间下设置 cc-onboarding.suppressed: true；随时可用 /onboard 重新开启。非交互（非 TTY）运行不会触发该流程。

你的第一个任务

用自然语言输入一个请求——例如让它查看某个文件或做一个小修改——agent 会规划、调用工具并汇报结果。交互方式是你熟悉的那一套：排队输入、敏感操作的审批流程，以及斜杠命令。

在会话内验证安装状态：

/doctor — 会话健康检查（支持 --verbose / --json）
/status — 环境和会话状态

选择模型

dsh-cc 不会把你绑定到某一家供应商。sketch、draft、blueprint、masterplan 等别名只是配置，不是硬编码——你可以把它们映射到 dsh 部署支持的任意 provider/model 组合。

/provider 在覆盖层中管理已配置的模型供应商：/provider list 列出当前路由，/provider add <preset-id> 通过向导添加内置预设（Moonshot、Z.AI/智谱、DeepSeek）或完全自定义的端点。
API 密钥通过掩码输入框录入并保存到凭据存储（~/.dsh/.credentials.yaml），不写入 settings。变更对新会话立即生效；当前会话保持原供应商，直到用 /model 重新选择。

完整的别名到路由映射、路由语义和按 agent 覆盖，详见模型路由指南。

其他方式

启动器只是便捷入口——同一套后端也可以显式组合，或用于 dsh Web UI：

$ dsh plugin --profile tui add \
    @dsh-cc/bundle-permissions \
    @dsh-cc/bundle-shell \
    @dsh-cc/bundle-tui
$ dsh --profile tui

$ dsh plugin --profile web add \
    @dsh-cc/bundle-permissions \
    @dsh-cc/bundle-shell
$ dsh web

下一步

交互基础 — 日常 TUI 工作流
模型路由 — 别名通道与 provider 配置详解
从 Claude Code 迁移 — 哪些延续，哪些不同

快速开始 ​

前置要求 ​

安装 ​

可选：官方插件 ​

升级 ​

dsh 版本兼容性 ​

首次运行 ​

你的第一个任务 ​

选择模型 ​

其他方式 ​

下一步 ​