OPFS 存储适配器：可配置切换的持久化后端，CAS 语义与 IndexedDB 一致 (TML-90)

[SeasonsChange422]

摘要

TML-53 范围项 TML-90：OPFS 存储适配器。实现与现有 IndexedDB 适配器可切换的 OPFS（Origin Private File System）持久化后端，经持久化门面 project-persistence.ts 统一接入；行为与 IndexedDB 完全一致：项目保存/加载/删除/最近项目 + revision 防倒退（CAS） 语义，既有持久化功能（TML-53 AC1-AC4）不回归。

实现

• packages/studio/src/persistence/project-storage.ts（新）— 共享存储抽象：StorageBackend（'indexeddb' | 'opfs'）、ProjectStorage 接口、SaveOutcome/RenameOutcome/DuplicateOutcome、estimateStorage、CAS 比对与配额错误判定等公共工具。
• packages/studio/src/persistence/project-store-opfs.ts（新）— OpfsProjectStore：
  • 存储结构 <root>/projects/<encodeURIComponent(uri)>，记录与 IndexedDB 同形；根目录名同为 lumora-studio，切换后端不混淆命名空间；
  • 并发安全对齐 IndexedDB 事务：save 临界区（读-比-写）在互斥锁内执行 —— 优先 Web Locks（跨标签页互斥），不可用时进程内 promise 链退化（同标签页串行）；写入为「临时文件落盘 + move 原子覆盖」，配额不足/中断时旧记录保持原样；
  • CAS 语义逐项对齐：number = 期望基线比对（落后基线拒绝、追平基线拒绝、同 revision 幂等重存允许）、null = 创建语义（已存在拒绝）、undefined = 无条件写入；
  • 损坏记录策略（OPFS 特有）：load 视为缺失、save 拒绝覆盖（storage-error）、list 跳过、remove 可删除（修复路径）；
  • OPFS 不可用时 create 返回 null，持久化静默降级（与 IndexedDB 一致）。
• project-persistence.ts / studio-runtime.ts / LumoraStudio.tsx — init({ storage: 'opfs' | 'indexeddb' }) 可配置后端，缺省 'indexeddb'（既有行为不变）；新增 persistence.backend 只读属性。
• examples/embedded-host/src/App.tsx — 经 ?storage=opfs 查询参数切换后端（演示宿主）。
• index.ts — 导出 OpfsProjectStore 与存储抽象类型。

测试

• 单测：project-store-opfs.test.ts（14，内存 OPFS shim，覆盖重开持久化、列表排序、CAS 全部语义、跨实例并发、损坏记录、配额原子性与临时文件清理、OPFS 不可用降级）；project-persistence-opfs.test.ts（6，门面层切换、后端隔离、AC2 冲突锁存与「加载较新版本」解决）。
• e2e：e2e/persistence-opfs.spec.ts（真实 Chromium OPFS；AC1 导出→清空→导入→刷新重开全链路 + 直接断言数据落 OPFS 目录；AC2 双标签页 Web Locks 下 CAS 冲突与显式解决）。

验证（本机）

• 单元测试 693 通过 / 1 跳过（vitest 全量）
• typecheck、lint（0 错误）、build 全部通过
• e2e 57/57 通过（npm run e2e；曾出现 4 个 WebGL/视口密集用例在整包并发下超时，单独重跑与整包重跑均通过，判定为资源争用性 flake，非回归）