Genarrative/docs/technical/EDITOR_ENTRY_CLEANUP_2026-04-21.md

主流程外编辑器入口清理说明（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. 若只剩文档、测试、兼容判断或独立路由壳，直接成批收口