Genarrative/docs/audits/text/GAME_EDITOR_PRESET_TEXT_AUDIT_2026-03-29.md

游戏 UI / 预设 / 编辑器 UI 英文与乱码复查

日期：2026-03-29

结论摘要

• 当前分支里，确认存在源码级中文乱码的文件只有 1 个：src/components/CustomWorldEntityEditorModal.tsx。
• 历史上已经出现过的两处高风险乱码，本次未复现：
  • src/components/GameShell.tsx 角色选择页返回按钮
  • src/data/npcInteractions.ts 切磋敌对动作文案
• 目前更主要的问题已经从“大面积乱码”转成了三类：
  • 运行时 UI 里的英文缩写或英文句子
  • 编辑器 UI 里的英文术语、原始枚举值和英文缩写
  • 预设数据中的英文名称、分类、标签、世界倾向、构筑角色等原始值直接透到 UI

复查口径

• 只统计会直接进入游戏 UI、编辑器 UI、预设预览或运行时详情的文本。
• 不把纯内部实现名算进问题范围，比如接口路径、变量名、导入路径、素材文件夹名。
• 终端输出已切换到 UTF-8 后复查，避免把“控制台显示乱码”误判成“源码真实乱码”。

一、已确认的源码级乱码

1. 编辑器 UI

文件	行号	当前文本	说明
src/components/CustomWorldEntityEditorModal.tsx	360, 381	褰撳墠浼氱洿鎺...、棰勮 #...	场景预设选择弹窗的说明文案和预设编号标签已写坏
src/components/CustomWorldEntityEditorModal.tsx	551, 559, 569, 572, 578, 581, 584, 587	褰撳墠澶栬妯℃澘、褰㈣薄妯℃澘、鍚嶇О、绉板彿 / 韬唤、鑳屾櫙、鎬ф牸、鎴樻枟椋庢牸、鏍囩	可扮演角色编辑表单的标题与字段标签存在真实乱码
src/components/CustomWorldEntityEditorModal.tsx	663, 666, 669, 672	鍚嶇О、韬唤 / 鑱岃兘、鎻忚堪、鍔ㄦ満	普通 NPC 编辑表单字段标签存在真实乱码，即“创建自定义世界 -> NPC 编辑页”这一段
src/components/CustomWorldEntityEditorModal.tsx	721, 732, 736, 739	鍦烘櫙、棰勮鍥句腑鐨勫垏纾...、鍚嶇О、鎻忚堪	场景编辑器默认回退文案、说明文案和字段标签存在真实乱码
src/components/CustomWorldEntityEditorModal.tsx	771, 791	瑙掕壊-${...}、['绾跨储', '浜掑姩']	默认新建数据本身带乱码，会继续流入编辑器与结果页

二、游戏 UI 中的英文残留

文件	行号	当前文本/值	说明
src/components/AdventurePanel.tsx	179-187	restores HP during an adventure run、fits offensive loadouts 等整句英文	奖励物品自动描述仍是英文句子，会直接进入运行时奖励详情
src/components/AdventureEntityModal.tsx	815-816, 988, 1124-1126, 1497	HP、MP	玩家、怪物、NPC 状态条与效果预览仍使用英文缩写
src/components/AdventureEntityModal.tsx	1071, 1109, 1426	NPC 信息、敌对NPC / NPC、NPC 背包	NPC 相关标题和标签仍是中英混排
src/components/CompanionCampModal.tsx	176-177, 232-233, 254	HP、MP、NPC	同行编队卡片和空态提示仍保留英文缩写
src/components/NpcModals.tsx	251, 355, 407	NPC 商品列表、NPC 商品、HP / MP	商店弹窗标题和物品效果预览仍是中英混排
src/components/CharacterDetailModal.tsx	117	数量 x{item.quantity}	数量前缀里仍保留英文乘号写法

三、编辑器 UI 中的英文残留

