初始仓库迁移

docs/GAME_UI_PRESET_EDITOR_TEXT_AUDIT_2026-03-31.md

@@ -0,0 +1,194 @@
+# 游戏 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` | `已完<E5B7B2>?` / `已交<E5B7B2>?` / `进行<E8BF9B>?` | 任务状态标签出现截断乱码 |
+| 游戏 UI | `src/components/CharacterDetailModal.tsx` | `223` | `属<>?` | 角色详情分区标题截断 |
+| 编辑器 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。
+