36 lines
3.0 KiB
Markdown
36 lines
3.0 KiB
Markdown
# 阶段4A实施任务书（已批准实施）
|
||
|
||
> 实施进度：本轮已完成全部检查点，合成18组及既有回归/Unity通过；限定自审完成，等待用户指定外部AI实施复核。见《阶段4A交付与验收矩阵-2026-09-23.md》。本文件保留已批准任务书，实施结果不等于4B启用。
|
||
|
||
日期：2026-09-23。状态：**原设计、3C前置及构建依赖差异补审全部通过，主会话已批准实施。** 文件名保留方便既有链接访问。裁决见《3C补验收与4A方案审查裁决-2026-09-23.md》。
|
||
|
||
## 前置门
|
||
|
||
- [x] 3C复核R1–R5修复、逐行补验收、外部复核及主会话终审裁决完成，3C/G3通过。
|
||
- [x] 其他AI审查4A方案、文件边界、生命周期和A1–A12验收矩阵，结论通过。
|
||
- [x] 主会话逐条裁决4A设计审查发现，无新增P1/P2，B-S1–B-S3全部采纳；原设计结论继续有效；3C已另行终审关闭。
|
||
- [x] 构建依赖差异外部补审PASS，主会话已裁决，见《阶段4A差异裁决与实施批准-2026-09-23.md》。
|
||
- [x] 本任务书改为“已批准实施”。
|
||
|
||
## 检查点
|
||
|
||
1. 记录生产hash、现有3C修复版本、允许文件和测试基线；建立独立`KVGameBridgeTests`，显式链接真实生产源码。
|
||
2. 新增Owner读取结果类型和受租约保护的ReadLocalSnapshot，验证Ready/非Ready、快照不可变、Close竞争；不打开第二个State。
|
||
3. 实现桥接和固定句柄：Open/Close串行屏障、排队取消、旧句柄拒绝、旧session提前失效。异常不得遗失正在收尾的owner和Task。
|
||
4. 用受控传输闸门执行A1–A12；逐项记录实际断言，不以总组数替代。
|
||
5. 执行42/86/29、3C离线和Unity CLI Loop；生成源码hash、日志和实施报告。4A无需正式服运行或打包。
|
||
6. 停止开发并准备实施后限定代码审查；通过不代表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见[构建依赖最小差异方案](阶段4A构建依赖最小差异方案-2026-09-23.md)。该扩展现已获准，属于当前可修改白名单。补充KVSyncCoordinatorReviewTests回归与csproj最小差异验收。
|
||
补审P3采纳：A12增加KVLiveTests仅构建验证，不运行；生产边界不扩大。 |