Genarrative/docs/GAME_UI_PRESET_EDITOR_TEXT_AUDIT_2026-03-31.md

游戏 UI / 预设 / 编辑器 UI 文案排查

日期：2026-03-31

说明

• 本文档基于当前分支源码重新复核，直接按 UTF-8 读取，不沿用旧审计文档中的乱码文本。
• 只记录会出现在游戏 UI、预设编辑器 UI、结果页预览或保存反馈中的文本。
• import、变量名、注释、仅内部使用的路径名，不计入本次问题清单。
• 位图图片里的内嵌文本未做 OCR，本次只看源码层可见文案。

结论摘要

• 当前问题可以分成 3 类：
  • 真实中文乱码或截断。
  • 英文或英文缩写直接暴露在中文界面。
  • 预设数据中的英文原始值直接透出到编辑器或预览。
• 乱码最集中的文件：
  • src/components/preset-editor/PresetEditorPanels.tsx
  • src/components/NpcVisualEditor.tsx
  • src/components/CustomWorldEntityEditorModal.tsx
  • src/components/GameShell.tsx
  • src/editor/shared/FormFields.tsx
• 英文最集中的文件：
  • src/components/adventure-panel/AdventurePanelOverlays.tsx
  • src/components/game-shell/PreGameSelectionFlow.tsx
  • src/components/game-shell/CharacterSelectionFlow.tsx
  • src/components/PresetEditor.tsx
  • src/components/ItemCatalogEditor.tsx
  • src/components/StateFunctionEditor.tsx
• 预设数据层仍有一批英文原始值会直接透出到 UI：
  • src/data/itemDesign.ts
  • src/data/monsterPresets.ts
  • src/data/characterPresets.ts
  • src/data/buildTags.ts

一、已确认的中文乱码 / 截断

范围	文件	行号	当前文本示例	说明
游戏 UI	src/components/GameShell.tsx	598, 611, 624	瑙掕壊 / 鍐掗櫓 / 鑳屽寘	主流程底部三个 tab 标签已写坏
游戏 UI	src/components/AdventurePanel.tsx	569-571	已完<EFBFBD>? / 已交<EFBFBD>? / 进行<EFBFBD>?	任务状态标签出现截断乱码
游戏 UI	src/components/CharacterDetailModal.tsx	223	属<EFBFBD>?	角色详情分区标题截断
编辑器 UI	src/components/CustomWorldEntityEditorModal.tsx	242, 384, 430, 434	鏀寔...URL / 宸查€? / 鍙栨秷 / 淇濆瓨淇敼	自定义世界实体编辑弹窗的占位、选中态、取消和保存按钮已写坏
编辑器 UI	src/components/preset-editor/shared.ts	42-55	瑙掕壊 / 鍦烘櫙 / 鏁屽 NPC / 姝︿緺 / 浠欎緺 / 鑷畾涔変笘鐣?	预设编辑器主 tab 和世界标签存在乱码
编辑器 UI	src/components/preset-editor/PresetEditorPanels.tsx	1269, 1364, 1371-1372, 1467, 1477-1486, 1521, 1654-1661, 1689, 1707	多处整句乱码	主编辑面板说明文案、预览模式、帮助文本、提示段落大面积损坏
编辑器 UI	src/components/NpcVisualEditor.tsx	463, 521, 550, 701-705, 719, 786-833	多处整句乱码	NPC 视觉编辑器的空态、失败提示、回滚提示、页头说明和多组选项已写坏
编辑器 UI	src/editor/shared/FormFields.tsx	156	淇濆瓨涓?..	通用保存按钮的“保存中...”状态显示乱码

二、游戏 UI 中的英文残留

1. 冒险主界面与奖励弹层

• src/components/adventure-panel/AdventurePanelOverlays.tsx:114-125
  • 奖励物品描述 fallback 仍是整句英文，如 restores HP during the run、works as a rare relic reward。
• src/components/adventure-panel/AdventurePanelOverlays.tsx:136-157
  • 任务目标展示里仍有 BOUNTY TARGET、CACHE TRACE、SPAR SESSION、Inspect the hidden reward site。
• src/components/adventure-panel/AdventurePanelOverlays.tsx:262-291
  • 任务奖励卡里仍有 REWARD CACHE、Tap an item icon to inspect its details.、Affinity、Currency、No item bounty attached to this quest.。
• src/components/adventure-panel/AdventurePanelOverlays.tsx:351-358
  • 目标详情卡仍有 Objective、Area。
