Genarrative/docs/audits/engineering/README.md

工程优化审查总览

这一组只保留仍能指导当前 Rust / SpacetimeDB 主线的工程审查入口。早期连续扫描的有效结论已经合并到本 README 的“融合结论”，不再保留逐日旧稿。

当前推荐入口

1. SERVER_NODE_FREEZE_AND_DEPRECATION_2026-04-24.md 这一版是旧 Node 后端冻结、第一批物理删除与后续批次边界记录，明确当前工程只保留 Rust / SpacetimeDB 主线入口。
2. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_F_2026-04-21.md 这一版是第六批落地记录，聚焦删除无入口 questDirector、旧观察文案 helper、一次性硬编码同步脚本，并补齐后端运行时 function catalog 契约覆盖。
3. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_E_2026-04-21.md 这一版是第五批落地记录，聚焦旧命名 re-export、空路由骨架、旧发布服务、前端 prompt 镜像与无入口编辑器壳层的物理删除。
4. FRONTEND_LOGIC_BACKEND_MIGRATION_AUDIT_2026-04-21.md 这一版是本轮前端越界逻辑专项审计，专门汇总当前仍应继续迁到 server-rs 的运行时、鉴权、生成编排与本地真相残留。
5. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_D_2026-04-21.md 这一版是第四批落地记录，聚焦未接入业务的数据生成产物、测试专用 stub 与对应配置残留出清。
6. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_C_2026-04-21.md 这一版是第三批落地记录，聚焦鉴权真相收口，先移除前端保存自动登录用户名/密码的本地真相，并明确运行时快照前置写入为什么当前还不能硬砍。
7. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_B_2026-04-21.md 这一版是第二批落地记录，聚焦旧主流程壳层、旧 bootstrap 和旧 inventory / forge / equipment flow Hook 的正式出清。
8. ENGINEERING_DEAD_CODE_CLEANUP_BATCH_A_2026-04-21.md 这一版是第一批落地记录，聚焦高置信度小型孤岛、prompt 壳子、stub 和无入口 modal 的首轮清理。
9. CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md 这一版是面向当前仓库状态的优化点盘点，适合直接拿来排优先级和拆执行批次。
10. ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md 这一版是对 2026-04-19 基线的当前仓库复核，明确哪些问题已经处理、哪些表述需要纠正、热点又迁移到了哪里。
11. ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-19.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 这一轮进一步确认：前两类已经阶段性完成，当前真正剩下的是边界尾巴和新热点迁移。
• 如果是要看当前清理和边界收口的最新状态，优先看 ENGINEERING_CLEANUP_AND_BACKEND_BOUNDARY_AUDIT_2026-04-20.md。
• 如果是要看“当前可执行的优化点清单”，优先看 CURRENT_ENGINEERING_OPTIMIZATION_OPPORTUNITIES_2026-04-20.md。
• 如果是要做长期重构方案，从 2026-04-19、2026-04-20 与当前 dead-code batch 记录开始即可。