Files
ft/CodexOutput/upserver/阶段4A实施任务书-待评审-2026-09-23.md

3.0 KiB
Raw Blame History

阶段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》。
  • 本任务书改为“已批准实施”。

检查点

  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见构建依赖最小差异方案。该扩展现已获准,属于当前可修改白名单。补充KVSyncCoordinatorReviewTests回归与csproj最小差异验收。 补审P3采纳:A12增加KVLiveTests仅构建验证,不运行;生产边界不扩大。