@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/scripts/schema-pages.js

@@ -0,0 +1,2668 @@
+/**
+ * schema-pages.js —— 把 story-builder 的阶段 JSON 转成 llm_wiki 的 schemaingest 页面
+ *
+ * 设计原则：
+ *   - JSON 仍是事实源；wiki 页面是确定性派生视图。
+ *   - 一个对象一个 page；关系表能落到实体字段的就落到实体字段，不能落地的才建关系页。
+ *   - 页面 body 用人类可读的字段清单，frontmatter 只放 schema 声明的结构化字段。
+ *   - 所有转换都是纯函数；网络写入集中在 materializeStage。
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { FIELD_CN } from './graph-utils.js';
+
+const SOURCES = ['设定', 'raw', 'sources'];
+
+/**
+ * 机器内部仍用英文键组织代码，写进 wiki frontmatter 的 type 用中文。
+ * 这样 schema.json 的 type 契约、llm_wiki 的目录路由和用户看到的页面
+ * 都使用同一套中文类型名。
+ */
+export const TYPE = {
+  book: '书',
+  volume: '卷',
+  act: '幕',
+  chapter: '章',
+  requirement: '细纲要求',
+  scene: '场景',
+  character: '人物',
+  other_entity: '其他实体',
+  faction: '势力',
+  location: '地点',
+  item: '道具',
+  conflict: '冲突',
+  foreshadow: '伏笔',
+  climax: '高潮',
+  pleasure: '爽点',
+  ending: '结局',
+  world_rule: '世界观',
+  main_line: '主线',
+  branch: '支线',
+  relation: '关系',
+  faction_relation: '势力关系',
+  membership: '势力成员',
+  theme: '主题',
+  arc: '角色弧光',
+  character_state: '角色状态',
+  timeline_event: '时间线',
+  character_brief: '章节细纲',
+  info_gap: '信息差',
+  manuscript: '正文',
+  source: '来源',
+};
+
+function pageType(key) {
+  return TYPE[key] || key;
+}
+
+function readJson(file) {
+  try {
+    return JSON.parse(readFileSync(file, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function pad3(n) {
+  return String(n).padStart(3, '0');
+}
+
+function label(key) {
+  return (FIELD_CN && FIELD_CN[key]) || key;
+}
+
+const LONG_TEXT_KEYS = new Set([
+  'description', 'note', 'core_flaw', 'golden_finger', 'resolution_method',
+  'narrative_role_description', 'suppression_method', 'resource_seizure_path',
+  'main_line_connection', 'function', 'relation', 'symbolic_meaning',
+  'usage_scenario', 'appearance', 'origin', 'function_detail', 'limit',
+]);
+
+export function objectBody(title, obj) {
+  const lines = ['# ' + title, ''];
+  const entries = Object.entries(obj || {}).filter(([, value]) =>
+    value !== undefined && value !== null && value !== '');
+  if (!entries.length) {
+    lines.push('- （待补充）');
+    return lines.join('\n') + '\n';
+  }
+
+  // 顶层字段分两类：
+  //   · 短标量 → “基本信息”列表；
+  //   · 长文本 / 对象 / 多元素数组 → 独立小节。
+  // 这样人物页不会变成一长串“ID：/名称：/描述：”平铺列表，渲染后
+  // 目标、信息状态、语言档案、关系各自有标题，扫读成本低很多。
+  const basic = [];
+  const sections = [];
+  for (const [key, value] of entries) {
+    const isLongText = typeof value === 'string'
+      && (LONG_TEXT_KEYS.has(key) || value.length > 80 || value.includes('\n'));
+    const isArray = Array.isArray(value) && value.length > 2;
+    const isObject = value && typeof value === 'object';
+    if (isLongText || isArray || isObject) sections.push([key, value]);
+    else basic.push([key, value]);
+  }
+
+  if (basic.length) {
+    lines.push('## 基本信息');
+    for (const [key, value] of basic) lines.push('- ' + label(key) + '：' + inlineValue(value));
+    lines.push('');
+  }
+  for (const [key, value] of sections) {
+    lines.push('## ' + label(key));
+    if (typeof value === 'string') {
+      lines.push(value);
+    } else {
+      renderValueLines(value, 0, lines);
+    }
+    lines.push('');
+  }
+  return lines.join('\n').trimEnd() + '\n';
+}
+
+/** 渲染一个独立小节的值；对象/对象数组会继续展开成子标题。 */
+function renderValueLines(value, indent, lines) {
+  const pad = ' '.repeat(indent);
+  if (Array.isArray(value)) {
+    const allPrimitive = value.every((item) => item === null || typeof item !== 'object');
+    if (allPrimitive) {
+      for (const item of value) lines.push(pad + '- ' + inlineValue(item));
+      return;
+    }
+    for (const item of value) {
+      if (item === null || item === undefined) continue;
+      if (typeof item !== 'object') {
+        lines.push(pad + '- ' + inlineValue(item));
+        continue;
+      }
+      const heading = item.name || item.title || item.target_name || item.stage || item.id;
+      if (heading) lines.push(pad + '### ' + heading);
+      renderObjectLines(item, indent + (heading ? 2 : 0), lines);
+      lines.push('');
+    }
+    return;
+  }
+  if (value && typeof value === 'object') {
+    renderObjectLines(value, indent, lines);
+    return;
+  }
+  lines.push(pad + '- ' + inlineValue(value));
+}
+
+function inlineValue(value) {
+  if (value === undefined || value === null) return '';
+  if (Array.isArray(value)) return value.map((item) => inlineValue(item)).filter(Boolean).join('、');
+  if (typeof value === 'object') {
+    return Object.entries(value)
+      .filter(([, v]) => v !== undefined && v !== null && v !== '')
+      .map(([k, v]) => label(k) + '：' + inlineValue(v))
+      .join('；');
+  }
+  return String(value);
+}
+
+function renderObjectLines(obj, indent, lines) {
+  const pad = ' '.repeat(indent);
+  for (const [key, value] of Object.entries(obj || {})) {
+    if (value === undefined || value === null || value === '') continue;
+    const prefix = pad + '- ' + label(key) + '：';
+    if (Array.isArray(value)) {
+      if (value.length === 0) continue;
+      const allPrimitive = value.every((item) => item === null || typeof item !== 'object');
+      if (allPrimitive) {
+        lines.push(prefix + value.map((item) => inlineValue(item)).join('、'));
+      } else {
+        lines.push(prefix);
+        for (const item of value) {
+          if (item === null || item === undefined) continue;
+          if (typeof item === 'object') {
+            lines.push(' '.repeat(indent + 2) + '- ' + inlineValue(item));
+          } else {
+            lines.push(' '.repeat(indent + 2) + '- ' + inlineValue(item));
+          }
+        }
+      }
+      continue;
+    }
+    if (typeof value === 'object') {
+      lines.push(prefix);
+      renderObjectLines(value, indent + 2, lines);
+      continue;
+    }
+    lines.push(prefix + inlineValue(value));
+  }
+}
+
+function textBody(title, text) {
+  const value = String(text || '').trim();
+  return '# ' + title + '\n\n' + (value || '（待补充）') + '\n';
+}
+
+/** 在实体页末尾追加“按章生效”的时间线；已有同名小节时跳过。 */
+function appendTimelineSection(body, entries) {
+  const base = String(body || '').trimEnd();
+  if (!entries.length) return base;
+  if (base.includes('\n## 时间线（按章生效）')) return base;
+  return base + '\n\n## 时间线（按章生效）\n' + entries.join('\n') + '\n';
+}
+
+function addPage(pages, byId, page) {
+  if (!page || !page.id) return;
+  const existing = byId.get(page.id);
+  if (existing) {
+    existing.frontmatter = Object.assign({}, existing.frontmatter || {}, page.frontmatter || {});
+    if (page.body) existing.body = page.body;
+    return;
+  }
+  byId.set(page.id, page);
+  pages.push(page);
+}
+
+function entityPage(type, row, frontmatter) {
+  return {
+    type: pageType(type),
+    id: row.id,
+    title: row.name || row.id,
+    frontmatter: frontmatter || {},
+    body: type === 'conflict' ? conflictBody(row) : objectBody(row.name || row.id, row),
+  };
+}
+
+function otherEntityBody(row, relations) {
+  const b = row || {};
+  const lines = ['# ' + (b.name || b.id || '其他实体'), ''];
+  lines.push('## 基本信息');
+  lines.push('- ID：' + (b.id || ''));
+  lines.push('- 类别：' + (b.kind || '题材特有存在'));
+  if (b.note) lines.push('- 备注：' + b.note);
+  lines.push('');
+  if (Array.isArray(b.traits) && b.traits.length) {
+    lines.push('## 独有特征');
+    for (const x of b.traits) lines.push('- ' + x);
+    lines.push('');
+  }
+  if (Array.isArray(b.abilities) && b.abilities.length) {
+    lines.push('## 能力');
+    for (const x of b.abilities) lines.push('- ' + x);
+    lines.push('');
+  }
+  if (Array.isArray(b.limits) && b.limits.length) {
+    lines.push('## 限制');
+    for (const x of b.limits) lines.push('- ' + x);
+    lines.push('');
+  }
+  if (b.description) {
+    lines.push('## 描述');
+    lines.push(b.description);
+    lines.push('');
+  }
+  if (b.extensions && typeof b.extensions === 'object') {
+    lines.push('## 题材扩展');
+    for (const [k, v] of Object.entries(b.extensions)) {
+      if (v === undefined || v === null || v === '') continue;
+      lines.push('- ' + label(k) + '：' + inlineValue(v));
+    }
+    lines.push('');
+  }
+  const rows = (relations || []).filter((r) => r && (r.from === b.id || r.to === b.id));
+  if (rows.length) {
+    lines.push('## 与其他存在的关系');
+    for (const r of rows) {
+      const other = r.from === b.id ? r.to : r.from;
+      const direction = r.from === b.id ? '→' : '←';
+      lines.push('- ' + direction + ' [[' + other + ']]：' + (r.relation_label || r.description || '相关'));
+    }
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+function characterBody(row, otherRelations) {
+  let body = objectBody(row.name || row.id, row);
+  const rows = (otherRelations || []).filter((r) => r && (r.from === row.id || r.to === row.id));
+  if (!rows.length) return body;
+  const lines = ['', '## 特殊关系'];
+  for (const r of rows) {
+    const other = r.from === row.id ? r.to : r.from;
+    const direction = r.from === row.id ? '→' : '←';
+    lines.push('- ' + direction + ' [[' + other + ']]：' + (r.relation_label || r.description || '相关'));
+  }
+  return body.trimEnd() + '\n' + lines.join('\n') + '\n';
+}
+
+function relationBody(row, timelineRows, fleshChanges) {
+  const b = row || {};
+  const lines = ['# ' + (b.from || '?') + ' → ' + (b.to || '?'), ''];
+  lines.push('## 基本信息');
+  lines.push('- 起点：[[' + (b.from || '') + ']]');
+  lines.push('- 终点：[[' + (b.to || '') + ']]');
+  lines.push('- 关系类型：' + (b.relation_kind || ''));
+  if (b.relation_label) lines.push('- 关系标签：' + b.relation_label);
+  lines.push('');
+
+  const rows = timelineRows || [];
+  lines.push('## 时间线（按章生效）');
+  if (rows.length) {
+    for (const r of rows) {
+      const end = typeof r.end_chapter === 'number' ? r.end_chapter : null;
+      const range = '第 ' + r.start_chapter + (end !== null ? '–' + end : '') + ' 章';
+      lines.push('### ' + range + (r.stage ? ' · ' + r.stage : ''));
+      if (r.state) lines.push('- 阶段状态：' + r.state);
+      if (r.trigger_event) lines.push('- 触发事件：' + r.trigger_event);
+      if (r.description) lines.push('- 关系表现：' + r.description);
+      lines.push('- 写作提示：本章按“' + (r.state || r.stage || '当前阶段') + '”呈现；不要提前使用下一阶段的称谓、态度或亲密程度。');
+      lines.push('');
+    }
+  } else {
+    lines.push('- ⚠️ 尚未由节奏阶段定时：当前只有关系类型，无法给出每个阶段从哪一章开始。');
+    lines.push('- 请在节奏阶段补充 `relationship_timeline`，再同步本页。');
+    lines.push('');
+  }
+
+  const changes = fleshChanges || [];
+  if (changes.length) {
+    lines.push('## 血肉阶段记录的变化');
+    for (const c of changes) {
+      lines.push('- ' + (c.stage || '阶段') + '：' + (c.from || '') + ' → ' + (c.to || '') +
+        (c.trigger ? '；触发：' + c.trigger : '') +
+        (c.description ? '；' + c.description : ''));
+    }
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 势力关系的时间线。数据结构与人物关系一致，但主体是势力。
+ * 没有节奏时间线时明确写出“尚未定时”，避免把静态关系误当成全时段关系。
+ */
+function factionRelationBody(row, timelineRows) {
+  const b = row || {};
+  const lines = ['# ' + (b.from || '?') + ' ↔ ' + (b.to || '?'), ''];
+  lines.push('## 基本信息');
+  lines.push('- 势力 A：[[' + (b.from || '') + ']]');
+  lines.push('- 势力 B：[[' + (b.to || '') + ']]');
+  lines.push('- 关系类型：' + (b.relation_type || b.kind || ''));
+  if (b.description) lines.push('- 描述：' + b.description);
+  lines.push('');
+
+  lines.push('## 时间线（按章生效）');
+  const rows = timelineRows || [];
+  if (rows.length) {
+    for (const r of rows) {
+      const end = typeof r.end_chapter === 'number' ? r.end_chapter : null;
+      const range = '第 ' + r.start_chapter + (end !== null ? '–' + end : '') + ' 章';
+      lines.push('### ' + range + (r.stage ? ' · ' + r.stage : ''));
+      if (r.state) lines.push('- 阶段状态：' + r.state);
+      if (r.trigger_event) lines.push('- 触发事件：' + r.trigger_event);
+      if (r.description) lines.push('- 关系表现：' + r.description);
+      lines.push('- 写作提示：本章按“' + (r.state || r.stage || '当前阶段') + '”呈现；不要提前写后续阶段的合作/敌对程度。');
+      lines.push('');
+    }
+  } else {
+    lines.push('- ⚠️ 尚未由节奏阶段定时：当前只有关系类型，无法给出每个阶段从哪一章开始。');
+    lines.push('- 请在节奏阶段补充 `faction_relationship_timeline`，再同步本页。');
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+/**
+ * 骨架阶段：卷/幕/实体/关系/层级。
+ */
+export function pagesFromSkeleton(projectRoot) {
+  const dir = join(projectRoot, ...SOURCES, '骨架');
+  const frameworkRaw = readJson(join(dir, '框架.json'));
+  const entitiesRaw = readJson(join(dir, '实体.json'));
+  const relationsRaw = readJson(join(dir, '关系.json'));
+  const hierarchyRaw = readJson(join(dir, '层级.json'));
+  if (!frameworkRaw && !entitiesRaw && !relationsRaw && !hierarchyRaw) return [];
+  const framework = frameworkRaw || {};
+  const entities = entitiesRaw || {};
+  const relations = relationsRaw || {};
+  const hierarchy = hierarchyRaw || {};
+  const pages = [];
+  const byId = new Map();
+
+  const volumes = Array.isArray(hierarchy.volumes) ? hierarchy.volumes : [];
+  const volumeIds = volumes.map((v) => v.id).filter(Boolean);
+  const bookTitle = (framework.input_snapshot && framework.input_snapshot.book_name) || '未命名';
+  addPage(pages, byId, {
+    type: TYPE.book,
+    id: 'BOOK',
+    title: bookTitle,
+    frontmatter: { volumes: volumeIds },
+    body: objectBody(bookTitle, framework.input_snapshot || {}),
+  });
+
+  // 幕：骨架里没有 id，按全局顺序生成 A001…
+  const actIdByVolumeIndex = new Map();
+  const actsByVolume = new Map();
+  let actSeq = 0;
+  for (const act of (Array.isArray(hierarchy.acts) ? hierarchy.acts : [])) {
+    if (!act || !act.volume) continue;
+    const id = 'A' + pad3(++actSeq);
+    actIdByVolumeIndex.set(act.volume + ':' + act.act_index, id);
+    if (!actsByVolume.has(act.volume)) actsByVolume.set(act.volume, []);
+    actsByVolume.get(act.volume).push(id);
+    addPage(pages, byId, {
+      type: TYPE.act,
+      id,
+      title: act.theme_short || ('第 ' + act.act_index + ' 幕'),
+      frontmatter: { volume: act.volume, theme: act.theme_short || '' },
+      body: textBody(act.theme_short || ('第 ' + act.act_index + ' 幕'), act.theme_short),
+    });
+  }
+
+  const ratioByVolume = new Map();
+  for (const ratio of (Array.isArray(framework.volume_ratio) ? framework.volume_ratio : [])) {
+    if (ratio && ratio.volume_id) ratioByVolume.set(ratio.volume_id, ratio.chapter_ratio);
+  }
+
+  for (const volume of volumes) {
+    if (!volume || !volume.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.volume,
+      id: volume.id,
+      title: volume.name || volume.id,
+      frontmatter: {
+        theme: volume.theme_short || '',
+        chapter_ratio: ratioByVolume.get(volume.id),
+        acts: actsByVolume.get(volume.id) || [],
+      },
+      body: textBody(volume.name || volume.id, volume.theme_short),
+    });
+  }
+
+  const entitySpecs = [
+    ['characters', 'character', (row) => ({ role: row.type, gender: row.gender, age: row.age_group })],
+    ['other_entities', 'other_entity', (row) => ({ kind: row.kind })],
+    ['conflicts', 'conflict', (row) => ({ kind: row.type, scale: row.scale })],
+    ['factions', 'faction', (row) => ({ kind: row.type })],
+    ['locations', 'location', (row) => ({ kind: row.type, narrative_function: row.narrative_function })],
+    ['items', 'item', (row) => ({ category: row.category })],
+    ['endings', 'ending', (row) => ({ level: row.level, kind: row.type })],
+    ['foreshadows', 'foreshadow', (row) => ({ kind: row.type })],
+    ['climaxes', 'climax', (row) => ({ kind: row.type })],
+    ['pleasures', 'pleasure', (row) => ({ scale: row.scale, kind: row.kind })],
+    ['world_rules', 'world_rule', (row) => ({ category: row.category })],
+    ['main_lines', 'main_line', () => ({})],
+    ['branches', 'branch', (row) => ({ kind: row.type })],
+  ];
+
+  for (const [arrayKey, type, fields] of entitySpecs) {
+    for (const row of (Array.isArray(entities[arrayKey]) ? entities[arrayKey] : [])) {
+      if (!row || !row.id) continue;
+      addPage(pages, byId, entityPage(type, row, fields(row)));
+    }
+  }
+  for (const row of (Array.isArray(entities.other_entities) ? entities.other_entities : [])) {
+    if (!row || !row.id) continue;
+    const page = byId.get(row.id);
+    if (page) page.body = otherEntityBody(row, relations.other_relations || []);
+  }
+  for (const row of (Array.isArray(entities.characters) ? entities.characters : [])) {
+    if (!row || !row.id) continue;
+    const page = byId.get(row.id);
+    if (page) page.body = characterBody(row, relations.other_relations || []);
+  }
+
+  // 主题：每卷一个 theme page（theme_short 是卷级主题）。
+  // ID 跟卷号绑定（V001 → TH001），卷顺序变化时不会漂移。
+  volumes.forEach((volume, index) => {
+    if (!volume || !volume.id) return;
+    const volumeSeq = /^V(\d{3})$/.exec(volume.id);
+    addPage(pages, byId, {
+      type: TYPE.theme,
+      id: 'TH' + (volumeSeq ? volumeSeq[1] : pad3(index + 1)),
+      title: volume.theme_short || volume.name || volume.id,
+      frontmatter: { volumes: [volume.id], statement: volume.theme_short || '' },
+      body: textBody(volume.theme_short || volume.name || volume.id, volume.theme_short),
+    });
+  });
+
+  // 角色关系 -> relation page
+  let relationSeq = 0;
+  for (const row of (Array.isArray(relations.character_relations) ? relations.character_relations : [])) {
+    if (!row || !row.from || !row.to) continue;
+    const id = 'REL' + pad3(++relationSeq);
+    addPage(pages, byId, {
+      type: TYPE.relation,
+      id,
+      title: row.from + '-' + row.to,
+      frontmatter: { from: row.from, to: row.to, kind: row.relation_kind, label: row.relation_label || undefined },
+      body: relationBody(row),
+    });
+  }
+
+  // 势力关系 -> faction_relation page
+  let factionRelationSeq = 0;
+  for (const row of (Array.isArray(relations.faction_relations) ? relations.faction_relations : [])) {
+    if (!row || !row.from || !row.to) continue;
+    const id = 'FREL' + pad3(++factionRelationSeq);
+    addPage(pages, byId, {
+      type: TYPE.faction_relation,
+      id,
+      title: row.from + '-' + row.to,
+      frontmatter: { from: row.from, to: row.to, kind: row.relation_type },
+      body: factionRelationBody(row),
+    });
+  }
+
+  // 势力成员 -> membership page + 角色 faction 字段
+  let membershipSeq = 0;
+  for (const row of (Array.isArray(relations.faction_membership) ? relations.faction_membership : [])) {
+    if (!row || !row.character || !row.faction) continue;
+    const id = 'MEM' + pad3(++membershipSeq);
+    addPage(pages, byId, {
+      type: TYPE.membership,
+      id,
+      title: row.character + '@' + row.faction,
+      frontmatter: {
+        character: row.character,
+        faction: row.faction,
+        kind: row.member_relation,
+        position: row.position_level,
+      },
+      body: textBody(row.character + '@' + row.faction, '成员关系：' + row.member_relation),
+    });
+    const character = byId.get(row.character);
+    if (character && !character.frontmatter.faction) {
+      character.frontmatter.faction = row.faction;
+    }
+  }
+
+  // 冲突参与方 -> conflict.characters
+  for (const row of (Array.isArray(relations.conflict_participants) ? relations.conflict_participants : [])) {
+    if (!row || !row.conflict) continue;
+    const ids = [];
+    for (const value of [row.protagonist_side, row.main_antagonist, row.secondary_antagonist, row.third_party]) {
+      if (Array.isArray(value)) ids.push(...value);
+      else if (value) ids.push(value);
+    }
+    const conflict = byId.get(row.conflict);
+    if (conflict) conflict.frontmatter.characters = [...new Set(ids)];
+  }
+
+  // 支线主角
+  for (const row of (Array.isArray(relations.branch_protagonist) ? relations.branch_protagonist : [])) {
+    const branch = row && byId.get(row.branch);
+    if (branch && row.character) branch.frontmatter.protagonist = row.character;
+  }
+
+  // 道具归属
+  for (const row of (Array.isArray(relations.item_owner) ? relations.item_owner : [])) {
+    const item = row && byId.get(row.item);
+    if (!item || !row.owner_id) continue;
+    if (String(row.owner_id).startsWith('C')) item.frontmatter.owner_character = row.owner_id;
+    else if (String(row.owner_id).startsWith('F')) item.frontmatter.owner_faction = row.owner_id;
+  }
+
+  // 地点冲突
+  for (const row of (Array.isArray(relations.location_conflict) ? relations.location_conflict : [])) {
+    const location = row && byId.get(row.location);
+    if (location) location.frontmatter.conflicts = Array.isArray(row.conflicts) ? row.conflicts : [];
+  }
+
+  // 结局角色
+  for (const row of (Array.isArray(relations.ending_character) ? relations.ending_character : [])) {
+    const ending = row && byId.get(row.ending);
+    if (ending) ending.frontmatter.characters = row.character ? [row.character] : [];
+  }
+
+  // 支线挂主线
+  for (const row of (Array.isArray(relations.main_line_branch_relation) ? relations.main_line_branch_relation : [])) {
+    const branch = row && byId.get(row.branch);
+    if (branch) branch.frontmatter.main_line = row.main_line;
+  }
+
+  // 主线/支线跨卷
+  for (const span of (Array.isArray(hierarchy.main_line_span) ? hierarchy.main_line_span : [])) {
+    const mainLine = span && byId.get(span.main_line);
+    if (!mainLine) continue;
+    mainLine.frontmatter.volumes = (span.volume_ratio || [])
+      .map((ratio, index) => (ratio > 0 ? volumeIds[index] : null))
+      .filter(Boolean);
+  }
+  for (const span of (Array.isArray(hierarchy.branch_span) ? hierarchy.branch_span : [])) {
+    const branch = span && byId.get(span.branch);
+    if (!branch) continue;
+    branch.frontmatter.volumes = (span.volume_ratio || [])
+      .map((ratio, index) => (ratio > 0 ? volumeIds[index] : null))
+      .filter(Boolean);
+  }
+
+  return pages;
+}
+
+const FLESH_SPECS = [
+  ['角色.json', 'characters', 'character'],
+  ['其他实体.json', 'other_entities', 'other_entity'],
+  ['冲突.json', 'conflicts', 'conflict'],
+  ['势力.json', 'factions', 'faction'],
+  ['剧情.json', 'main_lines', 'main_line'],
+  ['剧情.json', 'branches', 'branch'],
+  ['地点.json', 'locations', 'location'],
+  ['结局.json', 'endings', 'ending'],
+  ['世界观规则.json', 'core_rules', 'world_rule'],
+  ['世界观规则.json', 'information_rules', 'world_rule'],
+  ['世界观规则.json', 'social_rules', 'world_rule'],
+  ['关键道具.json', 'core_items', 'item'],
+  ['关键道具.json', 'branch_items', 'item'],
+  ['关键道具.json', 'symbolic_items', 'item'],
+];
+
+/**
+ * 血肉阶段：把详情写回骨架已创建的实体页；preserveFrontmatter=true。
+ */
+export function pagesFromFlesh(projectRoot) {
+  const dir = join(projectRoot, ...SOURCES, '血肉');
+  const skeletonRelations = readJson(join(projectRoot, ...SOURCES, '骨架', '关系.json')) || {};
+  const pages = [];
+  const byId = new Map();
+  let found = false;
+  for (const [file, arrayKey, type] of FLESH_SPECS) {
+    const data = readJson(join(dir, file));
+    if (data) found = true;
+    const rows = data && Array.isArray(data[arrayKey]) ? data[arrayKey] : [];
+    for (const row of rows) {
+      if (!row || !row.id) continue;
+      addPage(pages, byId, {
+        type: pageType(type),
+        id: row.id,
+        title: row.name || row.id,
+        frontmatter: {},
+        body: type === 'conflict' ? conflictBody(row)
+          : (type === 'other_entity' ? otherEntityBody(row, skeletonRelations.other_relations || [])
+            : (type === 'character' ? characterBody(row, skeletonRelations.other_relations || []) : objectBody(row.name || row.id, row))),
+      });
+    }
+  }
+  return found ? pages : [];
+}
+
+function actMap(projectRoot) {
+  const hierarchy = readJson(join(projectRoot, ...SOURCES, '骨架', '层级.json')) || {};
+  const map = new Map();
+  const byVolume = new Map();
+  let seq = 0;
+  for (const act of (Array.isArray(hierarchy.acts) ? hierarchy.acts : [])) {
+    if (!act || !act.volume) continue;
+    const id = 'A' + pad3(++seq);
+    map.set(act.volume + ':' + act.act_index, id);
+    if (!byVolume.has(act.volume)) byVolume.set(act.volume, []);
+    byVolume.get(act.volume).push(id);
+  }
+  return { map, byVolume };
+}
+
+function outlineRequirementSpecs(outline) {
+  if (!outline || typeof outline !== 'object') return [];
+  const fields = [
+    ['function_main', 'function', '主功能'],
+    ['function_aux', 'function', '辅功能'],
+    ['emotion_phase', 'emotion', '情绪阶段'],
+    ['foreshadow_action', 'foreshadow', '伏笔动作'],
+    ['faction_appearance', 'faction', '势力出场'],
+    ['hook_head', 'hook_head', '章首钩子'],
+    ['hook_tail', 'hook_tail', '章尾钩子'],
+    ['satisfaction_type', 'pleasure', '爽点'],
+  ];
+  return fields
+    .filter(([key]) => typeof outline[key] === 'string' && outline[key].trim())
+    .map(([key, kind, title]) => ({ kind, title, text: outline[key].trim() }));
+}
+
+/**
+ * 节奏阶段：章节 / 细纲要求 / 场景。
+ */
+export function pagesFromRhythm(projectRoot) {
+  const dir = join(projectRoot, ...SOURCES, '节奏');
+  const plan = readJson(join(dir, '章节规划.json')) || {};
+  const timeline = readJson(join(dir, '时序映射.json')) || {};
+  const outlines = readJson(join(dir, '章节细纲.json')) || {};
+  const { map: actByVolumeIndex, byVolume } = actMap(projectRoot);
+  const fallbackAct = actByVolumeIndex.values().next().value || '';
+  if (!plan || !Array.isArray(plan.chapters) || plan.chapters.length === 0) {
+    return { pages: [], chapterIds: [], outlineByChapter: new Map() };
+  }
+  const pages = [];
+  const byId = new Map();
+  const chapterIds = [];
+  const chaptersByAct = new Map();
+  const outlineByChapter = new Map();
+  for (const outline of (Array.isArray(outlines.outlines) ? outlines.outlines : [])) {
+    if (outline && typeof outline.ch === 'number') outlineByChapter.set(outline.ch, outline);
+  }
+  const hooksByChapter = new Map();
+  for (const hook of (Array.isArray(timeline.hook_timeline) ? timeline.hook_timeline : [])) {
+    if (hook && typeof hook.ch === 'number') hooksByChapter.set(hook.ch, hook);
+  }
+
+  for (const row of (Array.isArray(plan.chapters) ? plan.chapters : [])) {
+    if (!row || typeof row.ch !== 'number') continue;
+    const id = 'CH' + pad3(row.ch);
+    chapterIds.push(id);
+    const actId = actByVolumeIndex.get(row.volume + ':' + row.act) || (byVolume.get(row.volume) || [])[0] || fallbackAct;
+    if (actId) {
+      if (!chaptersByAct.has(actId)) chaptersByAct.set(actId, []);
+      chaptersByAct.get(actId).push(id);
+    }
+    const outline = outlineByChapter.get(row.ch);
+    const hook = hooksByChapter.get(row.ch);
+    const requirements = [];
+    const scenes = [];
+    // 新版每章有独立细纲文件时，不再为每个字段生成一条“细纲要求”页：
+    // 那些页面是旧版按字段拆分的视图，会被章节细纲页取代，数量还很多。
+    const hasBrief = existsSync(join(dir, '细纲', '第' + pad3(row.ch) + '章.json'));
+    const specs = hasBrief ? [] : outlineRequirementSpecs(outline);
+    if (!hasBrief && specs.length === 0 && hook) {
+      if (hook.hook_head) specs.push({ kind: 'hook_head', title: '章首钩子', text: hook.hook_head });
+      if (hook.hook_tail) specs.push({ kind: 'hook_tail', title: '章尾钩子', text: hook.hook_tail });
+    }
+    specs.forEach((spec, index) => {
+      const reqId = 'RQ-' + id + '-' + String(index + 1).padStart(2, '0');
+      requirements.push(reqId);
+      addPage(pages, byId, {
+        type: TYPE.requirement,
+        id: reqId,
+        title: id + ' ' + spec.title,
+        frontmatter: { chapter: id, kind: spec.kind, text: spec.text, status: 'planned' },
+        body: textBody(id + ' ' + spec.title, spec.text),
+      });
+    });
+    if (row.scene_focus) {
+      const sceneId = 'SCN-' + id + '-01';
+      scenes.push(sceneId);
+      addPage(pages, byId, {
+        type: TYPE.scene,
+        id: sceneId,
+        title: id + ' 场景',
+        frontmatter: { chapter: id, focus: row.scene_focus },
+        body: textBody(id + ' 场景', row.scene_focus),
+      });
+    }
+    addPage(pages, byId, {
+      type: TYPE.chapter,
+      id,
+      title: '第' + row.ch + '章',
+      frontmatter: {
+        act: actId,
+        volume: row.volume,
+        requirements,
+        scenes,
+        brief: existsSync(join(dir, '细纲', '第' + pad3(row.ch) + '章.json')) ? 'OB-' + id : undefined,
+        word_target: outline && typeof outline.word_target === 'number' ? outline.word_target : 0,
+      },
+      body: textBody('第' + row.ch + '章', row.scene_focus || ''),
+    });
+  }
+
+  const chapterVolume = new Map();
+  for (const row of (Array.isArray(plan.chapters) ? plan.chapters : [])) {
+    if (row && typeof row.ch === 'number') chapterVolume.set('CH' + pad3(row.ch), row.volume);
+  }
+
+  // 角色状态 / 弧光：把 character_timeline 的出场区间和 arc_stages 落成对象页。
+  for (const row of (Array.isArray(timeline.character_timeline) ? timeline.character_timeline : [])) {
+    if (!row || !row.char_id || typeof row.appear_start !== 'number') continue;
+    const startChapter = 'CH' + pad3(row.appear_start);
+    const startState = 'CS-' + row.char_id + '-' + startChapter;
+    addPage(pages, byId, {
+      type: TYPE.character_state,
+      id: startState,
+      title: row.char_id + '@' + startChapter,
+      frontmatter: { character: row.char_id, chapter: startChapter },
+      body: textBody(row.char_id + '@' + startChapter, '出场区间：第 ' + row.appear_start + '–' + row.appear_end + ' 章'),
+    });
+
+    for (const stage of (Array.isArray(row.arc_stages) ? row.arc_stages : [])) {
+      if (!stage || typeof stage.chapter !== 'number') continue;
+      const stageChapter = 'CH' + pad3(stage.chapter);
+      const stageState = 'CS-' + row.char_id + '-' + stageChapter;
+      addPage(pages, byId, {
+        type: TYPE.character_state,
+        id: stageState,
+        title: row.char_id + '@' + stageChapter,
+        frontmatter: { character: row.char_id, chapter: stageChapter },
+        body: textBody(row.char_id + '@' + stageChapter, stage.stage_name || ''),
+      });
+      const volume = chapterVolume.get(stageChapter) || chapterVolume.get(startChapter) || '';
+      if (!volume) continue;
+      const arcId = 'ARC-' + row.char_id + '-' + volume;
+      let arc = byId.get(arcId);
+      if (!arc) {
+        arc = {
+          type: TYPE.arc,
+          id: arcId,
+          title: row.char_id + '@' + volume,
+          frontmatter: { character: row.char_id, volume, stages: [] },
+          body: textBody(row.char_id + '@' + volume, ''),
+        };
+        addPage(pages, byId, arc);
+      }
+      if (!arc.frontmatter.stages.includes(stageState)) arc.frontmatter.stages.push(stageState);
+      arc.body = textBody(row.char_id + '@' + volume, (arc.frontmatter.stages || []).join(' → '));
+    }
+  }
+
+  // 伏笔/高潮/爽点/结局的章节位置在骨架里没有，只在节奏的时序映射里出现。
+  // 用骨架实体页做底稿，补上 chapter 链接后重新 upsert，impact 才能从这些
+  // 对象走到章节。
+  const chapterLink = (value) =>
+    typeof value === 'number' ? 'CH' + pad3(value) : undefined;
+  const baseEntities = new Map();
+  for (const page of pagesFromSkeleton(projectRoot)) {
+    baseEntities.set(page.id, page);
+  }
+  // 节奏阶段重新物化页面时，实体页要以血肉详情为底稿；
+  // 只用骨架页会把 traits / description / abilities 覆盖回空壳。
+  for (const page of pagesFromFlesh(projectRoot)) {
+    baseEntities.set(page.id, page);
+  }
+  const updateEntity = (id, updates) => {
+    const base = baseEntities.get(id);
+    if (!base) return;
+    const frontmatter = { ...base.frontmatter };
+    for (const [key, value] of Object.entries(updates)) {
+      if (value !== undefined) frontmatter[key] = value;
+    }
+    addPage(pages, byId, {
+      type: base.type,
+      id: base.id,
+      title: base.title,
+      frontmatter,
+      body: base.body,
+    });
+  };
+
+  for (const row of (Array.isArray(timeline.foreshadow_timeline) ? timeline.foreshadow_timeline : [])) {
+    if (!row || !row.fs_id) continue;
+    updateEntity(row.fs_id, {
+      buried_chapter: chapterLink(row.buried_chapter),
+      recovered_chapter: chapterLink(row.recovered_chapter),
+    });
+  }
+  for (const row of (Array.isArray(timeline.climax_timeline) ? timeline.climax_timeline : [])) {
+    if (!row || !row.climax_id) continue;
+    updateEntity(row.climax_id, { chapter: chapterLink(row.chapter) });
+  }
+  for (const row of (Array.isArray(timeline.pleasure_timeline) ? timeline.pleasure_timeline : [])) {
+    if (!row || !row.pleasure_id) continue;
+    updateEntity(row.pleasure_id, { chapter: chapterLink(row.chapter) });
+  }
+  for (const row of (Array.isArray(timeline.ending_timeline) ? timeline.ending_timeline : [])) {
+    if (!row || !row.ending_id) continue;
+    updateEntity(row.ending_id, { chapter: chapterLink(row.chapter) });
+  }
+
+  // 时间线事件：主线关键节点、冲突升级节点、支线交织点。
+  let timelineSeq = 0;
+  const nextTimelineId = () => 'T' + pad3(++timelineSeq);
+  for (const row of (Array.isArray(timeline.main_line_timeline) ? timeline.main_line_timeline : [])) {
+    if (!row || !row.main_id) continue;
+    for (const node of (Array.isArray(row.key_nodes) ? row.key_nodes : [])) {
+      if (!node || typeof node.chapter !== 'number') continue;
+      const id = nextTimelineId();
+      addPage(pages, byId, {
+        type: TYPE.timeline_event,
+        id,
+        title: '主线 ' + row.main_id + ' 第' + node.chapter + '章',
+        frontmatter: {
+          chapter: 'CH' + pad3(node.chapter),
+          main_line: row.main_id,
+          description: node.event_ref || '',
+        },
+        body: textBody('主线 ' + row.main_id + ' 第' + node.chapter + '章', node.event_ref || ''),
+      });
+    }
+  }
+  for (const row of (Array.isArray(timeline.conflict_timeline) ? timeline.conflict_timeline : [])) {
+    if (!row || !row.conflict_id) continue;
+    for (const node of (Array.isArray(row.escalation_nodes) ? row.escalation_nodes : [])) {
+      if (!node || typeof node.chapter !== 'number') continue;
+      const id = nextTimelineId();
+      addPage(pages, byId, {
+        type: TYPE.timeline_event,
+        id,
+        title: row.conflict_id + ' 第' + node.chapter + '章',
+        frontmatter: {
+          chapter: 'CH' + pad3(node.chapter),
+          conflict: row.conflict_id,
+          description: node.node_type || '',
+        },
+        body: textBody(row.conflict_id + ' 第' + node.chapter + '章', node.node_type || ''),
+      });
+    }
+  }
+  for (const row of (Array.isArray(timeline.branch_timeline) ? timeline.branch_timeline : [])) {
+    if (!row || !row.branch_id) continue;
+    for (const node of (Array.isArray(row.interweaves) ? row.interweaves : [])) {
+      if (!node || typeof node.chapter !== 'number') continue;
+      const id = nextTimelineId();
+      addPage(pages, byId, {
+        type: TYPE.timeline_event,
+        id,
+        title: row.branch_id + ' 第' + node.chapter + '章',
+        frontmatter: {
+          chapter: 'CH' + pad3(node.chapter),
+          branch: row.branch_id,
+          description: node.description || '',
+        },
+        body: textBody(row.branch_id + ' 第' + node.chapter + '章', node.description || ''),
+      });
+    }
+  }
+
+  // 关系页补上阶段变化：骨架只给初始关系，节奏阶段才知道从第几章开始变。
+  const fleshCharsRaw = readJson(join(projectRoot, ...SOURCES, '血肉', '角色.json')) || {};
+  const fleshChangesByPair = new Map();
+  for (const c of (Array.isArray(fleshCharsRaw.characters) ? fleshCharsRaw.characters : [])) {
+    if (!c || !c.id) continue;
+    for (const rel of (Array.isArray(c.relationships) ? c.relationships : [])) {
+      if (!rel || !Array.isArray(rel.changes) || rel.changes.length === 0) continue;
+      const target = (Array.isArray(fleshCharsRaw.characters) ? fleshCharsRaw.characters : [])
+        .find((x) => x && x.name === rel.target_name);
+      if (!target || !target.id) continue;
+      const key = [c.id, target.id].sort().join('↔');
+      if (!fleshChangesByPair.has(key)) fleshChangesByPair.set(key, []);
+      fleshChangesByPair.get(key).push(...rel.changes);
+    }
+  }
+  for (const base of baseEntities.values()) {
+    if (!base || base.type !== TYPE.relation) continue;
+    const from = base.frontmatter && base.frontmatter.from;
+    const to = base.frontmatter && base.frontmatter.to;
+    if (!from || !to) continue;
+    const key = [from, to].sort().join('↔');
+    const rows = (timeline.relationship_timeline || []).filter((r) =>
+      r && [r.from, r.to].sort().join('↔') === key);
+    addPage(pages, byId, {
+      type: TYPE.relation,
+      id: base.id,
+      title: base.title,
+      frontmatter: { ...base.frontmatter },
+      body: relationBody({ from, to, relation_kind: base.frontmatter.kind, relation_label: base.frontmatter.label }, rows, fleshChangesByPair.get(key) || []),
+    });
+  }
+
+  // 势力关系同样按节奏时间线补阶段；骨架只给初始关系类型。
+  for (const base of baseEntities.values()) {
+    if (!base || base.type !== TYPE.faction_relation) continue;
+    const from = base.frontmatter && base.frontmatter.from;
+    const to = base.frontmatter && base.frontmatter.to;
+    if (!from || !to) continue;
+    const key = [from, to].sort().join('↔');
+    const rows = (timeline.faction_relationship_timeline || []).filter((r) =>
+      r && [r.from, r.to].sort().join('↔') === key);
+    addPage(pages, byId, {
+      type: TYPE.faction_relation,
+      id: base.id,
+      title: base.title,
+      frontmatter: { ...base.frontmatter },
+      body: factionRelationBody({ from, to, relation_type: base.frontmatter.kind }, rows),
+    });
+  }
+
+  // 角色 / 地点 / 道具的出场区间也写到实体页上。
+  // 这样写作阶段不只知道“关系怎么变”，还知道“这个对象哪几章能用”。
+  const appendEntityTimeline = (base, entries) => {
+    if (!base) return;
+    addPage(pages, byId, {
+      type: base.type,
+      id: base.id,
+      title: base.title,
+      frontmatter: { ...base.frontmatter },
+      body: appendTimelineSection(base.body, entries),
+    });
+  };
+  for (const row of (timeline.character_timeline || [])) {
+    if (!row || !row.char_id) continue;
+    const base = baseEntities.get(row.char_id);
+    if (!base) continue;
+    const entries = [];
+    if (typeof row.appear_start === 'number' && typeof row.appear_end === 'number') {
+      entries.push('- 出场区间：第 ' + row.appear_start + '–' + row.appear_end + ' 章。');
+    }
+    if (typeof row.exit_chapter === 'number') {
+      entries.push('- 退场章：第 ' + row.exit_chapter + ' 章；退场后不得再出场。');
+    }
+    for (const stage of (row.arc_stages || [])) {
+      if (stage && stage.stage_name && typeof stage.chapter === 'number') {
+        entries.push('- 第 ' + stage.chapter + ' 章起：弧光进入「' + stage.stage_name + '」。');
+      }
+    }
+    if (entries.length) {
+      entries.push('- 写作提示：出场区间外不要无故让该角色出现；阶段未到之前不要提前写下一阶段的心态。');
+      appendEntityTimeline(base, entries);
+    }
+  }
+  for (const [key, idField, label] of [
+    ['location_timeline', 'loc_id', '地点'],
+    ['item_timeline', 'item_id', '道具'],
+  ]) {
+    for (const row of (timeline[key] || [])) {
+      if (!row || !row[idField]) continue;
+      const base = baseEntities.get(row[idField]);
+      if (!base) continue;
+      if (typeof row.appear_start !== 'number' || typeof row.appear_end !== 'number') continue;
+      appendEntityTimeline(base, [
+        '- 可用区间：第 ' + row.appear_start + '–' + row.appear_end + ' 章。',
+        '- 写作提示：区间外不要把' + label + '当作当前场景/在手道具；需要提前出现时必须先补节奏时间线。',
+      ]);
+    }
+  }
+
+  // 幕页补上章节列表：impact 从幕可以直接走到章节，而不是绕回卷。
+  for (const [actId, ids] of chaptersByAct) {
+    updateEntity(actId, { chapters: ids });
+  }
+
+  return { pages, chapterIds, outlineByChapter };
+}
+
+
+/**
+ * 独立档案 / 每章细纲：把 设定/raw/sources/档案 与 节奏/细纲 变成页面。
+ *
+ * 这些页面和骨架/血肉/节奏页共用 ID：
+ *   - 伏笔/爽点/冲突页会被后写入的档案 body 补全；
+ *   - 信息差、章节细纲是新页面类型。
+ */
+
+function statusCn(value) {
+  const map = {
+    planned: '计划中', open: '未解决', created: '已创建', resolved: '已解决',
+    invalid: '异常', draft: '草稿', done: '完成', revised: '已修订', stub: '占位', archived: '归档'
+  };
+  return map[String(value || '')] || String(value || '');
+}
+
+function briefBody(row) {
+  const b = row || {};
+  const lines = ['# 第' + (b.ch || '?') + '章 细纲', ''];
+  lines.push('## 基本信息');
+  lines.push('- 章节：第 ' + (b.ch || '?') + ' 章');
+  lines.push('- 卷 / 幕：' + (b.volume || '未指定') + ' / ' + (b.act || '未指定'));
+  lines.push('- 视角：' + (b.pov_name || b.pov || '未指定'));
+  if (b.scene_focus) lines.push('- 场景焦点：' + b.scene_focus);
+  if (b.function_main) lines.push('- 主功能：' + b.function_main);
+  if (b.function_aux) lines.push('- 辅助功能：' + b.function_aux);
+  if (b.emotion) lines.push('- 情绪：' + (b.emotion.phase || '') + (b.emotion.value !== null && b.emotion.value !== undefined ? '（强度 ' + b.emotion.value + '）' : ''));
+  if (b.word_target) lines.push('- 目标字数：' + b.word_target);
+  if (b.hooks) lines.push('- 钩子：章首 ' + (b.hooks.head || '未指定') + ' / 章尾 ' + (b.hooks.tail || '未指定') + (b.hooks.strength ? '（强度 ' + b.hooks.strength + '）' : ''));
+  lines.push('');
+
+  const cast = Array.isArray(b.cast) ? b.cast : [];
+  if (cast.length) {
+    lines.push('## 出场角色');
+    for (const c of cast) lines.push('- ' + (c.name || c.id) + '（' + c.id + '）：' + (c.role || '') + (c.reason ? '，' + c.reason : ''));
+    lines.push('');
+  }
+  if (b.location) lines.push('## 场景\n- ' + (b.location.name || b.location.id) + '（' + b.location.id + '）\n');
+  if (Array.isArray(b.items) && b.items.length) {
+    lines.push('## 关键道具');
+    for (const x of b.items) lines.push('- ' + (x.name || x.id) + '（' + x.id + '）');
+    lines.push('');
+  }
+
+  const events = Array.isArray(b.timeline_events) ? b.timeline_events : [];
+  if (events.length) {
+    lines.push('## 本章时间线');
+    for (const e of events) lines.push('- ' + (e.type || '事件') + '：' + (e.description || e.ref || ''));
+    lines.push('');
+  }
+
+  const relChanges = Array.isArray(b.relationship_changes) ? b.relationship_changes : [];
+  if (relChanges.length) {
+    lines.push('## 本章关系变化');
+    for (const r of relChanges) {
+      lines.push('- ' + (r.from_name || r.from) + ' → ' + (r.to_name || r.to) + '：' +
+        (r.stage ? '【' + r.stage + '】' : '') + (r.state || '') +
+        (r.trigger_event ? '；触发：' + r.trigger_event : ''));
+    }
+    lines.push('');
+  }
+
+  const conflicts = Array.isArray(b.conflicts) ? b.conflicts : [];
+  if (conflicts.length) {
+    lines.push('## 本章冲突');
+    for (const x of conflicts) lines.push('- ' + (x.name || x.id) + '（' + x.id + '）：' + (x.node_type || '推进'));
+    lines.push('');
+  }
+
+  const fsActions = Array.isArray(b.foreshadow_actions) ? b.foreshadow_actions : [];
+  if (fsActions.length) {
+    lines.push('## 本章伏笔动作');
+    for (const x of fsActions) lines.push('- ' + (x.action || '处理') + ' ' + (x.id || '') + '（' + (x.name || '') + '）');
+    lines.push('');
+  }
+
+  const big = [];
+  if (b.climax) big.push('高潮：' + (b.climax.name || b.climax.id) + '（' + b.climax.id + '）');
+  if (b.pleasure) big.push('爽点：' + (b.pleasure.name || b.pleasure.id) + '（' + b.pleasure.id + '）');
+  if (b.ending) big.push('结局节点：' + (b.ending.name || b.ending.id) + '（' + b.ending.id + '）');
+  if (big.length) lines.push('## 本章必须兑现\n' + big.map((x) => '- ' + x).join('\n') + '\n');
+
+  const gaps = Array.isArray(b.information_gaps) ? b.information_gaps : [];
+  if (gaps.length) {
+    lines.push('## 本章信息差');
+    for (const g of gaps) {
+      lines.push('- ' + (g.info_name || g.id) + '（' + g.id + '，' + (g.status === 'created' ? '本章创建' : g.status === 'resolved' ? '本章解决' : '仍未解决') + '）');
+      if (g.who_knows && g.who_knows.length) lines.push('  - 已知：' + g.who_knows.join('、'));
+      if (g.who_does_not_know && g.who_does_not_know.length) lines.push('  - 尚不知道：' + g.who_does_not_know.join('、'));
+      if (g.resolution_method) lines.push('  - 解决方式：' + g.resolution_method);
+      for (const line of (g.forbidden_mentions || [])) lines.push('  - 禁止：' + line);
+    }
+    lines.push('');
+  }
+
+  const boundaries = Array.isArray(b.information_boundaries) ? b.information_boundaries : [];
+  if (boundaries.length) {
+    lines.push('## 角色信息边界（不能写漏）');
+    for (const x of boundaries) {
+      if (x.unknown_secrets) lines.push('- ' + (x.name || x.id) + '（' + x.id + '）不知道：' + x.unknown_secrets);
+      if (x.false_beliefs) lines.push('- ' + (x.name || x.id) + '（' + x.id + '）误以为：' + x.false_beliefs);
+    }
+    lines.push('');
+  }
+
+  const how = b.how_to_write || {};
+  if (how && Object.keys(how).length) {
+    lines.push('## 怎么写');
+    if (how.pov_rule) lines.push('- 视角规则：' + how.pov_rule);
+    if (how.opening && how.opening.technique) lines.push('- 开场技法（' + (how.opening.hook_type || '') + '）：' + how.opening.technique);
+    if (how.ending && how.ending.technique) lines.push('- 收束技法（' + (how.ending.hook_type || '') + '）：' + how.ending.technique);
+    for (const beat of (how.scene_beats || [])) {
+      lines.push('- ' + (beat.name || '节拍') + '：' + (beat.goal || ''));
+      for (const x of (beat.must || [])) lines.push('  - 必须：' + x);
+      for (const x of (beat.avoid || [])) lines.push('  - 避免：' + x);
+    }
+    lines.push('');
+  }
+
+  const must = Array.isArray(b.must_write) ? b.must_write : [];
+  if (must.length) {
+    lines.push('## 必须写');
+    for (const x of must) lines.push('- ' + x);
+    lines.push('');
+  }
+  const forbidden = Array.isArray(b.must_not_write) ? b.must_not_write : [];
+  if (forbidden.length) {
+    lines.push('## 绝对不能写');
+    for (const x of forbidden) lines.push('- ' + x);
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+function conflictBody(row) {
+  const b = row || {};
+  const lines = ['# ' + (b.name || b.id || '冲突'), ''];
+  lines.push('## 基本信息');
+  lines.push('- ID：' + (b.id || ''));
+  if (b.type) lines.push('- 类型：' + b.type);
+  if (b.scale) lines.push('- 范围：' + b.scale);
+  if (b.participant_names && b.participant_names.length) lines.push('- 参与方：' + b.participant_names.join('、'));
+  else if (b.participants && b.participants.length) lines.push('- 参与方：' + b.participants.join('、'));
+  if (b.description) lines.push('- 描述：' + b.description);
+  if (b.core_goal) lines.push('- 核心目标：' + b.core_goal);
+  if (b.influence_scope) lines.push('- 影响范围：' + b.influence_scope);
+  if (b.focus_points && b.focus_points.length) lines.push('- 焦点：' + b.focus_points.join('、'));
+  lines.push('');
+
+  lines.push('## 矛盾结构');
+  if (b.surface_contradiction) lines.push('- 表层矛盾：' + b.surface_contradiction);
+  if (b.deep_contradiction) lines.push('- 深层矛盾：' + b.deep_contradiction);
+  if (b.ultimate_contradiction) lines.push('- 终极矛盾：' + b.ultimate_contradiction);
+  lines.push('');
+
+  const path = Array.isArray(b.escalation_path) ? b.escalation_path : [];
+  if (path.length) {
+    lines.push('## 升级路径（血肉内容）');
+    for (const node of path) lines.push('- ' + (node.node_type || '节点') + '：' + (node.description || ''));
+    lines.push('');
+  }
+  const nodes = Array.isArray(b.escalation_nodes) ? b.escalation_nodes : [];
+  if (nodes.length) {
+    lines.push('## 章节落点（节奏时间线）');
+    for (const node of nodes) lines.push('- ' + (node.node_type || '节点') + '：第 ' + node.chapter + ' 章');
+    if (typeof b.resolution_chapter === 'number') lines.push('- 解决章：第 ' + b.resolution_chapter + ' 章');
+    lines.push('');
+  }
+  if (b.resolution_plan) {
+    lines.push('## 收束方案');
+    if (b.resolution_plan.method) lines.push('- 方式：' + b.resolution_plan.method);
+    if (b.resolution_plan.residual_impact) lines.push('- 余波影响：' + b.resolution_plan.residual_impact);
+    lines.push('');
+  }
+
+  const gaps = Array.isArray(b.information_gaps) ? b.information_gaps : [];
+  if (gaps.length) {
+    lines.push('## 信息差');
+    for (const g of gaps) {
+      lines.push('- ' + (g.info_name || g.id) + '（' + (g.id || '') + '）');
+      if (g.who_knows && g.who_knows.length) lines.push('  - 已知：' + g.who_knows.join('、'));
+      if (g.who_does_not_know && g.who_does_not_know.length) lines.push('  - 尚不知道：' + g.who_does_not_know.join('、'));
+      if (g.resolution_method) lines.push('  - 解决方式：' + g.resolution_method);
+      if (typeof g.created === 'number') lines.push('  - 产生章：第 ' + g.created + ' 章');
+      if (typeof g.resolved === 'number') lines.push('  - 解决章：第 ' + g.resolved + ' 章');
+      for (const line of (g.forbidden_mentions || [])) lines.push('  - 禁止：' + line);
+    }
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+function infoGapBody(row) {
+  const b = row || {};
+  const lines = ['# ' + (b.info_name || b.id || '信息差'), ''];
+  const hasCreated = typeof b.created === 'number';
+  const hasResolved = typeof b.resolved === 'number';
+  const created = hasCreated ? b.created : null;
+  const resolved = hasResolved ? b.resolved : null;
+  const activeEnd = created !== null
+    ? Math.max(created, (resolved !== null ? resolved : created + 1) - 1)
+    : null;
+  const activeRange = created === null
+    ? null
+    : (resolved === null
+      ? '第 ' + created + ' 章起'
+      : (activeEnd > created ? '第 ' + created + '–' + activeEnd + ' 章' : '第 ' + created + ' 章'));
+
+  lines.push('## 时间窗');
+  if (created !== null && resolved !== null) {
+    lines.push('- 产生章：第 ' + created + ' 章');
+    lines.push('- 解决章：第 ' + resolved + ' 章');
+    if (created > 1) {
+      lines.push('- 第 1–' + (created - 1) + ' 章：信息尚未出现，不得提前埋线、暗示或让人物知情。');
+    }
+    lines.push('- ' + activeRange + '：信息存在但未解决，按下方知情范围和写作禁令执行。');
+    lines.push('- 第 ' + resolved + ' 章起：信息解密，可以写相关人物知情、提及并据此行动。');
+  } else if (created !== null) {
+    lines.push('- 产生章：第 ' + created + ' 章');
+    lines.push('- 解决章：尚未定时。');
+    if (created > 1) {
+      lines.push('- 第 1–' + (created - 1) + ' 章：信息尚未出现，不得提前埋线、暗示或让人物知情。');
+    }
+    lines.push('- 第 ' + created + ' 章起：信息存在但未解决，按下方知情范围和写作禁令执行。');
+  } else {
+    lines.push('- ⚠️ 尚未由节奏阶段定时：当前只有知情范围，无法给出“哪一章之前/之后”的精确写作约束。');
+    lines.push('- 请在节奏阶段为这个信息差分配 `created` / `resolved`，再同步本页。');
+  }
+  lines.push('');
+
+  lines.push('## 基本信息');
+  lines.push('- ID：' + (b.id || ''));
+  lines.push('- 所属冲突：' + (b.conflict_id || ''));
+  lines.push('- 信息名称：' + (b.info_name || ''));
+  if (b.status && b.status === 'invalid') lines.push('- ⚠️ 状态：时间窗非法（resolved 不晚于 created）');
+  lines.push('');
+
+  const rangeLabel = activeRange !== null ? '（' + activeRange + '）' : '（定时后生效）';
+  lines.push('## 知情范围' + rangeLabel);
+  if (b.who_knows && b.who_knows.length) lines.push('- 已知：' + b.who_knows.join('、'));
+  if (b.who_does_not_know && b.who_does_not_know.length) lines.push('- 尚不知道：' + b.who_does_not_know.join('、'));
+  lines.push('');
+
+  if (Array.isArray(b.forbidden_mentions) && b.forbidden_mentions.length) {
+    lines.push('## 写作禁令' + rangeLabel);
+    for (const line of b.forbidden_mentions) lines.push('- ' + line);
+    lines.push('');
+  }
+
+  if (b.resolution_method) {
+    lines.push('## 解禁方式');
+    lines.push('- ' + b.resolution_method);
+    if (resolved !== null) {
+      lines.push('- 从第 ' + resolved + ' 章起，上述禁令解除；可以写知情者公开说出这条信息，或据此行动。');
+    }
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+function foreshadowBody(row) {
+  const b = row || {};
+  const lines = ['# ' + (b.name || b.id || '伏笔'), ''];
+  lines.push('- ID：' + (b.id || ''));
+  lines.push('- 类型：' + (b.type || ''));
+  if (typeof b.buried_chapter === 'number') lines.push('- 埋设章：第 ' + b.buried_chapter + ' 章');
+  if (typeof b.recovered_chapter === 'number') lines.push('- 回收章：第 ' + b.recovered_chapter + ' 章');
+  if (b.status) lines.push('- 状态：' + statusCn(b.status));
+  lines.push('');
+  return lines.join('\n');
+}
+
+function pleasureBody(row) {
+  const b = row || {};
+  const lines = ['# ' + (b.name || b.id || '爽点'), ''];
+  lines.push('- ID：' + (b.id || ''));
+  lines.push('- 规模：' + (b.scale || ''));
+  lines.push('- 类型：' + (b.kind || ''));
+  if (typeof b.chapter === 'number') lines.push('- 兑现章：第 ' + b.chapter + ' 章');
+  lines.push('');
+  return lines.join('\n');
+}
+
+export function pagesFromArtifacts(projectRoot, opts = {}) {
+  const includeObjects = opts.objects !== false;
+  const includeInfoGaps = opts.infoGaps !== false;
+  const includeBriefs = opts.briefs !== false;
+  const artifactRoot = join(projectRoot, ...SOURCES, '档案');
+  const briefRoot = join(projectRoot, ...SOURCES, '节奏', '细纲');
+  const pages = [];
+  const byId = new Map();
+  const readDir = (dir) => {
+    try {
+      return readdirSync(dir).filter((name) => name.endsWith('.json') && !name.startsWith('.')).sort();
+    } catch {
+      return [];
+    }
+  };
+  const linkCh = (ch) => (typeof ch === 'number' ? 'CH' + pad3(ch) : undefined);
+  const branchAct = actMap(projectRoot).map;
+
+  if (includeObjects) {
+  for (const name of readDir(join(artifactRoot, '伏笔'))) {
+    const row = readJson(join(artifactRoot, '伏笔', name));
+    if (!row || !row.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.foreshadow,
+      id: row.id,
+      title: row.name || row.id,
+      frontmatter: {
+        kind: row.type,
+        buried_chapter: linkCh(row.buried_chapter),
+        recovered_chapter: linkCh(row.recovered_chapter),
+        description: row.description,
+      },
+      body: foreshadowBody(row),
+    });
+  }
+
+  for (const name of readDir(join(artifactRoot, '爽点'))) {
+    const row = readJson(join(artifactRoot, '爽点', name));
+    if (!row || !row.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.pleasure,
+      id: row.id,
+      title: row.name || row.id,
+      frontmatter: {
+        scale: row.scale,
+        kind: row.kind,
+        chapter: linkCh(row.chapter),
+        description: row.description,
+      },
+      body: pleasureBody(row),
+    });
+  }
+
+  for (const name of readDir(join(artifactRoot, '冲突'))) {
+    const row = readJson(join(artifactRoot, '冲突', name));
+    if (!row || !row.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.conflict,
+      id: row.id,
+      title: row.name || row.id,
+      frontmatter: {
+        kind: row.type,
+        scale: row.scale,
+        characters: row.participants,
+        description: row.description,
+      },
+      body: conflictBody(row),
+    });
+  }
+
+  }
+
+  if (includeInfoGaps) {
+  for (const name of readDir(join(artifactRoot, '信息差'))) {
+    const row = readJson(join(artifactRoot, '信息差', name));
+    if (!row || !row.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.info_gap,
+      id: row.id,
+      title: row.info_name || row.id,
+      frontmatter: {
+        conflict: row.conflict_id,
+        who_knows: row.who_knows_ids,
+        who_does_not_know: row.who_does_not_know_ids,
+        created_chapter: linkCh(row.created),
+        resolved_chapter: linkCh(row.resolved),
+        resolution_method: row.resolution_method,
+        forbidden: (row.forbidden_mentions || []).join('\n'),
+      },
+      body: infoGapBody(row),
+    });
+  }
+
+  }
+
+  if (includeBriefs) {
+  for (const name of readDir(briefRoot)) {
+    if (!/^第\d+章\.json$/.test(name)) continue;
+    const row = readJson(join(briefRoot, name));
+    if (!row || typeof row.ch !== 'number') continue;
+    const firstConflict = row.conflicts && row.conflicts[0] ? row.conflicts[0].id : undefined;
+    addPage(pages, byId, {
+      type: TYPE.character_brief,
+      id: row.id || ('OB-CH' + pad3(row.ch)),
+      title: row.title || ('第' + row.ch + '章 细纲'),
+      frontmatter: {
+        chapter: linkCh(row.ch),
+        volume: row.volume,
+        act: branchAct.get(row.volume + ':' + row.act),
+        pov: row.pov,
+        cast: (row.cast || []).map((x) => x.id),
+        location: row.location ? row.location.id : undefined,
+        conflict: firstConflict,
+        foreshadows: (row.foreshadow_actions || []).map((x) => x.id),
+        climax: row.climax ? row.climax.id : undefined,
+        pleasure: row.pleasure ? row.pleasure.id : undefined,
+        info_gaps: (row.information_gaps || []).map((x) => x.id),
+        timeline: (row.timeline_events || []).map((x) => x.type + '：' + x.description).join('\n'),
+        mandatory: (row.must_write || []).join('\n'),
+        forbidden: (row.must_not_write || []).join('\n'),
+        word_target: row.word_target,
+        status: 'planned',
+      },
+      body: briefBody(row),
+    });
+  }
+
+  }
+
+  return pages;
+}
+
+/**
+ * 写作阶段：正文 page。正文里没有 [[RQ-...]] 时，在末尾补“本章要求覆盖”清单，
+ * 作为 page-level 的覆盖锚点（不是真正的 block id）。
+ */
+export function pagesFromWriting(projectRoot) {
+  const dir = join(projectRoot, ...SOURCES, '写作');
+  if (!existsSync(dir)) return [];
+  const rhythm = pagesFromRhythm(projectRoot);
+  const requirementsByChapter = new Map();
+  for (const page of rhythm.pages) {
+    if (page.type === TYPE.chapter) requirementsByChapter.set(page.id, page.frontmatter.requirements || []);
+  }
+  const pages = [];
+  for (const name of readdirSync(dir)) {
+    const match = /^第(\d+)章\.md$/.exec(name);
+    if (!match) continue;
+    const ch = Number(match[1]);
+    const chapterId = 'CH' + pad3(ch);
+    const id = 'TXT-' + chapterId;
+    let content = readFileSync(join(dir, name), 'utf-8').trim();
+    if (!/\[\[RQ-CH\d{3}-\d{2}/.test(content)) {
+      const requirements = requirementsByChapter.get(chapterId) || [];
+      if (requirements.length) {
+        content += '\n\n## 本章要求覆盖\n\n' + requirements.map((req) => '- [[' + req + ']]').join('\n') + '\n';
+      }
+    }
+    pages.push({
+      type: TYPE.manuscript,
+      id,
+      title: '第' + ch + '章正文',
+      frontmatter: { chapter: chapterId },
+      body: content,
+    });
+  }
+  return pages;
+}
+
+/**
+ * 读取 llm_wiki 已经生成的来源摘要页。
+ *
+ * 来源页不是阶段 JSON 的产物，但它们也是 wiki 页面，必须通过 related 接入关系网：
+ *   BOOK → SRC-INDEX → 每个 SRC-xxx
+ * 这里只做最小 frontmatter 解析；related 会在 enrichLinks 里重算。
+ */
+export function pagesFromSources(projectRoot) {
+  const dir = join(projectRoot, '设定', 'wiki', '来源');
+  if (!existsSync(dir)) return [];
+  const pages = [];
+  for (const name of readdirSync(dir)) {
+    if (!name.endsWith('.md') || name.startsWith('.')) continue;
+    let content = '';
+    try {
+      content = readFileSync(join(dir, name), 'utf-8');
+    } catch {
+      continue;
+    }
+    const fmMatch = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(content);
+    if (!fmMatch) continue;
+    const frontmatter = {};
+    for (const line of fmMatch[1].split(/\r?\n/)) {
+      const match = /^([A-Za-z_][A-Za-z0-9_]*):\s*(.*)$/.exec(line.trim());
+      if (!match) continue;
+      let value = match[2].trim();
+      if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      if (value.startsWith('[') && value.endsWith(']')) {
+        value = value.slice(1, -1).split(',').map((item) => item.trim().replace(/^["']|["']$/g, '')).filter(Boolean);
+      }
+      frontmatter[match[1]] = value;
+    }
+    const type = frontmatter.type;
+    if (type !== TYPE.source && type !== 'source') continue;
+    const id = typeof frontmatter.id === 'string' ? frontmatter.id.trim() : '';
+    if (!id || id === 'SRC-INDEX') continue;
+    pages.push({
+      type: TYPE.source,
+      id,
+      title: typeof frontmatter.title === 'string' && frontmatter.title.trim() ? frontmatter.title.trim() : id,
+      frontmatter: { ...frontmatter, type: TYPE.source, id },
+      body: content.slice(fmMatch[0].length),
+    });
+  }
+  if (!pages.length) return [];
+  pages.sort((left, right) => left.id.localeCompare(right.id));
+  const index = {
+    type: TYPE.source,
+    id: 'SRC-INDEX',
+    title: '来源索引',
+    frontmatter: { source_file: 'wiki/来源' },
+    body: '# 来源索引\n\n' + pages.map((page) => '- [[' + page.id + ']] ' + page.title).join('\n') + '\n',
+  };
+  return [index, ...pages];
+}
+
+// ============================================================
+// 2.0 阶段页面（设定/00-baseline … 设定/50-writing）
+// ============================================================
+
+function v2StageDir(projectRoot, stage) {
+  const name = {
+    '00-baseline': '00-baseline',
+    '10-scale': '10-scale',
+    '20-macro': '20-macro',
+    '30-cast': '30-cast',
+    '40-rhythm': '40-rhythm',
+    '50-writing': '50-writing',
+    '60-deslop': '60-deslop',
+  }[stage] || stage;
+  return join(projectRoot, '设定', name);
+}
+
+function v2Read(projectRoot, stage, file) {
+  return readJson(join(v2StageDir(projectRoot, stage), file));
+}
+
+function v2LinkList(rows, key = 'id') {
+  return rows.map((row) => row && row[key]).filter(Boolean);
+}
+
+function namedLine(labelText, value) {
+  if (value === undefined || value === null || value === '') return '';
+  if (Array.isArray(value)) {
+    if (!value.length) return '';
+    return '- ' + labelText + '：' + value.map((x) => (typeof x === 'object' ? JSON.stringify(x) : String(x))).join('；');
+  }
+  if (typeof value === 'object') return '- ' + labelText + '：' + JSON.stringify(value);
+  return '- ' + labelText + '：' + String(value);
+}
+
+function semanticSection(title, questions) {
+  const lines = ['', '## 语义验证点（交给 llm_wiki 语义检查）', ''];
+  lines.push('> 这一节不是硬约束枚举，而是给语义检查的检查清单；结构校验不替它下结论。');
+  lines.push('');
+  for (const q of questions) lines.push('- ' + q);
+  return lines.join('\n');
+}
+
+function linkIds(ids) {
+  const list = Array.isArray(ids) ? ids : (ids ? [ids] : []);
+  return list.filter(Boolean).map((id) => '[[' + String(id).replace(/^\[\[|\]\]$/g, '') + ']]').join('、');
+}
+
+/**
+ * 20-macro：书、卷、幕、世界观、主线、支线、结局、主题。
+ */
+export function pagesFromMacroV2(projectRoot) {
+  const dir = v2StageDir(projectRoot, '20-macro');
+  if (!existsSync(join(dir, 'world.json')) && !existsSync(join(dir, 'volumes.json'))) return [];
+  const baseline = v2Read(projectRoot, '00-baseline', 'input.json') || {};
+  const scale = v2Read(projectRoot, '10-scale', 'scale.json') || {};
+  const world = v2Read(projectRoot, '20-macro', 'world.json') || {};
+  const story = v2Read(projectRoot, '20-macro', 'story.json') || {};
+  const volumesDoc = v2Read(projectRoot, '20-macro', 'volumes.json') || {};
+  const lines = v2Read(projectRoot, '20-macro', 'lines.json') || {};
+  const endings = v2Read(projectRoot, '20-macro', 'endings.json') || {};
+  const pages = [];
+  const byId = new Map();
+  const volumes = Array.isArray(volumesDoc.volumes) ? volumesDoc.volumes : [];
+  const volumeIds = v2LinkList(volumes);
+  const bookTitle = baseline.book_name || '未命名';
+  addPage(pages, byId, {
+    type: TYPE.book,
+    id: 'BOOK',
+    title: bookTitle,
+    frontmatter: { volumes: volumeIds },
+    body: objectBody(bookTitle, {
+      一句话定位: baseline.positioning,
+      题材: baseline.genre,
+      核心冲突: story.core_conflict || baseline.core_conflict,
+      主题: world.theme,
+      基调: world.tone,
+      总章数: scale.capacity && scale.capacity.target_chapters,
+      总字数: scale.capacity && scale.capacity.target_words,
+      卷数: scale.structure && scale.structure.volume_count,
+    }),
+  });
+
+  for (const volume of volumes) {
+    if (!volume || !volume.id) continue;
+    const acts = Array.isArray(volume.acts) ? volume.acts : [];
+    addPage(pages, byId, {
+      type: TYPE.volume,
+      id: volume.id,
+      title: volume.title || volume.id,
+      frontmatter: {
+        theme: volume.emotional_arc || '',
+        acts: v2LinkList(acts, 'act_id'),
+        chapter_ratio: volume.chapter_end && volume.chapter_start
+          ? (volume.chapter_end - volume.chapter_start + 1) / Math.max(1, Number(scale.capacity && scale.capacity.target_chapters || 1))
+          : undefined,
+      },
+      body: objectBody(volume.title || volume.id, {
+        章节区间: volume.chapter_start + '-' + volume.chapter_end,
+        卷目标: volume.goal,
+        核心冲突: volume.core_conflict,
+        情绪走向: volume.emotional_arc,
+        卷尾钩子: volume.ending_hook,
+        主线进度: volume.main_line_progress,
+        支线进度: volume.branch_progress,
+      }),
+    });
+    for (const act of acts) {
+      if (!act || !act.act_id) continue;
+      addPage(pages, byId, {
+        type: TYPE.act,
+        id: act.act_id,
+        title: act.title || act.goal || act.act_id,
+        frontmatter: { volume: volume.id, theme: act.goal || '' },
+        body: objectBody(act.title || act.goal || act.act_id, {
+          章节区间: act.chapter_start + '-' + act.chapter_end,
+          幕目标: act.goal,
+          幕高潮: act.climax,
+          转折: act.turn,
+          结束状态: act.end_state,
+        }),
+      });
+    }
+  }
+
+  for (const rule of (Array.isArray(world.world_rules) ? world.world_rules : [])) {
+    if (!rule || !rule.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.world_rule,
+      id: rule.id,
+      title: rule.name || rule.id,
+      frontmatter: { category: rule.category || rule.kind || '核心', scope: rule.scope || '' },
+      body: objectBody(rule.name || rule.id, {
+        规则内容: rule.content,
+        适用范围: rule.scope,
+        例外: rule.exceptions,
+        代价: rule.cost,
+        影响: rule.impact,
+        揭示阶段: rule.reveal_stage,
+        揭示方式: rule.reveal_method,
+      }) + semanticSection('世界观规则', [
+        '这条规则的代价与例外是否在后续冲突中被人物真实承担？',
+        '是否出现“规则只在需要时生效”的情节？',
+        '规则的揭示阶段是否与章节地图一致，没有提前剧透？',
+      ]),
+    });
+  }
+
+  const main = lines.main_line;
+  if (main && main.id) {
+    addPage(pages, byId, {
+      type: TYPE.main_line,
+      id: main.id,
+      title: main.name || main.id,
+      frontmatter: { volumes: [...new Set((main.nodes || []).map((n) => n && n.volume).filter(Boolean))] },
+      body: objectBody(main.name || main.id, { 主线节点: main.nodes }) + semanticSection('主线', [
+        '每个主线节点的目标与转折是否能推动核心问题？',
+        '主线节点是否与卷纲的章节区间一致，没有跳卷或倒序？',
+      ]),
+    });
+  }
+
+  for (const branch of (Array.isArray(lines.branches) ? lines.branches : [])) {
+    if (!branch || !branch.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.branch,
+      id: branch.id,
+      title: branch.name || branch.id,
+      frontmatter: { main_line: main && main.id ? main.id : undefined },
+      body: objectBody(branch.name || branch.id, {
+        支线目标: branch.goal,
+        开始: branch.start,
+        转折: branch.turning,
+        收束: branch.resolution,
+        交织主线: branch.interweaves,
+      }) + semanticSection('支线', [
+        '支线是否真正服务主线，而不是可以整段删除？',
+        '支线开始/转折/收束是否落在合法卷幕？',
+      ]),
+    });
+  }
+
+  for (const ending of (Array.isArray(endings.endings) ? endings.endings : [])) {
+    if (!ending || !ending.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.ending,
+      id: ending.id,
+      title: ending.type || ending.id,
+      frontmatter: { level: ending.level || '', kind: ending.type || '' },
+      body: objectBody(ending.type || ending.id, {
+        结局方向: ending.direction,
+        必须回收的伏笔: ending.required_foreshadow_recovery,
+        人物归宿: ending.character_destinations,
+      }) + semanticSection('结局', [
+        '结局方向是否回答了故事的核心问题？',
+        '必须回收的伏笔是否都能在节奏阶段找到落点？',
+      ]),
+    });
+  }
+
+  // 主题页：每卷一个，沿用 THxxx。
+  volumes.forEach((volume, index) => {
+    if (!volume || !volume.id) return;
+    const m = /^V(\d{3})$/.exec(volume.id);
+    const id = 'TH' + (m ? m[1] : pad3(index + 1));
+    addPage(pages, byId, {
+      type: TYPE.theme,
+      id,
+      title: volume.emotional_arc || volume.title || volume.id,
+      frontmatter: { volumes: [volume.id], statement: volume.emotional_arc || '' },
+      body: textBody(volume.emotional_arc || volume.title || volume.id, volume.emotional_arc || ''),
+    });
+  });
+
+  return pages;
+}
+
+/**
+ * 30-cast：人物、势力、地点、道具、冲突、伏笔、高潮、爽点、关系、成员、信息差。
+ *
+ * 关系页是独立 page，且带有“语义验证点”；kind 不设枚举，
+ * 结构校验只管两端存在与变化节点，是否自洽交给语义检查。
+ */
+export function pagesFromCastV2(projectRoot) {
+  const dir = v2StageDir(projectRoot, '30-cast');
+  if (!existsSync(dir)) return [];
+  const characters = v2Read(projectRoot, '30-cast', 'characters.json') || {};
+  const factions = v2Read(projectRoot, '30-cast', 'factions.json') || {};
+  const locations = v2Read(projectRoot, '30-cast', 'locations.json') || {};
+  const items = v2Read(projectRoot, '30-cast', 'items.json') || {};
+  const conflicts = v2Read(projectRoot, '30-cast', 'conflicts.json') || {};
+  const foreshadows = v2Read(projectRoot, '30-cast', 'foreshadows.json') || {};
+  const climaxes = v2Read(projectRoot, '30-cast', 'climaxes.json') || {};
+  const payoffs = v2Read(projectRoot, '30-cast', 'payoffs.json') || {};
+  const relations = v2Read(projectRoot, '30-cast', 'relations.json') || {};
+  const information = v2Read(projectRoot, '30-cast', 'information.json') || {};
+  const pages = [];
+  const byId = new Map();
+
+  for (const c of (Array.isArray(characters.characters) ? characters.characters : [])) {
+    if (!c || !c.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.character,
+      id: c.id,
+      title: c.name || c.id,
+      frontmatter: { role: c.type || c.role, faction: c.faction, role_slot: c.role_slot },
+      body: objectBody(c.name || c.id, {
+        身份: c.type || c.role,
+        所属势力: c.faction,
+        简介: c.description,
+        目标: c.goal,
+        缺陷: c.flaw,
+        金手指: c.golden_finger,
+        信息状态: c.information_state,
+        弧光: c.arc,
+        语言: c.voice,
+        特质: c.traits,
+        退场: c.exit,
+      }) + semanticSection('人物', [
+        '人物的目标/缺陷/弧光是否在冲突与章节细纲中真实发生变化？',
+        '人物知道与不知道的信息，是否与信息差页面一致？',
+        '人物的语言节奏与行为是否前后一致（没有 OOC）？',
+      ]),
+    });
+  }
+
+  for (const f of (Array.isArray(factions.factions) ? factions.factions : [])) {
+    if (!f || !f.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.faction,
+      id: f.id,
+      title: f.name || f.id,
+      frontmatter: { kind: f.type || '' },
+      body: objectBody(f.name || f.id, {
+        类型: f.type,
+        目标: f.goal,
+        资源: f.resources,
+        地盘: f.territory,
+        内部矛盾: f.internal_conflict,
+        简介: f.description,
+      }) + semanticSection('势力', [
+        '势力的资源与地盘是否足以支撑它在本卷的行动？',
+        '势力的内部矛盾是否在冲突或关系变化中被使用？',
+      ]),
+    });
+  }
+
+  for (const l of (Array.isArray(locations.locations) ? locations.locations : [])) {
+    if (!l || !l.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.location,
+      id: l.id,
+      title: l.name || l.id,
+      frontmatter: { kind: l.type, narrative_function: l.narrative_function },
+      body: objectBody(l.name || l.id, {
+        类型: l.type,
+        叙事功能: l.narrative_function,
+        简介: l.description,
+        '规则/限制': l.rules,
+      }),
+    });
+  }
+
+  for (const it of (Array.isArray(items.items) ? items.items : [])) {
+    if (!it || !it.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.item,
+      id: it.id,
+      title: it.name || it.id,
+      frontmatter: { category: it.category, owner_character: it.owner_character, owner_faction: it.owner_faction },
+      body: objectBody(it.name || it.id, {
+        类别: it.category,
+        功能: it.function,
+        简介: it.description,
+        归属: it.owner,
+        '代价/限制': it.limit,
+      }),
+    });
+  }
+
+  for (const x of (Array.isArray(conflicts.conflicts) ? conflicts.conflicts : [])) {
+    if (!x || !x.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.conflict,
+      id: x.id,
+      title: x.name || x.id,
+      frontmatter: { kind: x.type, characters: (x.participants || []).filter((id) => /^C\d{3}$/.test(String(id))) },
+      body: objectBody(x.name || x.id, {
+        类型: x.type,
+        核心目标: x.core_goal,
+        赌注: x.stakes,
+        简介: x.description,
+        升级路径: x.escalation_path,
+        解决方式: x.resolution_plan,
+        参与方: x.participants,
+      }) + semanticSection('冲突', [
+        '冲突的升级路径是否每一步都提高赌注，而不是原地重复？',
+        '解决方式是否由人物选择推动，而不是机械降神？',
+      ]),
+    });
+  }
+
+  for (const f of (Array.isArray(foreshadows.foreshadows) ? foreshadows.foreshadows : [])) {
+    if (!f || !f.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.foreshadow,
+      id: f.id,
+      title: f.name || f.id,
+      frontmatter: { kind: f.type, scope: f.scope || undefined },
+      body: objectBody(f.name || f.id, {
+        级别: f.type,
+        埋设: f.setup,
+        线索: f.clues,
+        回收目标: f.payoff_target,
+        回收要求: f.recovery_requirement,
+        红鲱鱼: f.red_herrings,
+      }) + semanticSection('伏笔', [
+        '线索是否足以让读者在回收时觉得合理，而不是作者临时解释？',
+        '伏笔的埋设与回收是否与章节地图顺序一致？',
+      ]),
+    });
+  }
+
+  for (const cl of (Array.isArray(climaxes.climaxes) ? climaxes.climaxes : [])) {
+    if (!cl || !cl.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.climax,
+      id: cl.id,
+      title: cl.name || cl.id,
+      frontmatter: { kind: cl.type, characters: (cl.participants || []).filter((id) => /^C\d{3}$/.test(String(id))) },
+      body: objectBody(cl.name || cl.id, {
+        级别: cl.type,
+        简介: cl.description,
+        兑现: cl.payoff,
+        参与方: cl.participants,
+      }),
+    });
+  }
+
+  for (const pl of (Array.isArray(payoffs.payoffs) ? payoffs.payoffs : [])) {
+    if (!pl || !pl.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.pleasure,
+      id: pl.id,
+      title: pl.name || pl.id,
+      frontmatter: { scale: pl.scale, kind: pl.type },
+      body: objectBody(pl.name || pl.id, {
+        类型: pl.type,
+        级别: pl.scale,
+        铺垫: pl.setup,
+        兑现: pl.payoff,
+        前置依赖: pl.required_setup,
+        情绪效果: pl.emotional_effect,
+      }) + semanticSection('爽点', [
+        '铺垫是否足够，兑现时读者是否能理解为什么爽？',
+        '爽点是否重复同一种套路，缺少变化？',
+      ]),
+    });
+  }
+
+  for (const rel of (Array.isArray(relations.character_relations) ? relations.character_relations : [])) {
+    if (!rel || !rel.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.relation,
+      id: rel.id,
+      title: (rel.from || '?') + '-' + (rel.to || '?'),
+      frontmatter: { from: rel.from, to: rel.to, kind: rel.kind, label: rel.label || undefined },
+      body: [
+        '# ' + (rel.kind || '人物关系'),
+        '',
+        '- 两端：[[' + rel.from + ']] → [[' + rel.to + ']]',
+        '- 关系类型（自由文本，不设枚举）：' + (rel.kind || '未填写'),
+        '- 初始状态：' + (rel.initial_state || '未填写'),
+        '',
+        '## 阶段变化',
+        ...(Array.isArray(rel.changes) ? rel.changes.map((c, i) =>
+          '- 第 ' + (i + 1) + ' 阶段：' + (c.stage || '') + '；触发：' + (c.trigger || '') + '；' + (c.description || '')
+        ) : ['- 未填写']),
+        semanticSection('人物关系', [
+          '这条关系与 ' + rel.from + ' 的目标/缺陷是否冲突？如果冲突，文本是否解释？',
+          '这条关系的变化是否有触发事件，而不是突然转向？',
+          '这条关系是否与双方各自的信息状态一致（没有让角色知道不该知道的事）？',
+          '同一条关系在不同章节里的称呼、态度、亲密程度是否连续？',
+        ]),
+      ].join('\n'),
+    });
+  }
+
+  for (const rel of (Array.isArray(relations.faction_relations) ? relations.faction_relations : [])) {
+    if (!rel || !rel.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.faction_relation,
+      id: rel.id,
+      title: (rel.from || '?') + '-' + (rel.to || '?'),
+      frontmatter: { from: rel.from, to: rel.to, kind: rel.kind },
+      body: [
+        '# ' + (rel.kind || '势力关系'),
+        '',
+        '- 两端：[[' + rel.from + ']] → [[' + rel.to + ']]',
+        '- 关系类型（自由文本，不设枚举）：' + (rel.kind || '未填写'),
+        '- 初始状态：' + (rel.initial_state || '未填写'),
+        '',
+        '## 阶段变化',
+        ...(Array.isArray(rel.changes) ? rel.changes.map((c, i) =>
+          '- 第 ' + (i + 1) + ' 阶段：' + (c.stage || '') + '；触发：' + (c.trigger || '') + '；' + (c.description || '')
+        ) : ['- 未填写']),
+        semanticSection('势力关系', [
+          '这条势力关系与双方的资源、地盘、目标是否冲突？',
+          '关系变化是否由具体事件触发，并与章节地图一致？',
+        ]),
+      ].join('\n'),
+    });
+  }
+
+  for (const m of (Array.isArray(relations.memberships) ? relations.memberships : [])) {
+    if (!m || !m.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.membership,
+      id: m.id,
+      title: (m.character || '?') + '@' + (m.faction || '?'),
+      frontmatter: { character: m.character, faction: m.faction, kind: m.kind, position: m.position },
+      body: objectBody((m.character || '?') + '@' + (m.faction || '?'), {
+        人物: m.character,
+        势力: m.faction,
+        身份: m.position,
+        成员关系: m.kind,
+        说明: m.description,
+      }),
+    });
+  }
+
+  for (const g of (Array.isArray(information.information_gaps) ? information.information_gaps : [])) {
+    if (!g || !g.id) continue;
+    addPage(pages, byId, {
+      type: TYPE.info_gap,
+      id: g.id,
+      title: g.info_name || g.id,
+      frontmatter: { conflict: g.conflict },
+      body: objectBody(g.info_name || g.id, {
+        所属冲突: g.conflict,
+        谁知道: g.who_knows,
+        谁不知道: g.who_does_not_know,
+        解决方式: g.resolution_method,
+        写作禁令: g.writing_ban,
+      }) + semanticSection('信息差', [
+        '谁知道/谁不知道是否与人物信息和章节地图一致？',
+        '在解决前，是否有角色说出了他不该知道的秘密？',
+      ]),
+    });
+  }
+
+  return pages;
+}
+
+/**
+ * 40-rhythm：章节页 + 每章独立细纲页。
+ */
+export function pagesFromRhythmV2(projectRoot) {
+  const dir = v2StageDir(projectRoot, '40-rhythm');
+  const chapterMap = readJson(join(dir, 'chapter_map.json'));
+  if (!chapterMap) return { pages: [], byId: new Map() };
+  const chapters = Array.isArray(chapterMap.chapters) ? chapterMap.chapters : [];
+  const pages = [];
+  const byId = new Map();
+  const outlineDir = join(dir, 'outlines');
+  let outlineFiles = [];
+  try {
+    outlineFiles = readdirSync(outlineDir).filter((n) => n.endsWith('.json') && !n.startsWith('.'));
+  } catch {
+    outlineFiles = [];
+  }
+  const outlineById = new Map();
+  for (const name of outlineFiles) {
+    const data = readJson(join(outlineDir, name));
+    if (!data) continue;
+    const chapter = data.chapter || {};
+    const id = chapter.chapter_id || chapter.id || name.replace(/\.json$/, '');
+    outlineById.set(id, data);
+  }
+
+  for (const c of chapters) {
+    if (!c || !c.chapter_id) continue;
+    const reason = c.why || {};
+    const how = c.how || {};
+    const body = [
+      '# 第 ' + c.display_no + ' 章 ' + (c.title || ''),
+      '',
+      '- 所属卷/幕：[[' + c.volume + ']] / [[' + c.act + ']]',
+      '- 视角：[[' + c.pov + ']]',
+      '- 出场人物：' + linkIds(c.cast),
+      '- 地点：' + linkIds(c.locations),
+      '- 时间：第 ' + (c.time && c.time.story_day) + ' 天 ' + (c.time && c.time.clock || '') + (c.time && c.time.duration_minutes ? '（' + c.time.duration_minutes + ' 分钟）' : ''),
+      '- 主线节点：' + (reason.main_line_nodes || []).join('、'),
+      '- 支线：' + (reason.branch_nodes || []).join('、'),
+      '- 冲突：' + linkIds(reason.conflict),
+      '- 主题：' + (reason.theme || ''),
+      '- 赌注：' + (reason.stakes || ''),
+      '- 本章功能：' + (how.function_main || '') + (how.function_aux ? '；辅助：' + how.function_aux : ''),
+      '- 转折：' + (how.turn || ''),
+      '- 章尾钩子：' + (how.ending_hook || ''),
+      '- 情绪：' + (c.emotion && c.emotion.phase || '') + (c.emotion && c.emotion.value ? '（' + c.emotion.value + '/10）' : ''),
+      '- 钩子强度：' + (c.hook && c.hook.strength || ''),
+      '- 字数目标：' + (c.word_target || ''),
+      '',
+      '## 伏笔动作',
+      ...((c.foreshadow_actions || []).length ? c.foreshadow_actions.map((a) => '- ' + a.action + ' [[' + a.id + ']]：' + (a.detail || '')) : ['- 无']),
+      '',
+      '## 爽点动作',
+      ...((c.payoff_actions || []).length ? c.payoff_actions.map((a) => '- ' + a.action + ' [[' + a.id + ']]：' + (a.detail || '')) : ['- 无']),
+      '',
+      '## 信息差',
+      ...((c.information_gaps || []).length ? c.information_gaps.map((a) => '- ' + a.state + ' [[' + a.id + ']]：' + (a.detail || '')) : ['- 无']),
+    ].join('\n');
+    addPage(pages, byId, {
+      type: TYPE.chapter,
+      id: c.chapter_id,
+      title: '第' + c.display_no + '章' + (c.title && !String(c.title).startsWith('第' + c.display_no + '章') ? ' ' + c.title : ''),
+      frontmatter: { act: c.act, volume: c.volume, chapter_no: c.display_no },
+      body,
+    });
+
+    const outline = outlineById.get(c.chapter_id);
+    if (outline) {
+      const ch = outline.chapter || {};
+      const hard = ch.hard_constraints || outline.hard_constraints || {};
+      const howWrite = ch.how || outline.how || {};
+      const scenes = Array.isArray(howWrite.scenes) ? howWrite.scenes : [];
+      const lines = [
+        '# 第 ' + c.display_no + ' 章细纲：' + (ch.title || c.title || ''),
+        '',
+        '- 对应章节：[[' + c.chapter_id + ']]',
+        '- 视角：[[' + (ch.pov && ch.pov.id || c.pov) + ']]',
+        '- 出场人物：' + linkIds((ch.cast || []).map((x) => (typeof x === 'string' ? x : x && x.id))),
+        '- 地点：' + linkIds((ch.locations || []).map((x) => (typeof x === 'string' ? x : x && x.id))),
+        '- 字数目标：' + (ch.word_target || c.word_target || ''),
+        '',
+        '## 为什么写这一章',
+        '- 主线：' + JSON.stringify(ch.why && ch.why.main_line || c.why.main_line_nodes || []),
+        '- 支线：' + JSON.stringify(ch.why && ch.why.branch || c.why.branch_nodes || []),
+        '- 冲突：' + linkIds(ch.why && ch.why.conflict || c.why.conflict || []),
+        '- 赌注：' + (ch.why && ch.why.stakes || c.why.stakes || ''),
+        '- 人物弧光：' + (ch.why && ch.why.character_arc || ''),
+        '',
+        '## 必须写',
+        ...(Array.isArray(hard.must_write || ch.must_write) ? (hard.must_write || ch.must_write).map((x) => '- ' + x) : ['- 未填写']),
+        '',
+        '## 绝对不能写',
+        ...(Array.isArray(hard.must_not_write || ch.must_not_write) ? (hard.must_not_write || ch.must_not_write).map((x) => '- ⛔ ' + x) : ['- 未填写']),
+        '',
+        '## 场景',
+        ...(scenes.length ? scenes.map((s, i) =>
+          '- 场景 ' + (s.no || i + 1) + '：' + (s.goal || '') + '；阻碍：' + (s.obstacle || '') + '；转折：' + (s.turn || '') + '；结果：' + (s.outcome || '') + (s.emotion ? '；情绪：' + s.emotion : '')
+        ) : ['- 未填写']),
+        '',
+        '## 结束方式',
+        '- 类型：' + (howWrite.ending && howWrite.ending.type || ''),
+        '- 收束：' + (howWrite.ending && howWrite.ending.text || ''),
+        '- 钩子：' + (howWrite.ending && howWrite.ending.hook || ''),
+        '',
+        '## 衔接',
+        '- 上一章：' + (ch.continuity && ch.continuity.from_prev || ''),
+        '- 下一章：' + (ch.continuity && ch.continuity.to_next || ''),
+      ];
+      addPage(pages, byId, {
+        type: TYPE.character_brief,
+        id: 'OB-' + c.chapter_id,
+        title: '第' + c.display_no + '章细纲',
+        frontmatter: { chapter: c.chapter_id, kind: '可落地细纲' },
+        body: lines.join('\n'),
+      });
+    }
+  }
+  return { pages, byId };
+}
+
+export function pagesFromWritingV2(projectRoot) {
+  const dir = v2StageDir(projectRoot, '50-writing');
+  const chaptersDir = join(dir, 'chapters');
+  if (!existsSync(chaptersDir)) return [];
+  const chapterMap = v2Read(projectRoot, '40-rhythm', 'chapter_map.json') || {};
+  const byDisplay = new Map((chapterMap.chapters || []).map((c) => [Number(c.display_no), c]));
+  const pages = [];
+  let names = [];
+  try {
+    names = readdirSync(chaptersDir).filter((n) => /^第\d+章\.md$/.test(n));
+  } catch {
+    names = [];
+  }
+  for (const name of names) {
+    const m = /^第(\d+)章\.md$/.exec(name);
+    if (!m) continue;
+    const displayNo = Number(m[1]);
+    const meta = byDisplay.get(displayNo);
+    const content = readFileSync(join(chaptersDir, name), 'utf-8');
+    const id = 'TXT-' + (meta && meta.chapter_id || ('CH' + pad3(displayNo)));
+    pages.push({
+      type: TYPE.manuscript,
+      id,
+      title: '第' + displayNo + '章' + (meta && meta.title && !String(meta.title).startsWith('第' + displayNo + '章') ? ' ' + meta.title : ''),
+      frontmatter: { chapter: meta && meta.chapter_id || ('CH' + pad3(displayNo)) },
+      body: content,
+    });
+  }
+  return pages;
+}
+
+/**
+ * 阶段源文件是否存在（用于 sync 默认模式跳过未产出的阶段）。
+ */
+export function hasStageSources(projectRoot, stage) {
+  if (stage === 'source') {
+    const dir = join(projectRoot, '设定', 'wiki', '来源');
+    if (!existsSync(dir)) return false;
+    try {
+      return readdirSync(dir).some((name) => !name.startsWith('.') && name.endsWith('.md') && name !== 'SRC-INDEX.md');
+    } catch {
+      return false;
+    }
+  }
+  const dirs = {
+    skeleton: '骨架', flesh: '血肉', rhythm: '节奏', writing: '写作',
+    '20-macro': '20-macro', macro: '20-macro',
+    '30-cast': '30-cast', cast: '30-cast',
+    '40-rhythm': '40-rhythm', 'rhythm-v2': '40-rhythm',
+    '50-writing': '50-writing', 'writing-v2': '50-writing',
+  };
+  const name = dirs[stage];
+  if (!name) return false;
+  const base = name.startsWith('0') || name.startsWith('1') || name.startsWith('2') || name.startsWith('3') || name.startsWith('4') || name.startsWith('5')
+    ? join(projectRoot, '设定', name)
+    : join(projectRoot, ...SOURCES, name);
+  if (!existsSync(base)) return false;
+  try {
+    return readdirSync(base, { withFileTypes: true }).some((entry) => {
+      if (entry.name.startsWith('.') || entry.name === 'bundle.json' || entry.name === 'README.md') return false;
+      if (entry.isDirectory()) {
+        if (!['chapters', 'outlines', 'timelines'].includes(entry.name)) return false;
+        try {
+          return readdirSync(join(base, entry.name)).some((n) => n.endsWith('.json') || n.endsWith('.md'));
+        } catch {
+          return false;
+        }
+      }
+      return entry.name.endsWith('.json') || entry.name.endsWith('.md');
+    });
+  } catch {
+    return false;
+  }
+}
+
+export function pagesForStage(projectRoot, stage) {
+  if (stage === 'skeleton') return mergePageList([...pagesFromSkeleton(projectRoot), ...pagesFromArtifacts(projectRoot, { objects: true, infoGaps: false, briefs: false })]);
+  if (stage === 'flesh') return mergePageList([...pagesFromFlesh(projectRoot), ...pagesFromArtifacts(projectRoot, { objects: false, infoGaps: true, briefs: false })]);
+  if (stage === 'rhythm') return mergePageList([...pagesFromRhythm(projectRoot).pages, ...pagesFromArtifacts(projectRoot)]);
+  if (stage === 'writing') return mergePageList([...pagesFromWriting(projectRoot), ...pagesFromArtifacts(projectRoot)]);
+  if (stage === 'macro' || stage === '20-macro') {
+    return pagesFromMacroV2(projectRoot);
+  }
+  if (stage === 'cast' || stage === '30-cast') {
+    // 首次正式同步必须带 macro 闭包：人物/势力/地点出现后，minimums 才满足。
+    return mergePageList([...pagesFromMacroV2(projectRoot), ...pagesFromCastV2(projectRoot)]);
+  }
+  if (stage === 'rhythm-v2' || stage === '40-rhythm') {
+    return mergePageList([
+      ...pagesFromMacroV2(projectRoot),
+      ...pagesFromCastV2(projectRoot),
+      ...pagesFromRhythmV2(projectRoot).pages,
+    ]);
+  }
+  if (stage === 'writing-v2' || stage === '50-writing') {
+    return mergePageList([
+      ...pagesFromMacroV2(projectRoot),
+      ...pagesFromCastV2(projectRoot),
+      ...pagesFromRhythmV2(projectRoot).pages,
+      ...pagesFromWritingV2(projectRoot),
+    ]);
+  }
+  if (stage === 'source') return pagesFromSources(projectRoot);
+  return [];
+}
+
+function mergePageList(pages) {
+  const byId = new Map();
+  for (const page of pages) {
+    if (!page || !page.id) continue;
+    const existing = byId.get(page.id);
+    if (!existing) {
+      byId.set(page.id, {
+        ...page,
+        frontmatter: { ...(page.frontmatter || {}) },
+      });
+      continue;
+    }
+    existing.type = page.type || existing.type;
+    existing.title = page.title || existing.title;
+    existing.frontmatter = { ...(existing.frontmatter || {}), ...(page.frontmatter || {}) };
+    if (page.body) existing.body = page.body;
+  }
+  return [...byId.values()];
+}
+
+/**
+ * 把项目里所有已存在的阶段产物合并成一份“全局页面表”。
+ * 关系网必须跨阶段计算：节奏页要能连到骨架角色，写作页要能连到章节。
+ */
+export function collectAllPages(projectRoot) {
+  return mergePageList([
+    ...pagesFromSkeleton(projectRoot),
+    ...pagesFromFlesh(projectRoot),
+    ...pagesFromRhythm(projectRoot).pages,
+    ...pagesFromArtifacts(projectRoot),
+    ...pagesFromWriting(projectRoot),
+    ...pagesFromMacroV2(projectRoot),
+    ...pagesFromCastV2(projectRoot),
+    ...pagesFromRhythmV2(projectRoot).pages,
+    ...pagesFromWritingV2(projectRoot),
+    ...pagesFromSources(projectRoot),
+  ]);
+}
+
+function parentIdOf(page) {
+  const fm = page.frontmatter || {};
+  switch (page.type) {
+    case TYPE.book:
+      return null;
+    case TYPE.volume:
+      return 'BOOK';
+    case TYPE.act:
+      return fm.volume || 'BOOK';
+    case TYPE.chapter:
+      return fm.act || fm.volume || 'BOOK';
+    case TYPE.requirement:
+    case TYPE.scene:
+    case TYPE.manuscript:
+      return fm.chapter || 'BOOK';
+    case TYPE.theme:
+    case TYPE.main_line:
+    case TYPE.world_rule:
+    case TYPE.faction:
+    case TYPE.location:
+    case TYPE.conflict:
+      return 'BOOK';
+    case TYPE.source:
+      return page.id === 'SRC-INDEX' ? 'BOOK' : 'SRC-INDEX';
+    case TYPE.branch:
+      return fm.main_line || 'BOOK';
+    case TYPE.character:
+      return fm.faction || 'BOOK';
+    case TYPE.other_entity:
+      return 'BOOK';
+    case TYPE.item:
+      return fm.owner_character || fm.owner_faction || 'BOOK';
+    case TYPE.foreshadow:
+      return fm.buried_chapter || 'BOOK';
+    case TYPE.climax:
+    case TYPE.pleasure:
+    case TYPE.ending:
+      return fm.chapter || 'BOOK';
+    case TYPE.relation:
+    case TYPE.faction_relation:
+      return fm.from || 'BOOK';
+    case TYPE.membership:
+      return fm.faction || 'BOOK';
+    case TYPE.arc:
+    case TYPE.character_state:
+      return fm.character || 'BOOK';
+    case TYPE.timeline_event:
+      return fm.chapter || 'BOOK';
+    case TYPE.character_brief:
+      return fm.chapter || 'BOOK';
+    case TYPE.info_gap:
+      return fm.conflict || fm.created_chapter || 'BOOK';
+    default:
+      return 'BOOK';
+  }
+}
+
+const ID_VALUE_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
+const NON_LINK_FIELDS = new Set([
+  'type', 'id', 'title', 'status', 'tags', 'sources', 'related', 'created', 'updated', 'aliases',
+]);
+
+function semanticLinkIds(page, byId) {
+  const out = new Set();
+  const fm = page.frontmatter || {};
+  for (const [key, value] of Object.entries(fm)) {
+    if (NON_LINK_FIELDS.has(key)) continue;
+    const values = Array.isArray(value) ? value : [value];
+    for (const item of values) {
+      if (typeof item !== 'string') continue;
+      if (item === page.id || !ID_VALUE_RE.test(item)) continue;
+      if (byId.has(item)) out.add(item);
+    }
+  }
+  return out;
+}
+
+function bodyLinkIds(page, byId) {
+  const out = new Set();
+  const regex = /\[\[([^\]|]+?)(?:\|[^\]]+?)?\]\]/g;
+  let match;
+  while ((match = regex.exec(String(page.body || ''))) !== null) {
+    const id = match[1].trim();
+    if (id !== page.id && byId.has(id)) out.add(id);
+  }
+  return out;
+}
+
+function uniqueIds(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+
+/**
+ * 去掉旧版本生成的 `## 关系网` 正文块。
+ * 关系只放在 frontmatter.related 里；正文不再重复一张“上下级”表。
+ */
+function stripRelationSection(body) {
+  const source = String(body || '');
+  const index = source.indexOf('\n## 关系网');
+  if (index < 0) return source;
+  return source.slice(0, index).trimEnd() + '\n';
+}
+
+/** 页面 title 统一带上 ID 前缀：V001_除夕分岁。 */
+function withIdTitle(page) {
+  const id = String(page.id || '').trim();
+  const title = String(page.title || id).trim();
+  if (!id) return title;
+  return title.startsWith(id + '_') ? title : id + '_' + title;
+}
+
+/**
+ * 给页面补齐层级 / 相邻 / 语义链接。
+ *
+ * 目标不是“有链接就行”，而是让页面组成一张有上下级、叶子相邻、
+ * 跨实体关联的图：
+ *   - 上级：卷→书、幕→卷、章→幕、要求/场景/正文→章……
+ *   - 下级：反向由父页链接所有子页
+ *   - 相邻：同类型同上级的页面按 ID 串成双向链表
+ *   - 相关：frontmatter 里已有的实体 link 字段
+ *
+ * 只写入 frontmatter.related（wikilink + 完整标题），不再生成正文关系表。
+ */
+export function enrichLinks(pages, contextPages = pages) {
+  const context = mergePageList(contextPages);
+  const byId = new Map(context.map((page) => [page.id, page]));
+  const parentOf = new Map();
+  const childrenOf = new Map();
+
+  for (const page of context) {
+    const parent = parentIdOf(page);
+    if (!parent || parent === page.id || !byId.has(parent)) continue;
+    parentOf.set(page.id, parent);
+    if (!childrenOf.has(parent)) childrenOf.set(parent, []);
+    childrenOf.get(parent).push(page.id);
+  }
+
+  const groups = new Map();
+  for (const page of context) {
+    if (page.type === TYPE.book || page.id === 'SRC-INDEX') continue;
+    let key = page.type;
+    if (page.type === TYPE.requirement || page.type === TYPE.scene) {
+      key += ':' + String((page.frontmatter || {}).chapter || '');
+    }
+    if (!groups.has(key)) groups.set(key, []);
+    groups.get(key).push(page);
+  }
+  const prevNext = new Map();
+  for (const list of groups.values()) {
+    list.sort((left, right) => left.id.localeCompare(right.id));
+    for (let i = 0; i < list.length; i += 1) {
+      prevNext.set(list[i].id, {
+        prev: list[i - 1] ? list[i - 1].id : null,
+        next: list[i + 1] ? list[i + 1].id : null,
+      });
+    }
+  }
+
+  // 标题统一加 ID 前缀，related 里用 [[ID|ID_标题]]：目标是文件名，别名给人看。
+  for (const page of context) page.title = withIdTitle(page);
+  const targets = mergePageList(pages);
+  for (const page of targets) page.title = withIdTitle(page);
+  const titleById = new Map(context.map((page) => [page.id, page.title]));
+  for (const page of targets) titleById.set(page.id, page.title);
+
+  for (const page of targets) {
+    const parent = parentOf.get(page.id) || null;
+    const children = uniqueIds(childrenOf.get(page.id) || []).filter((id) => id !== page.id);
+    const adjacent = prevNext.get(page.id) || {};
+    page.body = stripRelationSection(page.body);
+    const semantic = [...new Set([
+      ...semanticLinkIds(page, byId),
+      ...bodyLinkIds(page, byId),
+    ])];
+    const relatedIds = uniqueIds([
+      parent,
+      ...children,
+      adjacent.prev,
+      adjacent.next,
+      ...semantic,
+    ]).filter((id) => id !== page.id && byId.has(id));
+    if (!relatedIds.length && page.type !== TYPE.book && byId.has('BOOK')) {
+      relatedIds.push('BOOK');
+    }
+    // related 用「[[ID|完整标题]]」：
+    //   - 链接目标必须是 ID（llm_wiki 按文件名解析，页面文件是 C001.md）；
+    //   - 显示名用 ID_标题，UI 上仍然可读。
+    // 之前写 [[C001_岑野]]，解析器会去找 C001_岑野.md，结果全是
+    // “Related page not found”。
+    page.frontmatter = {
+      ...(page.frontmatter || {}),
+      related: relatedIds.map((id) => '[[' + id + '|' + (titleById.get(id) || id) + ']]'),
+    };
+  }
+  return targets;
+}
+
+function chunkPages(pages, maxPages = 80, maxBytes = 4 * 1024 * 1024) {
+  const chunks = [];
+  let current = [];
+  let bytes = 0;
+  for (const page of pages) {
+    const size = Buffer.byteLength(JSON.stringify(page), 'utf-8');
+    if (current.length >= maxPages || (current.length > 0 && bytes + size > maxBytes)) {
+      chunks.push(current);
+      current = [];
+      bytes = 0;
+    }
+    current.push(page);
+    bytes += size;
+  }
+  if (current.length) chunks.push(current);
+  return chunks;
+}
+
+async function postJson(baseUrl, token, path, body, timeoutMs, signal) {
+  const timeout = AbortSignal.timeout(timeoutMs);
+  const response = await fetch(baseUrl.replace(/\/$/, '') + path, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Authorization: 'Bearer ' + token,
+    },
+    body: JSON.stringify(body),
+    signal: signal ? AbortSignal.any([signal, timeout]) : timeout,
+  });
+  let data = null;
+  try {
+    data = await response.json();
+  } catch {
+    data = null;
+  }
+  return { status: response.status, data };
+}
+
+/**
+ * 把一个阶段物化到 llm_wiki。
+ *
+ * @param {object} opts
+ * @param {string} opts.projectRoot
+ * @param {'skeleton'|'flesh'|'rhythm'|'writing'} opts.stage
+ * @param {string} opts.setupId
+ * @param {string} opts.llmWikiUrl
+ * @param {string} opts.llmWikiToken
+ * @param {AbortSignal|null} [opts.signal]
+ * @returns {Promise<{ok:boolean, pageCount:number, written:string[], createdStubs:string[], errors:string[], warnings:string[], error:string|null}>}
+ */
+export async function materializeStage(opts) {
+  const { projectRoot, stage, setupId, llmWikiUrl, llmWikiToken, signal } = opts || {};
+  const stagePages = pagesForStage(projectRoot, stage);
+  if (!stagePages.length) {
+    return { ok: false, pageCount: 0, written: [], createdStubs: [], errors: [], warnings: [], error: '没有可物化的页面' };
+  }
+  if (!setupId) {
+    return { ok: false, pageCount: stagePages.length, written: [], createdStubs: [], errors: [], warnings: [], error: '缺少 setup_id' };
+  }
+
+  // 关系网必须跨阶段计算：节奏页要连到骨架角色，写作页要连到章节。
+  // 这里先合并全部阶段页面并补齐链接，再选出“本阶段页面 + 它们直接关联的
+  // 页面”。父页/子页一起写，才能保证新页面有入站链接、父页有出站链接。
+  const allPages = collectAllPages(projectRoot);
+  const enrichedAll = enrichLinks(allPages, allPages);
+  const enrichedById = new Map(enrichedAll.map((page) => [page.id, page]));
+  // 递归闭包：本阶段页面 → related 指向的页面 → 这些页面继续指向的页面。
+  // 只同步直接关联会漏掉“人物页 → 势力页 → 书页”这类两跳链接，
+  // link-lint 仍会报 broken-link。
+  const selectedIds = new Set();
+  const queue = stagePages.map((page) => page.id);
+  while (queue.length) {
+    const id = queue.shift();
+    if (!id || selectedIds.has(id)) continue;
+    selectedIds.add(id);
+    const enriched = enrichedById.get(id);
+    if (!enriched) continue;
+    const related = (enriched.frontmatter && enriched.frontmatter.related) || [];
+    for (const link of related) {
+      const target = String(link).replace(/^\[\[|\]\]$/g, '').split('|')[0].split('_')[0];
+      if (target && !selectedIds.has(target)) queue.push(target);
+    }
+  }
+  // 来源摘要页是 llm_wiki ingest 的产物，不属于任何阶段 JSON。
+  // 写作阶段是最后一道同步，顺手把 BOOK → SRC-INDEX → 来源页 接上。
+  if ((stage === 'writing' || stage === 'writing-v2' || stage === '50-writing') && allPages.some((page) => page.type === TYPE.source)) {
+    selectedIds.add('BOOK');
+    for (const page of allPages) {
+      if (page.type === TYPE.source) selectedIds.add(page.id);
+    }
+  }
+  const pages = enrichedAll.filter((page) => selectedIds.has(page.id));
+
+  const chunks = chunkPages(pages);
+  const written = [];
+  const createdStubs = [];
+  const errors = [];
+  const warnings = [];
+  const preserveFrontmatter = [
+    'flesh', 'rhythm', 'writing', 'source',
+    'macro', '20-macro', 'cast', '30-cast', 'rhythm-v2', '40-rhythm', 'writing-v2', '50-writing',
+  ].includes(stage);
+
+  for (const chunk of chunks) {
+    let result;
+    try {
+      result = await postJson(
+        llmWikiUrl,
+        llmWikiToken,
+        '/projects/' + setupId + '/schemaingest',
+        {
+          mode: 'upsert',
+          createMissingLinks: true,
+          preserveFrontmatter,
+          pages: chunk,
+        },
+        5 * 60 * 1000,
+        signal,
+      );
+    } catch (error) {
+      return {
+        ok: false,
+        pageCount: pages.length,
+        written,
+        createdStubs,
+        errors,
+        warnings,
+        error: error instanceof Error ? error.message : String(error),
+      };
+    }
+
+    const data = result.data || {};
+    if (result.status < 200 || result.status >= 300 || data.ok === false) {
+      const message = data.error || data.errors?.[0]?.message || ('HTTP ' + result.status);
+      return {
+        ok: false,
+        pageCount: pages.length,
+        written,
+        createdStubs,
+        errors,
+        warnings,
+        error: String(message),
+      };
+    }
+    if (Array.isArray(data.written)) written.push(...data.written);
+    if (Array.isArray(data.createdStubs)) createdStubs.push(...data.createdStubs);
+    if (Array.isArray(data.warnings)) warnings.push(...data.warnings);
+    if (Array.isArray(data.errors)) {
+      for (const item of data.errors) errors.push(item.message || JSON.stringify(item));
+    }
+  }
+
+  return {
+    ok: errors.length === 0,
+    pageCount: pages.length,
+    written,
+    createdStubs,
+    errors,
+    warnings,
+    error: errors.length ? errors[0] : null,
+  };
+}
+
+export function formatMaterializeNote(result, stageName) {
+  if (!result) return '';
+  if (!result.ok) {
+    return '⚠️ ' + stageName + ' 物化到 llm_wiki 失败：' + (result.error || '未知错误') +
+      (result.errors && result.errors.length ? '\n' + result.errors.slice(0, 5).join('\n') : '');
+  }
+  const parts = ['✅ ' + stageName + ' 已物化到 llm_wiki：' + result.pageCount + ' 个页面'];
+  if (result.createdStubs.length) {
+    parts.push('自动创建 stub ' + result.createdStubs.length + ' 个：' + result.createdStubs.slice(0, 10).join('、') +
+      (result.createdStubs.length > 10 ? ' …' : ''));
+  }
+  if (result.warnings.length) parts.push('警告：' + result.warnings.slice(0, 5).join('；'));
+  return parts.join('\n');
+}