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