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