SSFramework v0.1.6 — 统一普通 Git 安装入口

手动接入和安装工具现在统一使用普通 Git 地址：

https://github.com/heroliss/SSFramework.git

首次解析默认分支 main 的最新提交，无需修改地址中的标签。Unity 仍在 Packages/packages-lock.json 中记录实际提交；清单和锁文件应一起提交。更新时在 Package Manager 再次添加同一地址，然后核对和验收。安装工具重复运行保留已有来源与版本，不会静默升级已有工程。

包自身的版本号、不可移动的发行标签与第三方依赖版本继续保留，用于追踪、复现和回退。联网预检也已改为检查 main 的包元数据。

• SSFramework-Setup.zip：更新后的安装、自检工具和 Git / AI / C# 10 模板。
• SSFramework-Fonts-zh-CN.unitypackage：与 v0.1.5 完全相同的可选字体包；不需要重新导入已安装的字体。

Windows PowerShell 5.1 / PowerShell 7 各通过 30 组安装回归，包含真实消费工程只读预览及清单副本验证；普通地址与 main 元数据通过真实联网预检。框架 src/ 与依赖声明未变化，继续沿用 v0.1.2 运行时和 v0.1.5 字体的验收范围，本次不重复全套框架测试或 Player 构建。

接入与升级 · 工具说明 · 可选字体

SSFramework v0.1.5 — 可选中文字体资源

本版增加独立可选的简体中文字体包，让新项目可以直接接入 TMP / UGUI 和 UI Toolkit 中文显示；同步补充安装助手提示、字体接线说明与维护配方。

• SSFramework-Setup.zip：安装工具、自检入口与 Git / AI / C# 10 模板。完整解压后运行；无需先添加 Framework。
• SSFramework-Fonts-zh-CN.unitypackage：Noto Sans SC Regular 2.004 原始 OTF、TMP / TextCore 动态字体资产、OFL 许可及说明，约 6.83 MiB。字体是单独可选下载，不随 UPM 强制安装，不自动改写全局默认字体。

字体使用：TMP 项目先导入 TMP Essential Resources，再通过 Assets → Import Package → Custom Package 导入字体包；按 UI 后端选择对应字体资产。详见字体接入说明。本包优先采用简体中文地区字形，不承诺完整中日韩、所有生僻字或 Emoji；源字体及生成资产使用 OFL 1.1，附带版权与许可。

在真实 Unity 6000.3.23f1 消费工程完成导出后重新导入、GUID / 材质 / 源引用、空动态图集、字体链应用及释放还原检查。TMP 与 UI Toolkit 均通过 Editor 显示和非 Development Windows x64 IL2CPP Player 的可见画面验收；构建 0 错误 / 0 警告，RTX 3070 上运行无错误、退出码 0。早先隐藏窗口截图失败的报告保留为排查证据，最终使用独立的可见窗口报告。字体配方通过七项检查，归档检查拒绝五种损坏样例；Windows PowerShell 5.1 / PowerShell 7 各通过 20 组初始化、30 组安装、17 组包源回归。

src/ 与第三方依赖声明和 v0.1.2 保持一致；本次没有重新运行全套框架测试，既有资源加载验收范围见接入指南。已经接入的工程无需为使用字体包或外部工具而升级 UPM；新接入工具默认固定 v0.1.5，重复执行保留已有版本。

安装方式与验收 · 工具说明

附件 SHA-256：

9066c1801fc2b6272a717532935c0924b6d6fdb9171503218ca1a57b1d17f89b  SSFramework-Setup.zip
c4d82b944a83b22c15f413602e84ee95320af3e7d38617e98830ce9b76f64811  SSFramework-Fonts-zh-CN.unitypackage

SSFramework v0.1.4 — 配置自检与可选项目初始化

v0.1.4 增加安装后配置自检，以及可选 Git / AI 文件初始化。框架 Runtime、Editor 源码与第三方依赖继续与 v0.1.2 一致；已有项目可以直接使用新版外部工具，无需为此升级 UPM 包。

