阶段2独立 KV 适配验收

日期：2026-09-22。客户端 C:/projects/ft/Client；正式 API http://s101.local:18080/。

结论与开发边界

阶段2独立协议适配及本批验收通过：生产 Get/Set/Delete 客户端已实现，42 项契约测试、16 项真实服务联调检查和 Unity 编译通过。已完成独立代码审查；JSON 语法兼容性按下文裁决保留，不把它写成标准 JSON 严格校验。

尚未把游戏存档切到 KV。 PlayFab 存档入口和 SDK 仍保留；没有新增生产会话桥接、缓存同步、迁移或俱乐部功能。本批没有打包、提交或发布。最小登录已有证据继续有效，平台/UI 网络、主动推送、人工玩法/完整存档及最终渠道包仍待验收。

实施依据：阶段2启动裁决；独立报告：阶段2独立KV代码审查。每步记录在开发日志。

本批改动

新增 Client/Assets/Scripts/Services/PlayerData/PlayerKVModels.cs、PlayerKVClient.cs 及 Unity meta。
注入调用方拥有的固定会话 HttpClient；复制请求参数，不修改共享请求头/基址，不释放注入客户端，不自动重登或重试。
Get 返回只读字符串字典；失败 Data=null，明确区分合法空字典。Set/Delete 接受 HTTP 200 空响应。401/403、HTTP、网络、超时、取消、参数和协议错误分别标识。
写请求进入传输后失败，保守返回 MayHaveCommitted=true；调用方不能将失败理解为一定未写入，更不能据此盲目重试。
新增独立联调宿主 KVLiveTests，完善 KVContractTests；不修改现有游戏登录、存档和 SignalR 入口。

验收证据

项目	结果与证据	证明范围
生产源码契约测试	42项通过	.NET 9 宿主、项目 Newtonsoft、实际两个生产文件；请求/响应、快照、错误、取消、所有权
联调宿主构建	0错误/0警告	直接编译生产 KV 和 S101AccountSession 源码
正式服联调	16项通过、结果	真实 s101 网络、独立 Cookie、101/102 专用 key，非 Unity UI/真机
清理	精确manifest	两账号全部测试 key 删除后读回为空；HadUnknownWrite=false
Unity 编译	Success=true，0错误/274警告	C盘 Unity 2022.3.62f2c1 兼容编译；已有警告未清零
工具身份	CLI Loop 2.2.0及C盘DataPath	不操作D盘，不使用UnitySkills，不提高动态权限

正式联调验证：无 Cookie 的 Get/空 Set/空 Delete 拒绝；两账号 key 碰撞预检；新增、字符串/空字符串/JSON字符串原样读回、不存在 key 省略；同名 key 账号隔离；单 key 覆盖；null/空 keys 全读；空操作与删除不存在 key；每账号重新登录并新建 Cookie/HttpClient 后读回；删除101不影响102；最终清理及业务 KV 前后内存比较相同。

只写删 codex_kv_s2_20260922_3bc01858f94e4f67b984aeaae018236d_ 下四个预先列明 key。不存在 key 未实际写入。没有写删既有业务 key，不落盘 Cookie 或真实存档值。重登读回证明服务端跨客户端会话保留，不冒充数据库重启或灾备恢复测试。

Editor 在导入前已 Stop Play，本批没有重新启动游戏。独立网络测试不创建 Hub，也不替代 Unity 游戏内 KV 验收。清理已成功，无需再次执行写删。

独立评审后的明确裁决

JSON语法兼容性：接受并记录。 项目 Json.NET 允许未加引号字段、尾逗号等扩展语法，本批不添加新的解析库或手写语法分析器。“严格”只指完整单根对象、data 对象及字符串值、拒绝重复字段与尾随内容。扩展语法仍可能得到成功空 data；不是标准 JSON 全语法验证。该边界不改变有效服务器契约；阶段4必须重审空档初始化策略，禁止只凭空字典自动覆盖原档。
固定身份依赖调用方契约。 readonly HttpClient 不会自动锁定可变 CookieContainer；调用方必须每账号/环境独立 transport、禁用重定向、退出取消并等待结束后释放。测试宿主已按此实现，生产桥接仍待阶段3/4完整评审。
不声明服务端 key 大小写隔离。 客户端 Ordinal 字典不能证明 MySQL 排序规则；服务器契约未保证 A/a 是两个 key。本批测试未依赖这种行为。
不声明可靠同步已完成。 服务端无 revision/CAS，结果未知、离线脏数据、重试顺序与冲突策略属于下一阶段。

当前阶段与下一步

阶段	状态
1 映射/契约方案	已评审，本批复核
最小登录专项	核心实现与主要自动验收通过；平台/人工/最终包待验收单列
2 独立KV适配	本批实现、契约/联调/清理/Unity编译和限定review完成
3 缓存与可靠同步	下一步先完整评审方案，尚未编码
4 游戏存档切换	未开始，必须先完成3及迁移/空档保护评审
5 外围业务	SignalR基础已提前完成，其余暂停
6 SDK删除与最终包	最后执行

阶段3评审需明确：固定生产会话桥接、账号/环境缓存命名空间、读取失败禁止建空档、dirty版本与单通道写入、写结果未知后的核对策略、401/退出/换号取消边界及竞态验收。先落盘方案和评审裁决，再编码；不以本次通过自动放行游戏数据迁移或 SDK 删除。

5.7 KiB Raw Blame History Unescape Escape