]*>/i.exec(html);
+ if (!m) return script + html;
+ return html.slice(0, m.index + m[0].length) + '\n' + script + html.slice(m.index + m[0].length);
+}
+
+// ─────────────────────────── 放映页 ───────────────────────────
+
+export function buildPlayPage({
+ topic = '', lang = 'zh', slides = [], cssNote = '', generatedAt = '',
+ narration = true, // 是否加载口播文案 UI(没有 clauses 或 --no-script 时为 false)
+ timing = false, // 是否有对时数据(只影响标题上的"(未对时)"标注)
+ fallbackNote = '', // "还没对时/等间隔预览"的如实说明(与口播 UI 无关, 画面上也要说清)
+ canvas = { w: 1920, h: 1080 }, // 画布尺寸(竖版 1080×1920): 舞台缩放与缩略图比例都按它算
+} = {}) {
+ // UI 双语(实测反馈: 英文项目的放映页整套中文按钮)。lang 来自 script.json(en* → 英文, 其余中文)
+ const T = String(lang).toLowerCase().startsWith('en') ? {
+ title: 'Play', fxOn: 'Motion on', fxOff: 'Motion off', narrOn: 'Narration on', narrOff: 'Narration off',
+ overview: 'Overview', panelH: 'Narration for this slide', untimed: '(untimed)',
+ fxTitle: 'Motion on / off (key X)', narrTitle: 'Narration on / off (key P)',
+ prevTitle: 'Previous level / slide', nextTitle: 'Next level / slide',
+ hintStep: 'reveal level / slide', hintFx: 'motion on / off', hintNarr: 'narration on / off',
+ hintOv: 'overview', hintFs: 'fullscreen', level: 'step',
+ cut: 'Cut', xfade: 'Dissolve', transTitle: 'Slide transition: cut / dissolve (compare, then set script.json transition)', hintTrans: 'slide transition',
+ gen: 'Snapshots generated', genNote: 'same source as the final video (no audio, no subtitles)',
+ noThumbA: 'No thumbnail (preview/', ovH: 'Overview · click any slide to jump (thumbnails from preview/*.png)',
+ } : {
+ title: '放映页', fxOn: '动效开', fxOff: '动效关', narrOn: '口播开', narrOff: '口播关',
+ overview: '总览', panelH: '本张口播文案', untimed: '(未对时)',
+ fxTitle: '动效开 / 动效关(快捷键 X)', narrTitle: '口播开 / 口播关(快捷键 P)',
+ prevTitle: '上一级 / 上一张', nextTitle: '下一级 / 下一张',
+ hintStep: '逐级入场 / 翻页', hintFx: '动效开 / 动效关', hintNarr: '口播开 / 口播关',
+ hintOv: '总览', hintFs: '全屏', level: '级',
+ cut: '硬切', xfade: '溶解', transTitle: '切页方式:硬切 / 溶解(现场对比后写进 script.json 的 transition)', hintTrans: '切页方式',
+ gen: '快照生成于', genNote: '画面与成片同源(无声、无字幕)',
+ noThumbA: '无缩略图(preview/', ovH: '总览 · 点任意一张跳转(缩略图来自 preview/*.png)',
+ };
+ const model = slides.map(s => ({
+ id: s.id, name: s.name, title: s.title ?? '',
+ src: s.copy, nofx: s.copyNofx,
+ steps: (s.steps && s.steps.length) ? s.steps : [1], // 动效开时逐级揭示的 stage 序列
+ clauses: (s.clauses ?? []).map(c => ({ stage: c.stage ?? null, text: c.text ?? '', text2: c.text2 ?? '' })),
+ }));
+ const json = JSON.stringify(model).replace(/⚠ ${esc(cssNote)}` : '';
+ const notice = fallbackNote ? `${esc(fallbackNote)}
` : '';
+
+ return `
+
+
+
+
+
+${T.title} · ${esc(topic) || 'html2video'} · html2video-for-mcode
+
+
+
+
+
+ ${esc(topic) || T.title}
+ 1 / ${slides.length}
+
+
+ ${notice}
+
+
+
+ ${narration ? `` : ''}
+
+
+
+
+
+
+`;
+}
+
+// ─────────────────────────── 主流程 ───────────────────────────
+
+function main() {
+ const argv = process.argv.slice(2);
+ const dir = positionalDir(argv);
+ const OPEN = argv.includes('--open');
+ const NO_SCRIPT = argv.includes('--no-script'); // 不加载口播文案 UI(只想看 HTML 画面时)
+ process.env.KIT_PROJECT_DIR = dir;
+
+ const scriptPath = path.join(dir, 'script.json');
+ if (!fs.existsSync(scriptPath)) { console.error(`✗ 找不到 ${scriptPath}`); process.exit(1); }
+ const script = JSON.parse(fs.readFileSync(scriptPath, 'utf8'));
+ validateScriptPaths(script, dir); // id/html 派生路径收监(与 capture 同一道门)
+
+ const timingsPath = path.join(dir, 'build', 'timings.json');
+ const hasTimings = fs.existsSync(timingsPath);
+ const timings = hasTimings ? JSON.parse(fs.readFileSync(timingsPath, 'utf8')) : null;
+
+ const slidesDir = path.join(dir, 'slides');
+ const outDir = safeOut(dir, 'preview', 'play');
+ fs.mkdirSync(outDir, { recursive: true });
+
+ // 项目 tokens.css 落后于技能当前版本(缺 no-fx / 图表 / 表格任一段)时给副本兜底注入当前版,
+ // 并在页面与终端如实说明 —— 否则"关动效对照"会把画面锁在入场前的透明态, 旧图表规则也会
+ // 把新版画法(如 .chart-ticks)渲染坏。注入的
+