• Setup-SSFramework.cmd：新增 Git 配置和 AI 协作入口选项。交互模式按已有文件推荐创建缺失项或跳过，输入 y 才应用；非交互模式默认跳过这两项。
• Check-SSFrameworkProject.cmd：只读检查清单和锁记录、Scope 路由、业务 C# 10 配置、HybridCLR Enable 选择及项目规则文件。显示问题和下一步，也支持 JSON 输出。
• ZIP 附带 .gitignore、.gitattributes 和通用 AGENTS.md 模板，支持完全手动采用。已有规则不覆盖，不自动初始化 Git 或启用 LFS。
• 模板与包配置统一预览和应用。覆盖模板缺失、目录冲突、并发新建和后续写入失败回滚；缺少完整模板时在写入前停止。
• 同步 README、手动安装说明、工具说明，收尾已完成的初始化方案；安装器默认固定到 v0.1.4，重复运行仍保留工程已有版本。

验证：Windows PowerShell 5.1 / PowerShell 7 分别通过 20 组自检与初始化、30 组安装、17 组包源回归，安装与包源测试含真实消费工程只读预览及清单副本写入。候选工具先在真实消费工程验证，仅创建缺失的 AGENTS.md，已有 Git 规则、清单、锁文件和业务响应文件逐字节保留，再次应用无写入。

文件自检不运行 Unity、不联网、不写工程；RequiresUnityVerification 始终为 true，不用锁记录或文件检查替代下载、编译、场景和 Player 验收。另一个已有消费工程文件检查为 0 项错误、0 项需处理；独立首次安装工程正确提示尚未明确 HybridCLR Enable。

本轮没有重新运行 Unity 或构建 Player，沿用相同框架源码的 v0.1.2 资源包与非 Development Windows x64 IL2CPP 验收。字体、完整项目目录初始化和可独立安装的运行时模块仍未提供。

下载工具 ZIP · 工具说明 · 手动安装

固定 Git 地址：https://github.com/heroliss/SSFramework.git#v0.1.4。

SSFramework v0.1.3 — 首次安装验证与项目 Git 模板

v0.1.3 改善新工程的安装指引，补充可手动采用的 .gitignore 和 .gitattributes 模板。框架 src/ 和第三方依赖声明与 v0.1.2 一致；已经接入的项目无需重新迁移业务代码。

• Git 模板随接入工具 ZIP 提供。可复制到新 Unity 工程根目录；已有规则应对比后手动合并，安装器和 UPM 均不会自动覆盖。
• 模板忽略 Unity / IDE 缓存和构建输出，保留源码、meta、包清单 / 锁文件和 ProjectSettings；不默认启用 Git LFS 或 Unity 合并驱动。
• 修正工具将发行标签称为“待验收提交”的旧提示，将文档链接改为 main，并明确工程 Git / AI 规则的配置边界。
• 安装工具默认使用 v0.1.3；重复运行仍保留工程已有版本，不自动升级。

已使用 Unity 6000.3.23f1 新建独立空工程，从公开 v0.1.2 安装工具开始，配置包源、C# 10，并用单独的空 UPM 缓存解析依赖。基础验证通过：业务 record struct、关闭 Trace 时跳过消息求值、Context / Command / Event、资源 Provider 声明和 linker 回调，Unity 退出码 0。额外验证脚本的两处命名冲突已修正；未改写 Framework 或第三方包缓存。此轮网络使用验证进程的代理设置。

Git 模板在同一消费工程验证了 15 个忽略路径、13 个保留路径、5 项属性约定和二进制 .asset 保真。更新后的安装器分别在 Windows PowerShell 5.1 / PowerShell 7 通过 30 组回归。

目标资源包和非 Development Windows x64 IL2CPP Player 沿用相同框架源码的 v0.1.2 验收。本轮不新增图形、输入、字体、HybridCLR 或 Host/CDN 验收；签名提示仍由 Unity 展示，新项目仍需自己的场景和构建验证。

接入工具 ZIP · 手动安装说明 · Git 模板用法

固定安装地址：https://github.com/heroliss/SSFramework.git#v0.1.3。已有项目可以显式更新，核对并提交清单与锁文件；仅想采用 Git 模板时不需要升级包。

SSFramework v0.1.2 — 资源打包与 IL2CPP 裁剪修复

