创作数据流程收束

2026-04-21 09:44:17 +08:00
parent effe0355bd
commit 3614e1f5a2
93 changed files with 1794 additions and 8651 deletions
--- a/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md
+++ b/docs/audits/AGENT_TO_DRAFT_TO_WORLD_PIPELINE_AUDIT_2026-04-20.md
@@ -251,8 +251,8 @@ custom-world-library
 | `anchorContent / creatorIntent / anchorPack / lockState` 被直接塞进 legacy profile | 创作态元数据 | 会跟随自动保存一起写进作品库 profile，但 runtime 并不以这些字段为正式运行时输入 | 当前更像创作态元数据泄漏进运行时 profile |
 | `qualityFindings` | session / contract 字段 | contract、session store、测试里存在，但没形成生成、渲染、发布阻断闭环 | 当前主链悬空 |
 | `checkpoints` | session 字段 | session store 会记录，但主工作区和结果页没有真实展示入口 | 当前主链悬空 |
-| `suggestedActions` | session 字段 | session 会生成，但主工作区没有接 `QuickActions` 等面板 | 当前主链悬空 |
-| `pendingClarifications` | session 字段 | session 有数据，但澄清面板未接入主工作区 | 当前主链悬空 |
+| `suggestedActions` | session 字段 | session 会生成，但当前正式工作区没有对应消费面；旧 `QuickActions` 面板已在 `2026-04-21` 判定退出当前版本主链并物理删除 | 当前主链悬空 |
+| `pendingClarifications` | session 字段 | session 有数据，但当前正式工作区没有对应消费面；旧澄清面板已在 `2026-04-21` 判定退出当前版本主链并物理删除 | 当前主链悬空 |
 | `operations` 历史 | session 字段 | 主工作区只展示当前 `activeOperation` 横幅，不展示完整历史 | 当前主链弱消费 |
 | `roleAssetSummaryLabel / cover* / counts` 等 works 字段 | works 聚合字段 | 后端能返回，但主平台 create tab 没走 `works` 入口 | 当前主链弱消费 |

@@ -266,11 +266,11 @@ custom-world-library
 | --- | --- | --- |
 | 结果页直接生成 playable/story/landmark | `CustomWorldResultView.tsx` 仍可直接调用 AI 生成 | 与 Agent 对象精修链重复，且不会同步回 session |
 | 结果页直接编辑 `CustomWorldProfile` | `CustomWorldEntityEditorModal` 仍挂在结果页 | 把结果页继续维持成旧编辑器，而不是 Agent 流程的收口层 |
-| 旧 `custom-world/sessions` 世界生成 | `aiService.generateCustomWorldProfile()` 仍完整可用 | 与 Agent 八锚点世界创建重复 |
+| 旧 `custom-world/sessions` 世界生成 | `2026-04-20` 审计时仍完整可用；`2026-04-21` 已完成物理删除 | 与 Agent 八锚点世界创建重复；当前遗留问题已转为文档口径清理 |
 | 作品库 `publish/unpublish` 与 Agent `publish_world` | 两套“发布”概念并行 | 一套作用于 library profile，一套想作用于 Agent session，但后者还未打通 |
 | 结果页自动保存 | `generatedCustomWorldProfile` 变化时自动 `upsertCustomWorldProfile()` | 让“草稿保存”“作品库存档”“正式发布”语义混在一起 |

-## 7.2 冗余或未接线组件
+## 7.2 冗余或已退出当前版本主链的组件

 `src/components/custom-world-agent/CustomWorldAgentWorkspace.tsx` 当前只真正接了：

@@ -280,7 +280,7 @@ custom-world-library
 4. `CustomWorldAgentThread`
 5. `CustomWorldAgentComposer`

-但同目录下已经存在且主工作区未接线的组件包括：
+在 `2026-04-21` 清理前，同目录下还存在一组未接线旧组件：

 1. `CustomWorldAgentLockBar.tsx`
 2. `CustomWorldAgentDraftDrawer.tsx`
@@ -291,6 +291,25 @@ custom-world-library
 7. `CustomWorldAgentClarificationPanel.tsx`
 8. `CustomWorldGenerateEntityModal.tsx`