文件	行号	当前文本/值	说明
src/components/ItemCatalogEditor.tsx	601, 617-623	neutral / wuxia / xianxia、tag 原始值	世界倾向和标签直接显示原始英文值
src/components/ItemCatalogEditor.tsx	637-651, 689	HP、MP、Build Buff、CD	属性预览、使用效果和背包卡片预览仍有英文缩写/术语
src/components/ItemCatalogEditor.tsx	662-665	buildProfile.role、synergy 原始值	构筑角色和协同标签直接暴露英文角色定位值
src/components/ItemCatalogEditor.tsx	712, 824, 841	物品 ID、使用 Build Buff、套装 ID	字段标签里仍有 ID / Build Buff
src/components/StateFunctionEditor.tsx	843-846, 910	HP、No visible target	预览摘要和实时状态里仍有英文缩写与整句英文
src/components/StateFunctionEditor.tsx	1089-1091	Option behavior overrides saved.、Failed to save option behavior overrides	保存反馈文案仍是英文
src/components/StateFunctionEditor.tsx	1133, 1212, 1218	definition.state、AnimationState、idle/move/attack	原始状态值和动画值仍直接显示
src/components/PresetEditor.tsx	86-88, 2212	NPC、敌对 NPC	页签和说明文案仍有 NPC 英文缩写
src/components/PresetEditor.tsx	893-910, 1997-2000	AnimationState、steady/burst/...、idle/move/attack/die	技能动作、技能风格、怪物预览动作直接显示原始英文枚举值
src/components/PresetEditor.tsx	942, 1015, 1142, 1456, 1477, 1483, 1752, 1788, 1796, 2037, 2137, 2174	Build Buff、ID、FPS	多个编辑字段和动画配置项仍保留英文术语
src/components/NpcVisualEditor.tsx	568-571, 581, 817	NPC 视觉编辑器、当前 NPC、x / y	标题、字段名和坐标显示仍有英文缩写

四、预设 / 数据层中的英文残留

这些内容虽然不一定直接在当前文件里渲染，但会进入运行时详情、掉落展示、物品编辑器、预设编辑器或交易界面。

文件	行号	当前文本/值	透出路径
src/data/monsterPresets.ts	438-456, 479-499, 535-540, 647-650	Material、Relic、Armor、Consumable、Stone Shell Shard、Blood Lens、英文描述句子、rare/uncommon、material/relic/mana	会进入怪物掉落、物品详情、交易弹窗和编辑器预览
src/data/itemDesign.ts	56-72, 123-149, 602-604, 761-762, 832-834	worldAffinity 的 neutral/wuxia/xianxia，role 的 fieldcraft/breaker/caster/berserker/assassin，tags 的 breaker/burst/mana，pieceName 的 dust/crystal/gem，以及 build 混排短语	会直接透到 ItemCatalogEditor 的世界、标签、构筑角色、协同标签和套装信息
src/data/characterPresets.ts	368-379, 384-386, 525-543, 839-857, 1024-1045	Double Jump、jump attack、Wall Slide、blunt/dry/direct、wary/fragmented 等原始动作名和对话风格值	会被 PresetEditor 的动作/风格选择器直接显示

五、未复现的问题

• src/components/GameShell.tsx 角色选择页返回按钮旧乱码已修复，当前为“返回”。
• src/data/npcInteractions.ts 旧的切磋动作乱码已修复，当前为“敌对/切磋前蓄力，点击后转为原地闪避”。
• 本次扫描 src/components、src/data 未发现 <EFBFBD>（replacement character）类型的编码损坏。
• 除 src/components/CustomWorldEntityEditorModal.tsx 外，本次未再确认到新的源码级中文乱码文件。
• 自定义世界的 NPC 视觉编辑组件 src/components/CustomWorldNpcVisualEditor.tsx 本次未发现新的乱码。

六、建议处理顺序

1. 先修 src/components/CustomWorldEntityEditorModal.tsx 的真实乱码。
2. 再清理 src/components/AdventurePanel.tsx 和 src/data/monsterPresets.ts 的整句英文，因为它们最容易直接破坏玩家观感。
3. 为高频缩写和枚举值补统一映射层：
   • NPC
   • HP / MP / CD
   • worldAffinity
   • role
   • tags
   • AnimationState
   • 技能风格 steady/burst/mobility/finisher/projectile
4. 最后统一编辑器里所有 ID、FPS、Build Buff 之类术语的显示策略。