Sakura Framework 15 分钟快速开始

先取得可预览、可确认、失败关闭的图形化入口，不直接手改整份 manifest。

1. 在 Package Manager 中选择 Add package from git URL。
2. 粘贴页面提供的 Editor Tools 开发 / 评估 URL，等待 Unity 完成解析与编译。
3. 打开 IrisSakura / Sakura Framework / Developer Console。

完成标准Developer Console 能打开，Console 中没有由包解析产生的新编译错误。

用最小闭包确认 UPM 解析、基础契约和脚本编译，再继续增加运行时服务。

1. 在 Newcomer Guided Entry 中选择 Simple 2D Quickstart。
2. 预览 Core Only 路线和将要写入的依赖，不在未确认时应用修改。
3. 显式确认后等待 Unity 完成导入与编译。

完成标准Core Only 路线中的包均已解析，项目仍能无新增错误地完成脚本编译。

一次性安装已复核的最小稳定组合，避免手工猜测 Event 的内部依赖。

1. 在同一向导中预览 Bootstrap Lite 的完整包闭包。
2. 确认清单只包含下方从 adoption 注册表派生的 Supported 包。
3. 显式确认安装并再次等待脚本编译结束。

完成标准Bootstrap Lite 的四包闭包全部可解析，且没有引入 Preview 或 Experimental 包。

使用引擎无关 Event Core 做一次订阅、同步派发、退订与清理。

1. 把示例放入项目脚本，并从自己的启动或测试入口调用 QuickstartEventProbe.Run。
2. 确认返回值为 true；监听器必须同步消费事件，不能保留已被派发流程回收的事件引用。
3. 保留 RemoveListener 与 Clear，避免把教程探针变成长期订阅。

using System;
using Framework.Event;

public static class QuickstartEventProbe
{
    public static bool Run()
    {
        var events = new EventService();
        var received = 0;
        Action<PingEvent> listener = _ => received++;

        events.AddListener(listener);
        events.TriggerEvent(new PingEvent());
        events.RemoveListener(listener);
        events.Clear();
        return received == 1;
    }

    private sealed class PingEvent : IEvent
    {
        public string EventName => nameof(PingEvent);
        public DateTime TriggerTime { get; set; }
    }
}

完成标准事件只被接收一次，监听器已移除，EventService 已清理。

使用 Pooling Core 验证一次 Get、Release、活动计数归零与 Clear。

1. 把示例放入项目脚本，并从自己的启动或测试入口调用 QuickstartPoolProbe.Run。
2. 确认对象被使用一次，Release 后 CountActive 为零。
3. 探针结束时调用 Clear，不把临时对象留给后续场景。

using Framework.GameHelper;

public static class QuickstartPoolProbe
{
    public static bool Run()
    {
        var pool = new ObjectPool<Token>(() => new Token(), defaultCapacity: 1, maxSize: 4);
        var token = pool.Get();
        token.UseCount++;
        pool.Release(token);

        var passed = token.UseCount == 1 && pool.CountActive == 0;
        pool.Clear();
        return passed;
    }

    private sealed class Token
    {
        public int UseCount { get; set; }
    }
}

完成标准探针返回 true，对象已归还且活动对象计数为零。

以可观察结果收尾；需要更完整的 Preview 诊断时，再导入 Runtime Starter。

1. 重新触发脚本编译，确认 Event 与 Pooling 探针都返回 true。
2. 如需继续评估，在 Developer Console 中导入 Runtime Starter Sample，先运行 Doctor 再打开 Sample Scene。
3. 确认 Event、Pooling、Save 必须通过；Config / Audio 仅在项目资源缺失时允许结构化 Skipped。
4. 完成后删除教程探针；Runtime Starter 只按 owner token 清理自己的临时数据。

完成标准编译通过、事件往返为一次、对象池活动计数为零，所有临时订阅和探针资源均已清理。