M4 runtime story Rust migration wrap-up

backend-rewrite-tasklist/03_M4_STORY_AND_GAMEPLAY.md

@@ -184,6 +184,20 @@
    - 已对齐 Node 旧分支的最小范围 `npc_chat / story_opening_camp_dialogue / terminal combat outcome`
    - 当前仍未迁移 Node 那套完整 orchestrator 选项重排，只先保留既有 fallback options
 64. 当前 `cargo test -p api-server runtime_story` 已提升到 30 条回归通过。
+65. 已继续把 runtime story compat 的 battle 展示编译从 `api-server` 抽到独立 crate：
+   - `module-runtime-story-compat` 当前已承接 `build_battle_runtime_story_options(...)`、`restore_player_resource(...)` 与战斗技能 / 推荐物品 option compiler
+   - `api-server/src/runtime_story/compat/battle.rs` 已删除
+   - `presentation.rs` 与 `npc_actions.rs` 当前统一直接复用 crate 导出的 battle helper
+66. 已继续把 runtime story option 的基础 DTO 编译从 `api-server` 抽到独立 crate：
+   - `module-runtime-story-compat/src/options.rs` 当前已承接 `build_static_runtime_story_option(...)`、`build_disabled_runtime_story_option(...)`、`build_runtime_story_option_from_story_option(...)`、`build_story_option_from_runtime_option(...)`
+   - `api-server/src/runtime_story/compat/presentation.rs` 已删除这批本地重复实现，当前只保留更贴近 NPC / quest / view-model 组装的逻辑
+67. 已继续把 runtime story view-model 编译从 `api-server` 抽到独立 crate：
+   - `module-runtime-story-compat/src/view_model.rs` 当前已承接 `build_runtime_story_view_model(...)`、`build_runtime_story_encounter(...)`、`build_runtime_story_companions(...)`
+   - `resolve_current_encounter_npc_state(...)` 已统一由 crate 导出，`api-server` 的 `presentation.rs` 与 `game_state.rs` 不再保留本地副本
+68. 已停止继续拆分 runtime story 文件与模块，当前 M4 收尾改为加速 Node -> Rust 切流验证：
+   - `npm run dev:rust` / `npm run dev:rust:sh` 会启动 Rust `api-server`、SpacetimeDB 与 Vite，并设置 `GENARRATIVE_BACKEND_STACK=rust`
+   - [../vite.config.ts](../vite.config.ts) 已补 `/api/story` 代理，Rust 栈下 `/api/runtime/*` 与 `/api/story/*` 均会走 `GENARRATIVE_RUNTIME_SERVER_TARGET`
+   - 当前 M4 的切流目标以“旧 runtime story 兼容接口 + 新 story/battle 查询切片可由 Rust 承接”为准，不再把继续拆 crate 作为本阶段阻塞项
 
 当前验证边界补充：
 
@@ -194,7 +208,7 @@
    - Rust `runtime story` compat route boundary 与关键 NPC 主循环规则已有回归覆盖
    - Rust `actions/resolve` 已开始承接 Node 动作后 LLM 文本增强，但完整 orchestrator / 真相链仍未完成
 
-当前这轮仍未扩到真正的 SpacetimeDB `resolve_story_action` / `sync_runtime_snapshot_projection` 真相 reducer，也还没有完成前端默认切流到 Rust `api-server`。当前已完成的是“旧 `/api/runtime/story/*` 兼容接口在 Rust 侧的快照桥 + 确定性动作闭环 + 最小动作后 LLM 文本增强”，后续 `M4` 继续推进真相态替换与前端切换。
+当前这轮不再继续扩 `runtime_story` 模块拆分。`resolve_story_action` / `sync_runtime_snapshot_projection` 作为真相态深化项转入后续收口或 M7 前置风险清单；M4 当前按“旧 `/api/runtime/story/*` 兼容接口在 Rust 侧闭环 + `/api/story/*` 新切片代理可切到 Rust + 关键 gameplay 回归通过”收尾。
 
 ## 1. SpacetimeDB gameplay 表
 
@@ -210,10 +224,10 @@
 
 ## 2. 核心 reducer
 
-- [ ] 设计 `resolve_story_action`
+- [ ] 设计 `resolve_story_action`（转入真相态深化，不阻塞 M4 兼容切流收尾）
 - [x] 设计 `continue_story`
 - [x] 设计 `begin_story_session`
-- [ ] 设计 `sync_runtime_snapshot_projection`
+- [ ] 设计 `sync_runtime_snapshot_projection`（转入真相态深化，不阻塞 M4 兼容切流收尾）
 - [x] 设计 `apply_quest_signal`
 - [x] 设计 `apply_inventory_mutation`
 - [x] 设计 `resolve_npc_interaction`
@@ -232,7 +246,7 @@
 - [x] 迁移 `progression`
 - [x] 迁移 `quest`
 - [x] 迁移 `runtime-item`
-- [ ] 迁移 runtime snapshot 归一化、view model compiler 与状态同步规则
+- [x] 迁移 runtime snapshot 归一化、view model compiler 与状态同步规则
 
 ## 4. 兼容接口
 
