@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-story-builder/scripts/v2/prompts.js

@@ -0,0 +1,1335 @@
+/**
+ * v2/prompts.js —— 2.0 阶段提示词构建。
+ *
+ * 提示词统一按下面的中文结构组织：
+ *   角色 → 背景 → 选题 → 任务 → 可读取的输入 → 本文件要求
+ *   → 执行步骤 → 参考数据 → 禁止事项 → 校验与返工 → 上一轮错误 → 输出格式
+ *
+ * 这里只给模型“本轮要做什么、能读什么、写成什么样、怎么算过”。
+ * 阶段 README 里给人看的“阅读顺序 / 自包含 / 契约全文”不再原样塞进提示词，
+ * 避免模型把文档说明当成额外任务。
+ *
+ * 所有提示词只允许模型读取：
+ *   - 当前阶段目录
+ *   - _context/ 上游快照
+ *   - 项目根 模板/ 与 references/
+ * 明确禁止读取插件源码、node_modules。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { asArray, readJson, stageDir, stageFile } from './core.js';
+import { contractFor } from './contracts.js';
+import { referenceLogPromptBlock } from '../reference-log.js';
+import { renderBenchmarkDigest, renderBenchmarkGuidance } from '../../wiki-references.js';
+
+const CN_NUM = ['一', '二', '三', '四', '五', '六', '七', '八', '九', '十',
+  '十一', '十二', '十三', '十四', '十五', '十六', '十七', '十八', '十九', '二十'];
+
+function h2(n, title) {
+  return '## ' + (CN_NUM[n - 1] || String(n)) + '、' + title;
+}
+
+function ordered(items, start = 1) {
+  return asArray(items).map((item, i) => (start + i) + '. ' + item);
+}
+
+function nextSection(parts) {
+  // 只统计本文件自己的编号小节和附录；注入的对标摘要/参考记录里也有
+  // `##` 标题，不能把它们算进后续小节编号。
+  return (parts.join('\n').match(/^## (?:[一二三四五六七八九十]+、|附：)/gm) || []).length + 1;
+}
+
+function pushHeading(parts, title) {
+  parts.push(h2(nextSection(parts), title));
+}
+
+function roleBlock(role, background) {
+  return [
+    '# 角色：' + role,
+    '',
+    h2(1, '背景'),
+    '',
+    ...asArray(background).filter(Boolean),
+    '',
+  ].join('\n');
+}
+
+function topicBlock(topicData) {
+  const topic = topicBrief(topicData);
+  if (!topic || !Object.keys(topic).length) return '';
+  return [
+    h2(3, '选题'),
+    '',
+    '```json',
+    JSON.stringify(topic, null, 2),
+    '```',
+    '',
+    '说明：选题 JSON 里的 `genre` 字段就是本书的题材；`platform` 字段是目标平台。',
+    '',
+  ].join('\n');
+}
+
+function failureBlock(failures) {
+  if (!Array.isArray(failures) || !failures.length) return '';
+  const lines = ['## 附：上一轮校验错误（必须逐条改掉）', ''];
+  let n = 0;
+  for (const e of failures.slice(0, 30)) {
+    n += 1;
+    const code = e.code ? '[' + e.code + '] ' : '';
+    const p = e.path ? e.path + '：' : '';
+    lines.push(n + '. ' + code + p + (e.message || e.detail || ''));
+    if (e.expected !== undefined) lines.push('   - 期望：' + JSON.stringify(e.expected));
+    if (e.actual !== undefined) lines.push('   - 实际：' + JSON.stringify(e.actual));
+    if (e.hint) lines.push('   - 提示：' + e.hint);
+  }
+  if (failures.length > 30) lines.push((n + 1) + '. … 其余 ' + (failures.length - 30) + ' 个错误');
+  lines.push('');
+  return lines.join('\n');
+}
+
+function sectionBlock(section, number) {
+  if (!section) return '';
+  const lines = [h2(number, '本文件要求：' + section.title), ''];
+  lines.push(...ordered(section.body));
+  lines.push('');
+  return lines.join('\n');
+}
+
+const FORBIDDEN_EXPLAIN = {
+  '人物姓名': '任何具体人名、称号、绰号或称呼，例如“叶凡”“林老板”“师尊”。',
+  '具体人物姓名': '任何具体人名、称号、绰号或称呼，例如“叶凡”“林老板”“师尊”。',
+  '势力名称': '任何组织、宗门、公司、家族、国家、帮派的名字，例如“青云宗”“星河集团”。',
+  '具体势力名称': '任何组织、宗门、公司、家族、国家、帮派的名字，例如“青云宗”“星河集团”。',
+  '地点名称': '任何城市、街道、建筑、房间、地图区域的专名，例如“北京”“藏经阁”。',
+  '道具名称': '任何武器、法宝、信物、商品、系统道具的具体名字，例如“诛仙剑”“空间戒指”。',
+  '剧情句': '任何一句具体发生的事，例如“他去杀了城主”。',
+  '章节标题': '任何“第X章 ...”形式的标题。',
+  '章节号': '任何章节编号、章节标题或章节字段。',
+};
+
+function forbiddenBlock(stageId, extra = [], number = 13) {
+  const contract = contractFor(stageId);
+  const items = [...asArray(contract && contract.forbidden), ...asArray(extra)];
+  if (!items.length) return '';
+  const lines = [
+    h2(number, '禁止事项'),
+    '',
+    '本阶段不允许出现以下内容；下面每一项都按“具体名称 / 具体内容”理解，即使是举例、引用、占位名也算出现。',
+    '',
+  ];
+  for (let i = 0; i < items.length; i += 1) {
+    const item = items[i];
+    const explain = FORBIDDEN_EXPLAIN[item];
+    lines.push((i + 1) + '. ' + item + (explain ? '：' + explain : ''));
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+function checksBlock(stageId, checksOverride) {
+  const contract = contractFor(stageId);
+  const checks = asArray(checksOverride || (contract && contract.checks));
+  if (!checks.length) return '';
+  return ['插件会按以下契约检查（跨文件项以整阶段为准）：', '', ...ordered(checks), ''].join('\n');
+}
+
+/**
+ * 所有阶段共用的一段说明：
+ * 校验是插件跑的，不是模型跑脚本；失败会回喂，模型只改当前文件。
+ */
+function validationBlock(stageId, opts = {}) {
+  const validator = opts.validator || '本阶段校验器';
+  const lines = [
+    opts.appendix ? '## 附：校验与返工' : h2(opts.number || 14, '校验与返工'),
+    '',
+    ...ordered([
+      '校验由插件自动执行：你不需要运行任何校验脚本，也不要读取校验器源码。',
+      '你写完后，插件会在本轮结束时运行 ' + validator + '。',
+      '如果校验失败，插件会把错误逐条放进下一轮的“上一轮校验错误”；每条错误里有 `path`、`expected`、`actual`、`hint`，你按 `path` 找到对应字段逐条修改当前文件。',
+      '错误可能引用其它文件；不要直接改上游，先检查当前文件是否与它不一致。',
+      '不要改上游文件，不要改其它阶段文件，不要新建临时脚本或 Python 脚本来拼 JSON。',
+      '连续多轮仍失败时，插件会停止并把错误报告给用户，不会把阶段标记为通过。',
+    ]),
+    '',
+    checksBlock(stageId, opts.checks),
+  ];
+  return lines.join('\n');
+}
+
+function inputBlock(paths, opts = {}) {
+  const lines = [h2(5, '可读取的输入'), ''];
+  lines.push(...ordered(asArray(paths).map((p) => '`' + p + '`')));
+  lines.push('');
+  if (opts.template) lines.push('结构模板：`' + opts.template + '`。模板只规定字段，不规定具体内容。', '');
+  lines.push('只读上面列出的路径，以及项目里的 `模板/v2/`、`references/`、`对标/`（如果存在）。');
+  lines.push('需要上游信息时读当前阶段目录的 `_context/` 快照；不要读插件源码、`node_modules/` 或其它项目。');
+  lines.push('');
+  return lines.join('\n');
+}
+
+function fileTableBlock(rows) {
+  if (!rows.length) return '';
+  const lines = [
+    h2(2, '文件说明'),
+    '',
+    '| 路径 | 提示词中的称呼 | 作用 |',
+    '|---|---|---|',
+  ];
+  for (const [file, name, purpose] of rows) {
+    lines.push('| `' + file + '` | ' + name + ' | ' + purpose + ' |');
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+function platformNameOf(topicData) {
+  return String((topicData && (topicData.platform || topicData.target_platform)) || '').trim();
+}
+
+function platformNoticeBlock(topicData, number = 11) {
+  const platform = platformNameOf(topicData);
+  const lines = [h2(number, '平台提醒'), ''];
+  if (!platform) {
+    lines.push(...ordered([
+      '选题没有声明平台，默认按通用网文规则计算。',
+      '`genre-profiles.json` 里的 `platform` 是按番茄小说整理的；没有平台信息时，只能参考它的题材倍率，不要照搬番茄的章节字数和钩子密度。',
+    ]));
+  } else if (/番茄|fanqie/i.test(platform)) {
+    lines.push(...ordered([
+      '当前选题平台：' + platform,
+      '单章字数参考 2200 字；节奏公式仍以 2000 字/章为基准，用 `chapter_scale` 换算。',
+      '前 30 章是黄金期，钩子密度可以高于全书平均；卷长不宜过长。',
+    ]));
+  } else {
+    lines.push(...ordered([
+      '当前选题平台：' + platform,
+      '`genre-profiles.json` 的 `platform` / `platform_checks` / `platform_rules` 是按番茄小说整理的，和当前平台不一致，不能直接照搬。',
+      '当前平台只使用 `genre-profiles.json` 里的题材分类和倍率；章节字数、钩子密度、卷长按当前平台要求和选题定位处理。',
+    ]));
+  }
+  lines.push('');
+  return lines.join('\n');
+}
+
+function withoutMetaDeep(value) {
+  if (Array.isArray(value)) return value.map(withoutMetaDeep);
+  if (!value || typeof value !== 'object') return value;
+  const out = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (key === '_meta') continue;
+    out[key] = withoutMetaDeep(item);
+  }
+  return out;
+}
+
+/**
+ * 只把下游真正需要的上游字段放进提示词。
+ * 例如 20-macro 不需要 scale.formulas / derivations，也不需要 8 份题材 profile。
+ */
+function digestContextData(stageId, name, data) {
+  const clean = withoutMetaDeep(data);
+  if (name === 'baseline.json') {
+    return {
+      input: withoutMetaDeep(clean.input || {}),
+      references: clean.references || [],
+    };
+  }
+  if (name === 'scale.json') {
+    return {
+      capacity: clean.capacity,
+      structure: clean.structure,
+      quotas: clean.quotas,
+      rhythm_budget: clean.rhythm_budget,
+      distribution: clean.distribution,
+    };
+  }
+  return clean;
+}
+
+function contextDigest(projectRoot, stageId, number = 8) {
+  const lines = [];
+  const dir = path.join(stageDir(projectRoot, stageId), '_context');
+  let names = [];
+  try {
+    names = fs.readdirSync(dir).filter((n) => n.endsWith('.json')).sort();
+  } catch {
+    names = [];
+  }
+  // 写作阶段已经有逐章细纲和人物小档案；全量 cast/rhythm 快照只会重复烧 token。
+  const skip = stageId === '50-writing' ? new Set(['cast.json', 'rhythm.json']) : new Set();
+  for (const name of names) {
+    if (skip.has(name)) continue;
+    const data = readJson(path.join(dir, name), null);
+    if (!data) continue;
+    lines.push('### _context/' + name);
+    lines.push('');
+    lines.push('```json');
+    lines.push(JSON.stringify(digestContextData(stageId, name, data)));
+    lines.push('```');
+    lines.push('');
+  }
+  return lines.length
+    ? [h2(number, '上游只读快照（_context）'), '', '这些是已经通过校验的上游事实，只读，不要修改。', '', ...lines].join('\n')
+    : '';
+}
+
+function readContextFile(projectRoot, stageId, name) {
+  return readJson(path.join(stageDir(projectRoot, stageId), '_context', name), null);
+}
+
+function pickFields(obj, fields) {
+  if (!obj || typeof obj !== 'object') return obj;
+  const out = {};
+  for (const key of fields) {
+    if (obj[key] !== undefined) out[key] = obj[key];
+  }
+  return out;
+}
+
+function compactList(list, fields) {
+  return asArray(list).map((item) => pickFields(item, fields));
+}
+
+function compactCastForMap(cast) {
+  const c = cast || {};
+  // 章节地图只需要“可引用的 ID + 选择时需要的最小语义”；
+  // 道具、势力、高潮、关系不参与章节地图字段，不塞进来。
+  return {
+    characters: compactList(c.characters && c.characters.characters, ['id', 'name', 'type', 'role_slot', 'faction']),
+    locations: compactList(c.locations && c.locations.locations, ['id', 'name', 'type']),
+    conflicts: compactList(c.conflicts && c.conflicts.conflicts, ['id', 'name', 'type', 'participants']),
+    foreshadows: compactList(c.foreshadows && c.foreshadows.foreshadows, ['id', 'name', 'type', 'scope']),
+    payoffs: compactList(c.payoffs && c.payoffs.payoffs, ['id', 'name', 'type', 'scale']),
+    information: compactList(c.information && c.information.information_gaps, ['id', 'info_name', 'conflict']),
+  };
+}
+
+/** 章节地图只看“有哪些实体、怎么分布”，不把每个实体的长描述全塞进去。 */
+function chapterMapContext(projectRoot, number = 7) {
+  const scale = readContextFile(projectRoot, '40-rhythm', 'scale.json');
+  const macro = readContextFile(projectRoot, '40-rhythm', 'macro.json');
+  const cast = readContextFile(projectRoot, '40-rhythm', 'cast.json');
+  if (!scale && !macro && !cast) return contextDigest(projectRoot, '40-rhythm');
+  const data = {
+    scale: {
+      capacity: scale && scale.capacity,
+      structure: scale && scale.structure,
+    },
+    macro: {
+      world: pickFields(macro && macro.world, ['premise', 'theme', 'tone']),
+      story: pickFields(macro && macro.story, ['core_question', 'core_conflict']),
+      volumes: macro && macro.volumes,
+      lines: macro && macro.lines,
+      endings: macro && macro.endings,
+      emotion: macro && macro.emotion,
+    },
+    cast: compactCastForMap(cast),
+  };
+  return [
+    h2(number, '上游只读摘要（_context）'),
+    '',
+    '这里只保留和章节地图有关的字段；完整实体档案在 `_context/` 里，需要时再读。',
+    '',
+    '```json',
+    JSON.stringify(withoutMetaDeep(data)),
+    '```',
+    '',
+  ].join('\n');
+}
+
+function branchIdOf(value) {
+  const m = /^(B\d{3})/.exec(String(value || ''));
+  return m ? m[1] : '';
+}
+
+/** 单章细纲只带本章会用到的主线节点、支线、冲突、伏笔、人物和地点。 */
+function outlineContext(projectRoot, chapter, number = 13) {
+  const scale = readContextFile(projectRoot, '40-rhythm', 'scale.json');
+  const macro = readContextFile(projectRoot, '40-rhythm', 'macro.json');
+  const cast = readContextFile(projectRoot, '40-rhythm', 'cast.json');
+  if (!scale && !macro && !cast) return contextDigest(projectRoot, '40-rhythm');
+  const c = chapter || {};
+  const why = c.why || {};
+  const castIds = new Set(asArray(c.cast).map(String));
+  const locationIds = new Set(asArray(c.locations).map(String));
+  const conflictIds = new Set(asArray(why.conflict).map(String));
+  const mainNodeIds = new Set(asArray(why.main_line_nodes).map(String));
+  const branchIds = new Set(asArray(why.branch_nodes).map(branchIdOf).filter(Boolean));
+  const foreshadowIds = new Set(asArray(c.foreshadow_actions).map((a) => String(a && a.id)).filter(Boolean));
+  const payoffIds = new Set(asArray(c.payoff_actions).map((a) => String(a && a.id)).filter(Boolean));
+  const infoIds = new Set(asArray(c.information_gaps).map((a) => String(a && a.id)).filter(Boolean));
+  const endingIds = new Set(asArray(c.ending_actions).map((a) => String(a && a.id)).filter(Boolean));
+
+  const volume = asArray(macro && macro.volumes && macro.volumes.volumes)
+    .find((v) => (v.volume_id || v.id) === c.volume) || null;
+  const act = asArray(volume && volume.acts)
+    .find((a) => a.act_id === c.act)
+    || asArray(macro && macro.volumes && macro.volumes.acts).find((a) => a.act_id === c.act)
+    || null;
+  const characters = asArray(cast && cast.characters && cast.characters.characters)
+    .filter((x) => castIds.has(String(x.id)));
+  const factions = new Set(characters.map((x) => x.faction).filter(Boolean));
+  const displayNo = Number(c.display_no);
+  const targetChapters = Number(scale && scale.capacity && scale.capacity.target_chapters);
+  const endings = asArray(macro && macro.endings && macro.endings.endings)
+    .filter((e) => {
+      if (endingIds.size) return endingIds.has(String(e.id));
+      // 没有显式 ending_actions 时，不要把全书 5 个结局塞进每一章：
+      // 卷级结局只给卷末章，全书级结局只给最后一章。
+      if (e.level === '全书级') return displayNo === targetChapters;
+      if (e.volume && volume) {
+        return e.volume === (volume.volume_id || volume.id) && displayNo === Number(volume.chapter_end);
+      }
+      return false;
+    });
+  const data = {
+    scale: { capacity: scale && scale.capacity },
+    macro: {
+      world: pickFields(macro && macro.world, ['premise', 'theme', 'tone', 'world_rules']),
+      story: pickFields(macro && macro.story, ['core_question', 'core_conflict', 'structure']),
+      volume: volume ? {
+        volume_id: volume.volume_id || volume.id,
+        title: volume.title,
+        goal: volume.goal,
+        core_conflict: volume.core_conflict,
+        emotional_arc: volume.emotional_arc,
+        chapter_start: volume.chapter_start,
+        chapter_end: volume.chapter_end,
+      } : null,
+      act,
+      main_line_nodes: asArray(macro && macro.lines && macro.lines.main_line && macro.lines.main_line.nodes)
+        .filter((n) => mainNodeIds.has(String(n.id))),
+      branches: asArray(macro && macro.lines && macro.lines.branches)
+        .filter((b) => branchIds.has(String(b.id))),
+      endings,
+    },
+    cast: {
+      characters,
+      factions: asArray(cast && cast.factions && cast.factions.factions)
+        .filter((x) => factions.has(x.id)),
+      locations: asArray(cast && cast.locations && cast.locations.locations)
+        .filter((x) => locationIds.has(String(x.id))),
+      conflicts: asArray(cast && cast.conflicts && cast.conflicts.conflicts)
+        .filter((x) => conflictIds.has(String(x.id))),
+      foreshadows: asArray(cast && cast.foreshadows && cast.foreshadows.foreshadows)
+        .filter((x) => foreshadowIds.has(String(x.id))),
+      payoffs: asArray(cast && cast.payoffs && cast.payoffs.payoffs)
+        .filter((x) => payoffIds.has(String(x.id))),
+      information: asArray(cast && cast.information && cast.information.information_gaps)
+        .filter((x) => infoIds.has(String(x.id))),
+      relations: [
+        ...asArray(cast && cast.relations && cast.relations.character_relations),
+        ...asArray(cast && cast.relations && cast.relations.faction_relations),
+      ].filter((r) => castIds.has(String(r.from)) || castIds.has(String(r.to)) || factions.has(r.from) || factions.has(r.to)),
+    },
+  };
+  return [
+    h2(number, '本章相关上游（_context 摘要）'),
+    '',
+    '只保留本章会用到的主线节点、支线、冲突、伏笔、人物和地点；完整上游在 `_context/` 里。',
+    '',
+    '```json',
+    JSON.stringify(withoutMetaDeep(data)),
+    '```',
+    '',
+  ].join('\n');
+}
+
+function rhythmFormulaBlock(projectRoot, number = 9) {
+  const candidates = [
+    path.join(projectRoot, 'references', 'formulas-rhythm.json'),
+    path.join(projectRoot, '设定', '00-baseline', 'formulas-rhythm.json'),
+  ];
+  for (const file of candidates) {
+    try {
+      const data = JSON.parse(fs.readFileSync(file, 'utf-8'));
+      return [h2(number, '节奏公式与参考值（只读）'), '', '```json', JSON.stringify(data), '```', ''].join('\n');
+    } catch {
+      // try next
+    }
+  }
+  return '';
+}
+
+function projectTopic(projectRoot) {
+  const baseline = readJson(path.join(stageDir(projectRoot, '00-baseline'), '_context', 'baseline.json'), null)
+    || readJson(stageFile(projectRoot, '00-baseline', 'input.json'), null);
+  return (baseline && baseline.input) || baseline || {};
+}
+
+function sectionForFile(stageId, file) {
+  const contract = contractFor(stageId);
+  if (!contract) return null;
+  const base = String(file || '').replace(/\.json$/i, '').split('/').pop();
+  return asArray(contract.sections).find((s) => s.id === base) || null;
+}
+
+/** 只取选题里与数量决策有关的字段，避免把 _meta、空字段一起塞给模型。 */
+function topicBrief(topicData) {
+  const topic = topicData || {};
+  const keys = [
+    'book_name', 'genre', 'platform', 'positioning', 'one_line_pitch',
+    'target_chapters', 'target_words', 'core_conflict', 'reader_value',
+    'golden_finger', 'core_setting', 'selling_points', 'hard_constraints', 'anti_tropes',
+    'direction_title', 'payoff_model', 'emotion_curve', 'opening_hook', 'pacing_plan',
+    'character_design', 'differentiation', 'risk_validation',
+  ];
+  const out = {};
+  for (const key of keys) {
+    const value = topic[key];
+    if (value === undefined || value === null || value === '') continue;
+    if (Array.isArray(value) && !value.length) continue;
+    out[key] = value;
+  }
+  return out;
+}
+
+const REFERENCE_PHASE_BY_STAGE = {
+  '10-scale': 'skeleton',
+  '20-macro': 'skeleton',
+  '30-cast': 'flesh',
+  '40-rhythm': 'rhythm',
+  '50-writing': 'writing',
+};
+
+const STAGE_LABEL = {
+  '10-scale': '数量',
+  '20-macro': '骨架',
+  '30-cast': '血肉',
+  '40-rhythm': '节奏',
+  '50-writing': '写作',
+};
+
+const STAGE_GUIDE_FILES = {
+  '10-scale': [
+    'references/骨架指导/00-index.md',
+    'references/骨架指导/05-quota.md',
+    'references/骨架指导/06-audit.md',
+    'references/glossary.md',
+  ],
+  '20-macro': [
+    'references/骨架指导/00-index.md',
+    'references/骨架指导/01-positioning.md',
+    'references/骨架指导/03-entities.md',
+    'references/骨架指导/04-conflict.md',
+    'references/骨架指导/05-quota.md',
+    'references/骨架指导/06-audit.md',
+    'references/glossary.md',
+  ],
+  '30-cast': [
+    'references/血肉指导/00-index.md',
+    'references/血肉指导/01-character.md',
+    'references/血肉指导/02-worldbuilding.md',
+    'references/血肉指导/03-relations.md',
+    'references/血肉指导/04-emotion-methods.md',
+    'references/血肉指导/05-audit.md',
+    'references/glossary.md',
+  ],
+  '40-rhythm': [
+    'references/节奏指导/00-index.md',
+    'references/节奏指导/01-upgrade-rhythm.md',
+    'references/节奏指导/02-arc-rhythm.md',
+    'references/节奏指导/03-highpoint-hooks.md',
+    'references/节奏指导/04-satisfaction.md',
+    'references/节奏指导/05-foreshadow-density.md',
+    'references/节奏指导/06-chapter-outline.md',
+    'references/节奏指导/07-audit.md',
+    'references/formulas-rhythm.json',
+    'references/glossary.md',
+  ],
+  '50-writing': [
+    'references/写作指导/00-index.md',
+    'references/写作指导/01-scene.md',
+    'references/写作指导/02-chapter-workflow.md',
+    'references/写作指导/03-opening-chapter.md',
+    'references/写作指导/04-dialogue-mastery.md',
+    'references/写作指导/05-genre-formulas.md',
+    'references/写作指导/06-tone-ensemble.md',
+    'references/写作指导/07-ledger-audit.md',
+    'references/写作指导/08-diagnosis-revision.md',
+    'references/glossary.md',
+  ],
+};
+
+const STAGE_BATCH_BY_FILE = {
+  '20-macro': {
+    world: '实体',
+    story: '框架',
+    volumes: '层级',
+    lines: '框架',
+    endings: '框架',
+    emotion: '实体',
+    roles: '关系',
+  },
+  '30-cast': {
+    characters: '角色',
+    factions: '势力',
+    locations: '地点',
+    items: '关键道具',
+    conflicts: '冲突',
+    foreshadows: '剧情',
+    climaxes: '剧情',
+    payoffs: '剧情',
+    relations: '角色',
+    information: '剧情',
+  },
+};
+
+function existingReferenceFiles(projectRoot, paths) {
+  return asArray(paths).filter((rel) => {
+    try {
+      return fs.existsSync(path.join(projectRoot, rel));
+    } catch {
+      return false;
+    }
+  });
+}
+
+function guideFilesFor(stageId, opts = {}) {
+  if (opts.batchType === '章节细纲') {
+    return [
+      'references/节奏指导/00-index.md',
+      'references/节奏指导/03-highpoint-hooks.md',
+      'references/节奏指导/05-foreshadow-density.md',
+      'references/节奏指导/06-chapter-outline.md',
+      'references/节奏指导/07-audit.md',
+      'references/formulas-rhythm.json',
+      'references/glossary.md',
+    ];
+  }
+  return STAGE_GUIDE_FILES[stageId] || [];
+}
+
+/**
+ * 每个阶段都必须显式列出的参考块：
+ *   - references/<阶段>指导/ 的原文文件（方法论，决定下限）
+ *   - 对标/wiki/ 的阶段清单、本批优先清单和摘要（市场样本，校准上限）
+ *   - 参考决策台账的强制记录规则（每项输出都要留来源）
+ */
+function referenceDecisionBlock(projectRoot, stageId, opts = {}) {
+  const phase = opts.phase || REFERENCE_PHASE_BY_STAGE[stageId] || 'skeleton';
+  const batchType = opts.batchType || '';
+  const files = existingReferenceFiles(projectRoot, guideFilesFor(stageId, opts));
+  const guidance = renderBenchmarkGuidance(projectRoot, phase, batchType);
+  const digest = renderBenchmarkDigest(projectRoot, phase, { type: batchType });
+  const logBlock = referenceLogPromptBlock(
+    opts.stageLabel || STAGE_LABEL[stageId] || stageId,
+    { type: opts.batchName || batchType || stageId },
+    {
+      allowedFileText: opts.allowedFileText
+        || ('除本轮输出文件外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改 wiki、模板、references 目录或其它阶段。'),
+    },
+  );
+
+  const lines = [];
+  lines.push(opts.number ? h2(opts.number, '参考文件与参考决策（必须实际读取）') : '## 参考文件与参考决策（必须实际读取）');
+  lines.push('');
+  if (files.length) {
+    lines.push('### 本阶段方法论文件（先读原文，决定下限）');
+    lines.push('');
+    for (const file of files) lines.push('- `' + file + '`');
+    lines.push('');
+  } else {
+    lines.push('### 本阶段方法论文件');
+    lines.push('');
+    lines.push('项目 `references/` 下没有可读的指导文件；按硬契约、选题和上游产物写，不要凭空编造方法论。');
+    lines.push('');
+  }
+  if (guidance) {
+    lines.push(guidance);
+  } else {
+    lines.push('### 对标样本');
+    lines.push('');
+    lines.push('项目还没有 `对标/wiki/` 总结文件；不要编造“对标分析”，也不要引用不存在的路径。');
+    lines.push('');
+  }
+  if (digest) {
+    lines.push(digest);
+    lines.push('');
+  }
+  lines.push(logBlock);
+  return lines.join('\n');
+}
+
+function referenceInputPaths(projectRoot, stageId, opts = {}) {
+  const files = existingReferenceFiles(projectRoot, guideFilesFor(stageId, opts));
+  const hasBenchmark = (() => {
+    try {
+      return fs.existsSync(path.join(projectRoot, '对标', 'wiki'));
+    } catch {
+      return false;
+    }
+  })();
+  return [...files, ...(hasBenchmark ? ['对标/wiki/'] : [])];
+}
+
+export function buildStageFilePrompt(opts) {
+  const {
+    projectRoot, stageId, file, templateFile, attempt = 1, failures = [], extra = '',
+  } = opts || {};
+  const contract = contractFor(stageId);
+  const section = sectionForFile(stageId, file);
+  const fileBase = String(file || '').replace(/\.json$/i, '').split('/').pop();
+  const batchType = (STAGE_BATCH_BY_FILE[stageId] && STAGE_BATCH_BY_FILE[stageId][fileBase]) || '';
+  const parts = [];
+  parts.push(roleBlock(
+    '网文项目的阶段编辑（' + stageId + '）',
+    [
+      '你在一个按阶段推进的网文项目里工作。当前阶段是 `' + stageId + '`：' + (contract && contract.purpose ? contract.purpose : ''),
+      '本轮只写一个文件，不要同时处理其它阶段或其它文件。',
+    ],
+  ));
+  parts.push(fileTableBlock([
+    ['设定/' + stageId + '/', '当前阶段目录', '本阶段已经生成的文件。'],
+    ['设定/' + stageId + '/_context/', '上游快照', '已经通过校验的上游事实，只读。'],
+    ...(templateFile ? [['模板/v2/' + templateFile, '结构模板', '本文件的字段结构。']] : []),
+    ['设定/' + stageId + '/' + file, '输出文件', '你本轮要写的文件。'],
+  ]));
+  parts.push(topicBlock(projectTopic(projectRoot)));
+  pushHeading(parts, '任务');
+  parts.push('');
+  parts.push('写文件：`设定/' + stageId + '/' + file + '`。');
+  parts.push('');
+  parts.push(inputBlock([
+    '设定/' + stageId + '/',
+    '设定/' + stageId + '/_context/',
+    ...(templateFile ? ['模板/v2/' + templateFile] : []),
+    ...referenceInputPaths(projectRoot, stageId, { batchType }),
+  ], { template: templateFile ? '模板/v2/' + templateFile : '' }));
+  if (section) parts.push(sectionBlock(section, nextSection(parts)));
+  if (extra) {
+    pushHeading(parts, '本阶段其它文件（写当前文件时必须与它们保持一致）');
+    parts.push('');
+    parts.push(extra);
+    parts.push('');
+  }
+  const digest = contextDigest(projectRoot, stageId, nextSection(parts));
+  if (digest) parts.push(digest);
+  parts.push(referenceDecisionBlock(projectRoot, stageId, {
+    number: nextSection(parts),
+    batchType,
+    batchName: file,
+  }));
+  pushHeading(parts, '执行步骤');
+  parts.push('');
+  parts.push('1. 先读 `references/` 里的本阶段方法论，再核对 `对标/wiki/` 的本批参考；摘要只用于定位，不能替代原文。');
+  parts.push('2. 读结构模板和 `_context/` 上游快照，确认本文件需要哪些实体、数量和上游引用。');
+  parts.push('3. 只写当前文件；不要顺手改别的文件，也不要把上游快照复制回上游目录。');
+  parts.push('4. 每做一个会进入本文件的设计决策，就按“参考决策记录”的格式向 `设定/.reference-decisions.md` 追加一行。');
+  parts.push('5. 写完后按“本文件要求”和“禁止事项”自检一遍。');
+  parts.push('6. 等插件校验；如果收到错误，按错误路径修改当前文件。');
+  parts.push('');
+  parts.push(forbiddenBlock(stageId, [
+    '不要修改其它阶段或其它文件；`设定/.reference-decisions.md` 是唯一例外。',
+    '不要生成 wiki 页面。',
+    '不要写 `_meta`、依赖图或下游索引，这些由插件补。',
+  ], nextSection(parts)));
+  parts.push(validationBlock(stageId, { number: nextSection(parts) }));
+  parts.push(failureBlock(failures));
+  pushHeading(parts, '输出格式');
+  parts.push('');
+  parts.push('1. 写一个 JSON 对象，顶层业务字段与“本文件要求”一致。');
+  parts.push('2. 不要写 markdown 代码围栏，不要把 JSON 包在字符串里。');
+  parts.push('3. 不要自己补 `formulas`、`derivations`、`_meta` 这类插件生成的字段。');
+  parts.push('4. 参考决策按表格追加到 `设定/.reference-decisions.md`，不要覆盖已有行。');
+  parts.push('5. 写完后只汇报：文件路径、条目数量、参考决策行数、无法确定的地方。');
+  parts.push('');
+  return parts.join('\n');
+}
+
+export function buildChapterMapPrompt(opts) {
+  const {
+    projectRoot, volumes, volumeId, startCh, endCh, attempt = 1, failures = [], existing = '', currentChunk = null,
+  } = opts || {};
+  const contract = contractFor('40-rhythm');
+  const chapterMapSection = asArray(contract && contract.sections).find((s) => s.id === 'chapter-map');
+  const parts = [];
+  parts.push(roleBlock(
+    '网文项目的章节地图编辑（40-rhythm）',
+    [
+      '你在把宏观卷纲和实体设定落到每一章。本轮只负责一个 chunk，不写细纲。',
+      '`40-rhythm` 的目标：' + (contract && contract.purpose ? contract.purpose : ''),
+    ],
+  ));
+  parts.push(fileTableBlock([
+    ['设定/40-rhythm/', '当前阶段目录', '本阶段已经生成的章节地图和细纲。'],
+    ['设定/40-rhythm/_context/', '上游快照', 'scale / macro / cast 的只读快照。'],
+    ['模板/v2/40-rhythm/chapter-map-template.json', '结构模板', '章节地图分片的字段结构。'],
+    ['设定/40-rhythm/.chapter-map/' + volumes + '.json', '输出文件', '你本轮要写的章节地图分片。'],
+  ]));
+  parts.push(topicBlock(projectTopic(projectRoot)));
+  pushHeading(parts, '任务');
+  parts.push('');
+  parts.push((currentChunk ? '修订文件：' : '写文件：') + '`设定/40-rhythm/.chapter-map/' + volumes + '.json`。');
+  parts.push('所属卷：`' + (volumeId || volumes) + '`。');
+  parts.push('章节范围：第 ' + startCh + '-' + endCh + ' 章。');
+  parts.push('');
+  if (currentChunk) {
+    parts.push('这是返工轮：下面给出了本 chunk 的当前内容。只改“上一轮校验错误”指向的章节或缺失动作；其它章节必须原样保留，不要顺手重写整个 chunk。');
+  }
+  parts.push('这是章节地图分片，不是全书审校。不要重新规划全书，不要逐条检查所有 payoff 的 required_setup；如果某个 payoff 的 required_setup 指向后续卷，本 chunk 不要兑现，交给后续卷处理，但每个 payoff 最终都必须有落点。写完文件后立即结束，不要继续读文件或自我审计。');
+  parts.push('');
+  parts.push('覆盖硬约束：本 chunk 内出现的每个伏笔，`回收 / 推进 / 强化` 之前必须有更早的 `埋设`；如果本章节范围是它第一次出现，先写 `埋设`。全书每个爽点至少要有一次 `payoff_actions` 落点；属于本卷的爽点不要因为“后面还有章节”就全部跳过。');
+  parts.push('节奏硬约束：第 1-3 章的 `hook.strength` 必须是 `强`；不要连续 3 章使用同一个 `emotion.value`，需要平流时至少让其中一章差 1。');
+  parts.push('结局落点：`设定/20-macro/endings.json` 里的每个结局节点，至少要在对应卷末或全书末的章节写一次 `ending_actions`，动作写 `收束`。');
+  parts.push('知识时间线硬约束：只要本章有人对某条信息差/伏笔的知道程度发生变化，就必须写 `knowledge_events`。每个事件写清 subject_type、subject_id、character、change、coverage、knowledge、how、source_character、scene、evidence。同一角色对同一对象已经 `full` 后，不能在本章或后续章节重新写成 `partial/unknown/misinforms`；要写“遗忘/纠正”必须明确用 `forgets/corrects`。');
+  parts.push('知识事件取值映射（校验器强制，写错会被拒）：`learns → coverage 只能是 partial 或 full`；`partially_learns → partial`；`confirms → full`；`corrects → partial 或 full`；`forgets → unknown`；`misinforms → false`。`how=told` 时必须写 `source_character`，且不能等于 `character` 自己。');
+  parts.push('');
+  parts.push(inputBlock([
+    '设定/40-rhythm/',
+    '设定/40-rhythm/_context/',
+    '模板/v2/40-rhythm/chapter-map-template.json',
+    ...referenceInputPaths(projectRoot, '40-rhythm', { batchType: '章节规划' }),
+  ], { template: '模板/v2/40-rhythm/chapter-map-template.json' }));
+  if (chapterMapSection) parts.push(sectionBlock(chapterMapSection, nextSection(parts)));
+  parts.push('节奏公式以 2000 字/章为基准；本项目 `capacity.chapter_scale` 是换算系数，所有“持续 N 章”的参考值都要乘它。');
+  parts.push('');
+  if (existing) {
+    pushHeading(parts, '已生成的相邻章节（用于衔接，不要重复）');
+    parts.push('');
+    parts.push(existing);
+    parts.push('');
+  }
+  const digest = chapterMapContext(projectRoot, nextSection(parts));
+  if (digest) parts.push(digest);
+  parts.push(rhythmFormulaBlock(projectRoot, nextSection(parts)));
+  parts.push(referenceDecisionBlock(projectRoot, '40-rhythm', {
+    number: nextSection(parts),
+    batchType: '章节规划',
+    batchName: '章节地图 ' + volumes,
+    allowedFileText: '除本 chunk 外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改其它 chunk、章节地图、模板或上游文件。',
+  }));
+  if (currentChunk) {
+    pushHeading(parts, '本 chunk 当前内容（返工基线，未涉及章节必须保留）');
+    parts.push('');
+    parts.push('```json');
+    parts.push(JSON.stringify(currentChunk));
+    parts.push('```');
+    parts.push('');
+  }
+  pushHeading(parts, '执行步骤');
+  parts.push('');
+  parts.push('1. 先读 `references/节奏指导/` 的方法论和 `对标/wiki/` 的本批参考；摘要只用于定位，做决策前核对原文对应条目。');
+  parts.push('2. 读 `_context/scale.json`，确认本卷的章节区间、幕区间和平均每章字数。');
+  parts.push('3. 读 `_context/macro.json` 和 `_context/cast.json`，只取本卷相关的主线节点、支线、冲突、伏笔、人物和地点。');
+  parts.push('4. 按第 ' + startCh + '-' + endCh + ' 章逐章写 5W：谁、何时、何地、为什么、怎么写。');
+  parts.push('5. 检查伏笔先埋后收、爽点先铺垫后兑现，章节落点不要越过本卷；本卷内应出现的条目至少各落一次。');
+  parts.push('6. 每个会进入章节地图的设计决策，按“参考决策记录”的格式向 `设定/.reference-decisions.md` 追加一行（每章规划至少一行）。');
+  parts.push('7. 只写这个 chunk，不要合并其它 chunk，不要写 `chapter_map.json`。');
+  parts.push('8. 写完后只确认文件已落盘并汇报；不要继续读其它 chunk，不要做第二轮全书检查。');
+  parts.push('');
+  parts.push(forbiddenBlock('40-rhythm', [
+    '本 chunk 之外的内容不要写。',
+    '不要修改其它 chunk、章节地图或上游文件；`设定/.reference-decisions.md` 是唯一例外。',
+    '不要创建 Python/临时脚本，也不要运行脚本生成 JSON；直接写 JSON。',
+  ], nextSection(parts)));
+  parts.push(validationBlock('40-rhythm', { validator: '40-rhythm 的章节地图校验', number: nextSection(parts) }));
+  parts.push(failureBlock(failures));
+  pushHeading(parts, '输出格式');
+  parts.push('');
+  parts.push('顶层写 `{ "chapters": [ ... ] }`，只包含第 ' + startCh + '-' + endCh + ' 章。');
+  parts.push('`chapter_id` 初始生成一律使用 `CH` + 三位 display_no，例如第 1 章 → `CH001`；返工轮保留已有 chapter_id。');
+  parts.push('每章必须有：title、volume、act、pov、cast、locations、time、why、how、foreshadow_actions、payoff_actions、information_gaps、knowledge_events、emotion、hook、word_target。');
+  parts.push('`ending_actions` 可选；但每个结局节点（E001...）至少要在对应章节出现一次，格式 `{ "id": "E001", "action": "收束", "detail": "..." }`。');
+  parts.push('`knowledge_events` 可选但强烈建议每章都写（没有变化就写空数组）。格式：`{ "subject_type": "information|foreshadow", "subject_id": "IG-...|FS...", "character": "C001", "change": "learns|partially_learns|confirms|corrects|forgets|misinforms", "coverage": "unknown|partial|full|false", "knowledge": "具体知道什么", "how": "witnessed|told|inferred|document|rumor|experience|other", "source_character": "C002 或 null", "scene": "场景/地点", "evidence": "依据" }`。');
+  parts.push('字段值约束：`foreshadow_actions[].action` 用 埋设 / 回收 / 推进 / 强化；`information_gaps[].state` 只能是 created / progressed / resolved（不要写中文“推进/回收”）；`payoff_actions[].action` 用 铺垫 / 兑现 / 回收。');
+  parts.push('参考决策按表格追加到 `设定/.reference-decisions.md`，不要覆盖已有行。');
+  parts.push('不要在 JSON 里写 markdown。');
+  parts.push('');
+  return parts.join('\n');
+}
+
+export function buildOutlinePrompt(opts) {
+  const {
+    projectRoot, chapter, chapterMap, previous, next, castDigest, macroDigest, attempt = 1, failures = [],
+  } = opts || {};
+  const contract = contractFor('40-rhythm');
+  const outlineSection = asArray(contract && contract.sections).find((s) => s.id === 'outline');
+  const coverageSection = asArray(contract && contract.sections).find((s) => s.id === 'coverage');
+  const id = chapter.chapter_id;
+  const parts = [];
+  parts.push(roleBlock(
+    '网文项目的单章细纲编辑（40-rhythm）',
+    [
+      '你在把章节地图扩写成一份能直接交给写作模型的可落地细纲。',
+      '本轮只写第 ' + (chapter.number || chapter.display_no) + ' 章（`' + id + '`），不要写正文，也不要改章节地图。',
+    ],
+  ));
+  parts.push(fileTableBlock([
+    ['设定/40-rhythm/', '当前阶段目录', '章节地图和已有细纲。'],
+    ['设定/40-rhythm/_context/', '上游快照', 'scale / macro / cast 的只读快照。'],
+    ['模板/v2/40-rhythm/outline-template.json', '结构模板', '单章细纲的字段结构。'],
+    ['设定/40-rhythm/outlines/' + id + '.json', '输出文件', '你本轮要写的单章细纲。'],
+  ]));
+  parts.push(topicBlock(projectTopic(projectRoot)));
+  pushHeading(parts, '任务');
+  parts.push('');
+  parts.push('写文件：`设定/40-rhythm/outlines/' + id + '.json`。');
+  parts.push('');
+  parts.push('这一份文件必须能单独交给写作模型：它不需要再读别的章节细纲，就能知道谁出场、何时、何地、为什么、怎么写、怎么结束。');
+  parts.push('');
+  parts.push(inputBlock([
+    '设定/40-rhythm/',
+    '设定/40-rhythm/_context/',
+    '模板/v2/40-rhythm/outline-template.json',
+    ...referenceInputPaths(projectRoot, '40-rhythm', { batchType: '章节细纲' }),
+  ], { template: '模板/v2/40-rhythm/outline-template.json' }));
+  if (outlineSection) parts.push(sectionBlock(outlineSection, nextSection(parts)));
+  if (coverageSection) parts.push(sectionBlock(coverageSection, nextSection(parts)));
+  parts.push('节奏公式以 2000 字/章为基准；本项目 `capacity.chapter_scale` 是换算系数，场景节拍和钩子密度要按它调整。');
+  parts.push('');
+  pushHeading(parts, '本章章节地图');
+  parts.push('');
+  parts.push('```json');
+  parts.push(JSON.stringify(chapterMap, null, 2));
+  parts.push('```');
+  parts.push('');
+  if (previous) {
+    pushHeading(parts, '上一章摘要');
+    parts.push('');
+    parts.push(previous);
+    parts.push('');
+  }
+  if (next) {
+    pushHeading(parts, '下一章摘要');
+    parts.push('');
+    parts.push(next);
+    parts.push('');
+  }
+  if (macroDigest) {
+    pushHeading(parts, '宏观上下文（只取本章相关）');
+    parts.push('');
+    parts.push(macroDigest);
+    parts.push('');
+  }
+  if (castDigest) {
+    pushHeading(parts, '本章实体档案（只取本章相关）');
+    parts.push('');
+    parts.push(castDigest);
+    parts.push('');
+  }
+  const digest = outlineContext(projectRoot, chapter, nextSection(parts));
+  if (digest) parts.push(digest);
+  parts.push(rhythmFormulaBlock(projectRoot, nextSection(parts)));
+  parts.push(referenceDecisionBlock(projectRoot, '40-rhythm', {
+    number: nextSection(parts),
+    batchType: '章节细纲',
+    batchName: '细纲 ' + id,
+    allowedFileText: '除本章细纲外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改章节地图、其它细纲或上游文件。',
+  }));
+  pushHeading(parts, '执行步骤');
+  parts.push('');
+  parts.push('1. 先读 `references/节奏指导/` 的方法论和 `对标/wiki/` 的本批参考；摘要只用于定位，做决策前核对原文对应条目。');
+  parts.push('2. 把本章章节地图当作硬约束，确认 pov、cast、locations、why、how 和 word_target。');
+  parts.push('3. 结合上游宏观与实体档案，把 `why` 展开成人物动机、阻力和赌注。');
+  parts.push('4. 把 `how` 拆成可执行的场景节拍；每个场景必须有目标、阻碍、转折、结果。');
+  parts.push('5. 检查 coverage 是否覆盖本章的主线、支线、冲突、伏笔、爽点、信息差。');
+  parts.push('6. 写完后检查 continuity 是否能接上上一章、下一章。');
+  parts.push('7. 对照章节地图的 `knowledge_events`，把本章每个人物“知道了什么、怎么知道、在什么场景知道”写进 `knowledge_events` 和 `cast[].knowledge`；状态必须和章节地图回放结果一致。');
+  parts.push('8. 每个会进入细纲的设计决策，按“参考决策记录”的格式向 `设定/.reference-decisions.md` 追加一行（本章至少一行）。');
+  parts.push('');
+  parts.push('不要发明章节地图没有的剧情节点；不要引用不存在的实体。');
+  parts.push('');
+  parts.push(forbiddenBlock('40-rhythm', [
+    '不要写正文，不要改章节地图，不要改上游文件；`设定/.reference-decisions.md` 是唯一例外。',
+  ], nextSection(parts)));
+  parts.push(validationBlock('40-rhythm', { validator: '40-rhythm 的单章细纲校验', number: nextSection(parts) }));
+  parts.push(failureBlock(failures));
+  pushHeading(parts, '输出格式');
+  parts.push('');
+  parts.push('顶层：`{ "_meta": { "chapter": ... }, "chapter": { ... } }`。');
+  parts.push('chapter 至少包含：chapter_id、number、title、volume、act、word_target、pov、time、locations、cast、why、how、knowledge_events、continuity、coverage、hard_constraints、soft_suggestions。');
+  parts.push('how.scenes 至少 1 个，每个场景写 goal、obstacle、turn、outcome。');
+  parts.push('hard_constraints 写 must_write、must_not_write、foreshadow_actions、payoff_actions、information_state。');
+  parts.push('soft_suggestions 写 scene_split、emotion_trend、description_focus、pace，允许写作时调整。');
+  parts.push('coverage 必须覆盖本章的主线节点、支线、冲突、伏笔、爽点、信息差。');
+  parts.push('knowledge_events 与章节地图同结构；cast[].knowledge 写本章结束时该角色的知识快照（subject_type、subject_id、state、coverage、knowledge、how、scene、evidence）。');
+  parts.push('知识事件取值映射（校验器强制）：learns → partial|full；partially_learns → partial；confirms → full；corrects → partial|full；forgets → unknown；misinforms → false；how=told 必须写 source_character。');
+  parts.push('continuity 写 from_prev 与 to_next。');
+  parts.push('参考决策按表格追加到 `设定/.reference-decisions.md`，不要覆盖已有行。');
+  parts.push('');
+  return parts.join('\n');
+}
+
+export function buildWritingPrompt(opts) {
+  const { projectRoot, chapters, outlines, dossiers, prevTail, ledger, attempt = 1, failures = [] } = opts || {};
+  const contract = contractFor('50-writing');
+  const writingSection = asArray(contract && contract.sections).find((s) => s.id === 'writing');
+  const ledgerSection = asArray(contract && contract.sections).find((s) => s.id === 'ledger');
+  const parts = [];
+  parts.push(roleBlock(
+    '网文项目的正文写作者（50-writing）',
+    [
+      '你只按单章细纲写正文，不重新设计剧情。',
+      '本轮要写：' + asArray(chapters).join('、') + '。',
+    ],
+  ));
+  parts.push(fileTableBlock([
+    ['设定/50-writing/', '当前阶段目录', '已写正文和章台账。'],
+    ['设定/50-writing/_context/', '上游快照', 'scale / macro / cast 的只读快照。'],
+    ['设定/40-rhythm/outlines/', '细纲目录', '每章的可落地细纲。'],
+    ['模板/v2/50-writing/ledger-template.json', '结构模板', '章台账的字段结构。'],
+    ['设定/50-writing/chapters/', '正文输出目录', '你本轮要写的正文。'],
+    ['设定/50-writing/ledger.json', '台账输出文件', '你本轮要更新的章台账。'],
+  ]));
+  parts.push(topicBlock(projectTopic(projectRoot)));
+  pushHeading(parts, '任务');
+  parts.push('');
+  parts.push('按细纲写正文，并更新章台账。');
+  parts.push('');
+  parts.push(inputBlock([
+    '设定/50-writing/',
+    '设定/50-writing/_context/',
+    '设定/40-rhythm/outlines/',
+    '模板/v2/50-writing/ledger-template.json',
+    ...referenceInputPaths(projectRoot, '50-writing', { batchType: 'default' }),
+  ], { template: '模板/v2/50-writing/ledger-template.json' }));
+  if (writingSection) parts.push(sectionBlock(writingSection, nextSection(parts)));
+  if (ledgerSection) parts.push(sectionBlock(ledgerSection, nextSection(parts)));
+  pushHeading(parts, '本轮细纲');
+  parts.push('');
+  for (const ch of asArray(chapters)) {
+    const outline = outlines && outlines.get(ch);
+    if (!outline) continue;
+    parts.push('### 第 ' + ch + ' 章细纲（硬约束）');
+    parts.push('');
+    parts.push('```json');
+    parts.push(JSON.stringify(outline, null, 2));
+    parts.push('```');
+    parts.push('');
+  }
+  if (dossiers) {
+    pushHeading(parts, '本章人物档案');
+    parts.push('');
+    parts.push(dossiers);
+    parts.push('');
+  }
+  if (prevTail) {
+    pushHeading(parts, '前情衔接');
+    parts.push('');
+    parts.push('```');
+    parts.push(prevTail);
+    parts.push('```');
+    parts.push('');
+  }
+  if (ledger) {
+    pushHeading(parts, '当前台账快照');
+    parts.push('');
+    parts.push(JSON.stringify(ledger, null, 2));
+    parts.push('');
+  }
+  parts.push(referenceDecisionBlock(projectRoot, '50-writing', {
+    number: nextSection(parts),
+    batchType: 'default',
+    batchName: '正文 ' + asArray(chapters).join('、'),
+    allowedFileText: '除本轮正文与 `ledger.json` 外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改细纲、章节地图或上游文件。',
+  }));
+  pushHeading(parts, '执行步骤');
+  parts.push('');
+  parts.push('1. 先读 `references/写作指导/` 的方法论和 `对标/wiki/` 的本批参考；摘要只用于定位，写作前核对原文对应条目。');
+  parts.push('2. 逐章读细纲，先确认本章 must_write、must_not_write、ending 和 word_target。');
+  parts.push('3. 按 how.scenes 的顺序写，不要把场景写成摘要。');
+  parts.push('4. 写完后检查人物、地点、时间、知识状态是否和细纲一致。');
+  parts.push('5. 每章至少向 `设定/.reference-decisions.md` 追加一行，写清参考文件、原文条目和实际采用的写法。');
+  parts.push('6. 更新 ledger.json：每章一条，重写时替换同章旧条目。');
+  parts.push('');
+  parts.push(forbiddenBlock('50-writing', [], nextSection(parts)));
+  parts.push(validationBlock('50-writing', { validator: '50-writing 的正文与台账校验', number: nextSection(parts) }));
+  parts.push(failureBlock(failures));
+  pushHeading(parts, '输出格式');
+  parts.push('');
+  for (const ch of asArray(chapters)) {
+    parts.push('- 第 ' + ch + ' 章 → `设定/50-writing/chapters/第' + String(ch).padStart(3, '0') + '章.md`');
+  }
+  parts.push('- 台账 → `设定/50-writing/ledger.json`');
+  parts.push('- `ledger.knowledge_changes` 用结构化对象：subject_type、subject_id、character、from、to、coverage、knowledge、how、source_character、scene、evidence；不要只写 gained/lost 字符串。');
+  parts.push('');
+  parts.push('每章第一行 `# 第N章 标题`，N 与 display_no 一致。');
+  parts.push('必须写细纲 must_write 的内容，绝对不能违反 must_not_write。');
+  parts.push('本章结尾必须按细纲 ending.type / text / hook 收束。');
+  parts.push('参考决策按表格追加到 `设定/.reference-decisions.md`，不要覆盖已有行。');
+  parts.push('');
+  return parts.join('\n');
+}
+
+export function buildOutlineRepairPrompt(opts) {
+  return buildOutlinePrompt(opts);
+}
+
+/**
+ * 10-scale 的 LLM 选值提示词。
+ *
+ * 公式只给区间；LLM 结合题材 profile、章节字数基准和参考骨架选择最终数量。
+ * 插件随后用 validateScale 校验结构、求和和区间。
+ */
+export function buildScalePrompt(opts) {
+  const { projectRoot, topicData, attempt = 1, failures = [] } = opts || {};
+  const T = Number(topicData && topicData.target_chapters) || 0;
+  const words = Number(topicData && topicData.target_words) || 0;
+  const avgWords = T > 0 ? Math.round(words / T) : 0;
+  const chapterScale = avgWords > 0 ? Number((2000 / avgWords).toFixed(4)) : null;
+  const parts = [];
+  parts.push(roleBlock(
+    '网文项目的数量规划师（10-scale）',
+    [
+      '你只决定“多少”：章、卷、幕、各类实体配额和节奏预算。你不写人物、势力、地点和剧情。',
+      '这一阶段的产物会决定下游 20-macro / 30-cast / 40-rhythm 要生成多少内容，所以数字必须能落地。',
+    ],
+  ));
+  parts.push(fileTableBlock([
+    ['references/genre-profiles.json', '题材配置文件', '各类参考题材的倍率、结构、平台基准和题材匹配规则。'],
+    ['references/formulas-skeleton.json', '公式文件', '基础公式、变量、倍率分类、覆盖规则和平台规则。'],
+    ['模板/v2/10-scale/scale-template.json', '输出模板', 'scale.json 的字段结构。'],
+    ['设定/00-baseline/input.json', '选题基线', '已经固化的选题字段；提示词里的“选题”是本次决策用的完整选题。'],
+    ['设定/10-scale/scale.json', '输出文件', '你本轮要写的最终数量表。'],
+  ]));
+  parts.push(topicBlock(topicData));
+  parts.push(h2(4, '任务'));
+  parts.push('');
+  parts.push('写文件：`设定/10-scale/scale.json`。');
+  parts.push('先把 `references/genre-profiles.json`（题材配置文件）里最接近选题的题材选出来，再按 `references/formulas-skeleton.json`（公式文件）计算，最后把选择的题材 key 和所有最终值写进目标文件。');
+  parts.push('你只写文件，不要在聊天里输出完整 JSON；写完后只汇报文件路径、题材 key 和条目数量。');
+  parts.push('插件会在写完后自动运行 `validateScale`；如果失败，下一轮会给错误列表，你按 `path` 修改目标文件，不需要自己运行脚本。');
+  parts.push('');
+  parts.push(inputBlock([
+    '设定/10-scale/',
+    '设定/00-baseline/',
+    '模板/v2/10-scale/scale-template.json',
+    'references/genre-profiles.json',
+    'references/formulas-skeleton.json',
+    ...referenceInputPaths(projectRoot, '10-scale', { batchType: '' }),
+  ], { template: '模板/v2/10-scale/scale-template.json' }));
+
+  parts.push(h2(6, '执行流程（按顺序做，每步都有检查）'));
+  parts.push('');
+  parts.push('0. 先读 `references/骨架指导/` 的方法论和 `对标/wiki/` 的本批参考；摘要只用于定位，做数量决策前核对原文对应条目。');
+  parts.push('1. 读 `## 三、选题`，锁定 `target_chapters` 和 `target_words`。检查：两个都是正整数；这两个数来自选题，任何情况下都不允许改。总章数就是公式变量 T。');
+  parts.push('2. 读 `references/genre-profiles.json`，按 `## 七、题材匹配` 选一个 profile。检查：profile key 必须存在于文件的 `profiles` 里；没有明显匹配就用 `default`；记下这个 key。');
+  parts.push('3. 读 `references/formulas-skeleton.json`，按 `## 八、公式读取与计算` 的 5 步算出每条公式的最终区间。检查：每条公式都使用它自己的 `multiplier_category` 和 `scale_field`，不要自造字段。');
+  parts.push('4. 决定卷/幕结构。检查：各卷 `chapters` 之和 = T；卷 `chapter_start` / `chapter_end` 连续覆盖 1..T；每卷 `acts` 的章数之和 = 本卷章数；`structure.acts` 包含全部卷幕；`total_acts` = `structure.acts` 的长度；各卷 `ratio` 之和 = 1。');
+  parts.push('5. 决定 `quotas`。检查：所有配额是非负整数；只写 `scale_field` 指向的字段；每个值都落在“公式 × 题材倍率”后的区间内；偏离区间时写 `derivation_reasons`。');
+  parts.push('6. 决定 `distribution`。检查：只拆 `chapters`、`volume_supporting`、`volume_antagonist`、`phase_conflicts`、`foreshadows`、`climaxes`、`pleasures`；每卷 `chapters` 必须等于该卷章数；不要拆核心人物、核心反派、核心冲突、地点、道具、世界规则、结局、主线、支线、信息差、关系。');
+  parts.push('7. 决定 `rhythm_budget`。检查：钩子、揭示、反转、情绪峰值都有 `min` 和 `target`；`golden_three` 有 `hook_strength` 和 `must_establish`。');
+  parts.push('8. 写 `设定/10-scale/scale.json`。检查：顶层字段齐全；文件里是纯 JSON，没有 markdown 围栏；`genre_profile` 写的是目标文件的顶层字段。');
+  parts.push('9. 等插件校验。失败时按文末“附：校验与返工”逐条修改，不要改上游文件。');
+  parts.push('');
+
+  parts.push(h2(7, '题材匹配'));
+  parts.push('');
+  parts.push('### 7.1 匹配规则');
+  parts.push('');
+  parts.push('读取 `references/genre-profiles.json`。这个文件是题材匹配和倍率的唯一来源，提示词里不再重复它的内容。');
+  parts.push('');
+  parts.push(...ordered([
+    '`platform`：平台通用基准。只有当选题的 `platform` 字段和文件里的平台名一致时，才直接使用这些数值；不一致时只作参考。',
+    '`profiles`：每个 key 是一个题材配置。用 `label`、`aliases`、`channel`、`category`、`structure_feature` 判断它覆盖什么题材。',
+    '`profiles.<key>.special_rules`：该题材的额外节奏和结构要求，选值时必须参考。',
+    '`profiles.<key>.overrides`：该题材对个别公式区间的覆盖。',
+    '`base_overrides`：对所有题材都生效的公式区间覆盖。',
+    '`profile_match_rules`：匹配顺序和默认值规则。',
+    '`platform_checks`：平台对爽文、情感、悬疑、种田等类型的额外校验提醒；同样只在平台匹配时直接使用。',
+    '`default`：选题和所有题材都不接近时的默认配置。',
+  ]));
+  parts.push('');
+  parts.push('匹配顺序：');
+  parts.push('');
+  parts.push(...ordered([
+    '先看选题 JSON 的 `genre` 字段（它就是本书题材），看是否能命中某个 profile 的 `category` 或 `aliases`；',
+    '再看 `positioning` / `core_setting` / `reader_value` 里是否出现 profile 的 `aliases` 关键词；',
+    '仍然没有明显匹配时，使用 `default`，不要硬套一个不相关的题材。',
+  ]));
+  parts.push('');
+  parts.push('把最终选择的 profile key 写进**你要生成的目标文件** `设定/10-scale/scale.json` 的顶层字段 `genre_profile`。');
+  parts.push('不是写进 `references/genre-profiles.json`，也不是修改模板；`模板/v2/10-scale/scale-template.json` 里的 `genre_profile` 只是字段示例。');
+  parts.push('不要自己发明 key，也不要选一个文件里不存在的题材。');
+  parts.push('');
+  parts.push('### 7.2 选值原则');
+  parts.push('');
+  parts.push(...ordered([
+    '卷数：优先让每卷接近 profile 的 `structure.preferred_chapters_per_volume`；经营基建类偏中长卷，单元剧/悬疑类偏短卷，升级流可以偏长。',
+    '配额：默认取区间中值，再按题材特征上下浮动；不要全部取上界，也不要全部取下界。',
+    'distribution：按 profile 的 `distribution_weights` 和题材节奏分配，不要平均分；前段多埋伏笔，后段多回收，高潮和爽点向卷末集中。',
+  ]));
+  parts.push('');
+
+  parts.push(h2(8, '公式读取与计算'));
+  parts.push('');
+  parts.push('读取 `references/formulas-skeleton.json`。公式和倍率都在文件里，提示词不再给出公式区间或推荐值。');
+  parts.push('');
+  parts.push('### 8.1 强制计算顺序');
+  parts.push('');
+  parts.push('每条公式都必须严格按下面 5 步计算，不能跳步，也不能先乘倍率再覆盖：');
+  parts.push('');
+  parts.push('1. **算基础区间**：用 `expr_low` / `expr_high` 和当前 T、V、BC、CC 等变量算出基础区间。');
+  parts.push('2. **应用全局覆盖**：如果 `base_overrides` 里有这条公式，用覆盖值替换第 1 步的基础区间。');
+  parts.push('3. **应用题材覆盖**：如果当前 profile 的 `overrides` 里有这条公式，用覆盖值替换第 2 步的区间。');
+  parts.push('4. **乘题材倍率**：取这条公式的 `multiplier_category`，去当前 profile 的 `multipliers` 里找同名倍率相乘；没有分类或倍率缺失时按 1 处理。');
+  parts.push('5. **取整**：下界向上取整（`ceil`），上界向下取整（`floor`）；如果取整后上界小于下界，把上界改成和下界相等。取整只会让区间变窄，不会变宽。');
+  parts.push('');
+  parts.push('### 8.2 计算依赖顺序');
+  parts.push('');
+  parts.push(...ordered([
+    '先算 `structure.volume_count`，因为它决定 V；卷数优先看 profile 的 `structure.volume_chapters` / `preferred_chapters_per_volume`，不要直接套 `expr_low` / `expr_high`。',
+    '再算只依赖 T / V 的公式：支线数、卷级配角/反派、阶段冲突、势力、地点、伏笔、高潮、爽点、世界规则、结局、固定人物。',
+    '再算依赖前面配额的公式：势力关系依赖势力数，交织冲突依赖支线数，核心道具依赖核心冲突数。',
+    '最后算 `quotas.information_gaps` 和 `quotas.relations.character` 这两条自定义公式；它们在 `references/formulas-skeleton.json` 的 `custom_formulas` 里，不在 `formulas` 里。',
+  ]));
+  parts.push('');
+  parts.push('### 8.3 计算示例');
+  parts.push('');
+  parts.push('下面只演示顺序，数字不是本书的最终答案：');
+  parts.push('');
+  parts.push('```text');
+  parts.push('公式：小伏笔 V*3 ~ V*8，V=6');
+  parts.push('1. 基础区间：18 ~ 48');
+  parts.push('2. base_overrides 覆盖为 V*8 ~ V*15：48 ~ 90');
+  parts.push('3. profile.overrides 覆盖为 50 ~ 100：50 ~ 100');
+  parts.push('4. multipliers.foreshadows = 1.1：55 ~ 110');
+  parts.push('5. 取整：55 ~ 110');
+  parts.push('```');
+  parts.push('');
+  parts.push('如果你先乘倍率再覆盖，得到的结果会落在错误区间，`validateScale` 会报 `SCALE_FORMULA_RANGE`。');
+  parts.push('');
+  parts.push('### 8.4 超出区间时怎么处理');
+  parts.push('');
+  parts.push('如果某个值确实要超出乘倍率后的合法区间，必须在 `derivation_reasons` 里写理由。');
+  parts.push('有理由时，这条 `SCALE_FORMULA_RANGE` 只算 **warning**，阶段仍可通过；没有理由时才是 **error**，阶段不通过。');
+  parts.push('`derivation_reasons` 的 key 可以写公式 key（如 `custom.information_gaps`），也可以写目标字段路径（如 `quotas.information_gaps`）。');
+  parts.push('');
+
+  parts.push(h2(9, '字段说明'));
+  parts.push('');
+  parts.push('### 9.1 顶层字段');
+  parts.push('');
+  parts.push('`scale.json` 只写下面这些顶层字段：');
+  parts.push('');
+  parts.push(...ordered([
+    '`formula_version`：写 `references/genre-profiles.json` 的 `version`。',
+    '`genre_profile`：你从题材配置文件选中的 profile key。',
+    '`capacity`：规模参数。`target_chapters` / `target_words` 来自选题，不能改；`avg_words_per_chapter` 是平均每章字数；`base_words_per_chapter` 是节奏公式基准，默认 2000；`chapter_scale` 是 2000 / 平均每章字数。',
+    '`structure`：卷和幕的结构。`volumes` 里每卷写 chapters、chapter_start、chapter_end、ratio 和 acts；`structure.acts` 是全部卷幕的扁平表。',
+    '`quotas`：下游要生成多少实体；字段清单见 9.2。',
+    '`rhythm_budget`：全书的钩子、揭示、反转、情绪峰值预算，以及黄金三章要求。',
+    '`distribution`：按卷拆分的配额；字段清单见 9.3。',
+    '`derivation_reasons`：可选；只写偏离公式推荐值的原因。',
+  ]));
+  parts.push('不要写 `formulas`、`derivations`、`_meta`；这三个由插件补。');
+  parts.push('');
+  parts.push('### 9.2 quotas 必填字段');
+  parts.push('');
+  parts.push('只写下面这些路径，不要写 `faction_count`、`branch_count`、`ending_count` 之类的别名字段：');
+  parts.push('');
+  parts.push('```text');
+  parts.push('quotas.characters: protagonist, core_supporting, volume_supporting, core_antagonist, volume_antagonist');
+  parts.push('quotas.factions');
+  parts.push('quotas.faction_relations');
+  parts.push('quotas.locations');
+  parts.push('quotas.items: core, branch, symbolic');
+  parts.push('quotas.conflicts: core, phase, branch');
+  parts.push('quotas.foreshadows: small, medium, large');
+  parts.push('quotas.climaxes: small, medium, large');
+  parts.push('quotas.pleasures: small, medium, large');
+  parts.push('quotas.endings');
+  parts.push('quotas.world_rules: core, information, social');
+  parts.push('quotas.main_lines');
+  parts.push('quotas.branches');
+  parts.push('quotas.information_gaps');
+  parts.push('quotas.relations: character, faction, membership');
+  parts.push('```');
+  parts.push('');
+  parts.push('### 9.3 distribution 只拆这些');
+  parts.push('');
+  parts.push('每卷只写：');
+  parts.push('');
+  parts.push('```text');
+  parts.push('chapters, volume_supporting, volume_antagonist, phase_conflicts, foreshadows, climaxes, pleasures');
+  parts.push('```');
+  parts.push('不要把核心人物、核心反派、核心冲突、地点、道具、世界规则、结局、主线、支线、信息差、关系拆到卷里；这些是全书级配额。');
+  parts.push('');
+  parts.push('### 9.4 structure.acts 和 total_acts');
+  parts.push('');
+  parts.push('1. 每卷的 `volumes[i].acts` 写本卷的幕。');
+  parts.push('2. 把全部卷的幕按顺序复制到 `structure.acts`，形成扁平表。');
+  parts.push('3. `structure.total_acts` 必须等于 `structure.acts` 数组长度。');
+  parts.push('');
+  parts.push('### 9.5 术语统一');
+  parts.push('');
+  parts.push('本文档统一用词：配额 = `quotas`，幕 = `acts`，倍率 = `multipliers`，覆盖 = `overrides`。');
+  parts.push('');
+
+  parts.push(h2(10, '硬约束'));
+  parts.push('');
+  parts.push('1. 各卷 `chapters` 之和 = `capacity.target_chapters`；');
+  parts.push('2. 卷 `chapter_start` / `chapter_end` 连续覆盖 1..T；');
+  parts.push('3. 每卷 `acts` 至少 1 幕，幕章数之和 = 本卷章数；');
+  parts.push('4. `structure.acts` 包含所有卷的全部幕，`total_acts` 等于它的长度；');
+  parts.push('5. 各卷 `ratio` 之和 = 1；');
+  parts.push('6. 所有配额是非负整数；');
+  parts.push('7. `distribution` 的 `chapters` 必须等于对应卷的 `chapters`；');
+  parts.push('8. 不写任何人物名、势力名、地点名、道具名、剧情内容或章节标题。');
+  parts.push('');
+
+  parts.push(platformNoticeBlock(topicData, 11));
+  parts.push(h2(12, '章节字数基准'));
+  parts.push('');
+  parts.push('本书目标 `' + T + '` 章、`' + words + '` 字，平均每章约 `' + avgWords + '` 字，`chapter_scale = 2000 / avg = ' + (chapterScale ?? '') + '`。');
+  parts.push('');
+  parts.push('`chapter_scale` 只用于“时长类”参考：');
+  parts.push('');
+  parts.push(...ordered([
+    '需要乘：桥段时长、高潮间隔、连续压制/反转周期、伏笔回收周期、卷长参考。',
+    '不需要乘：总章数、总字数、配额数量、钩子/揭示/爽点总数或密度。',
+  ]));
+  parts.push('');
+
+  parts.push(forbiddenBlock('10-scale', [], 13));
+  parts.push(h2(14, '输出前检查清单'));
+  parts.push('');
+  parts.push(...ordered([
+    '顶层字段齐全：formula_version、genre_profile、capacity、structure、quotas、rhythm_budget、distribution、derivation_reasons。',
+    '`genre_profile` 是 `references/genre-profiles.json` 里真实存在的 key。',
+    '`capacity.target_chapters` / `target_words` 没有被改；`avg_words_per_chapter` 和 `chapter_scale` 计算正确。',
+    '各卷 chapters 之和 = T；章节区间连续；每卷幕章数之和 = 本卷章数；`ratio` 之和 = 1。',
+    '`structure.acts` 是全部卷幕的扁平表，`total_acts` 等于它的长度。',
+    '`quotas` 只写第九节列出的字段，全部是非负整数，并且落在公式 × 题材倍率后的区间内。',
+    '`distribution` 只拆允许的字段，每卷 chapters 等于该卷章数。',
+    '`rhythm_budget` 的钩子、揭示、反转、情绪峰值和黄金三章字段齐全。',
+    '没有人物姓名、势力名称、地点名称、道具名称、剧情句、章节标题。',
+    '文件内容是纯 JSON，没有 markdown 代码围栏。',
+  ]));
+  parts.push('');
+
+  parts.push(referenceDecisionBlock(projectRoot, '10-scale', {
+    batchType: '',
+    batchName: 'scale',
+    allowedFileText: '除 `scale.json` 外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改题材配置、公式或模板。',
+  }));
+  parts.push(failureBlock(failures));
+  parts.push(h2(15, '输出格式'));
+  parts.push('');
+  parts.push('只写 `设定/10-scale/scale.json`。文件内容必须是一个 JSON 对象，除此之外不要写任何东西。');
+  parts.push('不要在文件里加 ```json 围栏，也不要在聊天里重复完整 JSON；写完后只汇报文件路径、题材 key 和条目数量。');
+  parts.push('`formula_version` 写 `references/genre-profiles.json` 的 `version`；`genre_profile` 是目标文件的顶层字段。');
+  parts.push('每个会进入 `scale.json` 的数量决策（profile 选择、卷/幕结构、各配额、节奏预算），按“参考决策记录”的格式向 `设定/.reference-decisions.md` 追加一行。');
+  parts.push('');
+  parts.push('`derivation_reasons` 可选，格式示例：');
+  parts.push('');
+  parts.push('```json');
+  parts.push('{ "structure.volume_count": "悬疑单元案，5 卷比 3 卷更适合每卷闭环", "quotas.information_gaps": "悬疑需要更高信息差密度" }');
+  parts.push('```');
+  parts.push('');
+  parts.push(validationBlock('10-scale', {
+    appendix: true,
+    validator: 'validateScale',
+    checks: [
+      'genre_profile 必须存在于 references/genre-profiles.json',
+      '各卷 chapters 之和 = capacity.target_chapters',
+      '各卷 acts 的章数之和 = 本卷 chapters',
+      'structure.acts 包含全部卷幕，total_acts 等于它的长度',
+      '各卷 ratio 之和 = 1',
+      '所有配额是非负整数，且落在公式 × 题材倍率后的区间内',
+      '没有人物/势力/地点/剧情内容',
+    ],
+  }));
+  return parts.join('\n');
+}