快速开始

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.1.5-rc.1；默认的 npm install -g @deepseek-ai/dsh 目前满足该要求（截至 2026-09-12），启动器会在引导时强制检查这一下限。

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

$ 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。
dsh-cc-shunt — 把大批量文件读取和模板代码生成重定向到廉价通道的工作子代理，让大文件语料不进入主上下文。

在会话内安装：

text

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

安装后重启会话，新的 agent 和 hook 才会被加载。细节与配置见插件。

首次运行

运行 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 迁移 — 哪些延续，哪些不同

快速开始 ​

前置要求 ​

安装 ​

可选：官方插件 ​

首次运行 ​

你的第一个任务 ​

选择模型 ​

其他方式 ​

下一步 ​