3.0 KiB
3.0 KiB
阶段4A实施任务书(已批准实施)
实施进度:本轮已完成全部检查点,合成18组及既有回归/Unity通过;限定自审完成,等待用户指定外部AI实施复核。见《阶段4A交付与验收矩阵-2026-09-23.md》。本文件保留已批准任务书,实施结果不等于4B启用。
日期:2026-09-23。状态:原设计、3C前置及构建依赖差异补审全部通过,主会话已批准实施。 文件名保留方便既有链接访问。裁决见《3C补验收与4A方案审查裁决-2026-09-23.md》。
前置门
- 3C复核R1–R5修复、逐行补验收、外部复核及主会话终审裁决完成,3C/G3通过。
- 其他AI审查4A方案、文件边界、生命周期和A1–A12验收矩阵,结论通过。
- 主会话逐条裁决4A设计审查发现,无新增P1/P2,B-S1–B-S3全部采纳;原设计结论继续有效;3C已另行终审关闭。
- 构建依赖差异外部补审PASS,主会话已裁决,见《阶段4A差异裁决与实施批准-2026-09-23.md》。
- 本任务书改为“已批准实施”。
检查点
- 记录生产hash、现有3C修复版本、允许文件和测试基线;建立独立
KVGameBridgeTests,显式链接真实生产源码。 - 新增Owner读取结果类型和受租约保护的ReadLocalSnapshot,验证Ready/非Ready、快照不可变、Close竞争;不打开第二个State。
- 实现桥接和固定句柄:Open/Close串行屏障、排队取消、旧句柄拒绝、旧session提前失效。异常不得遗失正在收尾的owner和Task。
- 用受控传输闸门执行A1–A12;逐项记录实际断言,不以总组数替代。
- 执行42/86/29、3C离线和Unity CLI Loop;生成源码hash、日志和实施报告。4A无需正式服运行或打包。
- 停止开发并准备实施后限定代码审查;通过不代表4B已启用。
文件边界与交付
仅修改PlayerKVSessionOwner.cs并新增PlayerKVLocalReadResult.cs、PlayerKVGameSessionBridge.cs及meta、KVGameBridgeTests/。禁止修改UserService/PlayFabMgr/玩法/3A State/3B Coordinator/服务器/包。新增文件位于既有PlayerData目录。
每个检查点完成后更新《开发日志.md》和4A实施记录,记录变更、命令、退出码、证据路径、未执行项和偏离。完成交付需提供完整hash、测试逐项映射、禁止字段扫描、Unity结果,以及没有访问正式服的传输边界证据。
发现接口缺口先落盘差异方案并评审,不能临时扩展文件白名单。
2026-09-23开工依赖检查补充(已批准)
新增Owner结果类型会影响3个显式源码测试项目,原文件白名单未覆盖其csproj。拟各补一条Compile引用,测试实现不改;具体文件与精确XML见构建依赖最小差异方案。该扩展现已获准,属于当前可修改白名单。补充KVSyncCoordinatorReviewTests回归与csproj最小差异验收。 补审P3采纳:A12增加KVLiveTests仅构建验证,不运行;生产边界不扩大。