dsh-herdr-bridge

让在 herdr pane 里启动的 DeepSeek Harness（dsh）进程出现在 herdr 侧边栏，实时显示 working / blocked / idle 状态。无需修改 herdr。

A dsh host plugin: a dsh process launched inside a herdr pane reports its live agent activity to herdr, so herdr's status bar shows it as an agent. No herdr changes required.

原理 / How

herdr 会给 pane 进程注入 HERDR_SOCKET_PATH / HERDR_PANE_ID，任何进程都能通过该 unix socket 发 pane.report_agent 上报状态（herdr 自带的 claude/codex hook 同款路径）。本插件读取该环境变量，监听 dsh 的 agent/status、agent/created、agent/disposed、approval/request，映射为 blocked / working / idle，250ms 防抖 + 15s 心跳上报。不在 herdr pane 里则完全 no-op。

herdr injects HERDR_SOCKET_PATH / HERDR_PANE_ID into each pane command; any process can send pane.report_agent over that socket. The plugin maps dsh's agent events to blocked / working / idle and reports them, with a debounce and a self-healing heartbeat.

安装 / Install

# 以 web profile 为例 / example: the web profile
cd ~/.dsh/profiles/web
pnpm add dsh-herdr-bridge          # npm 发布后 / once published to npm
pnpm add github:flaricy/herdr-bridge   # 或直接用仓库 / or straight from git

在 profile 的 cordis.patch.yml（或机器级 ~/.dsh/cordis.patch.yml）加一行：

Add one row to the profile's cordis.patch.yml (or ~/.dsh/cordis.patch.yml):

- insert:
    - id: herdr-bridge
      name: dsh-herdr-bridge

重启 dsh。之后在 herdr pane 里跑 dsh（dsh web、headless 等），该 pane 即显示为 dsh。

Restart dsh. Any dsh run inside a herdr pane then shows up as dsh.

配置 / Config

所有字段可选，非法值回退默认并打日志。All fields optional; invalid values fall back with a log.

字段	默认	说明
agentLabel	deepseek-harness	上报的 agent 标签
source	herdr:deepseek-harness	上报 source
displayAgent