Genarrative/docs/audits/engineering

工程优化审查总览

这一组是同主题的连续审查记录，建议不要把它们当作三份彼此独立的文档来看。

当前推荐入口

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

融合结论

• 最新专项审计已经把“前端哪些逻辑还该后移到后端”收敛到 6 类：运行时快照、本地 token、本地浏览历史、NPC 委托换单、quest/runtime item 混合编排、浏览器 AI orchestration。
• 工程大清洗已经开始进入实际执行阶段，首批高置信度小型孤岛和残留壳子已开始清理。
• 第二批已经开始清理旧主流程壳层与旧 flow Hook，当前主工程的“现行入口”和“历史入口”边界正在变得更清楚。
• 第三批已经先完成鉴权真相收口的一段，前端不再保存自动登录用户名/密码；运行时快照链仍需先补后端 contract，再继续往前删。
• 第四批已经继续收掉未接入业务的数据生成产物、测试专用 stub 与对应脚本/配置残留，主工程里的“假数据主源”进一步减少。
• 第五批已经继续收掉旧命名 re-export、空路由骨架、旧发布 service、前端 prompt 镜像与无入口编辑器壳层，主工程里的“假入口”和“假 prompt 主源”进一步减少。
• 第六批已经继续收掉无入口 questDirector、旧观察文案 helper、一次性硬编码同步脚本，并修复 function catalog 对后端运行时契约的覆盖缺口。
• 当前仓库已经完成“旧 dev 插件链路删除、根目录噪音清理、server-node -> src/** 反向依赖切断”这批第一阶段任务。
• 当前如果想直接判断“今天先优化什么”，优先看 CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md。
• 当前的新重点已经进一步收敛到三类：未接线孤岛模块、前端残留的运行时/鉴权真相、热点向 prompt/runtime profile/平台入口壳层迁移。
• 三轮结论是一致收敛的：问题不在“有没有开始工程化”，而在“工程化是否真正覆盖了最危险的主链路”。
• 最新一轮已经把关注点集中到质量门禁、真实绿色基线、关键模块豁免和 build warning 上。
• 2026-04-19 这一轮把问题压实到了四类：仓库噪音、旧 dev 入口残留、前端越界运行时逻辑、巨型热点文件。
• 2026-04-20 这一轮进一步确认：前两类已经阶段性完成，当前真正剩下的是边界尾巴和新热点迁移。
• 如果只是为了判断现在先做什么，直接从 2026-04-01 开始即可。
• 如果是要看当前清理和边界收口的最新状态，优先看 ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md。
• 如果是要看“当前可执行的优化点清单”，优先看 CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md。
• 如果是要做长期重构方案，再按 2026-03-29 -> 2026-03-30 -> 2026-04-01 -> 2026-04-19 -> 2026-04-20 的顺序回看演进。