@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-export/exporter.js

@@ -0,0 +1,805 @@
+/**
+ * 故事图 → 中文 Markdown 导出。
+ *
+ * 输出目录固定为项目根下的「导出」。数据库是唯一真源；这里只做只读渲染，
+ * 不生成阶段 JSON，也不让 LLM 参与。
+ */
+
+import fs from 'fs';
+import path from 'path';
+
+const STORY = 'story:main';
+const META_FIELDS = new Set([
+  'id', 'payload', 'story', 'created_at', 'updated_at', 'entity_id',
+  'from_id', 'to_id', 'supersedes', 'chapter_id', 'outline_id', 'scene_order',
+]);
+
+const FIELD_ORDER = [
+  'name', 'title', 'type', 'kind', 'role_slot', 'faction', 'description',
+  'goal', 'flaw', 'golden_finger', 'arc', 'voice', 'traits', 'information_state', 'exit',
+  'premise', 'theme', 'tone', 'world_rules', 'power_system', 'social_order', 'taboos',
+  'core_imagery', 'reader_promise', 'core_question', 'core_conflict', 'structure',
+  'anti_tropes', 'promise', 'start', 'turning', 'resolution', 'level', 'direction',
+  'setup', 'clues', 'payoff_target', 'recovery_requirement', 'red_herrings', 'scope',
+  'scale', 'payoff', 'required_setup', 'emotional_effect', 'participants', 'stakes',
+  'category', 'item_function', 'owner', 'limit', 'resources', 'territory', 'internal_conflict',
+  'info_name', 'who_knows', 'who_does_not_know', 'resolution_method', 'writing_ban',
+  'must_write', 'must_not_write', 'continuity', 'ending', 'goal', 'obstacle', 'turn',
+  'outcome', 'location', 'cast', 'content', 'word_count', 'end_location', 'end_time',
+  'end_characters', 'open_threads', 'next_scene_hint', 'continuity_notes', 'status',
+];
+
+function isEmpty(value) {
+  if (value === null || value === undefined || value === '') return true;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === 'object') return Object.keys(value).length === 0;
+  return false;
+}
+
+function fieldRank(key) {
+  const index = FIELD_ORDER.indexOf(key);
+  return index === -1 ? 1000 : index;
+}
+
+const LABELS = {
+  title: '标题', genre: '题材', platform: '平台', target_chapters: '目标章数',
+  target_words: '目标字数', avg_words_per_chapter: '平均每章字数', status: '状态',
+  capacity: '容量', structure: '结构', quotas: '配额', rhythm_budget: '节奏预算',
+  distribution: '分布', constraints: '约束', formulas: '公式', derivations: '推导',
+  genre_profile: '题材档案', formula_version: '公式版本',
+  volume_id: '卷ID', act_id: '幕ID', line_id: '线索ID', node_id: '节点ID',
+  ending_id: '结局ID', role_id: '功能位ID', chapter_id: '章节ID', display_no: '章号',
+  chapter_start: '起始章', chapter_end: '结束章', goal: '目标', core_conflict: '核心冲突',
+  emotional_arc: '情感弧线', ending_hook: '卷末钩子', act_index: '幕序号', climax: '高潮',
+  name: '名称', type: '类型', kind: '类型', description: '描述', narrative_function: '叙事功能',
+  rules: '规则', premise: '前提', theme: '主题', tone: '语气', world_rules: '世界规则',
+  power_system: '力量体系', social_order: '社会秩序', taboos: '禁忌',
+  core_imagery: '核心意象', reader_promise: '读者承诺', core_question: '核心问题',
+  anti_tropes: '反套路', promise: '承诺', start: '起点', turning: '转折',
+  resolution: '收束', interweaves: '交织', level: '层级', direction: '方向',
+  required_foreshadow_recovery: '必须回收的伏笔', slot_function: '功能', quota_key: '配额键',
+  role_slot: '功能位', faction: '势力', flaw: '缺陷', golden_finger: '金手指',
+  information_state: '信息状态', arc: '弧光', voice: '说话风格', traits: '特征', exit: '退场',
+  resources: '资源', territory: '地盘', internal_conflict: '内部矛盾',
+  category: '分类', item_function: '道具功能', owner: '持有者', limit: '限制',
+  related_characters: '关联人物', related_conflicts: '关联冲突', stakes: '代价',
+  escalation_path: '升级路径', resolution_plan: '解决计划', participants: '参与者',
+  setup: '铺垫', clues: '线索', payoff_target: '回收目标', recovery_requirement: '回收要求',
+  red_herrings: '误导项', scope: '范围', initial_knowledge: '初始认知', scale: '规模',
+  payoff: '兑现', emotional_effect: '情绪效果', required_setup: '必需铺垫',
+  info_name: '信息差名称', who_knows: '知情者', who_does_not_know: '不知情者',
+  resolution_method: '揭晓方式', writing_ban: '写作禁令', time: '时间', why: '为什么写',
+  how: '怎么写', emotion: '情绪', hook: '钩子', word_target: '目标字数',
+  must_write: '必写', must_not_write: '禁写', continuity: '连贯性', coverage: '覆盖',
+  ending: '结尾', scene_order: '场景序号', obstacle: '障碍', outcome: '结果',
+  location: '地点', cast: '出场人物', content: '正文', word_count: '字数',
+  end_location: '章末地点', end_time: '章末时间', end_characters: '章末人物',
+  open_threads: '未结线索', next_scene_hint: '下一场提示', continuity_notes: '连贯备注',
+  text: '说明', reason: '理由', source: '来源', reference: '参考', due_chapter: '到期章',
+  hard: '必填', label: '标签', action: '动作', detail: '详情', chapter_no: '章号',
+  relation: '关系', change: '变化', subject_type: '对象类型', subject_id: '对象ID',
+  character_id: '人物ID', knowledge: '已知内容', evidence: '证据', scene: '场景',
+  turn: '转折', story_day: '故事日', clock: '时刻', duration_minutes: '时长（分钟）',
+  phase: '情绪阶段', value: '数值', strength: '强度', function_main: '本章主功能', function_aux: '本章辅助功能', ending_hook: '章末钩子',
+  from_prev: '承接上一章', to_next: '交给下一章',
+};
+
+function label(key) {
+  return LABELS[key] || key;
+}
+
+function esc(value) {
+  return String(value == null ? '' : value)
+    .replace(/\|/g, '\\|')
+    .replace(/\r?\n/g, ' ');
+}
+
+function table(headers, rows) {
+  if (!rows.length) return '（暂无）\n';
+  const lines = [
+    '| ' + headers.map(esc).join(' | ') + ' |',
+    '|' + headers.map(() => '---').join('|') + '|',
+  ];
+  for (const row of rows) lines.push('| ' + row.map(esc).join(' | ') + ' |');
+  return lines.join('\n') + '\n';
+}
+
+function inline(value) {
+  if (value == null || value === '') return '—';
+  if (Array.isArray(value)) return value.map((v) => inline(v)).join('、');
+  if (typeof value === 'object') {
+    return Object.entries(value)
+      .filter(([, v]) => v != null && v !== '')
+      .map(([k, v]) => label(k) + '：' + inline(v))
+      .join('；');
+  }
+  return String(value);
+}
+
+function bullets(values) {
+  if (!Array.isArray(values) || !values.length) return '—';
+  return values.map((value) => '- ' + inline(value)).join('\n');
+}
+
+function block(value) {
+  if (value == null || value === '') return '—\n';
+  if (Array.isArray(value)) return bullets(value) + '\n';
+  if (typeof value === 'object') {
+    const lines = [];
+    for (const [key, val] of Object.entries(value)) {
+      if (val == null || val === '') continue;
+      lines.push('- ' + label(key) + '：' + inline(val));
+    }
+    return (lines.length ? lines.join('\n') : '—') + '\n';
+  }
+  return String(value).trim() + '\n';
+}
+
+function fields(obj, level = '###') {
+  const lines = [];
+  const entries = Object.entries(obj || {})
+    .filter(([key, value]) => !META_FIELDS.has(key) && !isEmpty(value))
+    .sort(([a], [b]) => fieldRank(a) - fieldRank(b) || a.localeCompare(b));
+  for (const [key, value] of entries) {
+    lines.push('', level + ' ' + label(key), '', block(value).trimEnd());
+  }
+  return lines.join('\n');
+}
+
+function safeName(value, fallback = '未命名', max = 70) {
+  const text = String(value || fallback).replace(/[\\/:*?"<>|]/g, '-').replace(/\s+/g, ' ').trim();
+  return (text || fallback).slice(0, max);
+}
+
+function pad3(value) {
+  return String(value).padStart(3, '0');
+}
+
+function ensureDir(dir) {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+async function count(sdb, tableName) {
+  const rows = await sdb.rows(`SELECT count() FROM ${tableName} WHERE story = ${STORY} GROUP ALL;`);
+  return Number(rows[0] && rows[0].count) || 0;
+}
+
+async function renderOverview(sdb) {
+  const story = await sdb.one('SELECT * FROM story:main;') || {};
+  const tables = [
+    ['volume', '卷'], ['act', '幕'], ['character', '人物'], ['faction', '势力'],
+    ['location', '地点'], ['item', '道具'], ['conflict', '冲突'], ['foreshadow', '伏笔'],
+    ['payoff', '爽点'], ['climax', '高潮'], ['information', '信息差'], ['chapter', '章节'],
+    ['outline', '细纲'], ['chapter_text', '正文'], ['decision', '设计决策'],
+  ];
+  const rows = [];
+  for (const [key, name] of tables) rows.push([name, await count(sdb, key)]);
+  return [
+    '# 故事总览',
+    '',
+    '## 基本信息',
+    '',
+    table(['字段', '内容'], [
+      ['书名', story.title || '未命名'],
+      ['题材', story.genre || '—'],
+      ['平台', story.platform || '—'],
+      ['目标章数', story.target_chapters || 0],
+      ['目标字数', story.target_words || 0],
+      ['平均每章字数', story.avg_words_per_chapter || 0],
+      ['状态', story.status || '—'],
+    ]).trimEnd(),
+    '',
+    '## 数据规模',
+    '',
+    table(['内容', '数量'], rows).trimEnd(),
+    '',
+    '## 导出说明',
+    '',
+    '本目录由 `fancy-export` 从 SurrealDB 故事图导出，内容为中文 Markdown。',
+    '数据库是唯一真源；修改导出文件不会回写数据库。',
+    '',
+  ].join('\n');
+}
+
+async function renderScale(sdb) {
+  const scale = await sdb.one('SELECT * FROM scale:main;');
+  const volumes = await sdb.rows(`SELECT * FROM volume WHERE story = ${STORY} ORDER BY chapter_start;`);
+  const acts = await sdb.rows(`SELECT * FROM act WHERE story = ${STORY} ORDER BY chapter_start;`);
+  const lines = ['# 规模与结构', ''];
+  if (!scale) {
+    lines.push('（暂无规模数据）', '');
+    return lines.join('\n');
+  }
+  lines.push('## 容量', '', fields(scale.capacity || {}, '###').trim(), '');
+  lines.push('## 配额', '', block(scale.quotas || {}).trim(), '');
+  lines.push('## 卷', '', table(
+    ['卷', '标题', '章节范围', '目标', '核心冲突', '情感弧线', '卷末钩子'],
+    volumes.map((v) => [v.volume_id, v.title, `${v.chapter_start}-${v.chapter_end}`, v.goal, v.core_conflict, v.emotional_arc, v.ending_hook]),
+  ).trim(), '');
+  lines.push('## 幕', '', table(
+    ['幕', '所属卷', '章节范围', '目标', '高潮'],
+    acts.map((a) => [a.act_id, a.volume_id, `${a.chapter_start}-${a.chapter_end}`, a.goal, a.climax]),
+  ).trim(), '');
+  return lines.join('\n');
+}
+
+async function renderMacro(sdb) {
+  const world = await sdb.one('SELECT * FROM world_doc WHERE story = ' + STORY + ' LIMIT 1;');
+  const story = await sdb.one('SELECT * FROM story_doc WHERE story = ' + STORY + ' LIMIT 1;');
+  const lines = ['# 世界观与故事', ''];
+  if (world) lines.push('## 世界观', '', fields(world, '###').trim(), '');
+  if (story) lines.push('## 故事核心', '', fields(story, '###').trim(), '');
+  const lineRows = await sdb.rows(`SELECT * FROM line WHERE story = ${STORY} ORDER BY kind, line_id;`);
+  const main = lineRows.filter((row) => row.kind === 'main');
+  const branch = lineRows.filter((row) => row.kind !== 'main');
+  for (const [title, rows] of [['主线', main], ['支线', branch]]) {
+    if (!rows.length) continue;
+    lines.push('## ' + title, '');
+    for (const line of rows) {
+      lines.push('### ' + (line.name || line.line_id));
+      lines.push('', fields({ goal: line.goal, start: line.start, turning: line.turning, resolution: line.resolution, interweaves: line.interweaves }, '####').trim(), '');
+      const nodes = await sdb.rows(
+        `SELECT * FROM line_node WHERE story = ${STORY} AND line_id = $id ORDER BY node_id;`,
+        { id: line.line_id },
+      );
+      if (nodes.length) {
+        lines.push(table(['节点', '卷', '幕', '目标', '转折'], nodes.map((n) => [n.node_id, n.volume, n.act, n.goal, n.turn])).trim(), '');
+      }
+    }
+  }
+  const endings = await sdb.rows(`SELECT * FROM ending WHERE story = ${STORY} ORDER BY ending_id;`);
+  if (endings.length) {
+    lines.push('## 结局', '');
+    for (const ending of endings) {
+      lines.push('### ' + (ending.ending_id || '') + ' ' + (ending.type || ''));
+      lines.push('', fields(ending, '####').trim(), '');
+    }
+  }
+  return lines.join('\n');
+}
+
+async function renderCharacters(sdb) {
+  const rows = await sdb.rows(`SELECT * FROM character WHERE story = ${STORY} ORDER BY entity_id;`);
+  const relations = await sdb.rows(`SELECT * FROM relation WHERE story = ${STORY};`);
+  const names = new Map(rows.map((row) => [row.entity_id, row.name]));
+  const lines = ['# 人物', ''];
+  for (const row of rows) {
+    lines.push('## ' + (row.name || row.entity_id) + '（' + row.entity_id + '）', '');
+    lines.push(fields(row, '###').trim(), '');
+    const rels = relations.filter((r) => r.from_id === row.entity_id || r.to_id === row.entity_id);
+    if (rels.length) {
+      lines.push('### 关系', '');
+      lines.push(table(
+        ['对方', '关系', '初始状态', '变化'],
+        rels.map((r) => {
+          const other = r.from_id === row.entity_id ? r.to_id : r.from_id;
+          return [names.get(other) || other, r.kind, r.initial_state, r.changes];
+        }),
+      ).trim(), '');
+    }
+  }
+  return lines.join('\n');
+}
+
+async function renderSimpleEntity(sdb, title, tableName, idField = 'entity_id', nameField = 'name') {
+  const rows = await sdb.rows(`SELECT * FROM ${tableName} WHERE story = ${STORY} ORDER BY ${idField};`);
+  const lines = ['# ' + title, ''];
+  for (const row of rows) {
+    const id = row[idField] || '';
+    const name = row[nameField] || id;
+    lines.push('## ' + name + (id ? '（' + id + '）' : ''), '');
+    lines.push(fields(row, '###').trim(), '');
+  }
+  return lines.join('\n');
+}
+
+async function renderRelations(sdb) {
+  const characters = await sdb.rows(`SELECT entity_id, name FROM character WHERE story = ${STORY};`);
+  const names = new Map(characters.map((row) => [row.entity_id, row.name]));
+  const relations = await sdb.rows(`SELECT * FROM relation WHERE story = ${STORY} ORDER BY from_id, to_id;`);
+  const factions = await sdb.rows(`SELECT entity_id, name FROM faction WHERE story = ${STORY};`);
+  const factionNames = new Map(factions.map((row) => [row.entity_id, row.name]));
+  const fr = await sdb.rows(`SELECT * FROM faction_relation WHERE story = ${STORY} ORDER BY from_id, to_id;`);
+  const membership = await sdb.rows(`SELECT * FROM membership WHERE story = ${STORY} ORDER BY from_id, to_id;`);
+  return [
+    '# 人物与势力关系',
+    '',
+    '## 人物关系',
+    '',
+    table(['从', '到', '关系', '初始状态', '变化'], relations.map((r) => [
+      names.get(r.from_id) || r.from_id, names.get(r.to_id) || r.to_id, r.kind, r.initial_state, r.changes,
+    ])).trim(),
+    '',
+    '## 势力关系',
+    '',
+    table(['从', '到', '关系', '初始状态', '变化'], fr.map((r) => [
+      factionNames.get(r.from_id) || r.from_id, factionNames.get(r.to_id) || r.to_id, r.kind, r.initial_state, r.changes,
+    ])).trim(),
+    '',
+    '## 人物所属势力',
+    '',
+    table(['人物', '势力', '角色'], membership.map((r) => [
+      names.get(r.from_id) || r.from_id, factionNames.get(r.to_id) || r.to_id, r.role,
+    ])).trim(),
+    '',
+  ].join('\n');
+}
+
+async function renderChapters(sdb) {
+  const rows = await sdb.rows(`SELECT * FROM chapter WHERE story = ${STORY} ORDER BY display_no;`);
+  return [
+    '# 章节地图',
+    '',
+    table(
+      ['章', 'ID', '标题', '卷', '幕', 'POV', '时间', '情绪', '钩子', '目标字数', '状态'],
+      rows.map((c) => [
+        c.display_no, c.chapter_id, c.title, c.volume, c.act, c.pov,
+        inline(c.time), inline(c.emotion), inline(c.hook), c.word_target, c.status,
+      ]),
+    ).trim(),
+    '',
+  ].join('\n');
+}
+
+function stripRecord(value) {
+  return String(value == null ? '' : value).split(':').pop().replace(/[⟨⟩]/g, '');
+}
+
+function indexBy(rows, key, name) {
+  const map = new Map();
+  for (const row of rows || []) {
+    const id = typeof key === 'function' ? key(row) : row[key];
+    if (id != null) map.set(String(id), row);
+  }
+  return map;
+}
+
+function groupBy(rows, key) {
+  const map = new Map();
+  for (const row of rows || []) {
+    const id = stripRecord(typeof key === 'function' ? key(row) : row[key]);
+    if (!id) continue;
+    if (!map.has(id)) map.set(id, []);
+    map.get(id).push(row);
+  }
+  return map;
+}
+
+function entityName(map, id, fallback = '') {
+  const row = map.get(stripRecord(id));
+  return row ? (row.name || row.title || row.info_name || row.entity_id || fallback) : (fallback || stripRecord(id));
+}
+
+function chapterActionVerb(kind, action) {
+  if (kind === 'foreshadow') return { plant: '埋设', progress: '推进', reveal: '回收' }[action] || action;
+  if (kind === 'payoff') return { setup: '铺垫', payoff: '兑现' }[action] || action;
+  if (kind === 'information') return { created: '建立', progressed: '推进', resolved: '解决' }[action] || action;
+  return action || '';
+}
+
+async function loadOutlineGraph(sdb) {
+  const query = (table, order = '') => sdb.rows(
+    `SELECT * FROM ${table} WHERE story = ${STORY}${order ? ' ORDER BY ' + order : ''};`,
+  );
+  const [
+    chapters, outlines, scenes,
+    chapterCasts, chapterLocations, chapterNodes, chapterBranches, chapterConflicts,
+    chapterClimaxes, chapterItems, outlineCasts, outlineLocations,
+    foreshadowActions, payoffActions, infoActions, endingActions, knowledgeEvents,
+    characters, locations, conflicts, lineNodes, lines, foreshadows, payoffs, information, climaxes, items, endings,
+    volumes, acts,
+  ] = await Promise.all([
+    query('chapter', 'display_no'),
+    query('outline', 'number, chapter_id'),
+    query('scene', 'outline_id, scene_order'),
+    query('chapter_cast'),
+    query('chapter_location'),
+    query('chapter_line_node'),
+    query('chapter_branch'),
+    query('chapter_conflict'),
+    query('chapter_climax'),
+    query('chapter_item'),
+    query('outline_cast'),
+    query('outline_location'),
+    query('foreshadow_action'),
+    query('payoff_action'),
+    query('info_action'),
+    query('ending_action'),
+    query('knowledge_event', 'chapter_no, created_at'),
+    query('character', 'entity_id'),
+    query('location', 'entity_id'),
+    query('conflict', 'entity_id'),
+    query('line_node', 'node_id'),
+    query('line', 'line_id'),
+    query('foreshadow', 'entity_id'),
+    query('payoff', 'entity_id'),
+    query('information', 'entity_id'),
+    query('climax', 'entity_id'),
+    query('item', 'entity_id'),
+    query('ending', 'ending_id'),
+    query('volume', 'chapter_start'),
+    query('act', 'chapter_start'),
+  ]);
+  return {
+    chapters: indexBy(chapters, 'chapter_id'),
+    outlines,
+    scenes: groupBy(scenes, 'outline_id'),
+    chapterCasts: groupBy(chapterCasts, 'from_id'),
+    chapterLocations: groupBy(chapterLocations, 'from_id'),
+    chapterNodes: groupBy(chapterNodes, 'from_id'),
+    chapterBranches: groupBy(chapterBranches, 'from_id'),
+    chapterConflicts: groupBy(chapterConflicts, 'from_id'),
+    chapterClimaxes: groupBy(chapterClimaxes, 'from_id'),
+    chapterItems: groupBy(chapterItems, 'from_id'),
+    outlineCasts: groupBy(outlineCasts, 'from_id'),
+    outlineLocations: groupBy(outlineLocations, 'from_id'),
+    foreshadowActions: groupBy(foreshadowActions, 'from_id'),
+    payoffActions: groupBy(payoffActions, 'from_id'),
+    infoActions: groupBy(infoActions, 'from_id'),
+    endingActions: groupBy(endingActions, 'from_id'),
+    knowledgeEvents: groupBy(knowledgeEvents, 'chapter_no'),
+    characters: indexBy(characters, 'entity_id'),
+    locations: indexBy(locations, 'entity_id'),
+    conflicts: indexBy(conflicts, 'entity_id'),
+    lineNodes: indexBy(lineNodes, 'node_id'),
+    lines: indexBy(lines, 'line_id'),
+    foreshadows: indexBy(foreshadows, 'entity_id'),
+    payoffs: indexBy(payoffs, 'entity_id'),
+    information: indexBy(information, 'entity_id'),
+    climaxes: indexBy(climaxes, 'entity_id'),
+    items: indexBy(items, 'entity_id'),
+    endings: indexBy(endings, 'ending_id'),
+    volumes: indexBy(volumes, 'volume_id'),
+    acts: indexBy(acts, 'act_id'),
+  };
+}
+
+async function renderOutlineFiles(sdb, write) {
+  const graph = await loadOutlineGraph(sdb);
+  let count = 0;
+  for (const outline of graph.outlines) {
+    const chapter = graph.chapters.get(outline.chapter_id) || {};
+    const no = Number(chapter.display_no || outline.number || 0);
+    const title = outline.title || chapter.title || outline.chapter_id;
+    const rel = path.join('15-细纲', `第${pad3(no)}章-${safeName(title)}.md`);
+    const chapterId = outline.chapter_id;
+    const casts = graph.chapterCasts.get(chapterId) || [];
+    const outlineCasts = graph.outlineCasts.get(chapterId) || [];
+    const locations = graph.chapterLocations.get(chapterId) || [];
+    const outlineLocations = graph.outlineLocations.get(chapterId) || [];
+    const nodeEdges = graph.chapterNodes.get(chapterId) || [];
+    const branchEdges = graph.chapterBranches.get(chapterId) || [];
+    const conflictEdges = graph.chapterConflicts.get(chapterId) || [];
+    const climaxEdges = graph.chapterClimaxes.get(chapterId) || [];
+    const itemEdges = graph.chapterItems.get(chapterId) || [];
+    const fsActions = graph.foreshadowActions.get(chapterId) || [];
+    const payActions = graph.payoffActions.get(chapterId) || [];
+    const infoActions = graph.infoActions.get(chapterId) || [];
+    const endActions = graph.endingActions.get(chapterId) || [];
+    const knowledge = graph.knowledgeEvents.get(String(no)) || [];
+    const why = chapter.why || {};
+    const how = chapter.how || {};
+    const lines = ['# 第' + no + '章 ' + title, ''];
+
+    const volume = graph.volumes.get(chapter.volume || outline.volume) || {};
+    const act = graph.acts.get(chapter.act || outline.act) || {};
+    lines.push('## 基本信息', '');
+    lines.push(table(['项目', '内容'], [
+      ['卷', (volume.volume_id || chapter.volume || '—') + (volume.title ? ' ' + volume.title : '')],
+      ['幕', act.act_id || chapter.act || '—'],
+      ['章', '第' + no + '章' + (title ? ' ' + title : '') + '（' + chapterId + '）'],
+      ['视角人物', entityName(graph.characters, chapter.pov || outline.pov, chapter.pov || '—')],
+      ['时间', inline(chapter.time || outline.time)],
+      ['情绪', inline(chapter.emotion)],
+      ['目标字数', chapter.word_target || outline.word_target || '—'],
+      ['状态', chapter.status || outline.status || '—'],
+    ]).trim(), '');
+
+    lines.push('## 卷纲', '');
+    lines.push('- 卷：' + (volume.volume_id || chapter.volume || '—') + (volume.title ? ' ' + volume.title : ''));
+    if (volume.chapter_start || volume.chapter_end) lines.push('- 章节范围：' + (volume.chapter_start || '—') + '-' + (volume.chapter_end || '—'));
+    if (volume.goal) lines.push('- 卷目标：' + volume.goal);
+    if (volume.core_conflict) lines.push('- 核心冲突：' + volume.core_conflict);
+    if (volume.emotional_arc) lines.push('- 情感弧线：' + volume.emotional_arc);
+    if (volume.ending_hook) lines.push('- 卷末钩子：' + volume.ending_hook);
+    lines.push('');
+
+    lines.push('## 幕纲', '');
+    lines.push('- 幕：' + (act.act_id || chapter.act || '—'));
+    if (act.chapter_start || act.chapter_end) lines.push('- 章节范围：' + (act.chapter_start || '—') + '-' + (act.chapter_end || '—'));
+    if (act.goal) lines.push('- 幕目标：' + act.goal);
+    if (act.climax) lines.push('- 幕高潮：' + act.climax);
+    lines.push('');
+
+    lines.push('## 章纲', '');
+    const chapterEndingHook = how.ending_hook || (outline.ending && (outline.ending.text || outline.ending.hook)) || inline(chapter.hook);
+    if (chapterEndingHook) lines.push('- 章末钩子：' + chapterEndingHook);
+    lines.push('');
+    const mainParts = [];
+    for (const edge of nodeEdges) {
+      const node = graph.lineNodes.get(stripRecord(edge.to_id));
+      const line = node && graph.lines.get(node.line_id);
+      mainParts.push('- 主线节点 `' + stripRecord(edge.to_id) + '`' + (line ? '：' + line.name : '') + (node && node.goal ? '｜目标：' + node.goal : ''));
+    }
+    for (const edge of branchEdges) {
+      mainParts.push('- 支线 `' + stripRecord(edge.to_id) + '`：' + entityName(graph.lines, edge.to_id));
+    }
+    lines.push('### 主线与支线', '');
+    lines.push(mainParts.length ? mainParts.join('\n') : '（本章没有主线/支线节点边）', '');
+    if (why.theme || why.stakes) {
+      lines.push('### 本章主题与代价', '', '- 主题：' + (why.theme || '—'), '- 代价：' + (why.stakes || '—'), '');
+    }
+    if (how.function_main || how.function_aux || how.turn || how.ending_hook) {
+      lines.push('### 本章写法', '');
+      if (how.function_main) lines.push('- 主功能：' + how.function_main);
+      if (how.function_aux) lines.push('- 辅助功能：' + how.function_aux);
+      if (how.turn) lines.push('- 转折：' + how.turn);
+      if (how.ending_hook) lines.push('- 章末钩子：' + how.ending_hook);
+      lines.push('');
+    }
+
+    const castSource = casts.length ? casts : outlineCasts;
+    const castIds = new Set(castSource.map((edge) => stripRecord(edge.to_id || edge.out)));
+    const conflictParts = conflictEdges.map((edge) => {
+      const conflict = graph.conflicts.get(stripRecord(edge.to_id)) || {};
+      return '- `' + stripRecord(edge.to_id) + '` ' + (conflict.name || '') + '：' + (conflict.description || conflict.core_goal || '—') + (conflict.stakes ? '｜代价：' + conflict.stakes : '');
+    });
+    lines.push('### 本章关联冲突（可能是背景）', '');
+    lines.push(conflictParts.length ? conflictParts.join('\n') : '（本章没有挂 chapter_conflict）', '');
+    const conflictParticipants = new Set();
+    for (const edge of conflictEdges) {
+      const conflict = graph.conflicts.get(stripRecord(edge.to_id)) || {};
+      for (const id of (conflict.participants || [])) conflictParticipants.add(String(id));
+    }
+    if (conflictParticipants.size) {
+      const participantRows = [...conflictParticipants].map((id) => {
+        const character = graph.characters.get(id) || {};
+        return [character.name || id, id, character.type || '—', castIds.has(id) ? '本章 cast' : '未在本章 cast'];
+      });
+      lines.push('#### 冲突参与者（设定）', '');
+      lines.push(table(['角色', 'ID', '类型', '状态'], participantRows).trim(), '');
+      const missing = [...conflictParticipants].filter((id) => !castIds.has(id));
+      if (missing.length) {
+        lines.push('> 注意：' + missing.map((id) => entityName(graph.characters, id)).join('、') + ' 属于该冲突的设定参与者，但未出现在本章 `chapter_cast`/`outline_cast`。如果本章确实出场，rhythm 阶段需要补 cast 边；如果只是背景，保持现状。', '');
+      }
+    }
+
+    lines.push('## 出场人物', '');
+    const castRows = casts.length ? casts : outlineCasts;
+    lines.push(table(['角色', 'ID', '定位', '功能位'], castRows.map((edge) => {
+      const id = stripRecord(edge.to_id || edge.out);
+      const character = graph.characters.get(id) || {};
+      return [character.name || id, id, edge.role || character.type || '—', character.role_slot || '—'];
+    })).trim(), '');
+
+    lines.push('## 地点', '');
+    const locationRows = (locations.length ? locations : outlineLocations).map((edge) => {
+      const id = stripRecord(edge.to_id || edge.out);
+      const location = graph.locations.get(id) || {};
+      return [location.name || id, id, location.type || '—', location.narrative_function || '—'];
+    });
+    lines.push(table(['地点', 'ID', '类型', '叙事功能'], locationRows).trim(), '');
+
+    lines.push('## 道具', '');
+    let itemRows = itemEdges.map((edge) => {
+      const id = stripRecord(edge.to_id);
+      const item = graph.items.get(id) || {};
+      return [item.name || id, id, item.category || '—', item.item_function || item.owner || '—'];
+    });
+    let itemNote = '';
+    if (!itemRows.length) {
+      const castIds = new Set(castRows.map((edge) => stripRecord(edge.to_id || edge.out)));
+      const conflictIds = new Set(conflictEdges.map((edge) => stripRecord(edge.to_id)));
+      itemRows = [...graph.items.values()].filter((item) => {
+        if (item.category !== 'core') return false;
+        if (item.owner && castIds.has(String(item.owner))) return true;
+        if ((item.related_characters || []).some((id) => castIds.has(String(id)))) return true;
+        return (item.related_conflicts || []).some((id) => conflictIds.has(String(id)));
+      }).map((item) => [item.name, item.entity_id, item.category || '—', item.item_function || item.owner || '—']);
+      if (itemRows.length) itemNote = '（按本章人物/冲突关联推断，不是 chapter_item 明确指定）';
+    }
+    lines.push(itemNote, table(['道具', 'ID', '分类', '功能/持有者'], itemRows).trim(), '');
+
+    lines.push('## 伏笔', '');
+    const fsLines = fsActions.map((edge) => {
+      const id = stripRecord(edge.to_id);
+      const fs = graph.foreshadows.get(id) || {};
+      return '- **' + chapterActionVerb('foreshadow', edge.action) + '** `' + id + '` ' + (fs.name || '') + (edge.detail ? '｜本章动作：' + edge.detail : '') + (fs.setup ? '\n  - 原设定：' + fs.setup : '') + (fs.recovery_requirement ? '\n  - 回收要求：' + fs.recovery_requirement : '');
+    });
+    lines.push(fsLines.length ? fsLines.join('\n') : '（本章没有 foreshadow_action）', '');
+
+    lines.push('## 爽点', '');
+    const payLines = payActions.map((edge) => {
+      const id = stripRecord(edge.to_id);
+      const payoff = graph.payoffs.get(id) || {};
+      return '- **' + chapterActionVerb('payoff', edge.action) + '** `' + id + '` ' + (payoff.name || '') + (edge.detail ? '｜本章动作：' + edge.detail : '') + (payoff.setup ? '\n  - 原铺垫：' + payoff.setup : '') + (payoff.payoff ? '\n  - 兑现：' + payoff.payoff : '');
+    });
+    lines.push(payLines.length ? payLines.join('\n') : '（本章没有 payoff_action）', '');
+
+    lines.push('## 信息差', '');
+    const characterNames = (ids) => (Array.isArray(ids) ? ids : [])
+      .map((id) => entityName(graph.characters, id))
+      .join('、');
+    const infoLines = infoActions.map((edge) => {
+      const id = stripRecord(edge.to_id);
+      const info = graph.information.get(id) || {};
+      return '- **' + chapterActionVerb('information', edge.action) + '** `' + id + '` ' + (info.info_name || '') + (edge.detail ? '｜本章动作：' + edge.detail : '') + (info.who_knows ? '\n  - 知情：' + characterNames(info.who_knows) : '') + (info.who_does_not_know ? '\n  - 不知情：' + characterNames(info.who_does_not_know) : '') + (info.resolution_method ? '\n  - 揭晓方式：' + info.resolution_method : '');
+    });
+    lines.push(infoLines.length ? infoLines.join('\n') : '（本章没有 info_action）', '');
+
+    lines.push('## 高潮', '');
+    const climaxLines = climaxEdges.map((edge) => {
+      const id = stripRecord(edge.to_id);
+      const climax = graph.climaxes.get(id) || {};
+      return '- `' + id + '` ' + (climax.name || '') + (climax.type ? '（' + climax.type + '）' : '') + (climax.description ? '：' + climax.description : '');
+    });
+    lines.push(climaxLines.length ? climaxLines.join('\n') : '（本章没有 chapter_climax；如果是高潮章，rhythm 阶段需要补这条边）', '');
+
+    if (endActions.length) {
+      lines.push('## 结局动作', '');
+      lines.push(endActions.map((edge) => {
+        const ending = graph.endings.get(stripRecord(edge.to_id)) || {};
+        return '- `' + stripRecord(edge.to_id) + '` ' + (ending.type || '') + (edge.detail ? '：' + edge.detail : '');
+      }).join('\n'), '');
+    }
+
+    if (knowledge.length) {
+      lines.push('## 知识变化', '');
+      lines.push(knowledge.map((row) => '- `' + row.character_id + '` 对 `' + row.subject_id + '`：' + chapterActionVerb('information', row.change) + ' → ' + row.coverage + (row.knowledge ? '｜' + row.knowledge : '')).join('\n'), '');
+    }
+
+    lines.push('## 必写', '');
+    lines.push(bullets(outline.must_write).trim(), '');
+    lines.push('## 禁写', '');
+    lines.push(bullets(outline.must_not_write).trim(), '');
+
+    lines.push('## 场景', '');
+    const scenes = graph.scenes.get(chapterId) || [];
+    if (!scenes.length) {
+      lines.push('（暂无场景）', '');
+    } else {
+      for (const scene of scenes) {
+        lines.push('### 场景 ' + scene.scene_order, '');
+        lines.push(table(['项目', '内容'], [
+          ['目标', scene.goal],
+          ['阻碍', scene.obstacle],
+          ['转折', scene.turn],
+          ['结果', scene.outcome],
+          ['地点', scene.location ? entityName(graph.locations, scene.location) + '（' + scene.location + '）' : '—'],
+          ['出场', (scene.cast || []).map((id) => entityName(graph.characters, id)).join('、') || '—'],
+        ]).trim(), '');
+      }
+    }
+
+    if (outline.continuity) {
+      lines.push('## 连贯性', '', block(outline.continuity).trim(), '');
+    }
+    if (outline.ending) {
+      lines.push('## 章尾', '', block(outline.ending).trim(), '');
+    }
+    if (how.function_main || how.function_aux || how.turn || how.ending_hook) {
+      lines.push('## 写作提示', '', fields(how, '###').trim(), '');
+    }
+
+    write(rel, lines.join('\n'));
+    count += 1;
+  }
+  return count;
+}
+
+async function renderWritingFiles(sdb, write) {
+  const rows = await sdb.rows(`SELECT * FROM chapter_text WHERE story = ${STORY} ORDER BY display_no;`);
+  let count = 0;
+  for (const row of rows) {
+    const chapter = await sdb.one(
+      `SELECT display_no, title FROM chapter WHERE story = ${STORY} AND chapter_id = $id LIMIT 1;`,
+      { id: row.chapter_id },
+    );
+    const no = Number(row.display_no || (chapter && chapter.display_no) || 0);
+    const title = (chapter && chapter.title) || row.chapter_id;
+    const rel = path.join('16-正文', `第${pad3(no)}章-${safeName(title)}.md`);
+    let content = String(row.content || '').trim();
+    content = content.replace(/^#\s+.*\n+/, '');
+    // 正文文件只放正文；handoff 是写作流程元数据，不属于正文。
+    const lines = ['# 第' + no + '章 ' + title, '', content, ''];
+    write(rel, lines.join('\n'));
+    count += 1;
+  }
+  return count;
+}
+
+async function renderDecisions(sdb) {
+  const rows = await sdb.rows(`SELECT * FROM decision WHERE story = ${STORY} ORDER BY created_at;`);
+  const active = rows.filter((row) => row.status === 'active');
+  const history = rows.filter((row) => row.status !== 'active');
+  const make = (list) => table(
+    ['时间', '范围', '条目', '说明', '来源', '参考', '理由', '状态'],
+    list.map((row) => [row.created_at, row.scope, row.subject, row.text, row.source, row.reference, row.reason, row.status]),
+  ).trim();
+  return [
+    '# 设计决策',
+    '',
+    '## 当前生效',
+    '',
+    make(active),
+    '',
+    '## 历史决策',
+    '',
+    make(history),
+    '',
+  ].join('\n');
+}
+
+async function renderRequirements(sdb) {
+  const rows = await sdb.rows(`SELECT * FROM requirement WHERE story = ${STORY} AND status = 'pending' ORDER BY hard DESC, due_chapter, subject;`);
+  return [
+    '# 待办',
+    '',
+    table(['必填', '类型', '对象', '说明', '到期章'], rows.map((row) => [
+      row.hard ? '是' : '否', row.kind, row.subject, row.label, row.due_chapter,
+    ])).trim(),
+    '',
+  ].join('\n');
+}
+
+function prepareExportDir(root) {
+  const dir = path.join(root, '导出');
+  ensureDir(dir);
+  const manifestPath = path.join(dir, '.fancy-export.json');
+  let old = [];
+  try {
+    const parsed = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+    if (Array.isArray(parsed.generated)) old = parsed.generated;
+  } catch { /* 首次导出 */ }
+  for (const rel of old) {
+    if (typeof rel !== 'string') continue;
+    const target = path.resolve(dir, rel);
+    if (!target.startsWith(path.resolve(dir) + path.sep)) continue;
+    try { fs.rmSync(target, { force: true }); } catch { /* ignore */ }
+  }
+  return { dir, manifestPath };
+}
+
+export async function exportStoryGraph(sdb, projectRoot) {
+  const { dir, manifestPath } = prepareExportDir(projectRoot);
+  const generated = [];
+  const write = (rel, content) => {
+    const target = path.join(dir, rel);
+    ensureDir(path.dirname(target));
+    fs.writeFileSync(target, String(content).trimEnd() + '\n', 'utf8');
+    generated.push(rel);
+  };
+
+  write('00-总览.md', await renderOverview(sdb));
+  write('01-规模与结构.md', await renderScale(sdb));
+  write('02-世界观与故事.md', await renderMacro(sdb));
+  write('04-人物.md', await renderCharacters(sdb));
+  write('05-势力.md', await renderSimpleEntity(sdb, '势力', 'faction'));
+  write('06-地点.md', await renderSimpleEntity(sdb, '地点', 'location'));
+  write('07-道具.md', await renderSimpleEntity(sdb, '道具', 'item'));
+  write('08-冲突.md', await renderSimpleEntity(sdb, '冲突', 'conflict'));
+  write('09-伏笔.md', await renderSimpleEntity(sdb, '伏笔', 'foreshadow'));
+  write('10-爽点.md', await renderSimpleEntity(sdb, '爽点', 'payoff'));
+  write('11-高潮.md', await renderSimpleEntity(sdb, '高潮', 'climax'));
+  write('12-信息差.md', await renderSimpleEntity(sdb, '信息差', 'information', 'entity_id', 'info_name'));
+  write('13-人物与势力关系.md', await renderRelations(sdb));
+  write('14-章节地图.md', await renderChapters(sdb));
+  const outlines = await renderOutlineFiles(sdb, write);
+  const writing = await renderWritingFiles(sdb, write);
+  write('17-设计决策.md', await renderDecisions(sdb));
+  write('18-待办.md', await renderRequirements(sdb));
+
+  fs.writeFileSync(manifestPath, JSON.stringify({
+    generated,
+    generated_at: new Date().toISOString(),
+    outlines,
+    chapters: writing,
+  }, null, 2) + '\n', 'utf8');
+
+  return {
+    dir,
+    files: generated.length + 1,
+    outlines,
+    chapters: writing,
+  };
+}