#!/usr/bin/env node // novel-script — deterministic helpers for the novel-script skill (剧本). // Zero dependencies on purpose: the skill must work in any directory // without an npm install. Node 18+ (stdlib only). import { readFileSync, realpathSync } from 'node:fs'; import { resolve } from 'node:path'; import { fileURLToPath } from 'node:url'; /* ------------------------------------------------------------------ */ /* 时长引擎 */ /* ------------------------------------------------------------------ */ /* * 剧本层不分镜头（分镜是下一个 skill 的活），但时长预算必须在这层守住： * AI 短剧一集就是三分钟上下，台词写超了后面全盘返工。 * * 估算模型：台词秒数 = 非空白字符数 ÷ 语速；动作节拍按固定秒数计。 * 是估算不是秒表，所以容差给到 ±15%（可配）——但估算也比不算强得多， * 一集写到五分钟的剧本在这里就会被拦下，不会流到生成环节才发现。 */ export const DEFAULT_PARAMS = { charsPerSecond: 4.5, // 中文口语偏快档 actionSeconds: 2.5, // 每个动作节拍的估时 tolerance: 0.15, // 时长容差 ±15% maxLineChars: 35, // 单句台词上限——一口气说不完的台词也生成不了 hookWindow: 3, // 开场钩子必须在全集前几拍内兑现——短剧开场 3 秒定生死 }; export function paramsOf(doc) { return { ...DEFAULT_PARAMS, ...(doc?.params ?? {}) }; } /** 台词计秒用的字符数：去空白，标点算时间（停顿也是时间）。 */ export const lineChars = (line) => String(line ?? '').replace(/\s+/g, '').length; const r1 = (n) => Math.round(n * 10) / 10; /** 一场戏的估秒。flow 里台词按语速折算，动作节拍按固定秒数。 */ export function sceneSeconds(scene, params = DEFAULT_PARAMS) { let dlg = 0; let act = 0; for (const b of scene?.flow ?? []) { if (typeof b?.line === 'string') dlg += lineChars(b.line) / params.charsPerSecond; else if (typeof b?.action === 'string') act += params.actionSeconds; } return { dialogue: r1(dlg), action: r1(act), total: r1(dlg + act) }; } /* ------------------------------------------------------------------ */ /* stats — 报告与质量门共用的确定性统计 */ /* ------------------------------------------------------------------ */ export function computeStats(doc) { const params = paramsOf(doc); const episodes = []; const sceneTable = []; const byCharacter = new Map(); // C01 → { lines: [...], chars } for (const ep of doc?.episodes ?? []) { let dlg = 0; let act = 0; let lines = 0; (ep?.scenes ?? []).forEach((sc, idx) => { const sec = sceneSeconds(sc, params); dlg += sec.dialogue; act += sec.action; let lineCount = 0; for (const b of sc?.flow ?? []) { if (typeof b?.line !== 'string') continue; lineCount++; lines++; const key = b.speaker ?? '?'; if (!byCharacter.has(key)) byCharacter.set(key, { lines: [], chars: 0 }); const entry = byCharacter.get(key); entry.lines.push({ ep: ep.ep, sceneIndex: idx + 1, sceneId: sc.sceneId, line: b.line, delivery: b.delivery ?? '' }); entry.chars += lineChars(b.line); } sceneTable.push({ ep: ep.ep, index: idx + 1, sceneId: sc.sceneId, lighting: sc.lighting ?? '', characters: sc.characters ?? [], props: sc.props ?? [], lineCount, estSeconds: sec.total, }); }); episodes.push({ ep: ep.ep, target: ep.targetSeconds, est: r1(dlg + act), dialogueSeconds: r1(dlg), actionSeconds: r1(act), lines, sceneCount: (ep?.scenes ?? []).length, }); } const totals = { episodes: episodes.length, scenes: sceneTable.length, lines: episodes.reduce((n, e) => n + e.lines, 0), estSeconds: r1(episodes.reduce((n, e) => n + e.est, 0)), targetSeconds: episodes.reduce((n, e) => n + (e.target ?? 0), 0), dialogueSeconds: r1(episodes.reduce((n, e) => n + e.dialogueSeconds, 0)), }; const castLines = [...byCharacter.entries()] .map(([id, v]) => ({ id, count: v.lines.length, chars: v.chars, lines: v.lines })) .sort((a, b) => b.count - a.count); return { params, episodes, sceneTable, castLines, totals }; } /* ------------------------------------------------------------------ */ /* 质量门 */ /* ------------------------------------------------------------------ */ /* * 与仓库里其他 skill 同一主张：checklist 是代码，不是给模型读的文字。 * 需要上游对账的门（角色 / 场景与光照 / 爽点认领）在没给上游文件时 * 明说跳过——静默通过和撒谎只差一步。 */ const thText = (s) => typeof s === 'string' && s.trim(); /** 动作描述必须是叙述体——台词只能进 dialogue 字段，混进 action 就没法计秒。 */ const QUOTE_RE = /「|」|『|』|“|”/; export function gateReport(doc, ctx = {}) { const gates = []; const add = (id, label, ok, detail = '') => gates.push({ id, label, ok, detail }); const eps = Array.isArray(doc?.episodes) ? doc.episodes : []; const params = paramsOf(doc); const stats = computeStats(doc); const bad = { duration: [], lineLen: [], speaker: [], hook: [], hookOpen: [], noAction: [], prose: [], beats: [], chars: [], scenes: [] }; for (const [i, ep] of eps.entries()) { const st = stats.episodes[i]; const label = `第 ${ep?.ep} 集`; // 时长预算：写超写欠都在这层拦，别流到生成环节才发现 if (ep?.targetSeconds > 0) { const lo = ep.targetSeconds * (1 - params.tolerance); const hi = ep.targetSeconds * (1 + params.tolerance); if (st.est < lo) bad.duration.push(`${label}欠 ${r1(lo - st.est)} 秒（估 ${st.est}s / 目标 ${ep.targetSeconds}s）`); if (st.est > hi) bad.duration.push(`${label}超 ${r1(st.est - hi)} 秒（估 ${st.est}s / 目标 ${ep.targetSeconds}s）`); } // 开场钩子与结尾悬念：说明必须落在纸面 if (!thText(ep?.hook) || !thText(ep?.cliff)) bad.hook.push(label); // 钩子不是标签是第一拍：hookBeat 认领具象落在哪一拍，必须在全集前几拍内。 // 只有说明没有认领，就会出现「钩子说皮箱、开场拍了八拍雾」的衔接断裂 { const hb = ep?.hookBeat; if (!Array.isArray(hb) || hb.length !== 2 || !Number.isInteger(hb[0]) || !Number.isInteger(hb[1])) { bad.hookOpen.push(`${label}缺 hookBeat（[场, 拍]，认领钩子具象的位置）`); } else { const scene = ep?.scenes?.[hb[0] - 1]; if (!scene || hb[1] < 1 || hb[1] > (scene.flow ?? []).length) { bad.hookOpen.push(`${label}的 hookBeat [${hb[0]}, ${hb[1]}] 指向不存在的节拍`); } else { let pos = hb[1]; for (let i = 0; i < hb[0] - 1; i++) pos += (ep.scenes[i]?.flow ?? []).length; if (pos > params.hookWindow) { bad.hookOpen.push(`${label}的钩子落在全集第 ${pos} 拍，超出前 ${params.hookWindow} 拍——冷开场先给钩子的具象`); } } } } for (const sc of ep?.scenes ?? []) { const cast = new Set(sc?.characters ?? []); let hasAction = false; for (const b of sc?.flow ?? []) { if (typeof b?.action === 'string') { hasAction = true; if (QUOTE_RE.test(b.action)) bad.prose.push(`${label} ${sc?.sceneId ?? '?'}`); } if (typeof b?.line === 'string') { if (lineChars(b.line) > params.maxLineChars) { bad.lineLen.push(`${label}「${b.line.slice(0, 12)}…」${lineChars(b.line)} 字`); } if (b.speaker !== 'VO' && !cast.has(b.speaker)) { bad.speaker.push(`${label} ${sc?.sceneId ?? '?'} 的「${b.speaker}」不在本场人物里`); } } } // 纯对白无动作的场 = 广播剧，生成时没有画面可写 if ((sc?.flow ?? []).length > 0 && !hasAction) bad.noAction.push(`${label} ${sc?.sceneId ?? '?'}`); } } // ---- 需要上游对账的门 ---- const outline = ctx.outline ?? null; const art = ctx.art ?? null; if (outline) { const charIds = new Set((outline.characters ?? []).map((c) => c.id)); for (const ep of eps) { for (const sc of ep?.scenes ?? []) { for (const id of sc?.characters ?? []) { if (!charIds.has(id)) bad.chars.push(`第 ${ep.ep} 集 ${sc.sceneId ?? '?'} 的 ${id}`); } } // 爽点认领：大纲说这一集有的爆点，剧本必须认领 const due = [...new Set((outline.beats ?? []).filter((b) => b.episode === ep.ep).map((b) => b.type))]; const claimed = new Set(ep?.beatsClaimed ?? []); for (const t of due) if (!claimed.has(t)) bad.beats.push(`第 ${ep.ep} 集缺「${t}」`); } } if (art) { const sceneMap = new Map((art.scenes ?? []).map((s) => [s.id, s])); const propIds = new Set((art.props ?? []).map((p) => p.id)); for (const ep of eps) { for (const sc of ep?.scenes ?? []) { const ref = sceneMap.get(sc?.sceneId); if (!ref) { bad.scenes.push(`第 ${ep.ep} 集引用了不存在的场景 ${sc?.sceneId}`); } else if (thText(sc?.lighting) && !(ref.lighting ?? []).some((l) => l.state === sc.lighting)) { bad.scenes.push(`第 ${ep.ep} 集 ${sc.sceneId} 的光照「${sc.lighting}」没在美术设定里登记`); } for (const pid of sc?.props ?? []) { if (!propIds.has(pid)) bad.scenes.push(`第 ${ep.ep} 集引用了不存在的道具 ${pid}`); } } } } const SKIP_OUTLINE = '未提供 outline.json，本门跳过（视为通过）'; const SKIP_ART = '未提供 art.json，本门跳过（视为通过）'; add('duration', `每集时长在目标 ±${Math.round(params.tolerance * 100)}% 内`, eps.length > 0 && bad.duration.length === 0, bad.duration.join('；')); add('line-length', `单句台词 ≤ ${params.maxLineChars} 字`, bad.lineLen.length === 0, bad.lineLen.join('；')); add('speaker', '说话人在本场人物里，或明确标画外音 VO', bad.speaker.length === 0, bad.speaker.join('；')); add('hook-cliff', '每集开场钩子与结尾悬念都落在纸面', eps.length > 0 && bad.hook.length === 0, bad.hook.join('；')); add('hook-open', `钩子的具象在全集前 ${params.hookWindow} 拍内兑现（hookBeat 认领）`, eps.length > 0 && bad.hookOpen.length === 0, bad.hookOpen.join('；')); add('has-action', '每场至少一个动作节拍——纯对白的场是广播剧', eps.length > 0 && bad.noAction.length === 0, bad.noAction.join('；')); add('action-prose', '动作描述叙述体，台词只进 dialogue 字段', bad.prose.length === 0, bad.prose.join('；')); add('beats-claimed', '大纲爽点逐集认领', bad.beats.length === 0, outline ? bad.beats.join('；') : SKIP_OUTLINE); add('refs-characters', '角色引用对账大纲', bad.chars.length === 0, outline ? bad.chars.join('；') : SKIP_OUTLINE); add('refs-scenes', '场景／光照／道具对账美术设定', bad.scenes.length === 0, art ? bad.scenes.join('；') : SKIP_ART); return gates; } /* ------------------------------------------------------------------ */ /* validate */ /* ------------------------------------------------------------------ */ export function validateScript(doc, ctx = {}) { const problems = []; const p = (msg) => problems.push(msg); if (!doc || typeof doc !== 'object') return ['script.json 不是对象']; if (!thText(doc.source)) p('缺少 source（剧名/书名）'); const eps = doc.episodes; if (!Array.isArray(eps) || eps.length === 0) { p('episodes 为空'); return problems; } const seen = new Set(); for (const ep of eps) { const label = `第 ${ep?.ep ?? '?'} 集`; if (!Number.isInteger(ep?.ep) || ep.ep < 1) p(`${label}的 ep 必须是正整数`); if (seen.has(ep?.ep)) p(`集号 ${ep.ep} 重复`); seen.add(ep?.ep); if (!(ep?.targetSeconds > 0)) p(`${label}缺 targetSeconds（目标秒数，来自大纲的单集时长）`); if (!Array.isArray(ep?.beatsClaimed)) p(`${label}缺 beatsClaimed（认领的爽点，可为空数组）`); if (!Array.isArray(ep?.scenes) || ep.scenes.length === 0) { p(`${label}没有场次`); continue; } ep.scenes.forEach((sc, i) => { const sLabel = `${label}第 ${i + 1} 场`; if (!/^S\d{2,}$/.test(sc?.sceneId ?? '')) p(`${sLabel} sceneId 必须是 S01 这种格式`); if (!Array.isArray(sc?.characters)) p(`${sLabel}缺 characters（本场人物，空镜给空数组）`); if (!Array.isArray(sc?.flow) || sc.flow.length === 0) p(`${sLabel}的节拍流为空`); for (const b of sc?.flow ?? []) { const isAction = typeof b?.action === 'string'; const isLine = typeof b?.line === 'string'; if (isAction === isLine) { p(`${sLabel}有节拍既不是动作也不是台词（action 与 line 二选一）`); continue; } if (isAction && !b.action.trim()) p(`${sLabel}有空动作节拍`); if (isLine) { if (!b.line.trim()) p(`${sLabel}有空台词`); if (!thText(b.speaker)) p(`${sLabel}有台词缺 speaker`); } } }); } for (const g of gateReport(doc, ctx)) { if (!g.ok) p(`质量门未过：${g.label}${g.detail ? `（${g.detail}）` : ''}`); } return problems; } /* ------------------------------------------------------------------ */ /* seed — 从 outline.json 确定性预填骨架 */ /* ------------------------------------------------------------------ */ /* * 目标秒数、钩子、悬念、该集爽点在大纲里都是现成的——这些事实不让 * 模型重新想。scenes 留空给模型写戏。 */ export function seedFromOutline(outline, epRange = null) { const perEp = (outline?.params?.minutesPerEpisode ?? 3) * 60; const inRange = (n) => !epRange || (n >= epRange[0] && n <= epRange[1]); const episodes = (outline?.episodes ?? []) .filter((e) => inRange(e.ep)) .map((e) => ({ ep: e.ep, targetSeconds: perEp, hook: e.hook ?? '', cliff: e.suspense ?? '', beatsClaimed: [...new Set((outline.beats ?? []).filter((b) => b.episode === e.ep).map((b) => b.type))], scenes: [], // 从大纲搬来的参考，写完删掉也行 seedNote: `大纲梗概：${e.synopsis ?? ''}　候选场景：${(e.sceneIds ?? []).join('、')}　人物：${(e.characterIds ?? []).join('、')}`, })); return { source: outline?.source ?? '', episodes }; } /* ------------------------------------------------------------------ */ /* slug */ /* ------------------------------------------------------------------ */ export function slug(name) { const cleaned = String(name) .trim() .replace(/[\s/\\:*?"<>|·]+/g, '-') .replace(/^-+|-+$/g, ''); return cleaned || 'script'; } /* ------------------------------------------------------------------ */ /* render — 界面文案 */ /* ------------------------------------------------------------------ */ /* * 内置 zh / en 两套，全部界面文案收在这张表里。 * 质量门的 label/detail 是 validate/checkup 的诊断文案，保持中文，不在此列。 */ /* 门标签与「跳过」提示的英文映射：质量门面板是报告的一部分，出英文报告时 * 这里做展示层翻译——gateReport 的逻辑与中文诊断文案一行不动（CLI 仍是中文）。 * 动态阈值由门自己算，映射里只写固定语义；未命中的 id 回落到原标签。 */ const GATE_LABELS_EN = { 'duration': 'Episode duration within ±{0}% of target', 'line-length': 'Every line ≤ {0} characters', 'speaker': 'Speaker is in the scene cast, or explicitly marked V.O.', 'hook-cliff': 'Hook and cliffhanger on paper for every episode', 'hook-open': 'The hook\'s concrete image lands within the first {0} beats (claimed by hookBeat)', 'has-action': 'At least one action beat per scene — a dialogue-only scene is radio drama', 'action-prose': 'Action in narrative prose; dialogue only in dialogue entries', 'beats-claimed': 'Outline beats claimed per episode', 'refs-characters': 'Character references audited against the outline', 'refs-scenes': 'Scenes / lighting / props audited against the art bible', }; const GATE_SKIPS_EN = { '未提供 outline.json，本门跳过（视为通过）': 'outline.json not provided — gate skipped (treated as passing)', '未提供 art.json，本门跳过（视为通过）': 'art.json not provided — gate skipped (treated as passing)', '未提供 script.json，本门跳过（视为通过）': 'script.json not provided — gate skipped (treated as passing)', '未提供 outline/cast，本门跳过（视为通过）': 'outline/cast not provided — gate skipped (treated as passing)', '未提供 cast.json，本门跳过（视为通过）': 'cast.json not provided — gate skipped (treated as passing)', }; /** 报告里的门文案：英文界面取映射，未命中或中文界面回落原文。 */ const gateText = (g, lang) => { if (lang !== 'en') return { label: g.label, detail: g.detail }; const en = GATE_LABELS_EN[g.id]; // 阈值仍由门自己算：把中文标签里出现的数字按序填进 {0} {1} const nums = String(g.label).match(/\d+(?:\.\d+)?/g) ?? []; const label = en ? en.replace(/\{(\d)\}/g, (m, i) => nums[Number(i)] ?? m) : g.label; return { label, detail: GATE_SKIPS_EN[g.detail] ?? g.detail }; }; const I18N = { zh: { langCode: 'zh', kicker: '剧本', docTitle: (s, a, b) => `${s} · 剧本${a === b ? `（第 ${a} 集）` : `（第 ${a}–${b} 集）`}`, epHead: (n) => `第 ${n} 集`, epRange: (a, b) => (a === b ? `第 ${a} 集` : `第 ${a}–${b} 集`), exportJson: '导出 JSON', gates: '质量门', gatesPass: '全部通过', gatesFail: (n) => `${n} 项未过`, gatePill: (okN, total) => `质量门 ${okN} / ${total}`, kpi: { eps: '集数', epsSub: (sc) => `${sc} 场戏`, time: '预估总时长', timeSub: (t) => `目标 ${t}`, lines: '台词', linesSub: (sec) => `约 ${sec} 秒对白`, dlgRatio: '台词占比', dlgRatioSub: '其余是画面与动作', avgScene: '平均每场', avgSceneSub: '换景是统计不是门——AI 换景不要钱', }, secTiming: '时长仪表', secScript: '分集剧本', secSceneTable: '场次总表', secCastLines: '台词本', secGates: '质量门', timingNote: (tol) => `绿带 = 目标 ±${tol}%；台词按语速折算，动作按节拍估时`, scriptNote: '一排两集 · 场次信息超高自动截断，点开看全部', sceneTableNote: '自动汇总 · 模型不写', castLinesNote: '按角色聚合 · 列表最多显示 6 行可滚动 · 直接对接 TTS 批量生成', hookLabel: '开场钩子', hookAt: (sc, b) => `第 ${sc} 场第 ${b} 拍兑现`, voiceBtn: '音色提示词', cliffLabel: '结尾悬念', beatsLabel: '认领爽点', estLabel: (est, target) => `预估 ${est} 秒 / 目标 ${target} 秒`, sceneHead: (i) => `第 ${i} 场`, voLabel: '画外音', lightingLabel: '光照', showScenes: '▾ 展开全部场次', hideScenes: '▴ 收起场次', sceneCols: ['集', '场', '场景', '光照', '人物', '台词句数', '估秒'], castCols: ['角色', '台词句数', '字数', '约合秒数'], copyAllLines: '复制全部台词', copy: '复制', copied: '已复制', copyFailed: '复制失败', lineRef: (ep, i) => `E${String(ep).padStart(2, '0')} 第 ${i} 场`, dlgSec: (s) => `${s} 秒`, fmtMin: (m, s) => `${m} 分 ${s} 秒`, overBy: (s) => `超 ${s} 秒`, underBy: (s) => `欠 ${s} 秒`, legendDlg: '台词', legendAct: '动作', legendBand: '目标区间', unitLines: '句', unitSec: '秒', castMeta: (count, chars, sec) => `${count} 句 · ${chars} 字 · 约 ${sec} 秒`, castProps: (c, p) => (p ? `人物：${c}　道具：${p}` : `人物：${c}`), sep: '、', colon: '：', paren: (s) => `（${s}）`, colophon: '剧本由模型依据大纲与美术设定生成，时长与引用由脚本确定性检查。分镜与首帧提示词是下一层的事，不在本报告里。', }, en: { langCode: 'en', kicker: 'Script', docTitle: (s, a, b) => `${s} · Script${a === b ? ` (Episode ${a})` : ` (Episodes ${a}–${b})`}`, epHead: (n) => `Episode ${n}`, epRange: (a, b) => (a === b ? `Episode ${a}` : `Episodes ${a}–${b}`), exportJson: 'Export JSON', gates: 'Quality gates', gatesPass: 'All passed', gatesFail: (n) => `${n} failed`, gatePill: (okN, total) => `Quality gates ${okN} / ${total}`, kpi: { eps: 'Episodes', epsSub: (sc) => `${sc} scenes`, time: 'Estimated runtime', timeSub: (t) => `target ${t}`, lines: 'Lines', linesSub: (sec) => `~${sec}s of dialogue`, dlgRatio: 'Dialogue ratio', dlgRatioSub: 'the rest is picture and action', avgScene: 'Avg per scene', avgSceneSub: 'scene changes are a statistic, not a gate — AI scene changes are free', }, secTiming: 'Duration gauge', secScript: 'Episode scripts', secSceneTable: 'Scene table', secCastLines: 'Line book', secGates: 'Quality gates', timingNote: (tol) => `green band = target ±${tol}%; dialogue at reading speed, action per beat`, scriptNote: 'two episodes per row · tall scene areas clip, expand to see all', sceneTableNote: 'computed, never hand-written', castLinesNote: 'grouped by character · lists show 6 rows and scroll · feeds straight into batch TTS', hookLabel: 'Cold open hook', hookAt: (sc, b) => `lands at scene ${sc}, beat ${b}`, voiceBtn: 'Voice prompt', cliffLabel: 'Cliffhanger', beatsLabel: 'Beats claimed', estLabel: (est, target) => `est. ${est}s / target ${target}s`, sceneHead: (i) => `Scene ${i}`, voLabel: 'V.O.', lightingLabel: 'Lighting', showScenes: '▾ Show all scenes', hideScenes: '▴ Collapse scenes', sceneCols: ['Ep', 'Scene', 'Setting', 'Lighting', 'Cast', 'Lines', 'Est. sec'], castCols: ['Character', 'Lines', 'Chars', 'Est. seconds'], copyAllLines: 'Copy all lines', copy: 'Copy', copied: 'Copied', copyFailed: 'Copy failed', lineRef: (ep, i) => `E${String(ep).padStart(2, '0')} scene ${i}`, dlgSec: (s) => `${s}s`, fmtMin: (m, s) => `${m}m ${s}s`, overBy: (s) => `${s}s over`, underBy: (s) => `${s}s under`, legendDlg: 'Dialogue', legendAct: 'Action', legendBand: 'Target band', unitLines: 'lines', unitSec: 's', castMeta: (count, chars, sec) => `${count} lines · ${chars} chars · ~${sec}s`, castProps: (c, p) => (p ? `Cast: ${c} · Props: ${p}` : `Cast: ${c}`), sep: ', ', colon: ': ', paren: (s) => ` (${s})`, colophon: 'Script written by the model against the outline and art bible; durations and references checked deterministically by script. Storyboarding and first-frame prompts belong to the next layer, not this report.', }, }; export const tOf = (lang) => { if (lang && !I18N[lang]) throw new Error('报告界面语言目前内置 zh / en'); return I18N[lang ?? 'zh']; }; /* ------------------------------------------------------------------ */ /* render — markdown */ /* ------------------------------------------------------------------ */ const esc = (s) => String(s ?? '') .replace(/&/g, '&') .replace(//g, '>') .replace(/"/g, '"'); const mdRow = (cells) => `| ${cells.map((c) => String(c ?? '').replace(/\|/g, '\\|')).join(' | ')} |`; const mdHead = (cols) => [mdRow(cols), mdRow(cols.map(() => '---'))].join('\n'); /** 显示名：给了上游映射就用名字，否则裸 ID。 */ function namer(ctx = {}, t = tOf()) { const charName = new Map((ctx.outline?.characters ?? []).map((c) => [c.id, c.name])); const sceneName = new Map((ctx.art?.scenes ?? []).map((s) => [s.id, s.name])); const propName = new Map((ctx.art?.props ?? []).map((p) => [p.id, p.name])); const voiceByName = new Map((ctx.cast?.characters ?? []).map((c) => [c.name, c?.voice?.prompt ?? ''])); return { char: (id) => (id === 'VO' ? t.voLabel : charName.get(id) ?? id), scene: (id) => sceneName.get(id) ?? id, prop: (id) => propName.get(id) ?? id, // 台词本对接 TTS：给了 --cast 才有音色提示词（按 outline 名字对上 cast） voice: (id) => voiceByName.get(charName.get(id) ?? '') ?? '', }; } /** 界面语言：--lang > script.json 顶层 lang 字段 > zh。 */ const langOf = (doc, ctx) => ctx?.lang ?? doc?.lang ?? 'zh'; export function renderMarkdown(doc, ctx = {}) { const t = tOf(langOf(doc, ctx)); const n = namer(ctx, t); const stats = computeStats(doc); const eps = doc.episodes; const first = eps[0]?.ep; const last = eps[eps.length - 1]?.ep; const out = [`# ${t.docTitle(doc.source, first, last)}`, '']; for (const [i, ep] of eps.entries()) { const st = stats.episodes[i]; out.push(`## ${t.epHead(ep.ep)}`, ''); out.push(`> ${t.estLabel(st.est, ep.targetSeconds)} · ${t.hookLabel}${t.colon}${ep.hook}${Array.isArray(ep.hookBeat) ? t.paren(t.hookAt(ep.hookBeat[0], ep.hookBeat[1])) : ''} · ${t.cliffLabel}${t.colon}${ep.cliff}`); if (ep.beatsClaimed.length) out.push(`> ${t.beatsLabel}${t.colon}${ep.beatsClaimed.join(t.sep)}`); out.push(''); ep.scenes.forEach((sc, idx) => { out.push(`### ${t.sceneHead(idx + 1)} · ${n.scene(sc.sceneId)}${sc.lighting ? t.paren(sc.lighting) : ''}`, ''); if (sc.characters.length) out.push(t.castProps(sc.characters.map(n.char).join(t.sep), sc.props?.length ? sc.props.map(n.prop).join(t.sep) : ''), ''); for (const b of sc.flow) { if (typeof b.action === 'string') out.push(b.action, ''); else out.push(`**${n.char(b.speaker)}**${b.delivery ? t.paren(b.delivery) : ''}${t.colon}${b.line}`, ''); } }); } out.push('---', '', `## ${t.secSceneTable}`, '', mdHead(t.sceneCols)); for (const row of stats.sceneTable) { out.push(mdRow([row.ep, row.index, n.scene(row.sceneId), row.lighting, row.characters.map(n.char).join(t.sep), row.lineCount, row.estSeconds])); } out.push('', `## ${t.secCastLines}`, '', mdHead(t.castCols)); for (const c of stats.castLines) { out.push(mdRow([n.char(c.id), c.count, c.chars, r1(c.chars / stats.params.charsPerSecond)])); } out.push(''); return out.join('\n'); } /* ------------------------------------------------------------------ */ /* render — html */ /* ------------------------------------------------------------------ */ /* * 与另外三份报告同一套视觉语言：冷灰印张 + 铁锈红印记，1600 宽， * 零外部依赖。设计约定见 references/report-style.md。 */ function embedDoc(doc) { return JSON.stringify(doc).replace(/ !g.ok); const eps = doc.episodes; const first = eps[0]?.ep; const last = eps[eps.length - 1]?.ep; const tolPct = Math.round(stats.params.tolerance * 100); const fmtMin = (sec) => t.fmtMin(Math.floor(sec / 60), Math.round(sec % 60)); const dlgRatio = stats.totals.estSeconds ? Math.round((stats.totals.dialogueSeconds / stats.totals.estSeconds) * 100) : 0; const avgScene = stats.totals.scenes ? r1(stats.totals.estSeconds / stats.totals.scenes) : 0; // ---- 时长仪表：每集一行，目标区间画成绿带，台词/动作堆叠 ---- const scaleMax = Math.max(...stats.episodes.map((e) => Math.max(e.est, (e.target ?? 0) * (1 + stats.params.tolerance)))) * 1.08; const timingRows = stats.episodes .map((e) => { const lo = e.target * (1 - stats.params.tolerance); const hi = e.target * (1 + stats.params.tolerance); const inBand = e.est >= lo && e.est <= hi; const pct = (v) => `${r1((v / scaleMax) * 100)}%`; const status = inBand ? '' : ` ${esc(e.est > hi ? t.overBy(r1(e.est - hi)) : t.underBy(r1(lo - e.est)))}`; return `
E${String(e.ep).padStart(2, '0')}
${e.est}s / ${e.target}s${status}
`; }) .join('\n'); // ---- 分集剧本 ---- const epBlocks = eps .map((ep, i) => { const st = stats.episodes[i]; const scenesHtml = ep.scenes .map((sc, idx) => { const flow = sc.flow .map((b, bi) => { const hooked = Array.isArray(ep.hookBeat) && ep.hookBeat[0] === idx + 1 && ep.hookBeat[1] === bi + 1; const hk = hooked ? ' hooked' : ''; return typeof b.action === 'string' ? `

