用途：在 Flutter 项目中设计、实现和测试基于 bloc 与 flutter_bloc 库的状态管理。适用于新建 Cubit/Bloc、选择状态建模方式（sealed 类或带状态枚举的单类）、接线 BlocBuilder/BlocListener/BlocConsumer/BlocProvider、编写单元测试、在 Cubit 与 Bloc 之间取舍，以及按 bloc 约定重构既有状态管理。
主要能力与约定：默认优先 Cubit，需求复杂或需事件可追溯时改用 Bloc，高级事件处理（防抖、节流）用带事件转换器的 Bloc。命名遵循事件用过去式、状态用名词，基类为 BlocSubjectEvent/BlocSubjectState。状态可选用 sealed 子类（类型安全穷尽 switch）或单类加 status 枚举；两者都需继承 Equatable、把所有相关字段放入 props、用 @immutable 标注、每次 emit 新实例，bloc 会忽略重复状态。Cubit 公开方法只返回 void 或 Future<void>，业务逻辑不放 UI。Bloc 通过 bloc.add(Event()) 触发，事件处理器私有。架构分三层：表现层、业务逻辑层（注入仓库）、数据层（仓库包装数据提供者）；bloc 不直接访问数据提供者，bloc 之间不直接通信，通过 UI 的 BlocListener 桥接。使用 context.read 在回调中读取，context.watch 仅在 build 内必要处使用。测试使用 bloc_test 与 mocktail，须 tearDown 关闭 cubit，用 blocTest 断言状态序列，自定义类型需注册回退值。
使用方式与限制：资料未提供安装命令或具体运行步骤；完整代码示例较长，此处未抄录。常见陷阱包括重复 emit 同一实例、回调中用 watch、遗漏 Equatable props、可变状态字段、把业务逻辑写进 widget。参考为 bloc GitHub 仓库。