• src/components/adventure-panel/AdventurePanelOverlays.tsx:490, 525, 668
  • 统计说明、保存禁用提示、空任务提示仍是英文，如 Inspect play time, kills, quests, and travel history.、Saving is temporarily disabled...、No active quests yet.。
• src/components/adventure-panel/AdventurePanelOverlays.tsx:749, 781-785, 831, 887-908, 925-1016
  • 完成奖励与战斗奖励弹层仍有 Claim reward、QUEST COMPLETE、Reward ready、Quest reward claimed、Battle reward、LOOT CACHE、No loot dropped this time.、Rarity、Quantity、Slot、Not equippable、Usable directly、Effect preview: HP + ... / MP + ...。

2. 实体详情与 NPC 交互

• src/components/AdventureEntityModal.tsx:1073, 1111, 1163-1165, 1252, 1428
  • 仍有 NPC 信息、NPC、x{item.quantity}、Inspect、Character、NPC 背包。
• src/components/AdventureEntityModal.tsx:892, 898
  • 同伴状态标签仍直接显示 HP / MP。
• src/components/CompanionCampModal.tsx:177-178, 233-234, 255
  • 同伴卡片和空态句子里仍有 HP / MP / NPC。
• src/components/NpcModals.tsx:79, 252, 273, 356, 408
  • 交易弹窗与详情弹窗里仍有 x{item.quantity}、NPC 商品列表、这个 NPC 当前没有可售商品。、NPC 商品、效果预览：HP + ... / MP + ...。

3. 开场流程与角色选择

• src/components/game-shell/CharacterSelectionFlow.tsx:28-44
  • 角色名、称号、定位、标签全部是英文，如 Sword Princess、Royal Blade、Vanguard、STR、AGI、Female、Male。
• src/components/game-shell/CharacterSelectionFlow.tsx:329-391
  • 面板标题和按钮仍有 Character Stats、Gender:、Backstory、Customize、Details、Enter Camp、Go。
• src/components/game-shell/PreGameSelectionFlow.tsx:63-75
  • 自定义世界生成进度仍全是英文，如 Finalizing world archive...、Generating core NPCs...、Parsing world setup...。
• src/components/game-shell/PreGameSelectionFlow.tsx:252-308
  • 开场按钮和入口仍有 New Game、Start Game、Developer Team、Go、CONTACTS、WORLD SELECT、Back。
• src/components/game-shell/PreGameSelectionFlow.tsx:344-421
  • 世界卡片与自定义世界入口仍有 Online、Featured、Saved、Playable、Landmarks、Custom、Create Custom World、Enter a world setup...。
• src/components/GameShell.tsx:630, 651, 695
  • Suspense fallback 仍显示 Loading party panel、Loading adventure panel、Loading inventory panel。

4. 其他游戏 UI

• src/components/CharacterDetailModal.tsx:112
  • 数量 x{item.quantity} 中的 x 仍保留英文数量前缀。

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

1. 编辑器入口与共享配置

• src/components/PresetEditor.tsx:65-73
  • 页头完整为英文：Preset Workshop、Unified Preset Preview And Editor 及其说明段。
• src/components/preset-editor/shared.ts:43, 60-72
  • 主 tab 仍有 NPC；动画和技能风格选项仍直接使用 idle、move、attack、die、steady、burst、mobility、finisher、projectile。

2. 预设编辑器主面板

• src/components/preset-editor/PresetEditorPanels.tsx:1267, 1594
  • 保存反馈仍是 Saved.。
• src/components/preset-editor/PresetEditorPanels.tsx:1277-1279, 1327-1328, 1414-1415, 1608-1609, 1647-1648
  • 多个分区标题和描述仍是占位英文 Section / Editor section.。
• src/components/preset-editor/PresetEditorPanels.tsx:1283, 1442, 1448
  • 表单标签出现错误拼接，如 Field"NPC"、Field"ID"。
• src/components/preset-editor/PresetEditorPanels.tsx:1320, 1640
  • 保存按钮文字仍是 Save。
• src/components/preset-editor/PresetEditorPanels.tsx:1421, 1658-1661, 1692, 1698, 1701, 1710, 2149
  • 仍有 NPC ID、Monster Encounter、NPC Encounter、Empty Scene、None、NPC、FPS 等英文或英文缩写。

3. 物品 / 行为 / NPC 视觉编辑器

• src/components/ItemCatalogEditor.tsx:648, 729, 736, 760, 767, 783, 800
  • 仍有 HP、MP、CD、Build Buff、ID。
• src/components/ItemCatalogEditor.tsx:793-817
  • buildProfile.role、setId、pieceName 等原始英文值直接显示在输入框。
• src/components/StateFunctionEditor.tsx:818-821, 885, 915
  • 预览信息里仍有 HP、No visible target、n/a。
