21hbguo/dsh-agent-board

README 摘要

dsh-agent-board DSH（DeepSeek Harness）Agent 实时看板 —— 主 agent 与子代理的树形层级监控，停滞自动告警，点击直达会话。老板视角，一眼看清谁在跑、干到哪、卡没卡。 ✨ 特性 特性 说明 🎯 树形层级图 以主 agent（实心圆）为根、子代理（空心圆）为分支的层级森林；多主会话并排显示； 四色状态语义 ：🟢绿=working（在跑）/ 🔵蓝=完成（未查看）/ ⚪灰=空闲（完成且已打开过，已读弱化）/ 🔴红=停滞 ⚡ SSE 实时推送 数据变化事件级推送，看板即时刷新；断线自动回退轮询兜底 🚦 三态生命周期 working（在跑）→ 完成 （settle 后弱化保留 30 分钟，每根最多 12 条防堆积）→ 超时消失；有在跑子代理的根自动展开，子代理立即可见 🔔 停滞自动告警 子代理静默超过阈值（默认 10 分钟）→ 自动向父会话注入 notice 提醒（GUI 可见、不唤醒模型、不耗 API 额度）——不再需要手动轮询 list agents 催进度 📝 进展一目了然 每个节点同行显示：当前动作（正在执行的命令 ⚙ / 输出中 ✍ ）+ 最新答复节选 + 状态；工具与文本都是实时信号 🖱️ 单击直达，行首折叠 单击任意节点打开会话；展开/折叠只走行首 ▸/▾（有子节点的根）； 打开 = 已读 ：完成节点由蓝变灰（空闲），跨刷新持久（localStorage）；当前会话带「当前」标记 💾 跨重启持久 完成态存档落盘（ /.dsh/agent-board-archive.json ），重启后不丢；会话标题/名字自动恢复 🪟 常驻悬浮窗 可拖拽、折叠、隐藏（右下角召唤）；侧边栏「Agent 看板」按钮开关；位置状态持久化 🧩 解决的问题 DSH 的后台子代理 卡住 时（工具死等、LLM 挂起、自循环），父会话收不到任何信号： - subagent-settled 通知只在子代理 真正结束 时才投递——而卡住的 agent 可以 永远不 settle ； - list agents 只有 running/idle/ready ，没有活动时间戳——"running" ≠ "活着"； - 宿主没有 turn 级超时兜底。 dsh-agent-board 补齐这个洞 ：以 session 事件流为精确活动信号（毫秒级时间戳，最后一条 chunk/工具事件即"活着"），看板 + 自动告警双通道，老板不再需要轮询。 📦 安装 DSH 插件（host + client），本地构建注入即可，无需 npm 发布： 重启后自动恢复：注入 registry + junction 持久装配（ dev inject plugin 标准机制）。 ⚙️ 配置 参数 默认 说明 scanIntervalMs 60000 停滞…

分类