${esc(b.action)}

` : `
${esc(n.char(b.speaker))}${b.delivery ? `${esc(b.delivery)}` : ''}${esc(b.line)}
`; }) .join('\n'); return `
${esc(t.sceneHead(idx + 1))} ${esc(sc.sceneId)} ${esc(n.scene(sc.sceneId))} ${sc.lighting ? `${esc(t.lightingLabel)} · ${esc(sc.lighting)}` : ''} ${sc.characters.map((id) => `${esc(n.char(id))}`).join('')} ${(sc.props ?? []).map((id) => `${esc(n.prop(id))}`).join('')}
${flow}
`; }) .join('\n'); return `
E${String(ep.ep).padStart(2, '0')} ${esc(t.estLabel(st.est, ep.targetSeconds))} ${ep.beatsClaimed.map((b) => `${esc(b)}`).join('')}
${esc(t.hookLabel)}${esc(ep.hook)}${Array.isArray(ep.hookBeat) ? ` ${esc(t.hookAt(ep.hookBeat[0], ep.hookBeat[1]))}` : ''}
${scenesHtml}
${esc(t.cliffLabel)}${esc(ep.cliff)}
`; }) .join('\n'); // ---- 场次总表 / 台词本 ---- const table = (cols, rows) => `${cols.map((c) => ``).join('')}${rows.map((r) => `${r.map((c) => ``).join('')}`).join('\n')}
${esc(c)}
${c}
`; const sceneRows = stats.sceneTable.map((row) => [ String(row.ep), String(row.index), esc(`${row.sceneId} ${n.scene(row.sceneId)}`), esc(row.lighting), esc(row.characters.map(n.char).join(t.sep)), String(row.lineCount), String(row.estSeconds), ]); const castBlocks = stats.castLines .map((c) => { const allText = c.lines.map((l) => l.line).join('\n'); return `
${esc(n.char(c.id))} ${esc(t.castMeta(c.count, c.chars, r1(c.chars / stats.params.charsPerSecond)))} ${n.voice(c.id) ? `` : ''}
    ${c.lines.map((l) => `
  1. ${esc(t.lineRef(l.ep, l.sceneIndex))}${esc(l.line)}${l.delivery ? `${esc(l.delivery)}` : ''}
    2. `).join('')}
