dsh-tool-monitor

在 Agent 工作流里，你常常需要等日志落盘、长命令跑完，或盯着某个 WebSocket 流——若一直占着对话轮次轮询，既费 token 又容易漏掉瞬间输出。dsh-tool-monitor 把「盯着某路输出」变成后台监听：启动后立刻返回 monitor_id，有新内容再唤醒所属会话，模型可以继续做别的事。

插件通过 monitor_start 支持三类来源：本地文件轮询、后台命令 stdout，以及出站 WebSocket 客户端。可用 JavaScript 正则 pattern 只对匹配行触发；也支持 one_shot、时长上限、文件初始快照与输出尾缓冲。Web 会话头部会显示当前监听器数量，点开可看状态、详情、保留输出，并可在界面上停止；模型侧则有 monitor_read、monitor_stop、monitor_list 四个工具，增量读取与自管任务表，不混入框架的「后台任务」列表。

忙时唤醒会按监听器合并排队，空闲后一次性 followup，避免反复打断且不设唤醒次数上限；agent 销毁或插件卸载会清理全部监听。适合需要异步等构建/部署/日志/实时推送，又希望会话被及时叫醒的开发者与自动化场景。无 webServer 的 headless 环境仍可用模型工具，只是没有头部 UI 与 WS 快照推送。