创作数据流程收束

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. 若只剩文档、测试、兼容判断或独立路由壳，直接成批收口