1

server-rs/crates/spacetime-client/README.md

@@ -29,6 +29,7 @@
 4. 生成绑定到 BFF record / module record 的 row snapshot mapper 已集中在 `mapper.rs`。
 5. SDK 调用错误、reducer 业务错误、procedure 业务错误、缺快照错误和本地输入校验错误已统一收口到 `SpacetimeClientError` helper。
 6. Story runtime projection source 已复用 runtime inventory typed facade，读取投影不再只依赖 runtime snapshot 中的历史背包 JSON 副本。
+7. Story runtime 投影读取会对历史 `currentStory.options` 做兼容推断：若旧快照缺少 `scope`，仍会按 `functionId` 通过 `module-runtime-story` 的 option helper 还原为 `story / combat / npc` 作用域，避免旧存档把读取链路卡死。
 
 `confirm_asset_object_and_return` 与 `bind_asset_object_to_entity_and_return` 的调用必须等到 SDK `on_connect` 回调后再发起。`DbConnection::build()` 只代表 WebSocket 已经初始化，不代表 SpacetimeDB 身份握手完成；如果过早调用 procedure，本地联调会表现为连接建立但请求长期没有回调，最终等到 idle timeout。