Herdr 状态桥 zeidalqadri/herdr-dsh

herdr-dsh

为 DeepSeek Harness（DSH） 终端 UI 提供 Herdr 集成。

Herdr 默认把 DSH 面板显示为 unknown，因为它没有内置 DSH 进程清单。这个插件让 DSH 通过 Herdr 的 agent API 上报自身状态，于是你能得到：

- herdr agent list 和侧边栏里出现 dsh；
- 根据真实 harness 事件得到 idle / working / done；
- 审批或 ask_user_question 提示词等待你处理时显示 blocked；
- Herdr 服务器重启后恢复同一段会话；
- TUI 退出时自动释放。

无需重新编译 Herdr，也无需提交 pull request。

环境要求

- Herdr 0.9.2+ 才支持恢复会话；状态上报在 0.9.x 上可用。
- 基于 Cordis 配置档构建的 DSH TUI。0.1.x TUI 由 @peiyu_wang/deepseek-harness-cli 提供；官方 0.2.x 命令行不再包含 TUI。
- Node.js 22+。

已在 macOS 上用 Herdr 0.9.3 和 DSH 0.1.0-rc.15 测试。

安装

把仓库克隆到 harness home 旁边，然后运行安装脚本：

git clone https://github.com/zeidalqadri/herdr-dsh.git "$HOME/.dsh/herdr-dsh"
"$HOME/.dsh/herdr-dsh/install.sh"

脚本会把包链接到 ~/.dsh/profiles/tui/node_modules，备份 cordis.patch.yml，追加 insert 条目，并在 dsh 位于 PATH 时校验组合后的配置档。重复运行也安全。

如果设置了 DSH_HOME，脚本改用 $DSH_HOME/profiles/tui。

在 Herdr 面板里重启一次 DSH TUI。配置档只在启动时读取，所以正在运行的面板不会热加载插件。

手动安装

mkdir -p "$HOME/.dsh/profiles/tui/node_modules"
ln -sfn "$HOME/.dsh/herdr-dsh" "$HOME/.dsh/profiles/tui/node_modules/herdr-dsh"

把下面内容加到 ~/.dsh/profiles/tui/cordis.patch.yml：

- insert:
- id: herdr-dsh
name: 'herdr-dsh'

如果文件当前只有 []，用上面的块替换它。

验证

在运行 dsh 的面板里执行：

herdr pane get "$HERDR_PANE_ID"
herdr agent list

预期结果：面板带有 agent: dsh 和 agent_status: idle。发送一条提示词，状态会从 working 变为 done；出现审批提示时显示 blocked。Herdr 的 done 表示完成但尚未查看——idle 和 done 都表示智能体已就绪，可以接收输入。

恢复命令会持久化到 ~/.config/herdr/session.json：

jq '.. | objects | select(.agent_resume?.source == "dsh") | .agent_resume' \
"$HOME/.config/herdr/session.json"

配置

| 选项 | 默认值 | 含义 |
| resumeBin / DSH_HERDR_RESUME_BIN | deepseek | Herdr 恢复会话时运行的命令。0.1.x 命令行会安装 deepseek 和 dsh 两个别名；如果只有 dsh 别名，就用 dsh。 |
| DSH_HERDR_DEBUG=1 | 关闭 | 把上报用的 argv 追加到 $TMPDIR/dsh-herdr-report.log。 |

配置档补丁里的插件配置：

- insert:
- id: herdr-dsh
name: 'herdr-dsh'
config:
resumeBin: dsh

工作原理

| DSH 信号 | Herdr 上报 |
| agent/status running | working |
| agent/status idle | idle |
| approval/request 或 user-questions/request 待处理 | blocked |
| 根 session/created | 会话 id + resumeBin --resume=<id> |
| agent/disposed | 把该智能体从运行集合中移除 |
| 进程 exit | pane release-agent |

子代理活跃期间，一个运行计数器让窗格保持 working。每次调用都是一次短命的分离式 herdr 调用，错误一律忽略，所以 Herdr 响应慢或缺失都不会让智能体回合失败。在 Herdr 之外（HERDR_ENV != 1），apply() 立即返回，插件不生效。

限制

- Herdr 没有内置的 DSH 清单，所以这是自报的智能体。Herdr 0.9.3 会显示状态，但不在 agent list 里显示自报的会话 id；恢复用的 argv 持久化在 session.json 的 agent_resume 下，恢复时用的就是它。
- 面向 0.1.x TUI。官方 0.2.x 命令行没有 TUI。这里用到的事件属于 harness Cordis 核心，但其他 DSH 界面尚未测试。
- 插件只上报语义状态、会话 id 和恢复命令。它不读取凭据、提示词或模型输出。
- 与 Herdr 或 DeepSeek 无隶属关系。

卸载

从 cordis.patch.yml 中删掉 herdr-dsh 插入项，再删除 ~/.dsh/profiles/tui/node_modules/herdr-dsh，然后重启 TUI。安装器会为补丁文件保留一份带时间戳的备份。

许可证

MIT