dsh-folderwatch

对话进行中的 Agent 往往只能靠定时任务或 Webhook 被唤醒，却难以察觉会话之外的真实变动：构建结束、格式化改树、测试产出报告、下载落盘或同事写入共享目录。dsh-folderwatch 为指定目录挂上监视，在树发生变化时给出可行动的变更清单，并可选择立即唤醒下一轮，或把通知排队到下一步再处理。

它不是把 fs.watch 原样接到回调上。插件以周期性快照做差分，在各平台上正确归类重命名、删除与突发写入，并附带文件大小；原生 watch 只用来提示尽快重扫，正确性由轮询重扫兜底。更关键的是回声抑制：本会话内刚写入的路径会在短窗口内被记入账本，避免 Agent 自己触发的构建、格式化或测试输出反复把自己叫醒，同时每批通知会标明过滤了多少条，让你分清无事发生与是 Agent 自己写的。

交付方式可按监视单独选择：默认 wake 会发起新回合，queue 则只注入消息、不打断当前节奏。还提供即时检查、手动触发投递、列表与解除等工具，配合静默期、冷却与批量上限，适合需要长时间挂着监视又不想被频繁变更淹没的长会话工作流。

适合在本地或共享工作区里让 Agent 被动跟进外部流水线、协作改动或后台任务结果的人，尤其是你希望文件变了 Agent 就知道，而不是每隔一会儿主动扫一眼目录的时候。