1

docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md

@@ -19,7 +19,7 @@
 
 ## 1. 结论先行
 
-结合当前代码与已有边界文档，前端里仍有 6 类逻辑应该继续后移：
+结合当前代码与已有边界文档，前端里仍有 7 类逻辑应该继续后移：
 
 1. **运行时快照前置写入与本地镜像解释**
 2. **鉴权 token 的浏览器本地真相**
@@ -27,6 +27,7 @@
 4. **NPC 待接委托“换单”仍由前端直接触发正式生成**
 5. **quest/runtime item 的双环境混合编排**
 6. **浏览器侧大型 AI orchestration 与 prompt/repair/fallback 主链**
+7. **NPC 招募对白之后的正式结算链路**
 
 一句话判断：
 
@@ -59,6 +60,20 @@
 
 ## 3. 当前高置信度应后移逻辑
 
+## 3.0 本轮已完成后移
+
+以下链路已在本轮或上一轮连续落地中完成后移，不再属于“仍残留在前端”的正式主链：
+
+1. access token 浏览器本地真相
+2. browse history 本地真相
+3. runtime story 前置 `PUT /runtime/save/snapshot`
+4. NPC 待接委托 `replace / abandon / accept`
+5. custom world profile 正式浏览器入口
+6. `questDirector` / `runtimeItemAiDirector` 浏览器正式编排
+7. NPC 招募正式结算
+
+其中 NPC 招募已从“前端本地改 companions / roster / npcStates / storyHistory”收回到后端 runtime action。
+
 ## 3.1 运行时快照前置写入仍在前端
 
 ### 代码证据
@@ -427,6 +442,41 @@
 
 ---
 
+## 3.8 NPC 招募对白之后的正式结算链路已完成后移
+
+### 本轮前状态
+
+迁移前，`src/hooks/story/npcInteraction.ts` 中的 `buildRecruitmentOutcome / executeRecruitment / startRecruitmentSequence` 仍在前端本地正式结算：
+
+1. 改 `npcStates`
+2. 改 `companions`
+3. 改 `roster`
+4. 清 `currentEncounter / inBattle / sceneHostileNpcs`
+5. 直接写 `storyHistory`
+6. 再触发后续剧情推进
+
+这与“前端只做表现，所有正式逻辑、数据都放到 Express 后端”直接冲突。
+
+### 本轮后状态
+
+本轮已完成：
+
+1. `server-node/src/modules/story/runtimeSession.ts`
+   - 正式承接完整 `companions`
+   - 正式承接 `roster`
+2. `server-node/src/modules/npc/npcInteractionService.ts`
+   - `npc_recruit` 已支持正常入队
+   - `npc_recruit` 已支持满员换队招募
+3. `src/hooks/story/npcInteraction.ts`
+   - 前端只保留招募对白流式展示
+   - 正式招募结算改为调用后端 runtime action
+
+### 当前判断
+
+这一项已不再属于前端残留正式逻辑。
+
+---
+
 ## 4. 可以暂时保留在前端的部分
 
 下面这些内容即使和上述模块同文件出现，也不属于必须后移的对象：