dsh-tui-herdr

Readme

# dsh-tui-herdr

[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) 插件：把 dsh-TUI 的生命周期状态实时上报给 [Herdr](https://herdr.dev) 多路复用器——在 herdr 侧边栏直接看到 dsh-TUI 是 **working / blocked / done**，和 Claude Code、Kimi 等官方支持的 agent 同等待遇。

## 原理

Herdr 对新 agent 的原生检测需要二进制更新，但官方提供了自定义上报 API（`herdr pane report-agent`），并为每个 pane 注入 `HERDR_PANE_ID`。本插件在 dsh-TUI 运行于 herdr pane 内时自动激活，通过会话事件上报：

| dsh 事件 | herdr 状态 |
|---|---|
| `turn/start` | `working` |
| `approval/asked` | `blocked`（等待人工审批） |
| `approval/resolved` | `working` |
| `turn/end` | `done` |

不在 herdr 内运行（`HERDR_PANE_ID` 未设置）时插件自动休眠，零开销。上报全部 fire-and-forget，herdr 不可用不会拖垮宿主。

## 安装

```bash
# 暂未发布到 npm。下载仓库内打包好的 tgz（浏览器打开保存，或 curl -LO）：
#   https://github.com/FUSU123fusu/dsh-tui-herdr/raw/main/dsh-tui-herdr-0.1.0.tgz
# 然后本地安装（路径换成实际下载位置）：
dsh plugin --profile dsh-tui add file:C:\path\to\dsh-tui-herdr-0.1.0.tgz
```

需要 `herdr` CLI 在 PATH 中。

## 使用

装好即用。在 herdr pane 里启动 `dsh-tui`，侧边栏即出现 dsh-tui 的状态行。

- `/herdr` — 查看 pane id、上报来源与状态映射
- `/herdr ping` — 发送一条测试上报（state=idle）

只上报顶层会话事件；子代理（subagent）会话不产生上报，与官方 web 端行为一致。

## 相关

- [dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) · [Herdr](https://herdr.dev)（[自定义上报文档](https://herdr.dev/docs/agents/)）
- 同系列插件：[dsh-tui-webhook](https://github.com/FUSU123fusu/dsh-tui-webhook)（长任务完成推送到飞书/钉钉/企业微信）