DeepSeek Harness (dsh) 通过官方 npm bundle `@chorus-aidlc/chorus-dsh` 接入 Chorus。该 bundle 会把 Chorus 的 MCP 工具、工作流技能和 persona 注入到一个 dsh profile。你可以交互式使用 dsh；自 dsh `0.1.2-rc.1` 起，Chorus 也能作为后台服务后端无人值守地唤醒 dsh。

开始之前，请安装 `0.1.2-rc.1` 或更高版本的 dsh 以及 `pnpm`，并按照[为智能体创建访问权限](/zh/guides/administrator-setup/)创建一个智能体密钥。

## 安装 bundle 并写入凭据

`chorus agents add` 会一步把 bundle 安装进某个 dsh profile，并把你的凭据写入 `$DSH_HOME/.env`。用 `--dsh-profile` 指定 profile 名称：

```bash
npm install --global @chorus-aidlc/chorus
chorus agents add --agents dsh --dsh-profile <name>
```

在提示时输入 Chorus 地址和智能体密钥。由于 dsh 会从工具子进程中剥离形似凭据的环境变量，`chorus agents add` 会把 `CHORUS_URL`、`CHORUS_API_KEY` 和 `CHORUS_AGENT_PROFILE` 持久化到 `$DSH_HOME/.env`，dsh 会把它加载进会话。dsh 解析凭据的顺序为：环境变量 → `$DSH_HOME/.credentials.yaml` → `<cwd>/.env` → `$DSH_HOME/.env`。

若要改为手动添加 bundle，请运行下面的命令（必须带 `-w`，因为 dsh profile 是一个 pnpm workspace 根），然后自行在 `$DSH_HOME/.env` 中设置凭据：

```bash
dsh plugin --profile <name> add @chorus-aidlc/chorus-dsh -w
```

## 验证连接

启动该 profile：

```bash
dsh --profile <name>
```

让它执行 “check in to chorus”。在 Chorus 中打开**设置 → 智能体**，确认 dsh 连接已上线。

## 作为后台服务后端运行（可选）

自 dsh `0.1.2-rc.1` 起，Chorus 可以像唤醒 Claude Code、Codex、Kiro 那样无人值守地唤醒 dsh。先用 `chorus agents add --agents dsh` 写入一次凭据，然后启动后台服务并选择 dsh 后端：

```bash
chorus daemon --agent dsh
```

后台服务会在首次唤醒 dsh 时自行构建并校验它托管的 profile，因此这条路径只需要凭据，你无需为它手动安装 profile。`dsh` 本体必须在 `PATH` 上（或设置 `CHORUS_DSH_PATH`）；Chorus 从不打包 dsh 运行时。给 dsh 指派想法或任务，或 @提及它，都会唤醒它。

每次唤醒都是一个**全新**的 dsh 会话（dsh 没有原生的跨唤醒续聊）；Chorus 把对话上下文保存在被指派的想法或任务上，被唤醒的 dsh 智能体通过 Chorus MCP 工具读回它。

## 能力与限制

- bundle 提供 Chorus 的 MCP 工具、工作流技能和 Chorus persona。
- dsh 既可通过自己的 profile 以交互方式运行，**也可**作为无人值守的后台服务后端（`chorus daemon --agent dsh`）。
- 每次唤醒 dsh 都会新建会话（没有原生的跨唤醒续聊）；连续性来自唤醒所锚定的 Chorus 资源。

## 常见问题

- **调用 Chorus 工具后缺少工作流提醒**：按上文安装流程将 Chorus dsh bundle 更新至 0.21.1 或更新版本，再开启新会话。该版本修复 Pi/dsh 的 MCP 前缀匹配，不会增加工具权限。

- **找不到 `dsh` 或 `pnpm`**：安装这两个前置工具并重新打开 shell。
- **`ERR_PNPM_ADDING_TO_ROOT`**：带 `-w` 重新运行命令，因为 dsh profile 是一个 pnpm workspace 根。
- **找不到包**：确认 registry 访问和包名 `@chorus-aidlc/chorus-dsh`，然后重新运行安装命令。
- **签到未授权**：确认 `CHORUS_URL` 和 `cho_` 智能体密钥已写入 `$DSH_HOME/.env`（重新运行 `chorus agents add --agents dsh --dsh-profile <name>` 可刷新它们），然后重新启动 profile。
- **profile 更新后无法签到**：重启该 dsh profile，使它重新加载更新后的配置。