@wji.ai/cli 0.9.0 → 0.9.2

package/skill/short-drama/scripts/short-drama.mjs

@@ -24,6 +24,8 @@
 //   validate <project> [--stage outline|characters|art|script|storyboard] [--ep 1-3]
 //   checkup  <project> [--stage …] [--ep …]            every gate with ✓/✗, exit 0
 //   seed     <project> script --ep N [--force]        episodes/E0N.json skeleton from the outline
+//   seed     <project> dialogue --ep N [--force]      对白校对 record from the current lines (filled rows for unchanged lines are kept)
+//   apply    <project> dialogue --ep N               write the reviewed lines (and deliveries) back into the script
 //   seed     <project> storyboard --ep N [--force]    beat worksheet, visual-plan worksheet + empty segments from the script
 //   render   <project> outline | guideline | character C01 | scene S01 | prop P01 | script --ep N | dialogue --ep N | segment E01-01
 //   prompt   <project> segment E01-01                 derived video-prompt skeleton + keyframe reference plan
@@ -42,6 +44,7 @@
 import { copyFileSync, existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from 'node:fs';
 import { basename, dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { homedir } from 'node:os';
 
 // ── constants ───────────────────────────────────────────────────────────────
 
@@ -104,6 +107,9 @@ export const DEFAULT_PARAMS = Object.freeze({
   maxConsecutiveLines: 3,
   minActionRatio: 0.35,
   maxNameCallsPerScene: 2,
+  // The 对白校对 pass after the script (`seed dialogue` → fill → `apply dialogue`): `required` blocks the
+  // storyboard until every line is reviewed against the 语体 guide; `off` skips it.
+  dialogueReview: 'required',
   maxLineWords: 20,
   // Shot language.
   speechLeadSeconds: 0.5,
@@ -256,6 +262,42 @@ export function normalizeRegister(value) {
   const v = String(value || '').trim();
   return REGISTER_ALIASES[v] || v;
 }
+/**
+ * 语体 → the user's `w-film-dialogue-editor` skill: which language guide to read and which corpus
+ * `scripts/ref.mjs` can query. A register without a corpus still has its guide.
+ */
+export const DIALOGUE_GUIDES = {
+  '粤语': { lang: 'zh-hk', guide: 'lang-zh-hk.md', corpus: true },
+  '大陆普通话': { lang: 'zh-cn', guide: 'lang-zh-cn.md', corpus: true },
+  '台湾国语': { lang: 'zh-tw', guide: 'lang-zh-tw.md', corpus: true },
+  '港式普通话': { lang: 'zh-hk-mandarin', guide: 'lang-zh-hk-mandarin.md', corpus: false },
+  '古装': { lang: 'zh-period', guide: 'lang-zh-period.md', corpus: false },
+  '年代': { lang: 'zh-period', guide: 'lang-zh-period.md', corpus: false },
+  '英文美式': { lang: 'en', guide: 'lang-en.md', corpus: true },
+  '英文英式': { lang: 'en', guide: 'lang-en.md', corpus: true },
+};
+export const DIALOGUE_SKILL = 'w-film-dialogue-editor';
+export const DIALOGUE_LEVELS = ['轻修', '中修', '重修'];
+/** The scene-level diagnosis the review must answer before any line is touched. */
+export const DIALOGUE_DIAGNOSIS = { goal: '场面目标', conflict: '主要冲突', subtext: '潜台词核心', voice: '角色声音问题', rhythm: '节奏问题' };
+/** Director notes that are not notes. */
+export const VAGUE_NOTES = ['自然一点', '自然一點', '自然些', '激动一点', '激動一點', '伤心一点', '傷心一點', '大声一点', '大聲一點', 'more natural', 'be natural'];
+/** The corpus's age bands (ref.mjs ENUMS.age). */
+export function corpusAge(age) {
+  if (age == null) return null;
+  if (age <= 12) return 'kid';
+  if (age <= 19) return 'teen';
+  if (age <= 29) return 'young';
+  if (age <= 44) return 'mid';
+  if (age <= 59) return 'senior';
+  return 'elder';
+}
+/** Where the dialogue skill is: beside this skill (npm package, crew install), else the user's Claude skills. */
+export function dialogueSkillDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [join(here, '..', '..', DIALOGUE_SKILL), join(homedir(), '.claude', 'skills', DIALOGUE_SKILL)];
+  return candidates.find((d) => existsSync(join(d, 'SKILL.md'))) || null;
+}
 /** 本集功能 — what an episode is for in the run of the drama. */
 export const EPISODE_FUNCTIONS = ['开局钩子', '冲突升级', '身份揭露', '情感推进', '大反转', '清算收束'];
 /** 爽点类型库 — a 爽点 is done by a visible action of one of these kinds. */
@@ -543,6 +585,53 @@ export function identityOf(character) {
   return String(character?.identityEn || '').trim() || 'the person in this shot';
 }
 
+/** The drama-language identity, for a Chinese legend: two people must never read the same line. */
+export function identityZh(character) {
+  const p = character?.profile || {};
+  const clean = (v) => (v && !/^(不詳|不详|未知|n\/a|unknown)$/i.test(String(v).trim()) ? String(v).trim() : '');
+  const bits = [clean(p.ageRange), clean(p.gender), clean(p.appearance || p.identity)].filter(Boolean);
+  return String(bits.join('，') || '').trim();
+}
+
+/**
+ * What a picture IS, said in the legend, so the model never has to guess whether @image3 is the
+ * room, a person or a prop — and, for a reference that is not a person, what NOT to copy from it.
+ * One legend line per picture; nothing else in the prompt repeats it.
+ */
+/** A short English handle from an English art prompt, so an English legend can name a room or a prop
+ *  without breaking the "prompt must be English apart from dialogue" rule (and without using an id). */
+function plainPhrase(text, maxWords = 10) {
+  const s = String(text || '').trim();
+  if (!s || /[\u4e00-\u9fff]/.test(s)) return '';
+  const head = s.replace(/^(product photograph of|a|an|the)\s+/i, '').split(/[,.;(]/)[0].trim();
+  return head.split(/\s+/).filter(Boolean).slice(0, maxWords).join(' ');
+}
+
+export function sheetUse(ref, project) {
+  const id = String(ref.entity || '');
+  const ch = characterById(project, id);
+  const pr = propById(project, id);
+  const sc = sceneById(project, id);
+  if (ref.asset && /^lighting:/.test(ref.asset)) return 'the same environment in the lighting state to use \u2014 take only its light ratios, contrast and colour temperature, never its composition or its people';
+  if (/^C\d/.test(id) && ch) return `the character sheet of ${identityOf(ch)} \u2014 match face, hair and clothes exactly, and nothing else in the frame`;
+  if (/^P\d/.test(id) && pr) return `the prop to reproduce exactly${plainPhrase(pr.image?.prompt || pr.states?.[0]?.prompt) ? `: ${plainPhrase(pr.image?.prompt || pr.states?.[0]?.prompt)}` : ''} \u2014 only this object, not the surface it sits on`;
+  if (sc) return `the environment${plainPhrase(sc.lighting?.[0]?.prompt) ? `: ${plainPhrase(sc.lighting[0].prompt)}` : ''} \u2014 match its layout, materials and wear exactly; take no person from it, not ever`;
+  if (ref.asset === 'headshot') return 'the headshot that supplies one person\u2019s face \u2014 match face and hair only';
+  return 'a reference image for this segment';
+}
+export function sheetZh(ref, project) {
+  const id = String(ref.entity || '');
+  const ch = characterById(project, id);
+  const pr = propById(project, id);
+  const sc = sceneById(project, id);
+  if (ref.asset && /^lighting:/.test(ref.asset)) return '同一场景的光线状态：只照它的光比、反差与色温，不要照它的构图与人物';
+  if (/^C\d/.test(id) && ch) return `人物三视图（${identityZh(ch)}）：严格还原面容、发型与服装`;
+  if (/^P\d/.test(id) && pr) return `需要严格还原的道具：${pr.name || id}`;
+  if (sc) return `环境（${sc.name || id}），严格还原布局、材质与旧痕；这张图里没有人，不要照它的人物`;
+  if (ref.asset === 'headshot') return '一张人头特写，只照面容与发型';
+  return '本段参考图';
+}
+
 export const CAMERAS = [
   'Static Shot', 'Push In', 'Pull Out', 'Zoom In', 'Zoom Out', 'Pan Left', 'Pan Right',
   'Truck Left', 'Truck Right', 'Tilt Up', 'Tilt Down', 'Pedestal Up', 'Pedestal Down',
@@ -1699,6 +1788,90 @@ function gate(id, stage, label, run, opts = {}) {
   return { id, stage, label, run, advisory: opts.advisory === true };
 }
 
+const ASSET_CONDITIONS = ['new', 'lived-in', 'worn'];
+// Whole English words, so "stainless" is not "stain". Chinese marks are the wear words themselves.
+const WORN_CONDITION_RE = /\b(worn|rust|rusty|rusted|faded|chipped|torn|frayed|peeling|stain|stained|stains)\b|殘舊|残旧|生鏽|生锈|褪色|剝落|剥落/i;
+const CLEAN_BAN_RE = /showroom[-\s]?clean|brand[-\s]?new/i;
+
+function assetConditionFailures(entity, texts) {
+  const out = [];
+  if (!ASSET_CONDITIONS.includes(entity.condition)) out.push(`${entity.id}: condition must be new, lived-in or worn`);
+  if (!String(entity.conditionReason || '').trim()) out.push(`${entity.id}: conditionReason must say why the story gives this condition`);
+  if (entity.condition === 'new') {
+    for (const [where, text] of texts) {
+      if (WORN_CONDITION_RE.test(String(text || ''))) out.push(`${entity.id}: condition is new but ${where} describes wear`);
+    }
+  }
+  if (entity.condition && entity.condition !== 'worn' && CLEAN_BAN_RE.test(String(entity.image?.negativePrompt || ''))) {
+    out.push(`${entity.id}: only condition worn may ban brand-new or showroom-clean`);
+  }
+  return out;
+}
+
+function sceneConditionTexts(scene) {
+  const texts = [];
+  for (const a of scene.anchors || []) texts.push([`anchor "${a.name || ''}"`, `${a.name || ''} ${a.desc || ''}`]);
+  const img = scene.image || {};
+  for (const key of ['prompt', 'sheet']) if (img[key]) texts.push([`image.${key}`, img[key]]);
+  for (const l of scene.lighting || []) if (l.prompt) texts.push([`lighting "${l.state || ''}"`, l.prompt]);
+  return texts;
+}
+
+function propConditionTexts(prop) {
+  const texts = [];
+  for (const a of prop.anchors || []) texts.push([`anchor "${a.name || ''}"`, `${a.name || ''} ${a.desc || ''}`]);
+  const img = prop.image || {};
+  for (const key of ['prompt', 'sheet']) if (img[key]) texts.push([`image.${key}`, img[key]]);
+  for (const st of prop.states || []) if (st.prompt) texts.push([`state "${st.state || ''}"`, st.prompt]);
+  return texts;
+}
+
+// ── reference binding helpers ───────────────────────────────────────────────
+// The storyboard's picture plan has to survive into the delivery text. The model reads ONE string:
+// a shot that never names its @imageK falls back to whatever it last saw, and two pictures the
+// legend describes in the same words are two pictures the model will swap.
+const ID_STOPWORDS = new Set(['the', 'and', 'with', 'her', 'his', 'one', 'man', 'woman', 'from', 'this']);
+function identityTokens(ch) {
+  const out = new Set();
+  const add = (text) => {
+    for (const w of String(text || '').toLowerCase().split(/[^a-z0-9\u4e00-\u9fff]+/)) if (w.length > 2 && !ID_STOPWORDS.has(w)) out.add(w);
+    for (const run of String(text || '').match(/[\u4e00-\u9fff]+/g) || []) {
+      if (run.length <= 3) out.add(run);
+      else for (let i = 0; i + 1 < run.length; i++) out.add(run.slice(i, i + 2));
+    }
+  };
+  add(ch?.identityEn);
+  add(ch?.profile?.appearance);
+  add(ch?.profile?.identity);
+  const g = ch?.profile?.gender;
+  if (g) out.add(g === '男' ? '男' : '女');
+  return out;
+}
+/** The legend text that belongs to one label: from its `@imageN` to the next label. */
+function legendSpanOf(head, label) {
+  const m = new RegExp(`${label}(?!\\d)`).exec(head);
+  if (!m) return '';
+  const rest = head.slice(m.index + label.length);
+  const next = rest.search(/@image\d+/);
+  return (next < 0 ? rest : rest.slice(0, next)).trim();
+}
+/** Per-shot text for every family: h3 / wan / seedance sheets have a parser, keyframes are read here. */
+function referenceShotTexts(prompt, mode, params) {
+  const texts = shotTexts(prompt, mode.family, params.references);
+  if (texts.size) return texts;
+  const map = new Map();
+  const re = /(?:^|\n)\s*From @image(\d+)[^\n]*([\s\S]*?)(?=\n\s*From @image\d+|\n\s*\n|$)/g;
+  for (let m; (m = re.exec(prompt)); ) map.set(Number(m[1]), m[0]);
+  return map;
+}
+/** label per sheet entity (people, props and the room), for the binding checks. */
+function sheetLabelsOf(images) {
+  const m = new Map();
+  for (const r of images) if (r.asset === 'sheet' || r.asset === 'headshot') if (!m.has(r.entity)) m.set(r.entity, r.label);
+  return m;
+}
+const NEGATIVE_REF = /not its|never its|only its|no person|take no person|not the composition|只照|唔照|不要照|只取|这张图里没有人|不要照它的人物/i;
+
 export const GATES = [
   // ── outline ───────────────────────────────────────────────────────────
   gate('params', 'outline', 'params complete and valid', ({ project, params }) => {
@@ -2755,6 +2928,7 @@ export const GATES = [
     const look = kit.zh ? null : cinematographyOf(params);
     for (const s of project.scenes || []) {
       if (!String(s.summary || '').trim()) out.push(`${s.id}: summary (design intent) is empty`);
+      out.push(...assetConditionFailures(s, sceneConditionTexts(s)));
       const anchors = s.anchors || [];
       if (anchors.length < 3 || anchors.length > 5) out.push(`${s.id}: ${anchors.length} anchors, need 3–5`);
       for (const a of anchors) if (!a.name || !a.desc) out.push(`${s.id}: every anchor needs name + desc`);
@@ -2798,6 +2972,7 @@ export const GATES = [
     for (const p of project.props || []) {
       if (!PROP_SCALES[p.scale]) out.push(`${p.id}: scale must be one of ${Object.keys(PROP_SCALES).join(' / ')}`);
       if (!String(p.summary || '').trim()) out.push(`${p.id}: summary (dramatic function) is empty`);
+      out.push(...assetConditionFailures(p, propConditionTexts(p)));
       const anchors = p.anchors || [];
       if (anchors.length < 3 || anchors.length > 5) out.push(`${p.id}: ${anchors.length} anchors, need 3–5`);
       const states = p.states || [];
@@ -3082,6 +3257,49 @@ export const GATES = [
     }
     return out;
   }, { advisory: true }),
+  gate('dialogue-review', 'script', '对白校对: every line reviewed against its 语体 guide (w-film-dialogue-editor) — diagnosis, a row per line, the revision applied, playable director notes, the guide’s 自检', (ctx) => {
+    const { params } = ctx;
+    if (params.dialogueReview === 'off') return [];
+    const out = [];
+    for (const [ep, e] of ctx.episodes) {
+      const E = `E${pad2(ep)}`;
+      const lines = lineBeats(e);
+      if (!lines.length) continue;
+      const rv = e.dialogueReview;
+      if (!isObject(rv)) { out.push(`${E}: no dialogueReview — run \`seed <project> dialogue --ep ${ep}\`, read the 语体 guide, fill every row, then \`apply <project> dialogue --ep ${ep}\``); continue; }
+      if (!DIALOGUE_LEVELS.includes(rv.level)) out.push(`${E}: dialogueReview.level must be ${DIALOGUE_LEVELS.join(' / ')}`);
+      for (const [k, label] of Object.entries(DIALOGUE_DIAGNOSIS)) if (!String(rv.diagnosis?.[k] || '').trim()) out.push(`${E}: dialogueReview.diagnosis.${k} (${label}) is empty — diagnose the scene before touching a line`);
+      const want = new Set(dialogueRefs(ctx.project, e, { skillDir: null }).speakers.map((x) => DIALOGUE_GUIDES[x.register]?.guide).filter(Boolean));
+      const read = new Set(asList(rv.guides).map((g) => basename(String(g))));
+      for (const g of want) if (!read.has(g)) out.push(`${E}: dialogueReview.guides is missing ${g} — a speaker in this episode speaks that 语体`);
+      const rows = asList(rv.rows);
+      const byPos = new Map();
+      for (const r of rows) {
+        const key = `${r.scene}:${r.beat}`;
+        if (byPos.has(key)) out.push(`${E} scene ${r.scene} beat ${r.beat}: reviewed twice`);
+        byPos.set(key, r);
+      }
+      const isLine = new Set(lines.map((l) => `${l.scene}:${l.beat}`));
+      for (const r of rows) if (!isLine.has(`${r.scene}:${r.beat}`)) out.push(`${E} scene ${r.scene} beat ${r.beat}: a review row for a beat that is no longer a line — re-seed the review`);
+      for (const l of lines) {
+        const where = `${E} scene ${l.scene} beat ${l.beat}`;
+        const r = byPos.get(`${l.scene}:${l.beat}`);
+        if (!r) { out.push(`${where}: "${truncateLine(l.line)}" has no review row — re-seed the review (filled rows are kept)`); continue; }
+        if (r.speaker !== l.speaker) out.push(`${where}: the row is for ${r.speaker}, the line is ${l.speaker}'s — re-seed the review`);
+        if (String(r.revised ?? '') !== l.line) { out.push(`${where}: the script line differs from the reviewed one ("${truncateLine(String(r.revised ?? ''))}") — \`apply <project> dialogue --ep ${ep}\`, or re-seed after an edit so the new line is reviewed`); continue; }
+        if (!String(r.original || '').trim()) out.push(`${where}: original is empty`);
+        if (!String(r.issue || '').trim()) out.push(`${where}: issue is empty — name the problem, or 无 when the line stands`);
+        if (r.revised !== r.original && !String(r.reason || '').trim()) out.push(`${where}: changed without a reason`);
+        const note = String(r.note || '').trim();
+        if (!note) out.push(`${where}: no 导演／演员提示 — a playable action (逼 / 哄 / 避 / 试探 / 停半拍…)`);
+        else if (EMOTION_ONLY.includes(note) || VAGUE_NOTES.some((w) => note.toLowerCase().includes(w.toLowerCase()))) out.push(`${where}: note "${note}" is a mood, not an action — say what the line does to the other person`);
+      }
+      const checks = asList(rv.selfCheck);
+      if (checks.length < 3) out.push(`${E}: dialogueReview.selfCheck needs the guide's 自检清单 (at least 3 items), each { item, ok, note }`);
+      for (const c of checks) if (!c.ok && !String(c.note || '').trim()) out.push(`${E}: 自检 "${truncateLine(String(c.item || ''))}" failed with no note — fix the lines or say why it stands`);
+    }
+    return out;
+  }),
 
   // ── storyboard (per episode) ──────────────────────────────────────────
   gate('segments', 'storyboard', 'segments: ids sequential, one scene each, cuts claim every beat once in order', (ctx) => {
@@ -3659,6 +3877,70 @@ export const GATES = [
     }
     return out;
   }),
+  gate('ref-binding', 'storyboard', '参考图绑定: every picture says in the legend WHAT it is (and what not to copy from it), everyone and everything on screen is bound by its @imageK inside that shot, and no connected picture goes unused', (ctx) => {
+    const { project, params } = ctx;
+    const out = [];
+    if (params.references !== 'sheets') return out;
+    const mode = videoModel(params);
+    for (const [, e] of ctx.episodes) {
+      for (const seg of e.storyboard?.segments || []) {
+        const prompt = String(seg.prompt || '').trim();
+        if (!prompt) continue;
+        const refs = segmentReferences(project, e, seg);
+        const images = refs.filter((r) => r.kind === 'image');
+        if (!images.length) continue;
+        if (images.length > mode.maxRefs) out.push(`${seg.id}: ${images.length} picture references, but ${mode.model} takes at most ${mode.maxRefs} — split the segment, or drop a picture that earns nothing`);
+        const shotStart = prompt.search(/(?:^|\n)\s*(?:\[Shot\s*1\]|镜头\s*1|Shot\s*1)\b/);
+        const head = shotStart < 0 ? prompt : prompt.slice(0, shotStart);
+        // 1. one legend line per picture, and it says what the picture IS
+        const legendLines = head.split('\n').filter((l) => /^@image\d+\b/.test(l.trim()));
+        for (const r of images) {
+          const mine = legendLines.filter((l) => l.trim().startsWith(r.label));
+          if (!mine.length) out.push(`${seg.id}: ${r.label} (${r.why}) is connected but the legend never gives it a line — the model cannot know the picture exists`);
+          else if (mine.length > 1) out.push(`${seg.id}: ${r.label} gets ${mine.length} legend lines — one line per picture, or the model reads them as different things`);
+          if (mine.length && /^(@image\d+ is\s*)?a reference image/i.test(mine[0].trim().replace(/^@image\d+ is\s*/, ''))) out.push(`${seg.id}: ${r.label} says only "a reference image" — say whether it is the place, a person, the prop, or a light / moment to copy`);
+        }
+        // 2. a picture that is not a person must say what NOT to copy from it
+        for (const r of images) {
+          if (/^C\d/.test(String(r.entity))) continue;
+          const span = legendSpanOf(head, r.label);
+          if (span && !NEGATIVE_REF.test(span)) out.push(`${seg.id}: ${r.label} (${r.role || 'not a person'}) never says what NOT to take from it — a light or moment reference must say "only its light ratios / not its composition or people", or the model copies its faces`);
+        }
+        // 3. two people must not read the same in the legend
+        const chars = uniq((seg.cuts || []).flatMap((c) => c.characters || [])).filter((id) => id !== 'VO');
+        const byEntity = new Map(images.map((r) => [r.entity, r]));
+        const seenSpans = new Map();
+        for (const id of chars) {
+          const r = byEntity.get(id);
+          if (!r) { out.push(`${seg.id}: ${characterById(project, id)?.name || id} is on screen, but no picture supplies them`); continue; }
+          const span = legendSpanOf(head, r.label).toLowerCase();
+          const key = span.replace(/\s+/g, ' ').trim();
+          if (key && seenSpans.has(key)) out.push(`${seg.id}: ${r.label} and ${seenSpans.get(key)} read exactly the same in the legend — two people described in the same words are two people the model swaps`);
+          else if (key) seenSpans.set(key, r.label);
+          const hits = [...identityTokens(characterById(project, id))].filter((t) => span.includes(t)).length;
+          if (span && hits < 2) out.push(`${seg.id}: ${r.label} never says WHICH person it is (no age / hair / clothes from the character bible) — "@image2, @image3 are character sheets" is how faces get swapped`);
+        }
+        // 4. what is in shot is bound inside that shot
+        const texts = referenceShotTexts(prompt, mode, params);
+        const labels = sheetLabelsOf(images);
+        (seg.cuts || []).forEach((c, k) => {
+          const text = texts.get(k + 1) || '';
+          if (!text) return;
+          for (const id of c.props || []) {
+            const label = labels.get(id);
+            if (label && !text.includes(label)) out.push(`${seg.id} shot ${k + 1}: ${propById(project, id)?.name || id} is in shot but the shot never binds ${label} — the prop is invented on screen`);
+          }
+        });
+        // 5. a picture connected but never used outside the legend earns nothing
+        const body = shotStart < 0 ? prompt : prompt.slice(shotStart);
+        for (const r of images) {
+          if (r.role === 'environment' || r.role === 'lighting') continue;
+          if (!body.includes(r.label)) out.push(`${seg.id}: ${r.label} (${r.why}) is connected but used in no shot — that is a picture the model will not look at`);
+        }
+      }
+    }
+    return out;
+  }),
   gate('two-person-framing', 'storyboard', 'sheets mode, two-person segments: a single names only its person, every look has a screen direction toward the other, the sides are locked, over-the-shoulder is said', (ctx) => {
     const { project, params } = ctx;
     const out = [];
@@ -4348,7 +4630,7 @@ export function seedScript(project, ep) {
     const sp = c?.bible?.speech || {};
     if (c) speech[id] = { name: displayName(project, id, ep), rhythm: sp.rhythm || '', silence: sp.silence || '', catchphrase: sp.catchphrase || '', forbiddenWords: sp.forbiddenWords || [], register: sp.register || '', voice: c.voice?.pace || '' };
   }
-  return {
+  const seeded = {
     ep: Number(ep),
     targetSeconds: Math.round(Number(params.minutesPerEpisode) * 60),
     // The episode design from the outline's 分集目录 — gated against it in the script stage.
@@ -4371,6 +4653,7 @@ export function seedScript(project, ep) {
       guidelinePriorities: asList(project.outline?.guideline?.priorities),
       guidelineForbidden: asList(project.outline?.guideline?.forbidden),
       speech,
+      dialogue: null,
       rhythm: `hook image by ${params.hookSeconds} s · a turn (new information / obstacle / counter / choice, \`turn: true\`) at least every ${params.turnSeconds} s · 爽点 (satisfactionBeat) on a visible action after the hook and before the cliff · no more than ${params.maxConsecutiveLines} lines in a row`,
       sceneIds: outlineEp.sceneIds || [],
       characterIds: outlineEp.characterIds || [],
@@ -4384,6 +4667,10 @@ export function seedScript(project, ep) {
     storyboard: { segments: [] },
     wji: { screenplayDatasetId: '', canvasId: '', shotFolderId: '', displayNodes: {} },
   };
+  // The dialogue skill for everyone who speaks here — read while writing, not only in the review.
+  const pseudo = { ep: Number(ep), scenes: [{ characters: outlineEp.characterIds || [], flow: [] }] };
+  seeded.seedNote.dialogue = dialogueRefs(project, pseudo);
+  return seeded;
 }
 
 export function seedStoryboard(project, episode) {
@@ -4489,8 +4776,8 @@ export function imagePrompt(project, id, asset) {
     const l = (sc.lighting || []).find((x) => x.state === state);
     if (!l) throw new Error(`${id} has no lighting state "${state}" (${(sc.lighting || []).map((x) => x.state).join(' / ')})`);
     return out(zh
-      ? `${t('@image1 是同一个空间；结构、材质与磨损完全一致，只改变光线：')}${l.prompt}${t(`。空场景，没有任何人，${kit.framePhrase}`)}`
-      : `@image1 is this exact space; keep structure, materials and wear identical; change only the lighting: ${l.prompt}. Empty scene, no people, ${kit.framePhrase}`, '16:9', 'sheet');
+      ? `${t('@image1 是同一个空间；结构、材质与状态完全一致，只改变光线：')}${l.prompt}${t(`。空场景，没有任何人，${kit.framePhrase}`)}`
+      : `@image1 is this exact space; keep structure, materials and condition identical; change only the lighting: ${l.prompt}. Empty scene, no people, ${kit.framePhrase}`, '16:9', 'sheet');
   }
   if (pr && kind.startsWith('state:')) {
     const state = kind.slice('state:'.length);
@@ -4542,22 +4829,25 @@ export function segmentReferences(project, episode, seg) {
   // Optional per-segment image ref plan (Director Strategy B etc.) — pictures only; voices/video still appended below.
   if (Array.isArray(seg.refOverride) && seg.refOverride.length) {
     for (const r of seg.refOverride) {
+      const pinned = { entity: r.entity, asset: r.asset || 'sheet' };
+      const notTake = r.notTake ? ` \u2014 take only what it is for, not ${r.notTake}` : '';
       refs.push({
         entity: r.entity,
         asset: r.asset || 'sheet',
         why: r.why || `${r.entity}:${r.asset || 'sheet'}`,
-        use: r.use || 'a reference image for this segment',
-        zh: r.zh || '',
+        use: r.use || r.take || `${sheetUse(pinned, project)}${notTake}`,
+        zh: r.zh || r.takeZh || sheetZh(pinned, project),
+        role: r.role || null,
         kind: 'image',
         faceOf: r.faceOf || null,
       });
     }
   } else {
-    refs.push({ entity: scene.sceneId, asset: 'sheet', why: `environment: ${sceneEntity.name || scene.sceneId}${scene.lighting ? ` (${scene.lighting})` : ''}`, use: 'the environment \u2014 match its layout, materials and wear exactly', zh: '环境，严格还原布局、材质与旧痕' });
-    if (scene.lighting && sceneEntity.wji?.assets?.lighting?.[scene.lighting]) refs.push({ entity: scene.sceneId, asset: `lighting:${scene.lighting}`, why: `lighting state ${scene.lighting}`, use: 'the same environment in the lighting state to use', zh: '同一场景的光线状态' });
+    refs.push({ entity: scene.sceneId, asset: 'sheet', role: 'environment', why: `environment: ${sceneEntity.name || scene.sceneId}${scene.lighting ? ` (${scene.lighting})` : ''}`, use: sheetUse({ entity: scene.sceneId, asset: 'sheet' }, project), zh: sheetZh({ entity: scene.sceneId, asset: 'sheet' }, project) });
+    if (scene.lighting && sceneEntity.wji?.assets?.lighting?.[scene.lighting]) refs.push({ entity: scene.sceneId, asset: `lighting:${scene.lighting}`, role: 'lighting', why: `lighting state ${scene.lighting}`, use: sheetUse({ entity: scene.sceneId, asset: `lighting:${scene.lighting}` }, project), zh: sheetZh({ entity: scene.sceneId, asset: `lighting:${scene.lighting}` }, project) });
     const seen = new Set();
-    if (params.humanReferences !== false) for (const c of seg.cuts || []) for (const id of c.characters || []) if (!seen.has(id)) { seen.add(id); refs.push({ entity: id, asset: 'sheet', why: `face and clothes of ${characterById(project, id)?.name || id}`, use: 'the character sheet of one person in this segment \u2014 match face, hair and clothes exactly', zh: '人物三视图，严格还原面容、发型与服装' }); }
-    for (const c of seg.cuts || []) for (const id of c.props || []) if (!seen.has(id)) { seen.add(id); refs.push({ entity: id, asset: 'sheet', why: `prop ${propById(project, id)?.name || id}`, use: 'the prop to reproduce exactly', zh: '需要严格还原的道具' }); }
+    if (params.humanReferences !== false) for (const c of seg.cuts || []) for (const id of c.characters || []) if (!seen.has(id)) { seen.add(id); refs.push({ entity: id, asset: 'sheet', role: 'character', why: `face and clothes of ${characterById(project, id)?.name || id}`, use: sheetUse({ entity: id, asset: 'sheet' }, project), zh: sheetZh({ entity: id, asset: 'sheet' }, project) }); }
+    for (const c of seg.cuts || []) for (const id of c.props || []) if (!seen.has(id)) { seen.add(id); refs.push({ entity: id, asset: 'sheet', role: 'prop', why: `prop ${propById(project, id)?.name || id}`, use: sheetUse({ entity: id, asset: 'sheet' }, project), zh: sheetZh({ entity: id, asset: 'sheet' }, project) }); }
     refs.forEach((r) => (r.kind = 'image'));
   }
   // The clip before this one, when the project asks for it: the cheapest continuity there is — the
@@ -4712,6 +5002,19 @@ export function promptSkeleton(project, episode, segmentId) {
     return [sidesLine(axis, whoOf, framingLang)];
   };
   const othersOnScreen = (c, speaker) => (c.characters || []).filter((id) => id !== speaker && id !== c.ots).map((id) => (params.references === 'sheets' && sheetLabels.get(id) ? `the person in ${sheetLabels.get(id)}` : identityOf(characterById(project, id))));
+  // A prop on screen is bound by its label INSIDE that shot — a prop named only in the legend is a
+  // prop the model designs itself the moment it appears. Same rule people already had.
+  const propOf = (c, lang = 'en') => (c.props || []).map((id) => sheetLabels.get(id)).filter(Boolean)
+    .map((label) => (lang === 'zh' ? `道具严格照 ${label}；` : `the prop is ${label}, reproduced exactly; `)).join('');
+  // The environment is one picture for the whole segment: say once that it does not change, so the
+  // model does not re-invent the room between shots.
+  const sceneLine = (lang = 'en') => {
+    const label = sheetLabels.get(scene?.sceneId);
+    if (!label || params.references !== 'sheets') return '';
+    return lang === 'zh'
+      ? `整段都在 ${label} 的空间里：布局、材质与旧痕不变，不要重新设计场景。`
+      : `Every shot stays inside ${label} \u2014 its layout, materials and wear do not change; do not redesign the room.`;
+  };
   let video;
   if (mode.family === 'h3') {
     const sheets = params.references === 'sheets';
@@ -4727,14 +5030,14 @@ export function promptSkeleton(project, episode, segmentId) {
       // In sheets mode the cut's own `frame` goes into the prompt and already carries the lens, the
       // light and the foreground (gated there), so only the shot size and camera move are added.
       const body = sheets
-        ? `${framingOf(c)}${c.frame || '…'} ${SIZES[c.size] || c.size}, ${c.camera}.`
+        ? `${framingOf(c)}${c.frame || '…'} ${SIZES[c.size] || c.size}, ${c.camera}. ${propOf(c, framingLang)}`
         : `… anchor on @image${k + 1} · ${SIZES[c.size] || c.size}, ${c.camera}, ${cameraPhrase(c, params)}. ${lightPhrase(c)}.${foregroundPhrase(c)}`;
       return `${head}${body} ${motionSentence(c)} ${idleOf(c)}${cameraClause(c)} ${d}${lips}`.replace(/\s+/g, ' ').trim();
     });
     // Keyframes are aligned by the alignment line; the voices are named either way.
     const voiceLegend = allRefs.filter((r) => r.kind !== 'image').map((r) => `${r.label} is ${r.use}.`);
     const lead = sheets
-      ? [...allRefs.map((r) => `${r.label} is ${r.use}.`), ...sidesOf()]
+      ? [...allRefs.map((r) => `${r.label} is ${r.use}.`), ...[sceneLine(framingLang)].filter(Boolean), ...sidesOf()]
       : [h3AlignmentLine(cuts), ...voiceLegend];
     const look = sheets ? [`Look: ${lookOf()}.`, ''] : [];
     const soundscape = [sound.ambience || '…', ...cuts.map((c, k) => (sfxOf(k) ? `at [Shot ${k + 1}] ${sfxOf(k)}` : '')).filter(Boolean)].join('; ');
@@ -4745,18 +5048,18 @@ export function promptSkeleton(project, episode, segmentId) {
       // Wan's prompt is Chinese: the lens and the light direction translate, the note and the
       // foreground are the author's English prose, so they are left as blanks to write in Chinese.
       const shot = `${cameraPhrase(c, params, 'zh')}。${LIGHT_DIRECTIONS_ZH[c.light?.direction] || '…'}，…。前景：${c.foreground ? '…（虚化）' : '无'}。`;
-      return [`${wanShotHeader(cuts, k)}${framingOf(c)}…${shot}${motionSentence(c, 'zh')}${idleOf(c)}${cameraClause(c, 'zh')}`, ...talk].join('\n');
+      return [`${wanShotHeader(cuts, k)}${framingOf(c)}…${shot}${motionSentence(c, 'zh')}${idleOf(c)}${propOf(c, 'zh')}${cameraClause(c, 'zh')}`, ...talk].join('\n');
     });
     const sfxAll = cuts.map((c, k) => (sfxOf(k) ? `镜头${k + 1}：${sfxOf(k)}` : '')).filter(Boolean).join('；');
     video = [
-      params.references === 'sheets' ? wanSheetLegendLine(allRefs) : wanLegendLine(cuts, allRefs), ...sidesOf(), '',
+      params.references === 'sheets' ? wanSheetLegendLine(allRefs) : wanLegendLine(cuts, allRefs), ...[sceneLine('zh')].filter(Boolean), ...sidesOf(), '',
       ...blocks.flatMap((b) => [b, '']),
       ...(cine && params.references === 'sheets' ? [`画面：${cine.videoPhraseZh}${params.lookPhraseZh ? `，${params.lookPhraseZh}` : ''}。`, ''] : []),
       ...(grammarLines(seg, params, 'zh').length ? [...grammarLines(seg, params, 'zh'), ''] : []),
       `音频：对白为${accent || '…'}，环境音${sound.ambience || '…'}${sfxAll ? `；${sfxAll}` : ''}${clipMusic ? `；配乐：${clipMusic}` : params.audioTrack === 'post' ? '；无配乐' : ''}。${params.subtitles ? '' : `${NO_SUBTITLES.zh}。`}`,
     ].join('\n');
   } else if (params.references === 'sheets') {
-    const legend = [...allRefs.map((r) => `${r.label} is ${r.use}.`), ...sidesOf()];
+    const legend = [...allRefs.map((r) => `${r.label} is ${r.use}.`), ...[sceneLine(framingLang)].filter(Boolean), ...sidesOf()];
     const shots = cuts.map((c, k) => {
       const talk = dialogue[k].map((l) => {
         const base = `${l.speakerRef}${l.direction ? `, ${l.direction},` : ''} says: ${l.line}`;
@@ -4767,7 +5070,7 @@ export function promptSkeleton(project, episode, segmentId) {
         return `${base} while ${others.join(' and ')} ${others.length > 1 ? 'do' : 'does'} not speak, ${LIPS_CLOSED}`;
       }).join(' ');
       // The frame already carries the lens, the light and the foreground — do not repeat them.
-      return `Shot ${k + 1} (${starts[k].toFixed(1)}–${(starts[k] + Number(c.seconds)).toFixed(1)} s, ${SIZES[c.size] || c.size}, ${c.camera}): ${framingOf(c)}${c.frame || '…'} ${motionSentence(c)} ${idleOf(c)}${cameraClause(c)} ${talk}`.replace(/\s+/g, ' ').trim();
+      return `Shot ${k + 1} (${starts[k].toFixed(1)}–${(starts[k] + Number(c.seconds)).toFixed(1)} s, ${SIZES[c.size] || c.size}, ${c.camera}): ${framingOf(c)}${c.frame || '…'} ${motionSentence(c)} ${idleOf(c)}${propOf(c, framingLang)}${cameraClause(c)} ${talk}`.replace(/\s+/g, ' ').trim();
     });
     const sfxAll = cuts.map((c, k) => (sfxOf(k) ? `shot ${k + 1}: ${sfxOf(k)}` : '')).filter(Boolean).join('; ');
     video = [...legend, '', ...shots, '', ...actionLine, `Look: ${lookOf()}. Maintain continuity in character identities, clothing, prop ownership, scene layout and the camera axis across every shot.`, `Sound: ${sound.ambience || '…'}${sfxAll ? `; ${sfxAll}` : ''}.${accent && dialogue.flat().length ? ` All dialogue in ${accent}.` : ''}${clipMusic ? ` Music: ${clipMusic}.` : ' No music.'}${params.subtitles ? '' : ` ${NO_SUBTITLES.en[0].toUpperCase()}${NO_SUBTITLES.en.slice(1)}.`}`].join('\n');
@@ -4783,7 +5086,7 @@ export function promptSkeleton(project, episode, segmentId) {
         if (!others.length) return base;
         return `${base} while ${others.join(' and ')} ${others.length > 1 ? 'do' : 'does'} not speak, ${LIPS_CLOSED}`;
       }).join(' ');
-      return `From @image${k + 1} (${starts[k].toFixed(1)}–${(starts[k] + Number(c.seconds)).toFixed(1)} s): ${motionSentence(c)} ${cameraClause(c)} ${talk}`.replace(/\s+/g, ' ').trim();
+      return `From @image${k + 1} (${starts[k].toFixed(1)}–${(starts[k] + Number(c.seconds)).toFixed(1)} s): ${motionSentence(c)} ${propOf(c, framingLang)}${cameraClause(c)} ${talk}`.replace(/\s+/g, ' ').trim();
     });
     const sfxAll = cuts.map((c, k) => (sfxOf(k) ? `from @image${k + 1}: ${sfxOf(k)}` : '')).filter(Boolean).join('; ');
     video = [...anchors, ...states, '', ...script, '', ...actionLine, 'Maintain continuity in character identities, clothing, prop ownership, scene layout and the camera axis.', `Sound: ${sound.ambience || '…'}${sfxAll ? `; ${sfxAll}` : ''}.${accent && dialogue.flat().length ? ` All dialogue in ${accent}.` : ''}${clipMusic ? ` Music: ${clipMusic}.` : ' No music.'}${params.subtitles ? '' : ` ${NO_SUBTITLES.en[0].toUpperCase()}${NO_SUBTITLES.en.slice(1)}.`}`].join('\n');
@@ -4953,31 +5256,144 @@ export function scriptSelfCheck(project, episode) {
     ['结尾是否有明确【钩子标记】？', !!String(episode.cliff || '').trim() && !!episode.hookType, `${episode.hookType || ''}：${episode.cliff || ''}`],
     ['对白是否符合「谈话 + 行动」？', ta.longestLineRun <= params.maxConsecutiveLines && (ta.lines < 5 || ta.ratio >= params.minActionRatio), `${ta.actions} 动作 / ${ta.lines} 台词，最长连续 ${ta.longestLineRun} 句`],
     ['人物行为是否可拍摄，没有小说式心理描写？', !novel, novel ? '动作里有心理词' : ''],
+    ...(params.dialogueReview === 'off' ? [] : [['对白是否已按语体 guide 逐句校对？', dialogueReviewDone(episode), dialogueReviewNote(episode)]]),
   ];
   return { rows, score: rows.filter((r) => r[1]).length * 2, max: rows.length * 2 };
 }
 
-/** The 对白校对 worksheet: one row per line, 原句 filled, the rest for the polish pass. */
+/** True when every current line has a filled, applied review row. */
+export function dialogueReviewDone(episode) {
+  const rv = episode.dialogueReview;
+  if (!isObject(rv) || !DIALOGUE_LEVELS.includes(rv.level)) return false;
+  const byPos = new Map(asList(rv.rows).map((r) => [`${r.scene}:${r.beat}`, r]));
+  return lineBeats(episode).every((l) => { const r = byPos.get(`${l.scene}:${l.beat}`); return r && r.revised === l.line && String(r.issue || '').trim() && String(r.note || '').trim(); });
+}
+function dialogueReviewNote(episode) {
+  const rv = episode.dialogueReview;
+  if (!isObject(rv)) return '未校对';
+  const rows = asList(rv.rows);
+  const changed = rows.filter((r) => r.revised !== r.original).length;
+  return `${rv.level || '?'} · ${asList(rv.guides).join('、')} · 改 ${changed} / ${rows.length} 句`;
+}
+
+/** Every line beat of an episode, in order, with its scene / beat position (1-based). */
+export function lineBeats(episode) {
+  const out = [];
+  (episode.scenes || []).forEach((sc, i) => (sc.flow || []).forEach((b, k) => {
+    if (b.line !== undefined) out.push({ scene: i + 1, beat: k + 1, speaker: b.speaker, line: String(b.line), delivery: b.delivery || '' });
+  }));
+  return out;
+}
+
+/**
+ * The dialogue skill per speaker of this episode: the 语体 (their bible's override, else the drama's),
+ * the language guide to read, and — where a corpus exists — the `ref.mjs` query that pulls real
+ * phrasing for someone of their age, so lines are drawn from the corpus instead of invented.
+ */
+export function dialogueRefs(project, episode, opts = {}) {
+  const params = paramsOf(project);
+  const dir = opts.skillDir !== undefined ? opts.skillDir : dialogueSkillDir();
+  const root = dir || `<skills>/${DIALOGUE_SKILL}`;
+  const ids = [];
+  for (const l of lineBeats(episode)) if (l.speaker !== 'VO' && !ids.includes(l.speaker)) ids.push(l.speaker);
+  if (!ids.length) for (const sc of episode.scenes || []) for (const id of sc.characters || []) if (!ids.includes(id)) ids.push(id);
+  const speakers = ids.map((id) => {
+    const ch = characterById(project, id);
+    const register = normalizeRegister(ch?.bible?.speech?.register || params.register);
+    const g = DIALOGUE_GUIDES[register];
+    const age = corpusAge(parseAge(ch?.profile?.ageRange));
+    const query = g?.corpus ? `node ${root}/scripts/ref.mjs --lang ${g.lang} list${age ? ` --age ${age}` : ''} --limit 30` : '';
+    return { id, name: displayName(project, id, episode.ep), register, guide: g ? `${root}/references/${g.guide}` : '', lang: g?.lang || '', age: age || '', query };
+  });
+  const guides = [...new Set(speakers.map((x) => x.guide).filter(Boolean))];
+  return {
+    skill: DIALOGUE_SKILL,
+    installed: !!dir,
+    framework: `${root}/references/dialogue_revision_framework.md`,
+    guides,
+    speakers,
+    rule: 'read the guide of every 语体 in this episode before writing a line; pull phrasing from each speaker\'s corpus query (`search <字>` for a word); never invent slang or particles; finish with the guide\'s 自检清单',
+  };
+}
+
+/**
+ * The 对白校对 record (`episode.dialogueReview`), seeded from the current lines. Rows already filled
+ * for a line that has not changed since are kept, so a re-seed after editing the script only asks
+ * for the lines that moved.
+ */
+export function seedDialogue(project, episode, opts = {}) {
+  const refs = dialogueRefs(project, episode, opts);
+  const prev = opts.force ? null : (isObject(episode.dialogueReview) ? episode.dialogueReview : null);
+  const kept = new Map();
+  for (const r of asList(prev?.rows)) kept.set(`${r.scene}:${r.beat}:${r.speaker}:${r.revised}`, r);
+  const rows = lineBeats(episode).map((l) => kept.get(`${l.scene}:${l.beat}:${l.speaker}:${l.line}`) || {
+    scene: l.scene, beat: l.beat, speaker: l.speaker, original: l.line, issue: '', revised: l.line, reason: '', note: '',
+  });
+  const diagnosis = {};
+  for (const k of Object.keys(DIALOGUE_DIAGNOSIS)) diagnosis[k] = prev?.diagnosis?.[k] || '';
+  return {
+    level: prev?.level || '',
+    guides: refs.guides.map((g) => basename(g)),
+    diagnosis,
+    rows,
+    selfCheck: asList(prev?.selfCheck),
+  };
+}
+
+/** Write each row's `revised` (and `delivery`, when the row sets one) back into the script's flow. */
+export function applyDialogue(episode) {
+  const review = episode.dialogueReview;
+  if (!isObject(review)) throw new Error('no dialogueReview — run `seed <project> dialogue --ep N` first');
+  let changed = 0;
+  for (const r of asList(review.rows)) {
+    const b = episode.scenes?.[Number(r.scene) - 1]?.flow?.[Number(r.beat) - 1];
+    if (!b || b.line === undefined) throw new Error(`row scene ${r.scene} beat ${r.beat} is not a line — re-seed the review`);
+    if (b.speaker !== r.speaker) throw new Error(`row scene ${r.scene} beat ${r.beat}: speaker ${r.speaker} but the script has ${b.speaker} — re-seed the review`);
+    const revised = String(r.revised ?? '').trim();
+    if (!revised) throw new Error(`row scene ${r.scene} beat ${r.beat}: revised is empty — a line to cut is removed from the flow, then the review re-seeded`);
+    if (b.line !== revised) { b.line = revised; changed += 1; }
+    if (r.delivery !== undefined && String(r.delivery).trim() && b.delivery !== r.delivery) { b.delivery = r.delivery; changed += 1; }
+  }
+  return changed;
+}
+
+/** The 对白校对 sheet: the filled review when there is one, otherwise the blank worksheet. */
 export function renderDialogue(project, episode) {
   const params = paramsOf(project);
+  const review = isObject(episode.dialogueReview) ? episode.dialogueReview : null;
+  const refs = dialogueRefs(project, episode);
+  const d = review?.diagnosis || {};
   const lines = [`# ${project.title} · 第 ${episode.ep} 集对白校对`, '', mdTable(['项目', '判断'], [
-    ['语体', params.register || ''], ['场面目标', ''], ['主要冲突', ''], ['潜台词核心', ''], ['角色声音问题', ''], ['节奏问题', ''], ['建议修改幅度', '轻修／中修／重修'],
+    ['语体', params.register || ''],
+    ...Object.entries(DIALOGUE_DIAGNOSIS).map(([k, label]) => [label, d[k] || '']),
+    ['修改幅度', review?.level || '轻修／中修／重修'],
   ]), ''];
+  if (!review) {
+    lines.push('## 语体 guide 与语料库', '', `技能 \`${refs.skill}\`${refs.installed ? '' : '（未安装 — 把它放在本技能旁或 ~/.claude/skills）'}；先读 \`${refs.framework}\`。`, '');
+    lines.push(mdTable(['角色', '语体', 'guide', '语料库查询'], refs.speakers.map((x) => [x.name, x.register, x.guide ? `\`${x.guide}\`` : '—', x.query ? `\`${x.query}\`` : '（此语体无语料库，只按 guide）'])), '');
+  }
+  const byPos = new Map(asList(review?.rows).map((r) => [`${r.scene}:${r.beat}`, r]));
   (episode.scenes || []).forEach((sc, i) => {
     const scene = sceneById(project, sc.sceneId);
     lines.push(`## ${i + 1}. ${scene?.name || sc.sceneId}`, '');
     const rows = [];
-    (sc.flow || []).forEach((b) => {
+    (sc.flow || []).forEach((b, k) => {
       if (b.line === undefined) return;
       const ch = characterById(project, b.speaker);
       const sp = ch?.bible?.speech || {};
       const who = b.speaker === 'VO' ? 'VO' : displayName(project, b.speaker, episode.ep);
-      const hint = [sp.rhythm, sp.silence ? `沉默：${sp.silence}` : '', (sp.forbiddenWords || []).length ? `禁用：${sp.forbiddenWords.join('、')}` : ''].filter(Boolean).join('；');
-      rows.push([`${who}${b.delivery ? `（${b.delivery}）` : ''}：${b.line}`, '', '', '', hint]);
+      const r = byPos.get(`${i + 1}:${k + 1}`);
+      if (r) {
+        rows.push([`${who}${b.delivery ? `（${b.delivery}）` : ''}：${r.original}`, r.issue || '', r.revised === r.original ? '（保留）' : r.revised, r.reason || '', r.note || '']);
+      } else {
+        const hint = [sp.rhythm, sp.silence ? `沉默：${sp.silence}` : '', (sp.forbiddenWords || []).length ? `禁用：${sp.forbiddenWords.join('、')}` : ''].filter(Boolean).join('；');
+        rows.push([`${who}${b.delivery ? `（${b.delivery}）` : ''}：${b.line}`, '', '', '', hint]);
+      }
     });
     lines.push(mdTable(['原句', '问题', '修改句', '修改理由', '导演／演员提示'], rows), '');
   });
-  lines.push('> 每句检查：有没有戏剧功能？遮住名字还认得出是谁在说？真正想说的有没有藏起来？熟人有没有互相解释已知的事？导演提示用可演动词（逼、哄、避、试探），不用情绪形容词。', '');
+  if (asList(review?.selfCheck).length) lines.push('## 自检', '', mdTable(['检查项', '结论', '说明'], asList(review.selfCheck).map((c) => [c.item || '', c.ok ? '是' : '否', c.note || ''])), '');
+  if (!review) lines.push('> 每句检查：有没有戏剧功能？遮住名字还认得出是谁在说？真正想说的有没有藏起来？熟人有没有互相解释已知的事？导演提示用可演动词（逼、哄、避、试探），不用情绪形容词。', '');
   return lines.join('\n');
 }
 
@@ -5494,9 +5910,23 @@ function main(argv) {
   if (cmd === 'seed') {
     const what = pos[1];
     const ep = Number(flag(rest, '--ep'));
-    if (!['script', 'storyboard'].includes(what) || !ep) throw new Error('usage: seed <project> script|storyboard --ep N [--force]');
+    if (!['script', 'storyboard', 'dialogue'].includes(what) || !ep) throw new Error('usage: seed <project> script|dialogue|storyboard --ep N [--force]');
     const { paths, project, episodes } = loadProject(input);
     const file = join(paths.episodes, `E${pad2(ep)}.json`);
+    if (what === 'dialogue') {
+      const episode = episodes[ep];
+      if (!episode) throw new Error(`${file} does not exist — seed and write the script first`);
+      if (!lineBeats(episode).length) throw new Error(`${file} has no lines to review`);
+      episode.dialogueReview = seedDialogue(project, episode, { force: Boolean(flag(rest, '--force')) });
+      writeJsonFile(file, episode);
+      const rv = episode.dialogueReview;
+      const refs = dialogueRefs(project, episode);
+      const open = rv.rows.filter((r) => !String(r.issue || '').trim()).length;
+      console.log(`✓ ${file} · dialogueReview: ${rv.rows.length} lines (${open} to review) · read ${refs.framework}`);
+      for (const x of refs.speakers) console.log(`  ${x.name} · ${x.register} · ${x.guide || '(no guide)'}${x.query ? `\n    ${x.query}` : ''}`);
+      if (!refs.installed) console.log(`  ! ${DIALOGUE_SKILL} is not installed beside this skill or in ~/.claude/skills`);
+      return 0;
+    }
     if (what === 'script') {
       if (existsSync(file) && !flag(rest, '--force')) throw new Error(`${file} exists (pass --force to overwrite)`);
       const seeded = seedScript(project, ep);
@@ -5513,6 +5943,20 @@ function main(argv) {
     return 0;
   }
 
+  if (cmd === 'apply') {
+    const what = pos[1];
+    const ep = Number(flag(rest, '--ep'));
+    if (what !== 'dialogue' || !ep) throw new Error('usage: apply <project> dialogue --ep N');
+    const { paths, episodes } = loadProject(input);
+    const file = join(paths.episodes, `E${pad2(ep)}.json`);
+    const episode = episodes[ep];
+    if (!episode) throw new Error(`${file} does not exist`);
+    const changed = applyDialogue(episode);
+    writeJsonFile(file, episode);
+    console.log(`✓ ${file} · ${changed} change(s) written into the script — re-run validate --stage script --ep ${ep}`);
+    return 0;
+  }
+
   if (cmd === 'dashboard') {
     const loaded = loadProject(input);
     const outputFlag = flag(rest, '--output');