docs(persistence): record import query client validation

Author: Codex

docs/current-build-validation.md

@@ -1,12 +1,13 @@
 # 当前构建与客户端验收
 
-更新：2026-10-14。负责审查 R12 的本轮交付对应、整合验证和客户端验收；
+更新：2026-10-15。负责审查 R12 的本轮交付对应、整合验证和客户端验收；
 不替代[历史 R03/R04 验收](r03-r04-acceptance.md)、单项性能对照或[总体剩余清单](documentation-audit-2026-10-08.md)。
 
 test3 发布后收到清理/重导成绩关联问题，本次增量的代码及验证见文末
 [成绩关联修复](#清理重导成绩关联修复2026-10-14)。此前用户“全部正常”只覆盖对应安装包及清单，
 不补记本次修复的人工验收；test3 发布资产保持冻结。
-本地最新安装为 2026-10-14 17:35 的 D2734B… 成绩关联验收包；下文 0265A6… 是此前包的历史身份。
+本地最新安装为 2026-10-15 的 5CA301… 文件名查询验收包，功能验证见文末；
+下文 D2734B… 与 0265A6… 均为此前包的历史身份。
 
 ## 当前交付
 
@@ -254,4 +255,37 @@ e3a2ef7 的完整远程 CI 已通过：1949 项、零失败/跳过，正式 201
 239 项定向过滤回归及分层检查通过；用户单独授权的四进程只读对照也已完成。
 两版查询结果一致，既有/合成未登记输入的批次查询成本分别减少约 25.9%/37.6%。
 这不是客户端完整导入计时；普通更新约 22 秒的指纹读取不受本增量改善。
-实际安装 DLL 仍为 D2734B… 成绩关联修复包，本轮没有替换 DLL、操作客户端或更新 test3。
+该轮只读对照结束时，实际安装 DLL 仍为 D2734B… 成绩关联修复包；
+对照本身没有替换 DLL、操作客户端或更新 test3。随后客户端验证另记于下节。
+
+## 文件名查询增量的客户端功能验证（2026-10-15）
+
+493257f 的完整宿主 CI 已通过：七组共 1957 项、零失败/跳过，正式 201 份源码分层检查通过，
+[运行记录](https://github.com/sumiyuki727/O2Lazer/actions/runs/38691363205)保留。
+用户授权自行测试后，先使用匹配宿主的独立便携客户端，只复制 Reason 与 Mermaid girl
+两份 OJN 及对应 OJM。便携目录没有 storage.ini 重定向；实库、原安装 DLL、配置和四份
+源文件的 Hash 在这一步结束前均不变。
+
+首次普通更新导入两个 set、六个难度和两个源文件夹收藏；第二次更新实际写入为零。
+正常退出后，仅备份并移除便携库的一份缓存 OJN，重启更新写入一个源并恢复该文件。
+首次导入后、重复更新后、缓存修复后的谱面身份与收藏摘要全部相同；两次实际写入日志
+均为 native-name-membership-v3。没有清空用户曲库或删除源文件。
+
+随后在日常客户端关闭时备份原 DLL、client.realm 及配置，安装本地基础桥验收包：
+SHA-256 为 5CA3018E45CE6EE6DB5FE9C8EF2CF643FEA4658CE0C88D35BB293EA09F64B712。
+它包含 16 个基础桥类型，不含活动同步计时入口、R02 探针或 NUnit 类型；正式候选不含测试桥。
+test3 标签和发布资产保持冻结，不使用此验收包替换正式发布。
+
+1792047502.runtime.log 记录 15:59:30 至 16:00:06（Asia/Tokyo）的普通更新：
+7480 个源、7028 个已导入源，实际写入、星级补算和额外恢复成绩关联均为零，正常显示更新完成。
+更新前后 559 条成绩的完整快照摘要、73317 张谱面身份（其中 21082 张 O2Lazer）、
+38 个收藏夹的内容摘要及 305254 个文件记录计数一致。
+两条已验收的 NoMS/MS 成绩均仍有关联和各一份回放附件；原生 ScoreManager 分别读取
+10139 / 14583 帧，端点与完整帧摘要和此前验收一致。
+
+本轮没有开始 Player 游玩或录制声卡/画面，不能据此补记新的听感、视觉或全库重导速度验收。
+上述 36 秒只是单次无变化普通更新的日志，不是新 benchmark，也不证明首次导入吞吐提升。
+原模式、选曲及预览运行状态未变；客户端通过无后台任务的普通退出恢复原先关闭状态，
+本次没有出现 Realm 异步等待超时。停机备份、便携库、桥返回值及日志位于
+.artifacts/library-client-validation-20261015。Reason 回放退出补播的既有人工通过结果、
+Mania → O2Lazer 偶发选曲滞留的观察状态保持原范围。

docs/library-persistence-contract.md

@@ -662,9 +662,10 @@ RulesetLocalScoreRestorer 属于 Host/Persistence/Realm，接受原生 RealmAcce
 ## 文件名查询优化（2026-10-15）
 
 基线固定为 e3a2ef7 的成绩关联修复；查询增量在独立构建中完成验证后保留于源码。
-本次不把功能测试通过当作速度结论，客户端 DLL 未替换，test3 标签和发布资产不变。
+本次不把功能测试通过当作速度结论；只读查询对照时客户端 DLL 未替换，
+随后安装与功能验证另记于本节末尾。test3 标签和发布资产不变。
 
-最新 1792042709.runtime.log 显示重启后的普通更新：14:39:00（Asia/Tokyo）开始，
+此前 1792042709.runtime.log 显示重启后的普通更新：14:39:00（Asia/Tokyo）开始，
 14:39:40 完成；7480 个源、7028 个已导入源、实际写入和星级补算均为零。
 指纹读取约 22 秒，匹配约 6 秒；原生启动已经清理旧待删除谱面，仍不能沿用旧记录的
 16–17 秒作为本轮保证。日志同时确认恢复 189 条成绩关联，不代替成绩列表/回放的人工确认。
@@ -707,3 +708,11 @@ O2Lazer set，结果只证明该快照及已预热输入的查询收益，不证
 真实导入吞吐或普通更新的指纹读取速度；不据此声称完整导入减少 26–38%。
 私有源码备份、基线/候选产物、过滤 TRX、准备清单和执行器位于
 .artifacts/library-query-candidate-20261015。
+
+493257f 的完整宿主 CI 随后通过 1957 项。用户授权的客户端功能验证另使用独立便携库：
+两个真实源首次导入六个难度，重复更新无重复写入；备份并移除便携库内一份缓存 OJN 后，
+重启更新恢复文件，同时保留全部谱面身份及收藏。首次和修复写入均确认使用新查询模式。
+实库只进行一次普通更新，没有清空重导；更新前后成绩完整摘要、谱面身份和收藏内容一致，
+两份已验收回放的原生读取也通过。备份后安装的本地验收 DLL 为 5CA301…，正式 test3 不变。
+范围、包身份及数据计数见[本轮客户端记录](current-build-validation.md#文件名查询增量的客户端功能验证2026-10-15)。
+这补充当前安装包的功能证据，不扩大前述只读性能对照或人工游玩验收的结论。