dsh-event-auditor

在 DeepSeek Harness 中编写插件时，事件流是核心通信机制——agent 生命周期、会话流转、工具调用、subagent 派发、配置变更，以及 tools/execute、approval/request、llm/stream 等 waterfall 透传节点，每一步都决定了插件的实际行为。然而这些事件散落在源码各处，缺少统一的观察窗口，调试往往只能靠反复打断点或翻阅日志。dsh-event-auditor 把 22 个 harness emit 事件和 10 个 waterfall 事件集中到一个客户端面板里，按事件名与分发模式实时计数，环形缓冲保留最近 500 条原始记录，并暴露带 ?since= 增量参数的 JSON 接口，让开发者既能直观看趋势，也能程序化拉取明细。

除了被动观察，它还提供分组开关（agent、session、tools、subagent、config、waterfall 各自独立启停，config 默认关闭以减少噪音）、settings 面板热改（installSettingsSection 实时切换分组无需重启服务），以及 headless 模式下通过 DSH_EVENT_AUDIT_DUMP 一次性导出完整事件快照，方便在无浏览器的 CI 或远程容器中做事件回归。

它适合正在为 Harness 开发或调试插件的工程师：当你不确定某个工具调用是否真的走到了 tools/execute、subagent 会话的生命周期是否符合预期、或者配置热更新后事件分发模式是否发生变化时，打开 /audit 面板即可一目了然，而不必再逐行翻源码确认 emit 调用位置。