`; }) .join('\n'); const gateList = ``; return ` ${esc(t.docTitle(doc.source, first, last))}

${esc(doc.source)}

${esc(t.kicker)} · ${esc(t.epRange(first, last))} ${failed.length ? '✗' : '✓'} ${esc(t.gatePill(gates.length - failed.length, gates.length))}
${esc(t.kpi.eps)}
${stats.totals.episodes}
${esc(t.kpi.epsSub(stats.totals.scenes))}
${esc(t.kpi.time)}
${esc(fmtMin(stats.totals.estSeconds))}
${esc(t.kpi.timeSub(fmtMin(stats.totals.targetSeconds)))}
${esc(t.kpi.lines)}
${stats.totals.lines} ${esc(t.unitLines)}
${esc(t.kpi.linesSub(stats.totals.dialogueSeconds))}
${esc(t.kpi.dlgRatio)}
${dlgRatio}%
${esc(t.kpi.dlgRatioSub)}
${esc(t.kpi.avgScene)}
${avgScene} ${esc(t.unitSec)}
${esc(t.kpi.avgSceneSub)}
${failed.length ? `
✗ ${esc(t.gatesFail(failed.length))}${failed.map((g) => `${esc(gateText(g, t.langCode).label)}${g.detail ? ` — ${esc(gateText(g, t.langCode).detail)}` : ''}`).join('')}
` : ''}
01

