ji-haitang/char_card_1/gal-presentation

GAL 演出迭代开发方案（格式升级 + GameMode 0 演出层）

状态：代码与自动化测试已完成（Phase 0-6 的代码改动、单测、规范/提示词更新均已落地；完成情况见第四节各 Phase 验收勾选）。待手工验收：浏览器脚本、真机/APK、真实模型 5 轮统计、旧格式特殊事件链端到端——清单见第四节末「状态与待办」。所有决策均已与用户逐条确认（见第二节决策表），落地时不要再重新讨论已拍板项。

用户补充决定：解析器与控制器不拆独立文件，直接写在 module/game-ui.js 内（见第三节）。

执行顺序固定：Phase 0 → 1 → 2 → 3 → 4 → 5。每个 Phase 独立可验收、可回滚；前一阶段验收未过不进下一阶段。

一、动手前必读（按顺序）

二、已拍板决策（不再讨论）

2.1 核心原则

演出层 = 纯表现层覆盖。 viewport 里原本是业务层（2D .scene / 3D #sect-3d-root），演出就是在其上叠 gal-layer-container + mask；进入 = 挂上、退出 = 摘掉；底下一切业务逻辑照常运转、不感知演出。演出层挂上后只认自己那份 frames，不响应业务层变化；摘掉后用户看到业务层此刻的真实状态。

有意例外仅 4 处：① mask 拦 viewport 内点击（viewport 外控件仍可用）；② setBusy('gal') 暂停 3D 渲染（性能，不改状态机）；③ 末帧时间写 currentGameTime/dayNightStatus（属 commit 流水线，与是否进演出无关）；④ switchScene('player-stats'/'relationships') 触发 exit（那两页现有代码会删图层）。

2.2 决策表

三、目标架构

LLM MAIN_TEXT
   │ GalParser.parseFrames()           ← game-ui.js 内 `// ==== GAL_PARSER_BEGIN/END ====` 块（纯函数 IIFE）
   ▼
frames[] = [{ text, scene, time, cast:[{npc,emotion}], cg, legacy, npc, emotion }]
   │                                    (npc/emotion = cast[0] 的镜像，兼容旧消费者)
   ├── 数据层：slgModeData / storyPages / currentPage（game-ui.js 现有）
   ├── 时间源：parseLLMResponse 读 frames 末帧时间（game-events.js）
   └── 演出层：galPresentation 控制器  ← game-ui.js 内 `// ==== GAL_PRESENTATION_BEGIN/END ====` 块（IIFE）
          enter({source, pageIndex}) / goto(i) / exit({reason}) / isPlaying()
          渲染 .slg-layer-container（背景/立绘/CG）+ .slg-interaction-mask
          GameMode 1：不走状态机，updateStoryDisplay 直接调 renderLayers/clearLayers（行为同现状）
          GameMode 0：按 G1-G13 进出，加 gal-presenting，setBusy('gal')
业务层：.scene / #sect-3d-root / displayNpcs / switchScene —— 不改

不新增模块文件（用户决定）。两个 IIFE 直接写在 game-ui.js 顶部（parseSlgMainText 原位置），各用一对切片标记注释包裹；单测用 source.slice(indexOf('// ==== GAL_PARSER_BEGIN ===='), indexOf('// ==== GAL_PARSER_END ====')) 把块切出来在 vm 沙箱运行（同 bridge-unit.mjs 切函数体的做法）。两个块内部只能引用：自身参数 / ctx 传入项 / 明确以 typeof x !== 'undefined' 守卫的全局，保证在最小沙箱可加载。

编辑纪律：game-ui.js 含 \n 正则字面量，SearchReplace 曾两次把文件写坏——本文件的所有修改一律用 node 手术脚本（Write 临时 .js → node 执行 → node --check → 删脚本）。

3.1 GalParser 契约

GalParser.parseFrames(mainText, ctx) → Frame[]        // 实际实现：直接返回数组；末尾无标记残文作为最后一帧 tail=true，沿用上一有效展示配置
ctx = buildGalParseContext(gameMode)                 // game-ui.js 内的共用构造，game-events.js 也用它
    = { gameMode, roster:[{id,name}], matchNpc, isNpcAllowed, matchScene, matchEmotion, matchCG, log }
Frame = { text, scene, time|null, cast:[{npc,emotion}](≤2), cg, legacy:boolean, npc, emotion, tail?:true }

• 分隔符：按行切；一行 split('|') 恰得 5 段才是标记行；否则累积到当前段正文（与现状一致）。
• 新格式判定：parts[2] trim 后匹配 ^\d{1,2}[:：]\d{2}$。时间归一为 HH:MM（补零，全角冒号转半角）。
• cast 解析：parts[3] 按 [;；] 切，每项按 [:：] 切成 NPC:表情；缺表情视为 none；none/无/空 → 空 cast；白名单过滤后取前 2 个。
• 旧格式：parts[1]=NPC、parts[2]=场景、parts[3]=表情、parts[4]=CG，cast 最多 1 个，legacy=true，time=null。
• 纯函数、无 DOM、无全局读写。

3.2 galPresentation 契约