通过 Git / UPM 安装框架后，普通 IL2CPP 构建可能成功，但运行时资源初始化报“没有注册默认资源 Provider”。原因是 Package 内的 link.xml 未进入 UnityLinker，反射装配的 YooAsset Adapter 被裁剪。v0.1.2 修复了这条构建与运行路径。

• Framework Editor 构建回调自动汇总目标平台 Module 自带的保留规则，通过源码 Catalog 定位 Package 文件；无需手动复制到 Assets。
• 保留规则仍归各 Module 管理，删除 Module 后清除旧的汇总内容；无效 XML 会阻止构建并指出来源。
• 更新手动接入、资源构建与 Player 验收说明，接入工具默认固定到 v0.1.2。第三方依赖版本和 Runtime API 保持原有契约。

验证使用真实 Unity 6000.3.23f1 消费工程：574 项 Editor 测试分批通过（564 项既有测试 + 10 项新增回归），15 项 YooAsset PlayMode 测试通过。资源构建与非 Development Windows x64 IL2CPP 构建均为 0 错误 / 0 警告；解压后的 Player 在 RTX 3070 上通过计数命令、Offline 资源加载 / 释放 / 再加载、文本与 URP 材质检查，退出码为 0，可见画面截图检查通过。

接入工具的 30 组安装测试和 17 组包源测试分别在 Windows PowerShell 5.1 / PowerShell 7 通过。Player 验证源码为 b07620359798f02e421f3a68b8f91a409bfa8c0d；此发行版的 src/ 与其一致。本轮不覆盖 HybridCLR 代码热更新、Host/CDN 更新、其他平台 / 显卡或大规模 ECS 仿真；此前 769 项 PlayMode 全量结果属于 v0.1.1 的历史验证。

安装方式可自由选择：

• 下载接入工具 ZIP：解压后关闭目标 Unity 工程，运行 Setup-SSFramework.cmd，核对预览再应用。无需先安装框架；已有 Framework 版本会保留，工具不会自动升级已有工程。
• 手动安装与升级：配置包源后，在 Unity Package Manager 添加 https://github.com/heroliss/SSFramework.git#v0.1.2。已有工程也可用此地址显式升级，再核对并提交清单与锁文件。

不做代码热更新时继续关闭 HybridCLR 的 Enable。使用完整 Framework Editor Module 即可获得本次裁剪修复；物理删除该模块的精简工程需要提供等价保留入口。

SSFramework v0.1.1 — Unity 6.3 接入与 C# 10

新工程可选择完整手动接入，或下载下面的 SSFramework-Setup.zip 一次配置 Framework、OpenUPM 包源、可选 Unity MCP 和业务 C# 10。先运行工具，再打开 Unity；无需先安装 Framework。

本版补齐 UPM 依赖，框架每个程序集默认 C# 10；修正 Command 的 View 权限说明、UI 生命周期边界、自检异步结果和 Editor 对消费工程布局的假设。YooAsset 测试自行准备临时资源与收集器，恢复使用者原配置。工具提供推荐选项、变更预览、精确备份、重复运行保护和失败回滚，已有版本不会自动升级。

手动简便入口：https://github.com/heroliss/SSFramework.git

固定本版：https://github.com/heroliss/SSFramework.git#v0.1.1（也是工具默认值）。标签不再移动；UPM 锁文件记录实际提交。第三方依赖仍固定兼容版本。

完整安装说明 · 工具用法与恢复

验证：真实 Unity 6000.3.23f1 消费工程，Editor 564/564、PlayMode 769/769，零失败、零跳过；Windows x64 IL2CPP Development 构建 0 错误 / 0 警告，程序内 UI → Command → 状态 → HUD 交互通过，进程退出码 0。安装工具的 30 组接入和 17 组包源测试分别通过 PowerShell 5.1 / 7。源码验证提交为 0d8e5b4；发行仅追加安装入口与发布说明。

当前目标为 Unity 6.3 LTS。YooAsset / HybridCLR 仍随整包安装；暂不做热更新时手动关闭 HybridCLR Enable。字体与项目目录模板尚未内置。HybridCLR 热更新、YooAsset 离线/Host 内容、真实设备输入及大规模 ECS 性能仍由消费项目验收。