Changelog

本文件记录 ShrinkEventBus 在当前工作区中的包内变更。

[2.0.1] - 2026-08-28

ShrinkEventSubscriberAttribute 新增显式 Lifetime，选择 AwakeToDestroy 的 MonoBehaviour 会由 ILPostProcessor 在编译期织入生成绑定的 Attach 与 Dispose，禁用对象时保持订阅，销毁时自动释放。
自动生命周期支持已有或缺失的 Awake / OnDestroy，并保留可重写基类生命周期调用；默认仍为 Manual，避免既有 2.0 使用方升级后重复订阅。

新增统一 IShrinkEvent 契约、ShrinkEventSubscriber / ShrinkSubscribe 特性与 Post / PostAsync 入口。
新增命名多 Bus：Game、Scene、Mod、World、Server 及自定义 ShrinkBusKey。
Bus 创建时可选择 Inline、Unity MainThread、DedicatedThread 或 TaskPool 调度器，并支持有界队列、溢出策略、最大并发与关闭排空。
Unity 中异步 handler 与调度优先使用 UniTask；新增 ShrinkMonoEventScope 管理普通 MonoBehaviour 的绑定生命周期。
ILPostProcessor 为特性标记的普通 C# / Mono 类型生成 IShrinkGeneratedSubscriber 强类型绑定，发布热路径不使用反射调用。
新增可选 com.cneicy.shrink-eventbus-entities 包，Burst Job 通过 NativeQueue writer/playback 进入同一 Bus。
新增 Tools~/DotNet/ShrinkEventBus.Core ValueTask 运行时与 Roslyn incremental generator，纯 .NET 宿主无需 Unity 或 UniTask。
EventBus 可视化调试器使用 UI Toolkit 重写，新增 Bus 导航、实时指标、分发耗时、线程/执行模式/结果详情、问题筛选、跟随和 CSV 导出；详细采样只在窗口主动采集时启用。
新增独立 Play Mode benchmark，覆盖 0/1/8/30 handler、取消、异步和生成绑定开销。
Inline Bus 使用专用运行时实现，非取消全同步 channel 在订阅变化时生成有序 multicast dispatcher；ShrinkPostResult 压缩为 32-bit 状态，保持 API 不变。

删除 EventBase、EventBusSubscriber / EventSubscribe、RegisterEvent / SubscribeEvent / TriggerEvent、手工 Delegate 注册和旧反射通道。
所有事件改为实现 IShrinkEvent；取消和结果分别实现 IShrinkCancelableEvent、IShrinkResultEvent<TResult>。

移除 EventBase.GetListenerList()。事件对象不再内置 ListenerList，改为持有派发时的快照数组；调试请使用 GetSubscribers()（现在返回拷贝）。
数字优先级 0 现在映射到 NORMAL（原为 LOW），与枚举重载的默认值保持一致。
所有 int 数字优先级重载（RegisterEvent / SubscribeEvent）不再提供默认值 0，必须显式传入数字——消除与枚举重载之间的重载二义性。不带优先级的调用现在唯一解析到枚举重载（NORMAL）。

织入前会检查类型自身及基类链上是否存在实例 [EventSubscribe] 方法，没有的类型不再织入，避免在 Awake 中抛出注册异常。
AutoRegister（含 Mod 框架反射路径）遇到没有任何匹配 [EventSubscribe] 方法的类型时，改为输出警告并跳过，不再抛异常；显式 Register() 仍保持严格抛错。
ListenerList 父子链脏标记传播与快照重建之间的竞态：同一总线内所有监听列表（含父子链）现共用一把锁。
RegisterCore 的 check-then-act 竞态（并发下同一实例可能被注册两次）。
EventPool.Release 的双重归还竞态；对象池增加容量上限（128），超出直接丢弃。
父子事件同 phase 内的 handler 顺序：现在按数字优先级跨父子稳定归并（平局时子类型 handler 在前），数字优先级不再只在单层内生效。

派发热路径重构：事件对象的监听者快照从“逐个带锁二分插入内置 ListenerList”改为一次数组引用赋值；EventId 改为懒生成；事件元数据缓存改用 ConcurrentDictionary。每个事件实例的构造分配显著减少。
删除死代码 EventCache<T>（README 此前描述的“泛型静态缓存热路径”自实例化总线改造后已不存在）。
恢复模块内 CodeGen/ 作为可选本地织入管线：命中 ShrinkShared.CodeGen 覆盖范围的程序集继续由共享管线优先处理，其余只引用 ShrinkEventBus.Runtime 的程序集改由本地 EventBusILPostProcessor 兜底，避免 [EventBusSubscriber] 自动注册失效。
GetEventSubscribers / GetAllSubscribersSnapshot / EventBase.GetSubscribers 返回内部快照的拷贝，外部修改不再影响派发顺序。
SetPhase / IsCanceled / Result 的校验异常现在携带具体错误消息。
ILPP 的诊断列表与程序集解析器改为调用内局部状态，消除共享实例并发隐患。

MonoBehaviour 自动注册/反注册的 IL 织入已并入共享 ShrinkShared.CodeGen 管线；当前工作区同时保留 ShrinkEventBus 本地 CodeGen/ 作为可选兜底，以兼容纯 ShrinkEventBus.Runtime 引用程序集。
保留现有 [EventBusSubscriber] 用法与自动生命周期行为，不要求业务层改写订阅代码。

运行时总线升级为“默认静态门面 + 可实例化 IShrinkEventBus/Builder”双层结构，支持异常策略、事件类型校验、按 phase 分发。
手动注册能力从纯 delegate 扩展为 object / Type / MethodInfo 三类入口，并在注册阶段严格校验签名、静态/实例模式和事件参数类型。
ListenerList 改为按 phase 分桶 + 快照缓存模型，并支持父事件监听子事件。
事件查看器不再反射私有字典，改走公开快照接口。
EventBusBenchmark 扩展为覆盖实例 bus、扫描注册、继承监听、phase 分发、对象池与取消事件跳过等关键场景。