Workspace/Assets/Modules/ShrinkModFramework/CHANGELOG.md

Changelog

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

[Unreleased]

Added

• 新增 ShrinkModContextHost / ShrinkModComponentSource，把模组生命周期、Registry、Network handler 与 Harmony lease 纳入可逆组件事务。
• 新增真实外部 DLL fixture 测试，覆盖失败替换恢复、损坏文件、依赖缺失、watcher 去抖与删除卸载。

Changed

• ShrinkModLoader 默认使用 ContextHost；外部 DLL 以 SHA-256 作为 revision，同内容幂等。
• watcher 监听新增、修改、删除与重命名，并把 burst 文件事件折叠为一次主线程组合提交。

Fixed

• 新模组 apply 失败时同时恢复旧组件组合和外部 DLL revision 缓存，避免失败程序集继续被当作当前版本。
• 删除 DLL 时同步清理程序集解析路径缓存；EditMode 创建 watcher driver 时不再调用 DontDestroyOnLoad。

[0.1.0] - 2026-04-07

Added

• 建立模组声明与生命周期基础：[ShrinkMod]、[ShrinkModDependency]、IShrinkMod、ShrinkModBase、ShrinkModLoader、注册表与运行时设置。
• 默认启动入口改为 [RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.AfterAssembliesLoaded)] 自动引导，不再强依赖场景内手挂 bootstrap。
• 支持扫描和增量装载外部 DLL 模组。
• 预留可选 Harmony 热补丁与模组网络同步抽象层。
• 新增 ShrinkSDK/Mod/导出 Mod SDK 开发包，可导出给外部模组开发者使用的 GeneratedModSdk/。
• 新增 ShrinkSDK/Mod/生成仓库内模组模板(推荐)，可在当前 Unity 工程内快速生成模组模板。
• 新增 ShrinkSDK/Mod/生成外部模组模板，可生成独立 DLL 模组工程。

Changed

• 运行时目录结构统一拆分为 Bootstrap / Core / Metadata / Registry / Loading / Network / Integration。
• README 同步更新新的目录结构、模板入口、SDK 导出方式与推荐工作流。