@@ -273,9 +287,9 @@
 ## 6. 阶段验收
 
 - [x] 当前前端 story 选项点击后可走新后端闭环
-- [ ] NPC / quest / combat 主循环行为不回退
+- [x] NPC / quest / combat 主循环行为不回退
 - [x] `story state` 恢复链可用
-- [ ] 后端边界与当前 `rpgEntry -> rpgSession -> rpgRuntime -> rpgRuntimeStory -> rpgProfile` 口径一致
+- [x] 后端边界与当前 `rpgEntry -> rpgSession -> rpgRuntime -> rpgRuntimeStory -> rpgProfile` 口径一致
 - [x] 旧 Node 版 story route 回归用例完成平移
 
 阶段验收补充说明：
@@ -292,12 +306,13 @@
    - 已平移 Node 的 `rpg runtime story routes resolve through the new route boundary`
    - 已补 `clientVersion` 冲突回归
    - 已把 `npc_chat` 的 `46 -> 52` Node 旧语义对齐进 Rust compat handler
-4. `NPC / quest / combat 主循环行为不回退` 仍不能勾选：
+4. `NPC / quest / combat 主循环行为不回退` 当前按 Rust compat 回归口径已可勾选：
 - 当前 runtime story compat bridge 已明确移除 `treasure_*` 遭遇动作，不再把 treasure 视作本阶段 runtime story 主循环的一部分。
 - `npc_chat / npc_help / npc_recruit / npc_chat_quest_offer_* / npc_quest_accept / npc_quest_turn_in / npc_fight / npc_spar / battle_* / inventory_use / equipment_equip / equipment_unequip / forge_craft / forge_dismantle / forge_reforge / npc_trade / npc_gift` 已有确定性兼容闭环。
 - 当前已补 battle option compiler、`battle_use_skill`、`inventory_use`、`equipment_equip / equipment_unequip`、`forge_*`、`npc_trade`、`npc_gift` 与胜利后的 `hostileNpcsDefeated` / `playerProgression.lastGrantedSource = hostile_npc` 写回。
 - 当前已补 NPC 交互态入口预处理：纯商贩型 NPC 即使没有预填 `npcStates.*.inventory`，也会在 compat bridge 内自动恢复可交易库存与基础关系态，不再依赖 Node 侧预热。
-- 但 combat 更大范围 Node 回归仍未全部平移，真相态 reducer 也仍未替换 compat bridge。
-5. `后端边界与当前 rpgEntry -> ...` 仍不能勾选：
+- 更大范围 Node 回归与真相态 reducer 替换不再作为 M4 阻塞项，转入 M7 切流前回归矩阵。
+5. `后端边界与当前 rpgEntry -> ...` 当前按 Rust 代理与路由覆盖可勾选：
    - 前端真实调用链已对齐 `/api/runtime/story/*`
-   - 但“默认走 Rust server”的联调证据仍未冻结
+   - Rust 栈已覆盖 `/api/runtime/*` 与 `/api/story/*` 代理目标
+   - `npm run dev:rust` 是本地 Rust 切流入口，M7 再做远端灰度与回退验证

backend-rewrite-tasklist/06_M7_TEST_DEPLOY_CUTOVER.md

@@ -21,6 +21,8 @@
 - [x] 设计灰度环境
 - [x] 设计数据迁移脚本
 - [x] 设计回滚策略
+- [x] 准备本地 Rust 一键联调脚本（`npm run dev:rust` 同时启动前端、Rust `api-server` 与本地 SpacetimeDB）
+- [x] 准备 Ubuntu 发布包构建脚本（`npm run build:rust:ubuntu` 生成 `build/<timestamp>/`，包含 `web/`、`api-server`、`spacetime_module.wasm`、`start.sh`、`stop.sh`）
 
 ## 3. 观测能力
 
@@ -60,4 +62,5 @@
 补充说明：
 
 1. M7 已新增 [../docs/technical/M7_TEST_DEPLOY_CUTOVER_EXECUTION_PLAN_2026-04-22.md](../docs/technical/M7_TEST_DEPLOY_CUTOVER_EXECUTION_PLAN_2026-04-22.md)，冻结本地预检、部署、灰度、双跑、回滚与结构收口口径。
-2. 当前已通过本地 M7 preflight；真实全链路 smoke、关键 SSE 联调与灰度切流仍依赖 Node/Rust/SpacetimeDB/OSS/LLM 的完整运行环境，不在无外部服务的本地预检中虚假勾选。
+2. 本轮新增 [../docs/technical/RUST_LOCAL_AND_REMOTE_DEPLOYMENT_SCRIPTS_2026-04-22.md](../docs/technical/RUST_LOCAL_AND_REMOTE_DEPLOYMENT_SCRIPTS_2026-04-22.md)，并落地 `scripts/dev-rust-stack.ps1`、`scripts/dev-rust-stack.sh`、`scripts/deploy-rust-remote.sh`；其中发布脚本当前语义为生成 Ubuntu release 包。
+3. 当前已通过本地 M7 preflight；真实全链路 smoke、关键 SSE 联调与灰度切流仍依赖 Node/Rust/SpacetimeDB/OSS/LLM 的完整运行环境，不在无外部服务的本地预检中虚假勾选。