# FlowScope Game Core P1 生产化需求

## 目标

P1 在 P0 核心接口稳定后推进，目标是补齐第一批生产化扩展点，而不是扩张成完整框架生态。

## 本轮范围

- `IResourceBackend` 与 Addressables 独立适配。
- `IConfigSource` / `IConfigParser` 配置扩展点。
- `ISaveMigration` 存档迁移扩展点。
- `IUIScreenNavigator` 与 Panel 预加载。
- MainMenuP0 样例验收升级。
- 使用规范文档。

## 已完成

- Runtime 资源核心已拆为 `ResourceService` + `IResourceBackend`，Addressables 适配移动到 `FlowScope.Addressables` 独立 asmdef。
- 配置系统支持 source/parser 组合，旧 `Mapping<T>(fileName, loadTextAsync)` API 保持可用。
- 存档序列化支持版本 envelope 和连续 migration chain，旧 raw JSON 按版本 1 读取。
- UI 增加 `UIPreloadService` 与 `UIScreenNavigator`，并保持 `UIManager` 层内 LIFO 规则。
- MainMenuP0 样例升级为 P1 装配方式，覆盖启动、点击、保存恢复和资源释放测试。
- 新增运行时使用规范与样例验收指南。

## 未进入本轮

- Luban 完整接入。
- YooAsset / AssetBundle 后端实现。
- 云存档。
- AudioMixer / 3D 音频。
- Package 分发。
- URL 式 UI 路由、跨 Feature 页面恢复和完整页面栈框架。

## 当前验收状态

代码级编译验证中，`FlowScope.Runtime`、`FlowScope.Tests.EditMode` 和 `FlowScope.Tests.PlayMode` 均可通过；仍存在 Unity 生成项目的引用版本冲突 warning。

`packages-lock.json` 已包含 Addressables 相关包，旧的 PlayMode 编译阻塞已解除。完整 Unity Test Runner 与 MainMenuP0 人工场景验收仍需要单独补跑，不能仅用 `dotnet build` 替代。