拆分大文件

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

@@ -55,6 +55,61 @@
    - `cancel_ai_task_and_return`
 18. `turn_in_quest` 与 `resolve_combat_action(Victory)` 到 `player_progression / chapter_progression` 的最小经验联动
 
+### 2.0.1 `runtime` 域拆分进度
+
+截至 `2026-04-23`，`runtime` 域已完成第一轮真实内容拆分，根入口不再保留该域的业务 helper 实现。
+
+当前 `src/runtime/` 的实际落位如下：
+
+1. `src/runtime/settings.rs`
+   - `runtime_setting` 表
+   - setting 读取 / upsert procedure 与快照 helper
+2. `src/runtime/snapshots.rs`
+   - `runtime_snapshot` 表
+   - snapshot 读取 / upsert / delete helper
+3. `src/runtime/browse_history.rs`
+   - `user_browse_history` 表
+   - 浏览历史 list / upsert / clear procedure 与行转换 helper
+4. `src/runtime/profile.rs`
+   - `profile_dashboard_state`
+   - `profile_wallet_ledger`
+   - `profile_played_world`
+   - `profile_save_archive`
+   - profile dashboard / ledger / play stats / save archive 投影与同步 helper
+
+`src/runtime/mod.rs` 当前只承担聚合职责：
+
+1. 声明 `settings / snapshots / browse_history / profile`
+2. 对外统一使用 `pub use xxx::*;` 重新导出
+
+后续新增 runtime 相关 table / reducer / procedure / helper 时，必须直接落到上述二级文件，禁止回写到 `src/lib.rs`。
+
+### 2.0.2 `ai` 域拆分进度
+
+截至 `2026-04-23`，`ai` 域也已完成第一轮真实内容拆分，根入口不再保留 `ai_task / ai_task_stage / ai_text_chunk / ai_result_reference` 的业务实现。
+
+当前 `src/ai/` 的实际落位如下：
+
+1. `src/ai/tasks.rs`
+   - `ai_task` 表
+   - task 创建、启动、完成、失败、取消的 reducer / procedure
+   - task 状态迁移与持久化 helper
+2. `src/ai/stages.rs`
+   - `ai_task_stage`
+   - `ai_text_chunk`
+   - `ai_result_reference`
+   - stage 启动、chunk 追加、stage 完成、result reference 绑定的 procedure / helper
+3. `src/ai/snapshots.rs`
+   - AI 任务、阶段、chunk、reference 的 row / snapshot 转换 helper
+
+`src/ai/mod.rs` 当前只承担聚合职责：
+
+1. 声明 `tasks / stages / snapshots`
+2. 对外统一使用 `pub use xxx::*;`
+3. 对内部共享的 row / snapshot helper 使用 `pub(crate) use snapshots::*;`
+
+后续新增 AI 相关 table / reducer / procedure / helper 时，必须直接落到上述二级文件，禁止回写到 `src/lib.rs`。
+
 ## 2.1 `src/lib.rs` 拆分路由规则
 
 从 `2026-04-23` 起，`src/lib.rs` 不再允许继续承载具体业务域的 table / reducer / procedure / tx helper。