用途:在编写或审查 QFramework 架构代码前查阅的规则文档,全部规则提炼自官方源码与教程,并标注文件/行号;遇到分歧以 QFramework.cs 源码为准,Doc.md/API.md 仅供交叉印证(教程可能滞后)。
主要能力:覆盖 Architecture<T> 的 Init 启动逻辑与 RegisterSystem/RegisterModel/RegisterUtility;IController/ISystem/IModel/IUtility 接口实现与 ICan* 能力接口增删;SendCommand/SendQuery/SendEvent/RegisterEvent 与 ICommand/ICommand<TResult>/IQuery<TResult>;BindableProperty/BindableList/BindableDictionary 的声明与 Register/RegisterWithInitValue/Comparer;TypeEventSystem/EasyEvent 注册与手动注销;覆写 ExecuteCommand 做 Command 拦截;数据放 Model 还是留在 MonoBehaviour 的判断;核心 IOCContainer 与 Toolkits IOCKit 选型;Toolkits 安装形态与版本核对。
关键约定:Register* 自 2026-08-12 起返回注册实例本身,Doc.md 旧示例仍丢弃返回值,属过时写法;四层职责遵循 IController 改状态走 Command、下层通知上层用 Event 或 BindableProperty、上层可直接获取下层、Command/Query 无状态,作者允许按需放宽;仅时间共享、物理共享、配置表三类数据放 Model;BindableProperty 靠 Comparer 判等后触发;事件工具在 TypeEventSystem/EasyEvent/架构内建 SendEvent 三选一,手动注销须用具名方法;核心 IOCContainer 与 Toolkits IOCKit 是两套独立实现,不可混淆;Toolkits 以 unitypackage 导入 Assets,无 UPM。
适用场景与限制:属于只读文档模块,无 REST 技能需 gate,任意模式下可自由加载;REST 端点层调用请改用对应 REST 模块。已知缺口:LocaleKit 教程几乎零覆盖,FluentAPI 方法清单未逐条收录。版本锚定 v1.0.257,Toolkits 实际版本以 PackageKit 面板或 PackageVersion.json 为准,可能领先于本模块快照。