Worker 模式或 Chain 模式的应用场景以及使用注意事项

[degent007]

Worker 模式或 Chain 模式的应用场景以及使用注意事项

[nevstop]

[nevstop]

@degent007 工作者模式机器人的回复是正确的，但是关于责任链模式的描述是错误的... 责任链模式组成串后，只会由最低可处理权限的节点处理，之后的节点将不会处理消息。例如：Chain由 chain$1 chain$2 chain$3 组成, 其中 chain$2 chain$3 都可以处理 message1 ,chain$1 不可以，那么 message1 会被丢给chain$2 处理，其他的并不会收到消息。这个讨论会丢给AI，补充到 csm-wiki 中，抱歉带来误解。

[nevstop]

正确的相关描述： @degent007

CSM 框架提供了责任链模式 (Chain Mode)，用于按优先级静态路由消息。

一句话结论

• 责任链模式用于按优先级静态路由消息，框架根据注册表将消息直接投递给优先级最高且能处理该消息类型的节点，消息只被一个节点处理，无节点间传递或降级。
• 核心注意事项：Chain 模式必须通过 Chain 名称发送消息，节点命名使用 $ 后缀加数字表示优先级（数字越小优先级越高），框架自动路由到优先级最高的可处理节点。

应用场景

模式	核心机制	典型应用场景	并发性
责任链模式 (Chain Mode)	每个节点通过 $ 后缀声明优先级并声明自己能处理的消息类型。框架为每个 Chain 维护注册表（消息类型 → 该 Chain 下能处理此类型的节点优先级列表）。向 Chain 发送消息时，框架直接选择优先级最高的节点投递，消息不经过其他节点。	1. 不同功能的模块组成更大功能集合（如一个 Chain 包含加、减、乘、除节点，外部调用加法消息自动路由到加法节点）；2. 功能覆盖（相同功能的多个模块按优先级决定最终行为，高优先级节点生效，低优先级节点被覆盖）。	单节点处理（每个消息只被一个节点处理，无并发）

使用注意事项与最佳实践

责任链模式 (Chain Mode)

1. 命名规则：节点模块必须使用 $ 后缀加数字来声明优先级，格式为 ChainName$优先级数字。例如，DataProcessor$1、DataProcessor$2，数字越小优先级越高。所有同名的 ChainName 节点共同组成一个责任链。
2. 注册表与静态路由：框架会为每个 Chain 维护一个注册表，记录该 Chain 下所有节点的优先级以及每个节点能处理的消息类型（方法名）。当你向 Chain 名称（例如 DataProcessor）发送消息时：
   • 框架根据消息的方法名，从注册表中查找所有能处理该方法的节点。
   • 从这些节点中选出优先级最高的一个（数字最小）。
   • 将消息直接投递给该节点，消息不会在节点间依次传递，节点内部也不会进行“接受/拒绝”判断并降级。处理节点在链组成时已由优先级静态确定。
   • 若没有任何节点能处理该消息，则消息被丢弃或报错（取决于框架配置）。
3. 通讯限制：必须通过 Chain 名称发送消息，不能直接向单个 ChainName$N 节点发送消息。发送同步消息使用 -@ ChainName，异步消息使用 -> ChainName。
4. 适用场景：
   • 不同功能的模块组成更大功能集合：例如将加法模块、减法模块、乘法模块、除法模块组合成一个名为 Calculator 的 Chain。外部发送 Add 消息时，框架自动路由到加法模块；发送 Multiply 消息时路由到乘法模块。外部调用者无需知道内部具体模块，只需与 Chain 交互。
   • 功能覆盖（优先级覆盖）：多个模块实现相同功能但版本或策略不同。例如，Auth$1 使用新版验证算法，Auth$2 使用旧版算法。由于 $1 优先级更高，所有 Authenticate 消息都会由 Auth$1 处理，Auth$2 永远不会收到消息（除非 Auth$1 被卸载）。链的整体行为等于优先级最高的那个能处理该消息的节点。