• src/components/StateFunctionEditor.tsx:1060-1064
  • 保存失败/成功提示仍是英文：Failed to save option behavior overrides、Option behavior overrides saved.。
• src/components/StateFunctionEditor.tsx:1106, 1185, 1191, 1217
  • 仍直接展示 battle / idle、AnimationState 原值、idle / move / attack，以及 steady / burst / mobility / finisher / projectile。
• src/components/NpcVisualEditor.tsx:538, 714, 781, 798
  • 仍有 Save failed、Current NPC、Custom Hair Color、Hide Facial Hair。
• src/components/npcVisualEditorPersistence.ts:26, 31, 45, 50
  • 保存提示仍为 Failed to save NPC visual overrides、Saved NPC visual overrides to src/data/npcVisualOverrides.json.、Failed to save NPC layout config、Saved shared NPC layout config.。

4. 自定义世界结果页 / 编辑弹窗

• src/components/CustomWorldEntityCatalog.tsx:346
  • 说明文案里直接暴露资产名 MedievalFantasyCharacters。
• src/components/CustomWorldEntityEditorModal.tsx:242, 458
  • 图片路径占位里仍保留 URL；NPC 形象编辑说明里直接出现 MedievalFantasyCharacters。

四、预设 / 数据层中会透出 UI 的英文原始值

1. 物品预设

• src/data/itemDesign.ts:56-58, 67-69, 123-149
  • worldAffinity、role、rarity、tags 中仍有 neutral、wuxia、xianxia、fieldcraft、breaker、caster、berserker、assassin、common、rare、epic 等原始值。
• src/data/itemDesign.ts:213-219
  • pieceName 仍为 boots、chest、gloves、helm、leggings、shield、weapon。
• src/data/itemDesign.ts:538-545, 581-598, 731-748, 906-913
  • 描述拼接和构筑信息里仍直接出现 build、role、dust、crystal、gem 等英文原始词。
• 这些值会直接透出到 ItemCatalogEditor 的标签、构筑字段和预览信息。

2. 怪物掉落预设

• src/data/monsterPresets.ts:494-536, 647-721
  • 掉落类别仍有 Armor、Relic、Material、Consumable。
  • 掉落名称仍有 Carapace Plate、Guard Core、Spore Pouch、Burst Cap、Ashfire Feather、Serpent Eye、Tide Ink、Lake Pearl、Thorn Nectar。
  • 掉落描述仍有整句英文，如 A toxin sac prized by alchemists and assassins alike.。
• 这些值会进入战斗奖励、物品详情和交易 UI。

3. 角色预设

• src/data/characterPresets.ts:54-70
  • 会话风格原始值仍为 blunt、wary、evasive、measured、gentle、teasing、dry、steady、direct、fragmented、deflecting。
• src/data/characterPresets.ts:368-386, 525-543, 839-857, 1024-1045
  • 动画文件夹 / 前缀与风格原始值仍有 Double Jump、jump attack、Wall Slide、guardStyle、warmStyle、truthStyle。
• 这些值会透出到角色预设编辑器、技能预览和部分选择器。

4. Build / 标签词典

• src/data/buildTags.ts:42, 56, 91, 126-147, 308-316
  • 仍有 assassin、fieldcraft、breaker、caster、weapon、armor、relic、material、consumable、rare、wuxia、xianxia、neutral 等原始标签。
• 这些值会在物品编辑器标签、构筑画像和相似度映射结果中直接显示。

五、优先级建议

1. 先修 src/components/preset-editor/PresetEditorPanels.tsx 和 src/components/NpcVisualEditor.tsx
   • 这两处是当前编辑器侧最严重的问题源，既有大面积乱码，也有大量英文占位词。
2. 再修游戏首屏与奖励相关 UI
   • 优先处理 src/components/adventure-panel/AdventurePanelOverlays.tsx
   • 优先处理 src/components/game-shell/PreGameSelectionFlow.tsx
   • 优先处理 src/components/game-shell/CharacterSelectionFlow.tsx
3. 然后修直接影响主流程判断的乱码
   • src/components/GameShell.tsx
   • src/components/AdventurePanel.tsx
   • src/components/CharacterDetailModal.tsx
   • src/components/CustomWorldEntityEditorModal.tsx
   • src/editor/shared/FormFields.tsx
4. 最后补“显示层映射”
   • 为 itemDesign.ts、monsterPresets.ts、characterPresets.ts、buildTags.ts 这类预设原始值统一增加中文显示映射，避免继续把内部英文值直接透给编辑器和游戏 UI。