${esc(t.secTiming)}

${esc(t.timingNote(tolPct))}
${esc(t.legendDlg)} ${esc(t.legendAct)} ${esc(t.legendBand)}
${timingRows}
02

${esc(t.secScript)}

${eps.length > 1 ? esc(t.scriptNote) : ''}
${epBlocks}
03

${esc(t.secSceneTable)}

${esc(t.sceneTableNote)}
${table(t.sceneCols, sceneRows)}
04

${esc(t.secCastLines)}

${esc(t.castLinesNote)}
${castBlocks}
05

${esc(t.secGates)}

${gateList}

${failed.length ? `${esc(t.gatesFail(failed.length))}` : esc(t.gatesPass)}

${esc(t.colophon)}

`; } /* ------------------------------------------------------------------ */ /* CLI */ /* ------------------------------------------------------------------ */ const USAGE = `novel-script.mjs — novel-script skill 的确定性工具（剧本） seed [--eps 1-6] 从大纲预填每集骨架（打印到 stdout） validate [--outline o.json] 校验；有违规逐条打印并 exit 1 [--art a.json] 给了上游才做对账（角色 / 场景光照道具 / 爽点认领） checkup [--outline] [--art] 只打印质量门 ✓/✗，有未过项 exit 1 render [--html|--md] 渲染报告到 stdout（默认 --md） [--lang zh|en] 报告界面语言（默认中文，或跟 script.json 的 lang 字段） [--outline o.json] [--art a.json] 给了上游就把 ID 显示成名字 [--cast cast.json] 台词本带每个角色的音色提示词（对接 TTS） slug 剧名转安全文件名`; function readJson(path) { return JSON.parse(readFileSync(resolve(path), 'utf8')); } function flag(rest, name, fallback = null) { const i = rest.indexOf(name); return i >= 0 && rest[i + 1] ? rest[i + 1] : fallback; } function loadCtx(rest) { const get = (name) => { const path = flag(rest, name); return path ? readJson(path) : null; }; return { outline: get('--outline'), art: get('--art'), cast: get('--cast') }; } function main(argv) { const [cmd, ...rest] = argv; if (!cmd || cmd === '-h' || cmd === '--help') { console.log(USAGE); process.exit(cmd ? 0 : 1); } if (cmd === 'seed') { const [path] = rest; if (!path) throw new Error('用法：seed [--eps 1-6]'); const range = flag(rest, '--eps'); let epRange = null; if (range) { const m = String(range).match(/^(\d+)-(\d+)$/) ?? String(range).match(/^(\d+)$/); if (!m) throw new Error('--eps 形如 3 或 1-6'); epRange = m[2] ? [Number(m[1]), Number(m[2])] : [Number(m[1]), Number(m[1])]; } console.log(JSON.stringify(seedFromOutline(readJson(path), epRange), null, 2)); return; } if (cmd === 'validate' || cmd === 'checkup') { const [path] = rest; if (!path) throw new Error(`用法：${cmd} [--outline o.json] [--art a.json]`); const doc = readJson(path); const ctx = loadCtx(rest); if (!ctx.outline) console.error('⚠️ 没给 --outline，跳过角色引用与爽点认领检查'); if (!ctx.art) console.error('⚠️ 没给 --art，跳过场景／光照／道具对账'); if (cmd === 'checkup') { const gates = gateReport(doc, ctx); for (const g of gates) console.log(`${g.ok ? '✓' : '✗'} ${g.label}${!g.ok && g.detail ? ` — ${g.detail}` : ''}`); const failedN = gates.filter((g) => !g.ok).length; console.log(failedN ? `\n✗ ${failedN} 项未过` : '\n✓ 全部通过'); if (failedN) process.exit(1); return; } const problems = validateScript(doc, ctx); if (problems.length) { console.error(`✗ ${problems.length} 处违规：\n`); for (const x of problems) console.error(' ' + x); process.exit(1); } const st = computeStats(doc); console.log(`✓ ${st.totals.episodes} 集 / ${st.totals.scenes} 场 / ${st.totals.lines} 句台词全部通过校验（预估 ${st.totals.estSeconds}s / 目标 ${st.totals.targetSeconds}s）`); return; } if (cmd === 'render') { const [path] = rest; if (!path) throw new Error('用法：render [--html|--md] [--lang zh|en] [--outline o.json] [--art a.json]'); const doc = readJson(path); const ctx = loadCtx(rest); const lang = flag(rest, '--lang'); if (lang) ctx.lang = lang; process.stdout.write((rest.includes('--html') ? renderHtml(doc, ctx) : renderMarkdown(doc, ctx)) + '\n'); return; } if (cmd === 'slug') { if (!rest[0]) throw new Error('用法：slug '); console.log(slug(rest[0])); return; } throw new Error(`未知命令 ${cmd}\n\n${USAGE}`); } // 软链安装时 argv[1] 是链接路径，两边都取 realpath 才能比得上 function isMainModule() { if (!process.argv[1]) return false; try { return realpathSync(process.argv[1]) === realpathSync(fileURLToPath(import.meta.url)); } catch { return false; } } if (isMainModule()) { // `render ... | head` 这类管道提前关闭时安静退出，别甩 EPIPE 堆栈 process.stdout.on('error', (e) => { if (e.code === 'EPIPE') process.exit(0); throw e; }); try { main(process.argv.slice(2)); } catch (error) { console.error(error instanceof Error ? error.message : error); process.exit(1); } }