# dsh-herdr-bridge [English](README.md) | 简体中文 一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)插件,把 DSH 的会话接进 [Herdr Core](https://github.com/herdrdev/herdr-core)(`hc`)。每个会话变成一个 hc 终端,Herdr 里的 Agent 可以像操控 Claude Code、Codex 一样读取和操控 DSH。适用于 DSH Desktop 和 `dsh web`。 - **在 Herdr 里看到 DSH 会话**,状态实时更新:工作中、完成、需要你、出错。 - **让其他 Agent 使用 DSH**:带着任务新建会话、追加消息、读取回复,或者接管你在 DSH 里开的会话。 - **让 DSH 使用其他 Agent**:DSH 会话里的模型可以启动 Claude Code、Codex 或另一个 DSH 会话,并收到它们的回报。 - **审批两边都能答**:在 DSH 窗口或 hc 里回答都行,先答的生效。 ![Herdr App 里的三个 DSH 会话:一个等待审批,一个正在工作,一个已完成;右侧是已完成会话的对话](https://raw.githubusercontent.com/Hariketsu/dsh-herdr-bridge/main/docs/media/herdr-app.webp) ## 要求 | | 测试过的版本 | |---|---| | DSH Desktop 或 `dsh web` | 0.2.2-rc.3 | | [herdr-core](https://github.com/herdrdev/herdr-core)(`hc`) | 0.1.21,需要在登录 shell 的 PATH 上 | | [Herdr App](https://github.com/herdrdev/herdr-app) | 0.1.15(可选) | 在 macOS 上测试过。Windows 和 Linux 已实现,但没有测试。DSH 的插件接口仍在变化,升级 DSH 后可能需要更新插件。 ## 安装 退出 Desktop(⌘Q)或停掉 `dsh web`,把插件加到你用的 profile(`desktop` 或 `web`): ```sh dsh plugin --profile desktop add dsh-herdr-bridge ``` 重新打开 DSH,在任意会话里发一条消息。Herdr App 和 `hc ls` 里会出现一个 `dsh-<短 id>` 终端,`hc templates` 里会列出 `dsh`。 ## 使用 **照常使用 DSH。** 会话第一次运行时就会出现在 Herdr 里。想让还没运行过的会话也出现,在里面输入 `/herdr`。 **让 Agent 运行 DSH。** 会用 hc 的 Agent(通过 `herdr-core` skill)可以像启动其他 Agent 一样启动 DSH: ```sh hc run --bg --name fix --cwd ~/repo dsh "修复 x.rs 里失败的测试" hc wait fix hc read fix hc send --wait fix "边界情况也覆盖一下" hc interrupt fix # 取消当前回合 ``` 会话正在工作时发来的消息会并入当前回合,和 DSH 里的插话一样。 这个会话也会出现在 DSH 里;在 Herdr App 里,它显示在启动它的 Agent 下面。 **接管在 DSH 里开的会话。** ```sh ~/.dsh/herdr-bridge/bin/dsh-hc ls # 最近的会话 hc run --bg --name login ~/.dsh/herdr-bridge/bin/dsh-hc attach 3b729fc9 # 用 id 或标题的一部分 ``` **让 DSH 启动其他 Agent。** 在 DSH 会话的 shell 里,`hc` 的用法和在 hc 里运行的 Agent 一样:它启动的 helper 显示在它下面,并向它回报。 ## 审批 会话请求审批或向你提问时,在 DSH 窗口或 hc 里回答都行。先答的生效,另一边的对话框随之关闭。 ![左:DSH Web 里的审批对话框;右:Herdr App 里的同一个会话,在等同一个审批](https://raw.githubusercontent.com/Hariketsu/dsh-herdr-bridge/main/docs/media/approval.webp) ```sh hc send --force fix y # 允许一次;n 拒绝 hc send --force fix 1,3 # 回答提问:选项编号,或直接写文字 ``` 和 hc 里所有 Agent 一样,回答正在等待的会话需要 `--force`。能使用你的 hc 的程序都能操控 DSH 会话;通过 hc 发来的消息,会作为用户消息交给模型。 ## 设置 在 DSH 里打开 **插件 → Herdr Bridge**,选择在 DSH 里开的会话显示在 Herdr App 的哪里:按文件夹分组(默认)、都放进一个名为 DSH 的 space(每个会话一个以标题命名的 tab),或者不显示。也可以写在 `~/.dsh/profiles//cordis.patch.yml` 里: ```yaml - id: herdr-bridge config: herdrPlacement: folder # folder、dsh 或 none herdrSpace: sp123 # 改用一个固定的 Herdr App space id reconnectGraceSeconds: 30 # 终端等 DSH 回来的时间 hc: /path/to/hc # hc 不在登录 shell 的 PATH 上时指定 ``` ## 故障排查 日志在 `~/.dsh/herdr-bridge/bridge.log`。 | 问题 | 怎么办 | |---|---| | `hc ls` 里没有会话 | 看日志。确认 DSH 能找到 `hc`(必要时在配置里设置 `hc`),以及 Desktop 和 `dsh web` 没有同时运行 | | `hc ls` 里有,Herdr App 里没有 | 检查显示位置是不是设成了“不显示” | | `hc templates` 里没有 `dsh` | 插件没有加载,看日志。你自己写的 `dsh` template 会保留 | | 终端提示协议版本不符 | 它是插件升级前开的。关掉它,重新 attach | | 升级 DSH 后插件不工作 | 带上日志提 issue | ## 已知限制 - Desktop 和 `dsh web` 同一时间只能有一个接入 Herdr,先启动的那个生效。 - 在 Herdr 里看过会话,不会清掉 DSH 侧栏的提醒。 - 插件升级前开着的终端仍用旧版本,重开后才更新。 ## 卸载 退出 DSH,执行 `dsh plugin --profile remove dsh-herdr-bridge`,并删掉 `cordis.patch.yml` 里的 `herdr-bridge` 条目(如果有)。然后删除 `~/.dsh/herdr-bridge/`、`~/.config/herdr-core/templates/dsh.md`、`~/.config/herdr-app/programs.json` 里的 `dsh` 条目,以及 `~/.config/herdr-app/icons/dsh-herdr-bridge.svg`。 ## 深入阅读 - [工作原理](docs/architecture.md):设计、状态映射、否决的方案、测试覆盖 - [开发](docs/development.md) 和 [AGENTS.md](AGENTS.md):参与这个仓库的开发 - [TODO.md](TODO.md):计划和没测过的路径 ## 许可 MIT。`assets/dsh.svg` 是 DeepSeek Harness 的标志,取自 [deepseek-ai/deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)(MIT,Copyright (c) 2026 DeepSeek)。DeepSeek 的名称和标志归其所有者。