+其中：
+
+1. `CustomWorldAgentDraftDrawer.tsx` 已在批次 A 清理中删除
+2. `CustomWorldAgentLockBar.tsx`
+3. `CustomWorldAgentDraftDetailPanel.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+5. `CustomWorldAgentSummaryPanel.tsx`
+6. `CustomWorldAgentIntentSummaryPanel.tsx`
+7. `CustomWorldAgentClarificationPanel.tsx`
+8. `CustomWorldGenerateEntityModal.tsx`
+
+已在批次 D 清理中判定为退出当前版本主链，并完成物理删除。
+
+因此这里的审计结论需要更新为：
+
+1. 它们不再属于“待接线组件”
+2. 它们属于已确认退场的旧副面板链
+3. 当前版本如果还要补 `suggestedActions / pendingClarifications / draftCards` 的消费面，应基于新的主链设计重新定义，而不是默认把旧面板接回来
+
 另外，`src/components/custom-world-home/CustomWorldCreationHub.tsx` 也已存在，但平台 `create` tab 还没有把它接成主入口。

 ---
@@ -345,16 +364,16 @@ Agent session
 2. 只有 `publish_world` 成功后，才产出正式 `CustomWorldProfile` 并允许主入口进入世界。
 3. `qualityFindings / blocker` 必须在 foundation draft 完成、资产写回后、publish 前持续重跑。

-## P1：决定旧 world session 流程的命运
+## P1：继续做旧 world session 链的文档收口

-当前最容易继续制造重复复杂度的是旧 `custom-world/sessions` 链。
+`2026-04-21` 更新：

-建议二选一：
+旧 `custom-world/sessions` 链已经完成物理删除。

-1. 明确保留为“快速世界生成兼容模式”，但从主入口降级。
-2. 明确进入淘汰路径，逐步下线 `generateCustomWorldProfile()` 这条旧链。
+因此这里不再是“保留还是淘汰”的开放问题，而是：

-不建议继续让它和 Agent 八锚点链同时作为主入口长期并存。
+1. 继续清理由这条旧链残留在审计、PRD、知识图谱中的过时口径
+2. 把当前正式主链与仍保留的兼容层边界写清楚

 ## P1：把 works 创作中心接回主平台

@@ -365,16 +384,23 @@ Agent session
 3. 已发布 profile 通过“进入世界”或“查看详情”进入。
 4. `myEntries` 退回为作品库子集，而不是 create tab 的唯一数据源。

-## P1：补齐 Agent workspace 的最小闭环
+## P1：为悬空 session 字段重新定义最小闭环

-建议优先接上：
+`2026-04-21` 更新：

-1. `CustomWorldAgentQuickActions`
-2. `CustomWorldAgentDraftDrawer`
-3. `CustomWorldAgentDraftDetailPanel`
-4. `CustomWorldAgentClarificationPanel`
+原文这里建议把旧 `QuickActions / DraftDrawer / DraftDetailPanel / ClarificationPanel` 接回主工作区。

-如果这几个面板不接上，`suggestedActions / pendingClarifications / draftCards` 这些 session 字段会长期处于悬空状态。
+但这些旧副面板已经在当前版本收口判断中被明确认定为：
+
+1. 不属于现行主链
+2. 不再作为当前版本默认待落地项
+3. 已完成物理删除
+
+因此当前更准确的建议应该是：
+
+1. 如果 `suggestedActions / pendingClarifications / draftCards` 仍要进入正式主流程，需要先重新定义符合当前极简工作区的消费方式
+2. 不应再以“把旧副面板接回来”作为默认方案
+3. 在没有新主链设计前，这些字段继续标记为“主链悬空”

 ## P2：等主链收口后再清桥接字段

--- a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md
@@ -0,0 +1,141 @@
+# 工程死分支清理执行记录 A（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应：
+
+- `docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md`
+- 其中的 `P0 + 批次 A`
+
+本批次只做一件事：
+
+**先清理高置信度、低耦合、无正式入口的小型孤岛与残留壳子。**
+
+这批对象有一个共同特征：
+
+1. 当前没有正式运行时引用
+2. 没有当前主链计划要接回
+3. 删除后有明确替代路径，或者本身只是历史占位
+
+因此这批次不碰运行时真相链、不碰鉴权链、不碰任务物品主链，只先做低风险去噪。
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已删除文件
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 | 验证口径 |
+| --- | --- | --- | --- | --- |
+| `src/services/customWorldPresentation.stub.ts` | 无引用占位 stub | 文件本身就是占位实现，且正式逻辑已由 `customWorldPresentation.ts` 承接 | `src/services/customWorldPresentation.ts` | 符号级检索确认正式调用方都指向正式实现 |
+| `src/services/typewriter.ts` | 无引用 helper 残留 | 独立 helper 已失效，正式链路已在 `storyPresentation.ts` / `storyRenderingHelpers.ts` 等处内联或迁移 | `src/hooks/story/storyPresentation.ts`、`src/hooks/story/storyRenderingHelpers.ts` | `getTypewriterDelay` 调用点未指向该文件 |
+| `src/prompts/customWorldOrchestratorPrompts.ts` | 前端孤岛 prompt 壳 | 当前无正式 import，正式主编排 prompt 已收口到后端 prompt 目录，前端 `ai.ts` 也保留自己的现行实现 | `server-node/src/prompts/customWorldOrchestratorPrompts.ts`、`src/services/ai.ts` | 全仓检索仅剩文档引用，无代码消费 |
+| `src/prompts/storyOrchestratorPrompts.ts` | 前端孤岛 prompt 壳 | 当前无正式 import，剧情语言修复 prompt 已由后端 prompt 目录承接，前端当前执行路径不依赖该文件 | `server-node/src/prompts/storyOrchestratorPrompts.ts`、`src/services/ai.ts` | 全仓检索仅剩文档引用，无代码消费 |
+| `src/components/custom-world-home/CustomWorldCreationLauncherModal.tsx` | 无入口 UI 壳层 | 最近两轮工程审计都确认无运行时引用，当前平台主流程未接这条入口 | 当前平台正式入口链 | 文件级检索确认无组件 import |
+| `src/components/custom-world-agent/CustomWorldAgentLauncherModal.tsx` | 无入口 UI 壳层 | Agent 创作主流程已切到当前工作区链路，这个旧 modal 没有接线价值 | 当前 Agent 工作区主链 | 文件级检索确认无组件 import |
+| `src/components/custom-world-agent/CustomWorldAgentDraftDrawer.tsx` | 无入口 UI 壳层 | 只有孤立 UI 实现，没有正式调用链，也不在当前结果页 / 工作区主链中 | 当前 Agent 工作区与结果页正式链 | 文件级检索确认无组件 import |
+
+---
+
+## 2. 本批次为什么先删这 7 个
+
+这批文件适合先处理，不是因为它们最大，而是因为它们最清晰：
+
+1. **没有正式入口。**
+   本轮检索没有发现主工程 import。
+2. **删除后不会形成职责空洞。**
+   要么已有正式替代路径，要么本身只是历史占位。
+3. **不会误伤当前重点链路。**
+   这批不涉及运行时快照、鉴权、任务、物品、AI 正式编排主链。
+4. **可以最快降低目录噪音。**
+   先把真假并存的壳子删掉，后面做批次 B/C/D 时判断成本会更低。
+
+---
+
+## 3. 本批次暂不处理对象
+
+以下对象虽然已进入首轮台账，但本批次暂不删除：
+
+1. `src/components/GameShell.tsx`
+2. `src/components/custom-world-home/CustomWorldCreationHub.tsx`
+3. `src/hooks/story/storyBootstrap.ts`
+4. `src/hooks/useEquipmentFlow.ts`
+5. `src/hooks/useForgeFlow.ts`
+6. `src/hooks/useInventoryFlow.ts`
+7. `src/data/buildTagSimilarity.generated.ts`
+
+暂缓原因分别是：
+
+1. 仍属于旧主流程 / 旧 flow 级别对象，删除前要先核对更多历史依赖和替代路径
+2. 部分对象仍有测试引用或更大的上下文耦合
+3. `buildTagSimilarity.generated.ts` 虽无正式业务 import，但属于生成产物，处理前还要确认脚本链与文档链
+
+这批对象更适合进入：
+
+1. `批次 B：旧 flow / 旧 shell / 旧 hook`
+2. 或独立的数据产物复核批次
+
+---
+
+## 4. 本批次同步更新的文档
+
+本批次除了删文件，还同步做了文档回填：
+
+1. 新增本执行记录，说明本批删了什么、为什么删、哪些对象暂缓
+2. 更新 `docs/audits/engineering/README.md`，把这份执行记录加入当前审计入口
+
+这样做的目的，是避免再次出现：
+
+1. 代码删了
+2. 但审计入口还是旧状态
+3. 后续开发又从旧清单里重复判断一遍
+
+---
+
+## 5. 验证方式
+
+本批次验证采用两层口径：
+
+## 5.1 删除前验证
+
+1. 文件级检索确认无正式 import
+2. 符号级检索确认关键导出没有被主链消费
+3. 结合 `2026-04-20` 工程审计交叉确认这些对象已被标记为高置信度孤岛
+
+## 5.2 删除后验证
+
+建议至少执行：
+
+1. `npm run check:encoding`
+2. `npm run build`
+
+说明：
+
+- 当前仓库已知 `typecheck` 与 `lint` 仍处于红线阶段，因此本批不把它们作为“由本批引入的新失败”判断口径
+- 本批主要验证目标是：删除小残留后，不产生新的导入断裂和构建断裂
+
+---
+
+## 6. 本批次结果判断
+
+本批次完成后，工程至少获得了 3 个直接收益：
+
+1. `src/prompts/`、`src/services/`、`src/components/custom-world-*` 中少了一批无入口孤岛
+2. 当前目录里“看起来像正式入口，其实已经废弃”的误导性对象减少
+3. 后续可以把精力集中到真正高价值的批次 B/C/D，而不是继续被小残留分散判断成本
+
+---
+
+## 7. 下一批建议
+
+建议严格按计划继续往下推进：
+
+1. 批次 B：`GameShell`、`storyBootstrap`、`useEquipmentFlow`、`useForgeFlow`、`useInventoryFlow`
+2. 批次 C：`runtimeStoryCoordinator`、`runtimeStoryService`、`apiClient`
+3. 批次 D：`npcEncounterActions`、`questDirector`、`runtimeItemAiDirector`、`ai.ts`
+
+一句话总结本批次：
+
+**先把最确定的死分支和占位壳子清掉，让主工程少一些假入口、假主源、假能力，再进入更重的主链收口。**
--- a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md
@@ -0,0 +1,145 @@
+# 工程死分支清理执行记录 B（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应清洗计划中的：
+
+- `批次 B：旧 flow / 旧 shell / 旧 hook`
+
+本批次聚焦的不是小型 stub，而是：
+
+**已经退出正式主流程、但仍占着高辨识度命名和旧职责心智的壳层与流程 Hook。**
+
+这类文件如果继续留在仓库里，问题比小 helper 更大，因为它们会持续制造误判：
+
+1. 新人会以为它们还是正式入口
+2. 后续开发会误判“应该往这里接逻辑”
+3. review 时会多出一层“旧主链是不是还活着”的判断成本
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已删除文件
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 | 验证口径 |
+| --- | --- | --- | --- | --- |
+| `src/components/GameShell.tsx` | 旧主流程壳层残留 | 当前正式壳层已由 `src/components/game-shell/GameShellRuntime.tsx` 承接，旧文件无正式 import | `src/components/game-shell/GameShellRuntime.tsx`、`src/hooks/useGameShellRuntime.ts` | 全仓检索未发现对旧 `GameShell` 组件的正式消费 |
+| `src/hooks/story/storyBootstrap.ts` | 旧启动流程 Hook 残留 | 当前主剧情启动链已不再调用该 Hook，继续保留只会误导人以为它还是故事初始化入口 | 当前 story runtime / coordinator 链 | 全仓检索未发现 `useStoryBootstrap` 消费方 |
+| `src/hooks/useEquipmentFlow.ts` | 旧装备流程 Hook 残留 | 当前正式背包与装备链未消费该 Hook，属于旧流程实现残留 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+| `src/hooks/useForgeFlow.ts` | 旧锻造流程 Hook 残留 | 当前正式锻造入口未通过该 Hook 进入主链，保留会制造旧流程错觉 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+| `src/hooks/useInventoryFlow.ts` | 旧背包使用流程 Hook 残留 | 当前主流程未消费该 Hook，属于旧状态推进实现残留 | 当前 inventory / runtime 正式链 | 符号级检索仅命中定义文件自身 |
+
+---
+
+## 2. 为什么这批要紧跟批次 A 处理
+
+批次 A 清掉的是“小型假入口”。
+
+批次 B 清掉的是“高辨识度旧主链”。
+
+这批必须紧跟着做，原因是：
+
+1. 它们虽然比 stub 更大，但引用关系同样清楚
+2. 它们的误导性比小残留更强
+3. 不先处理这批，后面做批次 C/D 时，很容易继续有人拿旧 flow Hook 当候选接线点
+
+一句话讲：
+
+**批次 A 是去噪，批次 B 是拔掉旧路牌。**
+
+---
+
+## 3. 本批次删除后的结构变化
+
+本批次完成后，仓库里的流程心智会更清楚：
+
+1. 游戏壳层正式入口继续收敛到 `src/components/game-shell/**`
+2. 旧 `GameShell.tsx` 不再和 `GameShellRuntime.tsx` 并存
+3. 旧的装备 / 锻造 / 背包单独 flow Hook 不再伪装成还在生效的正式实现
+4. 旧 `storyBootstrap` 不再和当前 story runtime 链并存
+
+这会直接减少两类误判：
+
+1. “是不是还有旧主流程没迁完”
+2. “我是不是应该把新逻辑继续补进这些旧 Hook”
+
+---
+
+## 4. 本批次暂不处理对象
+
+虽然批次 B 已经处理了旧 shell / old flow / old bootstrap，但以下对象仍暂缓：
+
+1. `src/components/custom-world-home/CustomWorldCreationHub.tsx`
+2. `src/data/buildTagSimilarity.generated.ts`
+3. 批次 C 的运行时真相链：
+   - `src/hooks/story/runtimeStoryCoordinator.ts`
+   - `src/services/runtimeStoryService.ts`
+   - `src/services/apiClient.ts`
+4. 批次 D 的混合执行层：
+   - `src/hooks/story/npcEncounterActions.ts`
+   - `src/services/questDirector.ts`
+   - `src/services/runtimeItemAiDirector.ts`
+   - `src/services/ai.ts`
+
+暂缓原因很明确：
+
+1. 这些对象要么仍在当前正式链上
+2. 要么涉及运行时真相与鉴权边界
+3. 不能按“无引用旧壳”同一口径直接删除
+
+---
+
+## 5. 本批次验证方式
+
+## 5.1 删除前验证
+
+1. 全仓检索 `GameShell` 旧组件消费方，确认当前正式壳层已切到 `game-shell/` 目录
+2. 全仓检索 `useStoryBootstrap`
+3. 全仓检索旧装备 / 锻造 / 背包 flow Hook 导出的 handler 名称
+4. 交叉确认当前正式主链入口已存在替代实现
+
+## 5.2 删除后验证
+
+建议至少执行：
+
+1. `npm run check:encoding`
+2. `npm run build`
+
+如果这两项通过，说明：
+
+1. 删除没有引入新的导入断裂
+2. 主工程构建链仍然成立
+
+---
+
+## 6. 本批次结果判断
+
+本批次完成后，工程获得的直接收益是：
+
+1. 旧主流程壳层不再和现行壳层并存
+2. 旧流程 Hook 不再占据 `src/hooks/` 的主路径注意力
+3. 当前正式入口和历史残留的边界更清楚
+4. 后续开发更不容易把新逻辑接回旧流程壳子
+
+---
+
+## 7. 下一批建议
+
+建议下一步进入真正有结构价值的收口：
+
+1. `批次 C：运行时真相收口`
+   - `runtimeStoryCoordinator`
+   - `runtimeStoryService`
+   - `apiClient`
+2. `批次 D：任务 / 物品 / AI 混合执行层收口`
+   - `npcEncounterActions`
+   - `questDirector`
+   - `runtimeItemAiDirector`
+   - `ai.ts`
+
+一句话总结本批次：
+
+**这一步不是在“删几个没用 Hook”，而是在把已经退场的旧主流程壳层和旧 flow 路牌从主工程里真正拔掉，让现行架构不再和历史壳子并排站着。**
--- a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md
@@ -0,0 +1,177 @@
+# 工程死分支清理执行记录 C（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+这份记录对应清洗计划中的：
+
+- `批次 C：运行时真相收口`
+
+但这次不是“一口气把运行时真相链全删干净”，而是先做其中最明确、风险最低、最不该继续拖的那一段：
+
+1. **收掉前端本地自动登录用户名 / 密码真相**
+2. **把登录恢复改成优先依赖服务端 session / refresh**
+
+同时，这一批也明确记录了一件事：
+
+**运行时快照前置写入链当前还不能直接砍。**
+
+原因不是“不想动”，而是服务端当前 `runtime story` 动作入口仍然以远端快照作为执行基线。  
+在后端 contract 没先改好之前，前端不能假装自己已经退出这条链。
+
+---
+
+## 1. 本批次已处理对象
+
+## 1.1 已收口的鉴权链
+
+| 文件 | 处理动作 | 本批结论 |
+| --- | --- | --- |
+| `src/services/apiClient.ts` | 删除本地自动登录用户名 / 密码存取逻辑 | 前端不再保存 auto auth 账号密码 |
+| `src/services/authService.ts` | 去掉对本地游客凭证的读写依赖 | 自动游客登录改为仅本次生成凭证，不再长期落本地 |
+| `src/components/auth/AuthGate.tsx` | 去掉“必须先有本地 access token 才尝试恢复”的前置假设 | 登录恢复改为优先尝试服务端 `getCurrentAuthUser()` / refresh session |
+| `src/services/authService.test.ts` | 改写游客自动登录相关断言 | 验证改为“生成临时凭证并完成登录”，而不是“落本地账号密码” |
+| `src/components/auth/AuthGate.test.tsx` | 改写登录恢复 mock | 验证改为“先尝试服务端会话恢复，再决定是否走游客兜底” |
+
+---
+
+## 2. 本批次为什么先做这段
+
+这批优先级高，是因为它同时满足 4 条：
+
+1. **风险明确。**
+   浏览器保存自动登录用户名 / 密码，本身就不符合“前端只做表现、后端负责鉴权真相”的方向。
+2. **替代路径已经存在。**
+   后端已经有 refresh session cookie 与 `getCurrentAuthUser()`，不是没有可替代能力。
+3. **改动边界清楚。**
+   这一段主要落在前端鉴权恢复逻辑和测试，不会直接波及运行时战斗、任务、物品、剧情主链。
+4. **收益直接。**
+   一旦收掉，前端就少了一份最不该长期保留的高风险真相。
+
+一句话讲：
+
+**这一步先把“浏览器记住游客账号密码再重登”这条假真相链拔掉。**
+
+---
+
+## 3. 本批次明确没做的事
+
+## 3.1 没有直接删除 `runtimeStoryCoordinator.ts` 里的前置 `putSaveSnapshot(...)`
+
+这不是漏做，而是明确暂缓。
+
+当前复核结果是：
+
+1. `server-node/src/modules/story/storyActionService.ts`
+2. `server-node/src/routes/runtimeRoutes.ts`
+3. `server-node/src/repositories/runtimeRepository.ts`
+
+这条后端链当前仍然通过远端快照读取运行时状态，再执行：
+
+1. `getRuntimeStoryState`
+2. `resolveRuntimeStoryAction`
+
+也就是说，当前真实情况不是“前端多写了一份完全没用的镜像”，而是：
+
+**前端在提交动作前先把当前状态写回远端快照，后端再基于这份快照执行业务动作。**
+
+在这个 contract 没先升级为“前端只发 action，后端自己持有完整 session 真相”之前，前端不能直接把这一步砍掉。
+
+否则会出现：
+
+1. 动作请求仍在走
+2. 但服务端读取到的执行基线不完整
+3. 最后不是收口真相，而是把主链打断
+
+## 3.2 没有删除 `runtimeStoryService.ts` / `runtimeStoryCoordinator.ts` 的快照再水合逻辑
+
+这一步本轮也做了复核，结论是：
+
+1. 我曾尝试把 `runtimeStoryCoordinator.ts` 中对服务端返回快照的重复再水合去掉
+2. 但对应的 `runtimeStoryCoordinator` 测试立即暴露出：当前后端返回的快照在部分战斗场景下还不是完整水合态
+3. 说明前端当前这层再水合仍然有现实职责，不是纯多余代码
+
+所以这一步本批明确结论是：
+
+**暂不删除，等后端快照 contract 先补完整后再做。**
+
+---
+
+## 4. 本批次验证结果
+
+本批次已完成的定向验证：
+
+1. `npx vitest run src/services/authService.test.ts`
+2. `npx vitest run src/components/auth/AuthGate.test.tsx`
+3. `npx vitest run src/hooks/story/runtimeStoryCoordinator.test.ts`
+4. `npm run check:encoding`
+
+结果：
+
+1. `authService` 测试通过
+2. `AuthGate` 测试通过
+3. `runtimeStoryCoordinator` 测试通过
+4. 编码检查通过
+
+另外执行了：
+
+1. `npm run build`
+
+结果：
+
+构建产物生成成功，但 `build-gate` 仍因主包 chunk warning 拦截失败。  
+当前失败点仍是已知的主包体积问题：
+
+- `AuthenticatedApp-*.js` 超过当前 warning 门槛
+
+这属于仓库当前既有工程问题，不是本批次引入的新断裂。
+
+---
+
+## 5. 本批次完成后的实际收益
+
+这一步完成后，工程在鉴权边界上有了两个明确改善：
+
+1. **前端不再保存自动登录用户名 / 密码。**
+   浏览器只保留 access token，本地高风险游客凭证真相已经收掉。
+2. **登录恢复逻辑更接近服务端为真相源。**
+   `AuthGate` 不再假设“没有本地 token 就一定还没登录”，而是优先尝试服务端会话恢复。
+
+这意味着前端鉴权链已经从：
+
+```text
+本地用户名/密码 -> 再次 entry -> 拿 token
+```
+
+进一步收到了：
+
+```text
+refresh session / 当前会话 -> 恢复用户
+兜底时才创建一次游客凭证
+```
+
+---
+
+## 6. 本批次后续建议
+
+要继续完成批次 C，下一步不该直接在前端硬删，而应该先补后端 contract：
+
+1. 让 `runtime story` 动作链逐步摆脱“前端先写远端快照”的依赖
+2. 让服务端自己持有更完整的运行时 session 真相
+3. 等后端返回快照已经稳定水合后，再删前端的重复再水合
+
+换句话说，批次 C 的后半段应该拆成：
+
+1. **C-1：鉴权真相收口**  
+   本批已完成
+2. **C-2：运行时快照 contract 后端化**  
+   需要先改后端
+3. **C-3：前端镜像写入与重复水合退场**  
+   依赖 C-2
+
+---
+
+## 7. 一句话总结
+
+**批次 C 这一轮已经先把“浏览器长期保存游客账号密码”这条最不该存在的鉴权假真相链收掉了；而运行时快照前置写入这条链经过复核确认仍受后端 contract 约束，不能在服务端未先补齐前硬砍。**
--- a/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md
+++ b/docs/audits/engineering/ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md
@@ -0,0 +1,56 @@
+# 工程死分支清理执行记录 D（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 本批次目标
+
+本批次继续清理上一轮复核后剩余的低风险数据产物与测试占位：
+
+1. 未接入业务的生成产物
+2. 只为测试替换真实实现的空 stub
+3. 支撑这些残留的配置与脚本
+
+---
+
+## 1. 已删除对象
+
+| 文件 | 判定 | 删除原因 | 替代路径 / 当前真相源 |
+| --- | --- | --- | --- |
+| `src/data/buildTagSimilarity.generated.ts` | 未接入业务的生成产物 | 运行时代码不 import；Build 相似度当前由 `buildTags.ts` 中的属性亲和度逻辑计算 | `src/data/buildTags.ts` |
+| `scripts/generate-build-tag-similarity.py` | 已无输出目标的生成脚本 | 只负责生成已删除的矩阵文件，继续保留会误导后续开发恢复旧主源 | `src/data/buildTags.ts` 的手工审表逻辑 |
+| `src/data/customWorldCharacterLoadout.stub.ts` | 测试专用空 stub | 只通过 `vitest.config.ts` alias 替换真实实现；真实实现已经稳定存在 | `src/data/customWorldCharacterLoadout.ts` |
+
+---
+
+## 2. 同步更新
+
+本批次同步移除了：
+
+1. `vitest.config.ts` 中指向 `customWorldCharacterLoadout.stub.ts` 的 alias
+2. `BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md` 中把旧 generated 矩阵描述为当前文件的表述
+3. 清理计划里对 `buildTagSimilarity.generated.ts` 的未处理状态说明
+
+---
+
+## 3. 验证口径
+
+删除前已确认：
+
+1. `buildTagSimilarity.generated.ts` 无运行时代码引用
+2. `customWorldCharacterLoadout.stub.ts` 只被 `vitest.config.ts` alias 引用
+3. 真实 `customWorldCharacterLoadout.ts` 仍被 `characterPresets.ts` 与 `npcInteractions.ts` 使用，不能删除
+
+删除后建议验证：
+
+1. `npm run check:encoding`
+2. 与自定义世界开局物品相关的测试
+
+---
+
+## 4. 当前结论
+
+本批次完成后，剩余清理对象已经不再适合按“无引用直接删”推进。后续如果继续清，需要先改 contract 或主链职责：
+
+1. 运行时快照真相链
+2. 任务 / 物品 / AI 混合执行层
+3. 大型主流程组件继续拆分，而不是直接删除
--- a/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
+++ b/docs/audits/engineering/FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md
@@ -0,0 +1,503 @@
+# 前端应迁后端逻辑审计（2026-04-21）
+
+更新时间：`2026-04-21`
+
+## 0. 审计目标
+
+这份文档只回答一个问题：
+
+**当前前端代码里，哪些逻辑已经明显越过“前端只做表现，Express 后端负责逻辑、数据与存储”的边界，应该继续迁到后端。**
+
+本轮不改业务代码，只做：
+
+1. 基于当前仓库状态给出高置信度候选点
+2. 标明代码证据
+3. 给出迁移优先级
+4. 说明迁移后前端应该保留什么、移走什么
+
+---
+
+## 1. 结论先行
+
+结合当前代码与已有边界文档，前端里仍有 6 类逻辑应该继续后移：
+
+1. **运行时快照前置写入与本地镜像解释**
+2. **鉴权 token 的浏览器本地真相**
+3. **平台浏览历史的本地真相与迁移状态**
+4. **NPC 待接委托“换单”仍由前端直接触发正式生成**
+5. **quest/runtime item 的双环境混合编排**
+6. **浏览器侧大型 AI orchestration 与 prompt/repair/fallback 主链**
+
+一句话判断：
+
+**当前前端已经不是最早那种“大量主算”的状态，但仍然保留了运行时镜像、生成编排和部分正式真相。后端边界还需要再收一轮，前端才算真正退回表现层。**
+
+---
+
+## 2. 审计依据
+
+### 2.1 文档依据
+
+1. `docs/experience/PROJECT_WORK_EXPERIENCE_PLAYBOOK.md`
+2. `docs/planning/EXPRESS_BACKEND_REFACTOR_PLAN_2026-04-08.md`
+3. `docs/technical/RUNTIME_STORY_BACKEND_BOUNDARY_MIGRATION_2026-04-19.md`
+4. `docs/audits/engineering/ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md`
+5. `docs/audits/engineering/CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`
+
+### 2.2 当前代码依据
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts`
+2. `src/services/apiClient.ts`
+3. `src/services/platformBrowseHistory.ts`
+4. `src/components/game-shell/PreGameSelectionFlow.tsx`
+5. `src/hooks/story/npcEncounterActions.ts`
+6. `src/services/questDirector.ts`
+7. `src/services/runtimeItemAiDirector.ts`
+8. `src/services/ai.ts`
+
+---
+
+## 3. 当前高置信度应后移逻辑
+
+## 3.1 运行时快照前置写入仍在前端
+
+### 代码证据
+
+`src/hooks/story/runtimeStoryCoordinator.ts` 当前仍存在以下链路：
+
+1. `syncRuntimeSnapshot(...)`
+2. `syncRuntimeSnapshot(...)` 内部直接调用 `putSaveSnapshot(...)`
+3. `loadServerRuntimeOptionCatalog(...)` 在请求 `getRuntimeStoryState(...)` 之前先写本地快照
+4. `resolveServerRuntimeChoice(...)` 在请求 `resolveRuntimeStoryAction(...)` 之前先写本地快照
+
+对应位置：
+
+1. `src/hooks/story/runtimeStoryCoordinator.ts:21`
+2. `src/hooks/story/runtimeStoryCoordinator.ts:25`
+3. `src/hooks/story/runtimeStoryCoordinator.ts:36`
+4. `src/hooks/story/runtimeStoryCoordinator.ts:99`
+
+### 当前问题
+
+这意味着运行时正式动作发起前，前端仍会先落一份自己的快照真相，再去请求后端。
+
+这条链的问题不是“有没有缓存”，而是：
+
+1. 前端仍在承担正式提交前的状态镜像
+2. 快照解释权没有完全收回到后端
+3. 运行时主链仍处于“本地镜像 + 服务端会话”并存状态
+
+### 迁移建议
+
+后端继续承接：
+
+1. 运行时快照写入
+2. 快照版本解释
+3. 动作提交前的状态一致性校验
+
+前端只保留：
+
+1. 当前展示用的 view model
+2. 可选的只读恢复缓存
+3. 纯表现态的 loading / transition / animation state
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.2 鉴权 token 仍由前端 localStorage 持有真相
+
+### 代码证据
+
+`src/services/apiClient.ts` 当前仍直接访问 `window.localStorage` 保存 access token：
+
+1. `getStoredAccessToken()`
+2. `setStoredAccessToken(...)`
+3. `clearStoredAccessToken(...)`
+4. `withAuthorizationHeaders(...)` 直接从本地 token 组装请求头
+
+对应位置：
+
+1. `src/services/apiClient.ts:333`
+2. `src/services/apiClient.ts:341`
+3. `src/services/apiClient.ts:362`
+4. `src/services/apiClient.ts:382`
+
+### 当前问题
+
+第三批清理已经收掉了“自动登录用户名/密码”本地真相，但 access token 仍然由浏览器长期持有。
+
+这在当前项目边界下仍有两个问题：
+
+1. 正式鉴权真相仍没有完全收回后端 session 边界
+2. 前端 SDK 仍然负担 token 生命周期的关键部分
+
+### 迁移建议
+
+后端继续承接：
+
+1. session / refresh / cookie 真相
+2. 鉴权状态续期
+3. token 更新与失效策略
+
+前端只保留：
+
+1. 当前是否已登录的展示态
+2. 统一的请求封装
+3. 401 后的 UI 响应
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.3 平台浏览历史仍是“前端本地历史 + 后端回填”的双真相
+
+### 代码证据
+
+`src/services/platformBrowseHistory.ts` 当前仍维护一整套本地历史真相：
+
+1. `readPlatformBrowseHistory(...)`
+2. `writePlatformBrowseHistory(...)`
+3. `hasPendingPlatformBrowseHistoryMigration(...)`
+4. `markPlatformBrowseHistoryMigrated(...)`
+
+对应位置：
+
+1. `src/services/platformBrowseHistory.ts:77`
+2. `src/services/platformBrowseHistory.ts:103`
+3. `src/services/platformBrowseHistory.ts:151`
+4. `src/services/platformBrowseHistory.ts:164`
+
+`src/components/game-shell/PreGameSelectionFlow.tsx` 当前仍显式做：
+
+1. 先 `writePlatformBrowseHistory(...)`
+2. 再调用 `upsertProfileBrowseHistory(...)`
+3. 同步成功后 `markPlatformBrowseHistoryMigrated(...)`
+4. 启动阶段读取 `readPlatformBrowseHistory(...)`
+5. 根据 `hasPendingPlatformBrowseHistoryMigration(...)` 决定是否补同步
+
+对应位置：
+
+1. `src/components/game-shell/PreGameSelectionFlow.tsx:383`
+2. `src/components/game-shell/PreGameSelectionFlow.tsx:392`
+3. `src/components/game-shell/PreGameSelectionFlow.tsx:394`
+4. `src/components/game-shell/PreGameSelectionFlow.tsx:433`
+5. `src/components/game-shell/PreGameSelectionFlow.tsx:466`
+
+### 当前问题
+
+这条链已经不是单纯缓存，而是：
+
+1. 本地历史存储
+2. 本地同步标记
+3. 后端历史持久化
+
+三套状态同时存在。
+
+### 迁移建议
+
+后端继续承接：
+
+1. 浏览历史唯一持久化真相
+2. 历史去重、排序、截断
+3. 迁移完成标记
+
+前端只保留：
+
+1. 展示缓存
+2. 弱网下的临时 optimistic UI
+3. 刷新后重新拉取远端结果
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.4 NPC 待接委托“换单”仍由前端直接发起正式生成
+
+### 代码证据
+
+`src/hooks/story/npcEncounterActions.ts` 当前仍保留：
+
+1. `replacePendingNpcQuestOffer = async () => { ... }`
+2. 内部直接调用 `generateQuestForNpcEncounter(...)`
+
+对应位置：
+
+1. `src/hooks/story/npcEncounterActions.ts:1561`
+2. `src/hooks/story/npcEncounterActions.ts:1595`
+
+### 当前问题
+
+聊天后是否挂出待接委托已经后移，但“换一份委托”这条分支仍然是：
+
+1. 前端组装上下文
+2. 前端决定调用生成
+3. 前端直接把结果写回当前 story UI
+
+这仍属于正式运行时任务编排没有收干净。
+
+### 迁移建议
+
+后端继续承接：
+
+1. NPC 待接委托换单决策
+2. 是否允许换单
+3. 换单后的任务草案生成
+4. 对应聊天态快照回填
+
+前端只保留：
+
+1. 点击“换一份委托”
+2. loading / error 展示
+3. 消费后端返回的新 pending quest offer
+
+### 优先级
+
+`P0`
+
+---
+
+## 3.5 questDirector 仍是前端 SDK 与生成编排混合体
+
+### 代码证据
+
+`src/services/questDirector.ts` 当前同时承担：
+
+1. `generateQuestForNpcEncounter(...)`
+2. 浏览器路径 `requestJson('/api/runtime/quests/generate')`
+3. 非浏览器路径 `requestChatMessageContent(...)`
+4. 本地 `compileQuestIntentToQuest(...)` fallback
+
+对应位置：
+
+1. `src/services/questDirector.ts:213`
+2. `src/services/questDirector.ts:242`
+3. `src/services/questDirector.ts:267`
+4. `src/services/questDirector.ts:256`
+5. `src/services/questDirector.ts:281`
+6. `src/services/questDirector.ts:293`
+
+### 当前问题
+
+这类文件虽然浏览器正式路径已经优先走后端，但职责仍混在一起：
+
+1. 前端 SDK
+2. Quest prompt 编排
+3. Quest intent 解析
+4. deterministic fallback compile
+
+这会导致边界长期模糊，也让前端仍像“半个服务端”。
+
+### 迁移建议
+
+后端继续承接：
+
+1. quest intent 生成
+2. prompt 组装
+3. JSON 解析
+4. fallback compile
+
+前端只保留：
+
+1. `requestGenerateQuest(...)` 这类轻量 SDK
+2. 请求参数组装
+3. 结果消费
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.6 runtimeItemAiDirector 仍是前端 SDK 与意图生成混合体
+
+### 代码证据
+
+`src/services/runtimeItemAiDirector.ts` 当前同时承担：
+
+1. `generateRuntimeItemAiIntents(...)`
+2. 浏览器路径 `requestJson('/api/runtime/items/runtime-intent')`
+3. 非浏览器路径 `requestChatMessageContent(...)`
+4. 本地 `buildRuntimeItemAiIntent(...)` fallback
+
+对应位置：
+
+1. `src/services/runtimeItemAiDirector.ts:84`
+2. `src/services/runtimeItemAiDirector.ts:94`
+3. `src/services/runtimeItemAiDirector.ts:118`
+
+### 当前问题
+
+它和 `questDirector` 是同类问题：
+
+1. 正式浏览器路径已经走后端
+2. 但前端文件仍然承担完整生成逻辑认知
+3. 文件职责仍然是双环境混合
+
+### 迁移建议
+
+后端继续承接：
+
+1. runtime item intent prompt
+2. 模型调用
+3. 结果解析与 fallback
+
+前端只保留：
+
+1. 轻量请求 SDK
+2. 结果到 UI 的映射
+
+### 优先级
+
+`P1`
+
+---
+
+## 3.7 `src/services/ai.ts` 仍是浏览器侧正式 AI orchestration 热点
+
+### 代码证据
+
+当前 `src/services/ai.ts` 仍直接承担以下正式链路：
+
+1. `requestChatMessageContent(...)`
+2. `requestPlainTextCompletionFromClient(...)`
+3. `streamPlainTextCompletionFromClient(...)`
+4. `generateCustomWorldProfile(...)`
+5. `generateInitialStory(...)`
+6. `generateNextStep(...)`
+7. `streamNpcChatDialogue(...)`
+8. `streamNpcRecruitDialogue(...)`
+
+对应位置：
+
+1. `src/services/ai.ts:1732`
+2. `src/services/ai.ts:1868`
+3. `src/services/ai.ts:2038`
+4. `src/services/ai.ts:2339`
+5. `src/services/ai.ts:2447`
+6. `src/services/ai.ts:2487`
+7. `src/services/ai.ts:2529`
+8. `src/services/ai.ts:2570`
+
+并且文件内仍保留：
+
+1. JSON repair
+2. prompt 组装
+3. response normalize
+4. fallback/offline 响应
+5. 角色聊天建议与摘要生成
+
+### 当前问题
+
+这说明浏览器端并不只是“请求一个后端接口”，而是还在承担：
+
+1. prompt source
+2. 生成策略
+3. 错误修复
+4. fallback 编排
+5. 多类业务场景的正式 AI 出口
+
+这与“前端只做表现”存在明确冲突。
+
+### 迁移建议
+
+后端继续承接：
+
+1. story / npc / recruit / custom-world 的 prompt 编排
+2. JSON repair
+3. fallback 策略
+4. streaming orchestration
+5. 模型调用与日志
+
+前端只保留：
+
+1. 轻量 AI SDK
+2. SSE 文本流展示
+3. UI fallback 呈现
+
+### 优先级
+
+`P0`
+
+---
+
+## 4. 可以暂时保留在前端的部分
+
+下面这些内容即使和上述模块同文件出现，也不属于必须后移的对象：
+
+1. 面板开关、loading、error、streaming 文本展示
+2. 动画时间线、过场状态、临时 UI 回显
+3. 表单草稿、筛选词、排序选项
+4. 只影响表现、不影响正式真相的 view model 拼接
+
+迁移时要注意：
+
+**不是把所有前端代码都往后端搬，而是把“正式状态解释、规则裁决、生成编排、持久化真相”搬走。**
+
+---
+
+## 5. 推荐迁移顺序
+
+## 5.1 第一阶段
+
+先收最危险的正式真相：
+
+1. `runtimeStoryCoordinator.ts`
+2. `apiClient.ts`
+3. `npcEncounterActions.ts` 里的 quest replace 分支
+
+原因：
+
+1. 这三处最直接影响运行时真相和动作主链
+2. 不先收这些，前端仍然不是纯表现层
+
+## 5.2 第二阶段
+
+再拆双环境混合服务：
+
+1. `questDirector.ts`
+2. `runtimeItemAiDirector.ts`
+3. `platformBrowseHistory.ts`
+
+原因：
+
+1. 这几处已经有后端承接基础
+2. 迁移成本相对可控
+
+## 5.3 第三阶段
+
+最后继续压缩浏览器 AI orchestration：
+
+1. `src/services/ai.ts`
+2. 相关 prompt builder / repair helper / offline fallback
+
+原因：
+
+1. 这部分体量大
+2. 链路多
+3. 更适合在前两阶段把 contract 稳住后集中拆
+
+---
+
+## 6. 建议产出物
+
+如果后续按这份文档继续落地，建议每一批都至少同步产出：
+
+1. 一份落地文档，说明迁移了哪条链
+2. 一组 contract/route 变更说明
+3. 一组前端 SDK 收缩说明
+4. 一组防回退测试
+
+---
+
+## 7. 一句话结论
+
+当前前端最需要继续后移的，不是零散小工具，而是：
+
+**运行时快照前置写入、鉴权 token、本地浏览历史真相、NPC 委托换单、quest/runtime item 双环境混合编排，以及 `src/services/ai.ts` 里仍然留在浏览器的正式 AI orchestration。**
--- a/docs/audits/engineering/README.md
+++ b/docs/audits/engineering/README.md
@@ -4,21 +4,36 @@

 ## 当前推荐入口

-1. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
+1. [FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md](./FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md)
+   这一版是本轮前端越界逻辑专项审计，专门汇总当前仍应继续迁到 Express 后端的运行时、鉴权、生成编排与本地真相残留。
+2. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md)
+   这一版是第四批落地记录，聚焦未接入业务的数据生成产物、测试专用 stub 与对应配置残留出清。
+3. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md)
+   这一版是第三批落地记录，聚焦鉴权真相收口，先移除前端保存自动登录用户名/密码的本地真相，并明确运行时快照前置写入为什么当前还不能硬砍。
+4. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md)
+   这一版是第二批落地记录，聚焦旧主流程壳层、旧 bootstrap 和旧 inventory / forge / equipment flow Hook 的正式出清。
+5. [ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md](./ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md)
+   这一版是第一批落地记录，聚焦高置信度小型孤岛、prompt 壳子、stub 和无入口 modal 的首轮清理。
+6. [CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md](./CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md)
   这一版是面向当前仓库状态的优化点盘点，适合直接拿来排优先级和拆执行批次。
-2. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
+7. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md)
   这一版是对 `2026-04-19` 基线的当前仓库复核，明确哪些问题已经处理、哪些表述需要纠正、热点又迁移到了哪里。
-3. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
+8. [ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md](./ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.md)
   这一版保留原始问题快照和执行回填，适合回看“为什么会有这轮清理与边界收口”。
-4. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
+9. [ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-04-01.md)
   这一版最适合作为当前工程基线，重点从“是否真正绿色”“门禁有没有覆盖真实风险”来判断仓库状态。
-5. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
+10. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-30.md)
   适合回看运行时主链路、Story/Combat 边界、分层过渡期问题。
-6. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
+11. [ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md](./ENGINEERING_OPTIMIZATION_REVIEW_2026-03-29.md)
   适合看第一轮系统性工程扫描，了解最早的问题基线。

 ## 融合结论

+- 最新专项审计已经把“前端哪些逻辑还该后移到后端”收敛到 6 类：运行时快照、本地 token、本地浏览历史、NPC 委托换单、quest/runtime item 混合编排、浏览器 AI orchestration。
+- 工程大清洗已经开始进入实际执行阶段，首批高置信度小型孤岛和残留壳子已开始清理。
+- 第二批已经开始清理旧主流程壳层与旧 flow Hook，当前主工程的“现行入口”和“历史入口”边界正在变得更清楚。
+- 第三批已经先完成鉴权真相收口的一段，前端不再保存自动登录用户名/密码；运行时快照链仍需先补后端 contract，再继续往前删。
+- 第四批已经继续收掉未接入业务的数据生成产物、测试专用 stub 与对应脚本/配置残留，主工程里的“假数据主源”进一步减少。
 - 当前仓库已经完成“旧 dev 插件链路删除、根目录噪音清理、`server-node -> src/**` 反向依赖切断”这批第一阶段任务。
 - 当前如果想直接判断“今天先优化什么”，优先看 `CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md`。
 - 当前的新重点已经进一步收敛到三类：未接线孤岛模块、前端残留的运行时/鉴权真相、热点向 prompt/runtime profile/平台入口壳层迁移。
--- a/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md
+++ b/docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md
@@ -22,20 +22,20 @@

 ### 2.1 编辑器入口与页签整理

- 保留 `/preset-editor`、`/npc-editor`、`/function-editor`
- 新增 `/behavior-editor` 作为“选项行为”编辑页别名
+- 当时曾保留 `/preset-editor`、`/npc-editor`、`/function-editor`
+- 当时还新增过 `/behavior-editor` 作为“选项行为”编辑页别名
 - 将原先单独的 `NPC 视觉` 标签并回 `NPC` 编辑页
 - 将 `Function` 页签改名为 `选项行为`

 结论：
- 路由层要尽量兼容旧入口，避免历史链接失效
+- 独立编辑器入口如果没有继续接入主流程，应及时物理删除，不要长期保留兼容壳
 - 页签命名要贴近创作者语言，而不是内部实现命名

 ### 2.2 NPC 视觉模块并入 NPC 编辑

 完成内容：

- 将 [NpcVisualEditor](/E:/Repos/Genarrative/src/components/NpcVisualEditor.tsx) 嵌入 [PresetEditor](/E:/Repos/Genarrative/src/components/PresetEditor.tsx) 的 NPC 编辑页
+- 当时曾将 `NpcVisualEditor` 嵌入 `PresetEditor` 的 NPC 编辑页
 - 让 NPC 文本字段与视觉字段围绕同一个当前选中 NPC 联动
 - 保留视觉覆盖保存与全局布局保存能力

--- a/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md
+++ b/docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md
@@ -86,6 +86,22 @@
 2. 不为了“文档里写过”就把所有没接线面板都接进来
 3. 不把当前工作区重新改造成一个更复杂的大后台

+补充更新（`2026-04-21`）：
+
+上一轮审计里提到的一组旧 Agent 副面板，已经在工程清理中被明确判定为退出当前版本主链并物理删除，包括：
+
+1. `CustomWorldAgentLockBar.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+3. `CustomWorldAgentSummaryPanel.tsx`
+4. `CustomWorldAgentIntentSummaryPanel.tsx`
+5. `CustomWorldAgentClarificationPanel.tsx`
+6. `CustomWorldAgentDraftDetailPanel.tsx`
+7. `CustomWorldDraftCardDetailModal.tsx`
+8. `CustomWorldDraftEditPanel.tsx`
+9. `CustomWorldGenerateEntityModal.tsx`
+
+所以这里的“不为了文档里写过就全接进来”，现在不只是态度提醒，而是已经执行过的现实边界。
+
 ### 3.3 不把结果页继续当旧编辑器扩写

 这轮明确不再鼓励：
@@ -244,6 +260,15 @@

 尤其是旧 `custom-world/sessions` 这条链，如果还要保留，也只能是兼容入口，不能再和 Agent 主链平起平坐。

+补充更新（`2026-04-21`）：
+
+这条旧 `custom-world/sessions` 世界生成链已经完成物理删除。
+
+因此阶段三在当前仓库里的剩余任务，不再是“决定要不要保留这条旧链”，而是：
+
+1. 继续收掉结果页 legacy profile 直改能力的误导性职责
+2. 继续清理文档里把旧链当成现行选项的表述
+
 ---

 ## 4.5 第五件事：把文稿里那些“这轮不做”的未完成项从主叙事里移掉
@@ -323,6 +348,12 @@
 2. 把“未来也许做”从“这轮要做”里拆开
 3. 让所有当前规划只服务当前版本

+就当前状态补一句最重要的执行口径：
+
+1. 已经物理删除的旧链和旧副面板，不再作为“本轮待落地项”
+2. 历史 PRD 可以保留实现设想，但必须和“当前版本执行规划”分开
+3. 当前版本规划只保留仍对正式主链有现实约束的事项
+
 这一阶段的目标是：

 **让接下来所有开发都围绕同一套现实目标执行。**
--- a/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
+++ b/docs/planning/ENGINEERING_DEAD_CODE_AND_HIDDEN_BRANCH_CLEANUP_PLAN_2026-04-21.md
@@ -164,7 +164,7 @@ Git 分支治理可以后置做，但不能和首轮工程清洗混在一起，
 11. `src/services/typewriter.ts`
 12. `src/prompts/customWorldOrchestratorPrompts.ts`
 13. `src/prompts/storyOrchestratorPrompts.ts`
-14. `src/data/buildTagSimilarity.generated.ts`
+14. `src/data/buildTagSimilarity.generated.ts`（已在后续清理批次中删除）

 这些文件不能直接判死刑，但必须进入“保留 / 接回 / 归档 / 删除”四选一清单。

--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE1_IMPLEMENTATION_PLAN_2026-04-13.md
@@ -2,6 +2,16 @@

 更新时间：`2026-04-13`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第一阶段历史落地方案。
+
+补充边界：
+
+1. 文中出现的旧 Agent 副面板、旧世界生成链，不代表它们仍是当前版本待落地项
+2. 已被工程清理判定退出主链并删除的对象，应以最新清理记录为准，不再按这里的历史计划继续接回
+3. 当前版本执行优先级，应回到 `docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md`
+
 ## 0. 文档目的

 这份文档用于把以下两份 PRD 收束成可直接开工的第一阶段实现方案：
@@ -1056,6 +1066,16 @@ onSubmit({

 ## 12. 落地文件清单

+### 当前状态补充（2026-04-21）
+
+下面这份文件清单是第一阶段编写当日的历史落地清单。
+
+需要特别注意：
+
+1. 其中列出的 `CustomWorldAgentLockBar.tsx`、`CustomWorldAgentQuickActions.tsx` 等旧副面板，已经在当前版本清理中退出主链并物理删除
+2. 因此这里不能再被当作“当前版本仍要补齐的现行文件清单”
+3. 当前仍然有效的执行边界，应以最新优化规划和清理记录为准
+
 ## 12.1 shared

 必须新增：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE2_IMPLEMENTATION_PLAN_2026-04-13.md
@@ -2,6 +2,15 @@

 更新时间：`2026-04-13`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第二阶段历史落地方案。
+
+补充边界：
+
+1. 文中提到的 `CustomWorldAgentIntentSummaryPanel`、`CustomWorldAgentClarificationPanel`、`CustomWorldAgentLockBar`、`CustomWorldAgentQuickActions` 等旧副面板，已经在当前版本收口判断中退出主链并物理删除
+2. 这些内容现在只能作为历史设计参考，不再作为当前版本默认待接线项
+3. 当前如果要重新设计这些能力的消费方式，应基于现行主链重新定义
 ## 0. 文档目的

 这份文档用于把以下两份文档进一步收束成第二阶段实现方案：
@@ -548,6 +557,21 @@ buildPendingClarifications(intent, readiness)

 ## 10. 前端实现方案

+### 当前状态补充（2026-04-21）
+
+这一节描述的是第二阶段编写当时的右侧副面板方案。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentIntentSummaryPanel`
+2. `CustomWorldAgentClarificationPanel`
+3. `CustomWorldAgentLockBar`
+4. `CustomWorldAgentQuickActions`
+
+这组旧副面板不再作为当前版本默认待接线方向，其中对应已落地但退出主链的文件也已物理删除。
+
+因此本节以下内容应视为历史设计稿，不再直接代表当前版本执行方案。
+
 ## 10.1 修改 `CustomWorldAgentWorkspace.tsx`

 第二阶段它不再只是空壳工作区，而要新增：
@@ -679,6 +703,12 @@ buildPendingClarifications(intent, readiness)

 ## 13. 落地文件清单

+### 当前状态补充（2026-04-21）
+
+本节列的是第二阶段历史文件清单。
+
+其中涉及旧副面板的部分，现在只保留历史参考价值，不再等同于当前版本待落地项。
+
 ## 13.1 shared

 必须修改：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE3_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@

 更新时间：`2026-04-14`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第三阶段历史落地方案。
+
+补充边界：
+
+1. 文中涉及的 `CustomWorldAgentQuickActions`、`CustomWorldAgentDraftDetailPanel`、`CustomWorldDraftCardDetailModal` 等旧副面板，已在当前版本清理中退出主链并物理删除
+2. 因此这份文档里的对应实现章节，不能再直接视为当前版本待继续补完的目标
+3. 当前版本只保留对正式主链仍有现实约束的能力项
 ## 0. 文档目的

 这份文档用于把以下几份文档进一步收束成第三阶段实现方案：
@@ -721,6 +730,21 @@ object_refining

 ## 11. 前端实现方案

+### 当前状态补充（2026-04-21）
+
+这一节描述的是第三阶段编写当时的草稿抽屉与详情侧栏方案。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDrawer.tsx` 已在 earlier cleanup 中删除
+2. `CustomWorldAgentDraftDetailPanel.tsx`
+3. `CustomWorldDraftCardDetailModal.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+
+已在当前版本收口判断中退出主链并物理删除。
+
+因此本节以下内容应视为历史设计稿，而不是当前版本默认待落地方案。
+
 ## 11.1 修改 `CustomWorldAgentQuickActions.tsx`

 第三阶段必须让：
@@ -918,6 +942,12 @@ creatorIntentReadiness.isReady === false

 ## 14. 落地文件清单

+### 当前状态补充（2026-04-21）
+
+本节列的是第三阶段历史文件清单。
+
+其中涉及旧抽屉、旧详情面板、旧快捷动作面板的部分，当前仅保留历史参考意义。
+
 ## 14.1 shared

 必须修改：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE4_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@

 更新时间：`2026-04-14`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第四阶段历史落地方案。
+
+补充边界：
+
+1. 文中聚焦的草稿详情编辑链与实体生成弹窗链，在当前版本收口判断中已经退出主链
+2. 对应的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldDraftEditPanel`、`CustomWorldGenerateEntityModal`、`CustomWorldAgentQuickActions` 等文件已物理删除
+3. 当前版本不再把这套旧副面板链作为默认待接线方向
 ## 0. 文档目的

 这份文档用于把以下几份文档进一步收束成第四阶段实现方案：
@@ -665,6 +674,21 @@ generateAdditionalLandmarks(params)

 ## 10. 前端实现方案

+### 当前状态补充（2026-04-21）
+
+这一节描述的是第四阶段编写当时的草稿详情编辑链与实体生成弹窗链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldDraftEditPanel.tsx`
+3. `CustomWorldGenerateEntityModal.tsx`
+4. `CustomWorldAgentQuickActions.tsx`
+
+已在当前版本收口判断中退出主链并物理删除。
+
+因此本节以下内容只保留历史设计参考价值，不再直接代表当前版本执行方向。
+
 ## 10.1 修改 `CustomWorldAgentDraftDetailPanel.tsx`

 第四阶段它要从只读详情升级成：
@@ -851,6 +875,12 @@ editableSectionIds: []

 ## 13. 落地文件清单

+### 当前状态补充（2026-04-21）
+
+本节列的是第四阶段历史文件清单。
+
+其中涉及草稿详情编辑链与实体生成弹窗链的部分，不再等同于当前版本待落地清单。
+
 ## 13.1 shared

 必须修改：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE5_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@

 更新时间：`2026-04-14`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第五阶段历史落地方案。
+
+补充边界：
+
+1. 文中继续沿用的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldAgentQuickActions` 等旧副面板，在当前版本已经退出主链并物理删除
+2. 因此这份文档里的实现安排，不应再被直接视为当前版本执行清单
+3. 当前版本是否重引入相关能力，必须基于新的主链设计重新判断
 ## 0. 文档目的

 这份文档用于把以下几份文档进一步收束成第五阶段实现方案：
@@ -195,6 +204,19 @@

 ## 7.2 入口位置

+### 当前状态补充（2026-04-21）
+
+这一节以下描述依赖当时仍被视为现行方案的旧详情面板链与旧快捷动作链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+
+已退出主链并物理删除。
+
+因此这里关于入口位置的说明，现在只能作为历史资产工坊设计参考，不再代表当前版本 UI 入口。
+
 ### 角色卡详情入口

 在 `CustomWorldAgentDraftDetailPanel` 中，当当前卡类型为：
@@ -548,6 +570,12 @@ mergeRoleAssetIntoDraftProfile(draftProfile, payload);

 ## 11. 前端实现方案

+### 当前状态补充（2026-04-21）
+
+本节以下内容依赖旧详情面板链与旧快捷动作面板。
+
+这些文件当前已经退出主链并删除，所以这里不再是当前版本的直接执行清单。
+
 ## 11.1 修改 `CustomWorldAgentDraftDetailPanel.tsx`

 当卡片类型为 `character` 时，新增：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PHASE6_IMPLEMENTATION_PLAN_2026-04-14.md
@@ -2,6 +2,15 @@

 更新时间：`2026-04-14`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为第六阶段历史落地方案。
+
+补充边界：
+
+1. 文中继续引用的 `CustomWorldAgentDraftDetailPanel`、`CustomWorldAgentQuickActions` 等旧副面板，在当前版本已经退出主链并物理删除
+2. 这份文档可用于回看当时的资产工坊设想，但不代表当前版本仍按这里逐项补齐
+3. 当前执行边界以最新优化规划和阶段四清理边界文档为准
 ## 0. 文档目的

 这份文档用于把以下几份文档进一步收束成第六阶段实现方案：
@@ -190,6 +199,19 @@

 ## 7.2 入口位置

+### 当前状态补充（2026-04-21）
+
+这一节以下描述依赖当时仍被视为现行方案的旧详情面板链与旧快捷动作链。
+
+但当前版本已经明确：
+
+1. `CustomWorldAgentDraftDetailPanel.tsx`
+2. `CustomWorldAgentQuickActions.tsx`
+
+已退出主链并物理删除。
+
+因此这里关于入口位置的说明，现在只保留历史场景资产工坊设计参考价值。
+
 ### 地点卡详情入口

 在 `CustomWorldAgentDraftDetailPanel` 中，当当前卡类型为：
--- a/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md
+++ b/docs/prd/AI_NATIVE_AGENT_FIRST_CUSTOM_WORLD_CREATOR_PRD_2026-04-12.md
@@ -2,6 +2,16 @@

 更新时间：`2026-04-12`

+## 0.1 当前状态说明（2026-04-21）
+
+这份文档保留为历史 PRD 基线，用于回看当时的完整目标设计。
+
+但需要特别注意：
+
+1. 文中涉及的一部分旧 Agent 副面板与旧世界生成链，已经在 `2026-04-21` 的工程清理中判定退出当前版本主链并完成物理删除
+2. 当前版本的真实执行边界，以 `docs/planning/CURRENT_AGENT_CREATION_FLOW_OPTIMIZATION_PLAN_2026-04-20.md`、`docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md` 和最新工程清理批次记录为准
+3. 阅读这份文档时，应把它视为“历史完整设计稿”，而不是“当前版本仍要全部继续落地的执行清单”
+
 ## 0. 文档目的

 这份 PRD 用于把以下几份分析文档收束成一份可直接指导编码落地的新创作工具产品需求文档：
--- a/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
+++ b/docs/prd/BUILD_SYSTEM_ATTRIBUTE_SIMILARITY_PRD_2026-04-02.md
@@ -8,7 +8,6 @@

 - `src/data/buildDamage.ts`
 - `src/data/buildTags.ts`
- `src/data/buildTagSimilarity.generated.ts`

 现状不是“标签各自独立生效”，而是：

@@ -263,7 +262,7 @@ type BuildDamageBreakdown = {

 ## 4.3 相似度来源

-当前仓库已有 `src/data/buildTagSimilarity.generated.ts`，但新方案不再以“标签-标签相似度矩阵”为主数据源。
+旧版曾生成过标签-标签相似度矩阵，但新方案不再以“标签-标签相似度矩阵”为主数据源。

 建议改为新增：

@@ -401,13 +400,13 @@ finalDamage =
 ### 风险 3：旧数据迁移成本

 问题：
-现有 `buildTagSimilarity.generated.ts` 将弱化甚至失去主要用途。
+旧标签相似度矩阵已经不再作为主数据源。

 对策：

-1. 本期不强制删除旧文件。
-2. 新逻辑只依赖新 affinity 表。
-3. 等新系统稳定后，再清理旧相似度矩阵和旧展示逻辑。
+1. 新逻辑只依赖标签定义中的属性亲和度。
+2. 旧相似度矩阵生成产物已从主工程移除。
+3. 后续若需要重新引入自动建议，也应输出为审表辅助数据，而不是运行时真相源。

 ## 11. 一句话结论

--- a/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md
+++ b/docs/reference/BUSINESS_PROMPT_INVENTORY_2026-04-19.md
@@ -74,7 +74,6 @@
 | `src/prompts/storyOrchestratorPrompts.ts` | 剧情中文修复 | `STORY_LANGUAGE_REPAIR_SYSTEM_PROMPT` |
 | `src/prompts/customWorldRolePromptDefaults.ts` | 角色资产工作台默认词唯一主源 | `buildDefaultRolePromptBundle` |
 | `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器技能动作词 | `buildSkillActionPrompt` |
-| `src/prompts/qwenSpriteSheetToolPrompts.ts` | Qwen 精灵图工具 prompt 模型 | 主 prompt / sheet prompt / repair prompt / negative prompt 系列 |

 ### 3.3 共享层

@@ -91,7 +90,6 @@
 - `src/services/questPrompt.ts`
 - `src/services/runtimeItemAiPrompt.ts`
 - `server-node/src/services/eightAnchorPromptBuilder.ts`
- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/asset-studio/customWorldRolePromptDefaults.ts`
 - `packages/shared/src/assets/qwenSprite.ts`

@@ -110,14 +108,12 @@
 | --- | --- | --- |
 | `server-node/src/prompts/characterAssetPrompts.ts` | 正式角色资产生成 prompt | 后端角色主图、动作试片、角色场景词主源 |
 | `packages/shared/src/prompts/qwenSprite.ts` | 共享角色主 prompt 模板 | 共享给后端资产链使用的基础模板 |
-| `src/prompts/qwenSpriteSheetToolPrompts.ts` | 工具链 prompt 模型 | Qwen 精灵图工具主词、分镜词、修帧词、负面词 |
 | `src/prompts/customWorldRolePromptDefaults.ts` | 工作台默认词种子 | 角色视觉词、动画词、场景词默认值 |
 | `src/prompts/customWorldEntityActionPrompts.ts` | 编辑器动作词 | 技能动作描述 prompt builder |

 当前调用关系：

 - `server-node/src/modules/assets/characterAssetRoutes.ts` 调用 `server-node/src/prompts/characterAssetPrompts.ts`
- `src/tools/QwenSpriteSheetTool.tsx` 通过兼容层消费 `src/prompts/qwenSpriteSheetToolPrompts.ts`
 - `src/components/CustomWorldRoleAssetStudioModal.tsx` 通过兼容层消费 `src/prompts/customWorldRolePromptDefaults.ts`
 - `src/components/CustomWorldEntityEditorModal.tsx` 直接调用 `src/prompts/customWorldEntityActionPrompts.ts`

@@ -145,7 +141,7 @@
 - `src/services/customWorld.ts` 中的自定义世界分阶段 prompt 与场景背景图 prompt
 - `src/services/ai.ts` 中的世界修复 / 语言修复 / JSON only system prompt
 - `src/services/prompt.ts`、`characterChatPrompt.ts`、`questPrompt.ts`、`runtimeItemAiPrompt.ts` 这批前端 prompt 脚本
- `src/tools/qwenSpriteSheetToolModel.ts`、`src/components/asset-studio/customWorldRolePromptDefaults.ts`、`src/components/CustomWorldEntityEditorModal.tsx` 里的工具 / 编辑器 prompt 散点
+- `src/components/asset-studio/customWorldRolePromptDefaults.ts`、`src/components/CustomWorldEntityEditorModal.tsx` 里的工具 / 编辑器 prompt 散点

 ## 8. 当前仍在非 Prompt 目录中的相关文件

--- a/docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md
+++ b/docs/technical/CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md
@@ -0,0 +1,36 @@
+# 创作页移动端 UI 修复记录
+
+日期：`2026-04-21`
+
+## 问题定位
+
+本轮修复只处理创作页表现层，不新增创作流程。
+
+当前移动端问题主要来自三处：
+
+1. 平台页在 `platformTab === 'create'` 时直接渲染 `CustomWorldCreationHub`，绕过了 `PlatformHomeView` 的移动端外壳，导致底部 Tab 栏没有挂载。
+2. 创作中心内部仍混用 `pixel-*` 九宫格样式、`bg-black/*`、`text-white`、`border-white/*` 等暗色 Tailwind 类，亮色主题下会出现深色块和低对比文字。
+3. 创作中心根节点自带 `h-full overflow-y-auto`，放回平台页后容易与平台页主滚动区抢滚动权，手机上会显得布局混乱。
+
+## 落地约束
+
+1. 创作页仍复用现有平台首页，不新增页面和新系统。
+2. 移动端底部 Tab 必须始终由 `PlatformHomeView` 统一渲染，创作页只作为 `create` Tab 的内容。
+3. 创作中心内部不再使用深色硬编码作为默认底色，普通卡片、筛选 Tab、空状态和按钮统一使用 `platform-*` token。
+4. 创作中心不再自建整页滚动，只把内容交给平台页主滚动区，避免嵌套滚动。
+5. UI 中不增加规则说明类文案，只保留必要入口、状态和作品信息。
+
+## 编码方案
+
+1. 在 `PlatformHomeView` 增加可选的 `createTabContent`，让当前 Agent 创作中心接回平台页统一外壳。
+2. `PreGameSelectionFlow` 不再在 `platformTab === 'create'` 时绕过 `PlatformHomeView`，而是把 `CustomWorldCreationHub` 作为创作 Tab 内容传入。
+3. `CustomWorldCreationHub` 改为无内部整页滚动的内容容器，标题、返回、计数、错误、加载骨架都使用平台 token。
+4. `CustomWorldCreationStartCard` 与 `CustomWorldWorkCard` 从像素暗色面板切换为平台卡片样式，保留游戏化主视觉但跟随亮暗主题。
+5. `CustomWorldWorkTabs` 改用 `platform-tab`，并保持横向滚动与清晰选中态。
+
+## 验收要点
+
+1. 手机宽度下进入“创作”后，底部“首页 / 创作 / 存档 / 我的”Tab 始终可见。
+2. 亮色主题下创作页默认卡片不出现大面积黑色底板。
+3. 创作页只有平台页主内容区滚动，底部 Tab 不随作品列表滚走。
+4. 桌面端仍可通过左侧平台导航进入创作页。
--- a/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
+++ b/docs/technical/CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md
@@ -6,12 +6,13 @@

 当前这条 Agent 创作流已经完成阶段一到阶段三的主要收口。

-阶段四中的“文档清理”已经开始做，但还没有形成独立、完整的新主链。
+阶段四中的“文档清理”已经开始做，但还没有形成独立、完整的新主链审计闭环。

-因此这轮可以执行的清理只有一类：
+因此这轮可以执行的清理现在有两类：

 1. 删除已经不再从当前主入口可达的旧 `custom-world/sessions` 世界生成链
-2. 保留仍在服务 `Agent session` 主链或已保存作品兼容编辑体验的底层能力
+2. 删除已经完全脱离 `CustomWorldAgentWorkspace` 主链、只剩孤立互相引用与自测覆盖的 `custom-world-agent` 旧面板
+3. 保留仍在服务 `Agent session` 主链或已保存作品兼容编辑体验的底层能力

 这轮不做：

@@ -60,7 +61,8 @@
 原因：

 1. 文档清理已经开始，但还没有完整收束到单一结论文档
-2. 旧 `custom-world/sessions` 生成链虽然已经不在主入口上，但还未清干净
+2. 旧 `custom-world/sessions` 生成链已经完成物理清理，但与之相关的审计/PRD/知识图谱文档仍需继续统一口径
+3. `custom-world-agent` 孤岛面板已经完成第二轮物理清理，但阶段四文档总收口仍未完全覆盖所有历史 PRD 口径

 ---

@@ -72,12 +74,29 @@
 2. `server-node/src/routes/runtimeRoutes.ts` 里的旧 `custom-world/sessions` 路由
 3. `server-node/src/services/customWorldGenerationService.ts`
 4. 与这条旧链对应的测试
+5. `server-node/src/services/customWorldSessionStore.ts`
+6. `src/components/custom-world-agent/CustomWorldAgentLockBar.tsx`
+7. `src/components/custom-world-agent/CustomWorldAgentQuickActions.tsx`
+8. `src/components/custom-world-agent/CustomWorldAgentSummaryPanel.tsx`
+9. `src/components/custom-world-agent/CustomWorldAgentIntentSummaryPanel.tsx`
+10. `src/components/custom-world-agent/CustomWorldAgentClarificationPanel.tsx`
+11. `src/components/custom-world-agent/CustomWorldAgentDraftDetailPanel.tsx`
+12. `src/components/custom-world-agent/CustomWorldDraftCardDetailModal.tsx`
+13. `src/components/custom-world-agent/CustomWorldDraftEditPanel.tsx`
+14. `src/components/custom-world-agent/CustomWorldGenerateEntityModal.tsx`
+15. 仅为上述孤岛面板存在的对应测试文件

 不允许删除：

-1. `server-node/src/services/customWorldSessionStore.ts`
-2. `server-node/src/repositories/runtimeRepository.ts` 中被 Agent session 复用的 session 持久化能力
-3. `src/services/aiService.ts` 里仍在使用的 `generateCustomWorldProfile` 及其现代封装
+1. `server-node/src/repositories/runtimeRepository.ts` 中被 Agent session 复用的 session 持久化能力
+2. `src/services/aiService.ts` 里仍在使用的 `generateCustomWorldProfile` 及其现代封装
+3. 已保存作品结果页仍在使用的 legacy 编辑器兼容能力
+4. `src/components/custom-world-agent/CustomWorldAgentWorkspace.tsx` 及其仍在主链上的 5 个子模块：
+   - `CustomWorldAgentHeader`
+   - `EightAnchorProgressBar`
+   - `CustomWorldAgentOperationBanner`
+   - `CustomWorldAgentThread`
+   - `CustomWorldAgentComposer`

 ---

@@ -87,6 +106,8 @@

 1. `src/services/aiService.ts` 不再暴露旧 `custom-world/sessions` 请求函数
 2. `server-node/src/routes/runtimeRoutes.ts` 不再挂旧 session 路由
-3. 仓库里不再有主流程可达的旧世界生成入口
-4. Agent 主链与已保存作品编辑链仍然可用
-
+3. `server-node/src/services/customWorldSessionStore.ts` 与 `server-node/src/services/customWorldGenerationService.ts` 已物理删除
+4. 仓库里不再有主流程可达的旧世界生成入口
+5. `CustomWorldAgentWorkspace.tsx` 只保留当前正式主链需要的 5 个子模块
+6. 与旧 Agent 草稿面板相关的孤岛 UI 与自测不再继续占据正式目录注意力
+7. Agent 主链与已保存作品编辑链仍然可用
--- a/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md
+++ b/docs/technical/EDITOR_ASSET_API_MIGRATION_2026-04-08.md
@@ -26,10 +26,6 @@
 - `GET /api/assets/character-animation/jobs/:taskId`
 - `POST /api/assets/character-animation/import-video`
 - `GET /api/assets/character-animation/templates`
- `POST /api/assets/qwen-sprite/master`
- `POST /api/assets/qwen-sprite/sheet`
- `POST /api/assets/qwen-sprite/frame-repair`
- `POST /api/assets/qwen-sprite/save`

 ---

@@ -50,7 +46,6 @@
 - 状态行为覆盖保存
 - 角色主形象生成、发布与任务查询
 - 角色动作生成、导入、发布、模板读取与任务查询
- Qwen 精灵主图、精灵表、修帧与资产保存

 ---

--- a/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md
+++ b/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md
@@ -0,0 +1,85 @@
+# 主流程外编辑器入口清理说明（2026-04-21）
+
+日期：`2026-04-21`
+
+## 1. 文档目标
+
+记录本轮对“挂在主流程路由外的旧编辑器入口”和“仍把这些入口当现役能力的残留说明”做的收口，避免后续开发再次把历史入口误判成正式能力。
+
+---
+
+## 2. 本轮清理结论
+
+本轮确认后，当前前端正式入口只保留游戏主流程：
+
+- `src/routing/appRoutes.tsx` 仅保留 `game`
+
+本轮删除或收口的对象：
+
+- 独立前端工具路由 `qwen-sprite-tool`
+- 仅服务该独立入口的前端页面 `src/tools/QwenSpriteSheetTool.tsx`
+- 仅服务该独立入口的工具模型与持久化封装
+- 仅服务该独立入口的后端路由 `server-node/src/modules/assets/qwenSpriteRoutes.ts`
+- 路由测试里把旧编辑器 / 独立工具入口当作现役分支的断言
+- README、经验文档、类型检查配置中已经失效的旧编辑器文件引用
+
+---
+
+## 3. 为什么可以删除
+
+本轮删除对象满足下面几个条件：
+
+1. 不在当前玩家主流程中可达
+2. 没有继续嵌入正式创作主链
+3. 当前仓库已有主流程内嵌的替代能力
+4. 保留它们只会继续制造“看起来还能进、实际上已经不走”的假入口
+
+其中需要特别区分的是：
+
+- `src/editor/shared/editorApiClient.ts`
+- `server-node/src/modules/editor/editorRoutes.ts`
+- `src/components/CustomWorldEntityEditorModal.tsx`
+- `src/components/CustomWorldNpcVisualEditor.tsx`
+- `src/components/CustomWorldRoleAssetStudioModal.tsx`
+
+这些仍然服务当前主流程内嵌编辑能力，因此本轮不删除。
+
+---
+
+## 4. 当前保留的编辑能力边界
+
+当前保留的是“嵌入主流程的编辑能力”，不是“独立编辑器站点”：
+
+- 自定义世界实体编辑
+- 自定义世界角色形象编辑
+- 主流程内的角色资产工坊模态
+- 与这些能力配套的 `/api/editor/*` 与 `/api/assets/character-*` 接口
+
+后续如果还要新增编辑能力，应优先：
+
+1. 先确认是否真的需要独立入口
+2. 默认优先接回主流程模态或正式创作链
+3. 如果只是内部工具，不要长期挂在正式前端路由里
+
+---
+
+## 5. 本轮同步更新
+
+本轮已同步更新：
+
+- `README.md`
+- `docs/experience/CODEX_PAST_WORK_EXPERIENCE_SUMMARY.md`
+- `src/routing/appRoutes.tsx`
+- `src/routing/appRoutes.test.ts`
+- `server-node/src/app.ts`
+- `tsconfig.typecheck-guardrails.json`
+
+---
+
+## 6. 后续建议
+
+后续继续清理时，优先沿着这条规则推进：
+
+1. 先识别是否还在主流程可达
+2. 再判断是否仍有正式嵌入点
+3. 若只剩文档、测试、兼容判断或独立路由壳，直接成批收口
--- a/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md
+++ b/docs/technical/NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md
@@ -150,10 +150,11 @@ JWT 现状：
 - `POST /api/custom-world/scene-image`
 - `POST /api/runtime/story/initial`
 - `POST /api/runtime/story/continue`
- `POST /api/runtime/custom-world/sessions`
- `GET /api/runtime/custom-world/sessions/:sessionId`
- `POST /api/runtime/custom-world/sessions/:sessionId/answers`
- `GET /api/runtime/custom-world/sessions/:sessionId/generate/stream`
+- `POST /api/runtime/custom-world/agent/sessions`
+- `GET /api/runtime/custom-world/agent/sessions/:sessionId`
+- `POST /api/runtime/custom-world/agent/sessions/:sessionId/messages`
+- `POST /api/runtime/custom-world/agent/sessions/:sessionId/actions`
+- `GET /api/runtime/custom-world/works`
 - `POST /api/runtime/chat/character/suggestions`
 - `POST /api/runtime/chat/character/summary`
 - `POST /api/runtime/chat/character/reply/stream`
@@ -183,10 +184,6 @@ JWT 现状：
 - `GET /api/assets/character-animation/jobs/:taskId`
 - `POST /api/assets/character-animation/import-video`
 - `GET /api/assets/character-animation/templates`
- `POST /api/assets/qwen-sprite/master`
- `POST /api/assets/qwen-sprite/sheet`
- `POST /api/assets/qwen-sprite/frame-repair`
- `POST /api/assets/qwen-sprite/save`

 编辑器与资产接口门禁：

@@ -227,9 +224,7 @@ Custom World：
 编辑器与资产工具层：

 - `src/editor/shared/editorApiClient.ts`
- `src/editor/shared/useJsonSave.ts`
 - `src/components/preset-editor/characterAssetStudioPersistence.ts`
- `src/tools/qwenSpriteSheetToolPersistence.ts`

 ## 10. 当前 Vite 角色

--- a/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md
+++ b/docs/technical/PROMPT_DIRECTORY_MANAGEMENT_2026-04-19.md
@@ -11,7 +11,6 @@
 - `server-node/src/services/eightAnchorPromptBuilder.ts`
 - `server-node/src/modules/assets/characterAssetRoutes.ts`
 - `src/services/**`
- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/**`

 问题主要有三类：
@@ -50,7 +49,6 @@ src/prompts/
 ├─ customWorldPrompts.ts
 ├─ customWorldRolePromptDefaults.ts
 ├─ questPrompts.ts
-├─ qwenSpriteSheetToolPrompts.ts
 ├─ runtimeItemPrompts.ts
 ├─ storyOrchestratorPrompts.ts
 └─ storyPromptBuilders.ts
@@ -82,8 +80,6 @@ src/prompts/
  - 八锚点状态推断、模式规则与正式单轮共创 prompt
 - `src/prompts/customWorldPrompts.ts`
  - 自定义世界分阶段生成 prompt 与场景背景图 prompt
- `src/prompts/qwenSpriteSheetToolPrompts.ts`
-  - 精灵图工具主词 / 分镜词 / 修帧词 / 负面词
 - `src/prompts/customWorldRolePromptDefaults.ts`
  - 角色资产工作台默认 prompt 种子唯一主源
 - `src/prompts/customWorldEntityActionPrompts.ts`
@@ -127,7 +123,6 @@ src/prompts/
 - `src/services/characterChatPrompt.ts`
 - `src/services/questPrompt.ts`
 - `src/services/runtimeItemAiPrompt.ts`
- `src/tools/qwenSpriteSheetToolModel.ts`
 - `src/components/asset-studio/customWorldRolePromptDefaults.ts`
 - `packages/shared/src/assets/qwenSprite.ts`

--- a/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md
+++ b/docs/technical/QWEN_IMAGE_2_PIXELMOTION_REPRODUCTION_WORKFLOW_2026-04-07.md
@@ -676,7 +676,7 @@ PixelMotion 很关键的一点，不是要求 16 帧都完美，而是允许修
 ### 13.4 推荐目录结构

 ```text
-pixelmotion-qwen/
+pixelmotion-workflow/
  refs/
    master.png
    pose_board_run.png
--- a/docs/technical/README.md
+++ b/docs/technical/README.md
@@ -13,6 +13,7 @@
 - [AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE2_2026-04-20.md)：阶段二把平台创作入口统一到聚合作品列表，并收紧 Agent 结果页的新增入口职责边界。
 - [AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md](./AGENT_RESULT_PROFILE_SYNC_PHASE3_2026-04-20.md)：阶段三继续降级旧 pipeline，让创作中心只认 Agent 草稿与已发布作品，并把 Agent 结果页冻结为预览收口层。
 - [CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md](./CURRENT_AGENT_CREATION_FLOW_STAGE4_CLEANUP_CHECK_2026-04-21.md)：对照当前优化计划核查四阶段完成度，并明确这轮只允许物理删除旧 `custom-world/sessions` 世界生成链，不误伤 Agent 主链与已保存作品兼容编辑链。
+- [CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md](./CREATION_PAGE_MOBILE_UI_FIX_2026-04-21.md)：创作页移动端底部 Tab、亮色主题 token 与滚动权责修复记录。
 - [TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md](./TXT_MODE_VISUAL_NOVEL_MIGRATION_EXECUTION_PLAN_2026-04-20.md)：把外部仓库 TXT 模式完整迁入当前项目的冻结边界、模块映射、分阶段计划与验收清单。
 - [NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md](./NODE_SERVER_KNOWLEDGE_GRAPH_2026-04-08.md)：当前 Node 运行时后端的技术栈、入口、鉴权、存储与接口知识图谱。
 - [EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md](./EXPRESS_BACKEND_INTEGRATION_FREEZE_2026-04-09.md)：Express 后端当前 contract 冻结版本、热点文件编辑规则与集成窗口清单。