类比办公楼广播：行政部对着整栋楼喊“三点消防演练”，你不需要认识行政部的每个人，只需要关心“演练”这一类消息。发件人只管广播，收件人按消息类型决定听不听。技术定义：事件是按类型组织的解耦通知单元，是插件的扩展点。dsh 把运行中的关键环节划分成不同事件领域，例如 session/event、agent/、fs/、tools/、telemetry/。插件在共享上下文上订阅某一事件类型，另一个插件触发该类型时，订阅者被依次唤醒。发出方不持有订阅者引用，订阅者也不修改发出方代码，双方只通过事件类型松耦合。事件类型就是双方约定的频道号，频道对不上，订阅就收不到。

类比群聊通知：你在群里说“发布完成了”，每个成员都收到同一条消息，各回各的，谁也不等谁，谁也不改谁。技术定义：emit 语义把事件广播给该类型下的所有订阅者。每个订阅者都拿到同一份事件；订阅者之间没有数据传递，也不依赖彼此的处理结果；某个订阅者返回了值，也不会阻止其他订阅者被唤醒——这正是它与 bail 的分界。适合“每个都该知道、彼此无依赖”的场景：执行轨迹记录、遥测上报、审计日志可以各挂各的订阅，互不干扰，加一个新的记录插件不需要改任何旧插件。

类比安检闸口：一排守卫依次检查，任何一人说“不许过”，后面的人就不用再查了。技术定义：bail 语义按订阅顺序逐个唤醒订阅者，一旦某个订阅者返回一个决定性结果——比如拒绝、放行、已处理——传播立即停止，后续订阅者不再被唤醒。它把“谁先做出决定，谁就定音”变成语言层面的保证，而不是靠每个订阅者自行判断。适合审批拦截、权限门禁、唯一处理者场景。这也是实现工具执行前授权检查的语义基础。

类比工厂流水线：拧螺丝的工位必须在装外壳的工位之前完成，顺序就是产品质量的一部分。技术定义：serial 语义让订阅者一个接一个执行，前一个完成后，后一个才开始。它保证唤醒次序，但订阅者之间默认不传递数据——顺序本身就是约束。适合必须按固定次序执行的编排：先校验、再变换、后落库；顺序一旦打乱，结果就错。判断标准：如果次序改变会改变结果，选 serial；如果次序改变不影响结果，可能根本不需要 serial。

类比瀑布下的接力磨坊：上游的水推动第一台磨，第一台磨的出水再推动第二台，能量逐级传递。技术定义：waterfall 语义在串行的基础上多一步——把上一个订阅者的返回值作为下一个订阅者的输入，逐级加工直到产出最终结果。它同时满足两个约束：次序固定，且结果在订阅者之间流动。适合逐步变换数据的编排：原始数据先清洗、再增强、后汇总，每一步的输入都来自上一步的输出。serial 只保证次序，waterfall 在保证次序的同时传递结果——这是两者唯一的区别。