/design-patterns

name: design-patterns
description: 在 BK-CI 中判断何时使用工厂、策略、责任链、观察者、模板方法、装饰器等设计模式时使用。当用户要重构可扩展结构、统一模式选型、理解项目里的模式落点时优先使用。

BK-CI 设计模式实践

适用场景

• 需要为一段可扩展逻辑选择合适的设计模式
• 需要理解 BK-CI 里某个模式为什么这样落地
• 需要重构 if-else、分发逻辑、插件扩展点、后置处理链
• 需要判断某个能力更适合用工厂、策略、责任链、观察者还是模板方法

不适用场景

• 只是查某个类、某个接口或某段代码在哪里
• 只是普通 CRUD、简单参数封装或一次性脚本逻辑
• 问题本质是模块归属、接口设计或数据库结构，不是模式选型

快速指导

1. 先判断你解决的是哪一类问题：

• 对象按类型创建：看 `reference/1-core-patterns.md` 里的工厂模式
• 多种规则按条件切换：看策略模式
• 多个处理步骤串联：看责任链模式
• 状态变化后广播处理：看观察者模式
• 固定主流程、子类只改局部：看模板方法模式
• 在原能力外叠加附加行为：看装饰器模式

2. 在 BK-CI 里，模式选择要优先服从“模块边界 + 扩展点稳定性”，不要为了模式而模式。 3. 如果只是 2 到 3 个稳定分支，且短期不会扩展，先别急着上复杂模式。 4. 如果一段逻辑需要外部扩展、插件接入、规则分发或顺序处理，优先考虑模式，而不是继续堆 `when` / `if-else`。 5. 选型前先看项目里已有落地，不要凭空造新写法。常见实例在 `reference/3-project-examples.md`。

高信号规则

• 工厂模式适合“如何创建”，策略模式适合“如何选择一种行为”
• 责任链适合“多个处理器按顺序试或继续”，不适合硬凑单一判断逻辑
• 观察者适合事件解耦，不适合强事务链路里的必须同步步骤
• 模板方法适合主流程稳定、局部差异明确的场景
• 装饰器适合附加横切能力，不适合把核心流程绕得过深

关键陷阱

• 只有两个稳定分支也强行上策略或工厂，增加理解成本
• 把责任链当作“任何流程都能往里塞”的万能结构
• 观察者乱用在需要强一致性的主业务流程里
• 模式只在类图上优雅，落到 BK-CI 实际模块时却破坏分层和边界
• 只看教科书定义，不看项目里已经存在的同类实践

延伸阅读

• 核心模式：`reference/1-core-patterns.md`
• 选型方法：`reference/2-selection-guidelines.md`
• 项目案例：`reference/3-project-examples.md`
• 如果模式已经沉淀为通用组件：再看 `utility-components`
• 如果问题偏框架实践：再看 `common-technical-practices`