@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-story-builder/scripts/v2/export-markdown.js

@@ -0,0 +1,794 @@
+/**
+ * v2/export-markdown.js —— 把阶段 JSON 导出成供另一个 LLM 阅读的 Markdown。
+ *
+ * 导出不是复制目录：读者应该看到章节、人物、关系、冲突等内容的
+ * Markdown 结构，而不是一堆和源目录完全相同的 JSON 文件。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { asArray, readJson, stageDir, stageFile } from './core.js';
+import { contractFor } from './contracts.js';
+
+const STAGE_FILE_ORDER = {
+  '10-scale': ['scale.json'],
+  '20-macro': ['world.json', 'story.json', 'volumes.json', 'lines.json', 'endings.json', 'emotion.json', 'roles.json'],
+  '30-cast': ['characters.json', 'factions.json', 'locations.json', 'items.json', 'conflicts.json', 'foreshadows.json', 'climaxes.json', 'payoffs.json', 'relations.json', 'information.json'],
+  '40-rhythm': ['chapter_map.json', 'index.json'],
+  '50-writing': ['ledger.json'],
+  '60-deslop': [],
+};
+
+const KEY_LABELS = {
+  // 通用
+  schema_version: '格式版本', stage: '阶段', status: '状态', checked_at: '检查时间',
+  files: '文件', errors: '错误', warnings: '警告', id: '编号', name: '名称',
+  title: '标题', type: '类型', chapter_id: '章节编号', display_no: '章节序号',
+  chapter: '章节', chapters: '章节列表', content: '内容', description: '描述',
+  note: '备注', reason: '原因', value: '值', values: '值列表', label: '标签',
+  order: '顺序', path: '路径', method: '方法', function: '功能', question: '问题',
+  answer: '答案', goal: '目标', stakes: '赌注', theme: '主题', tone: '基调',
+  premise: '前提', promise: '承诺', recognition: '认知', measure: '度量',
+  limits: '限制', limit: '限制', cost: '代价', impact: '影响', scope: '范围',
+  rules: '规则', exceptions: '例外', layers: '层级', axes: '维度',
+  // 数量与公式
+  formula_version: '公式版本', genre_profile: '题材配置', capacity: '规模参数',
+  target_chapters: '目标章数', target_words: '目标总字数', avg_words_per_chapter: '平均每章字数',
+  base_words_per_chapter: '基准每章字数', chapter_scale: '章节字数换算系数',
+  structure: '结构', volume_count: '卷数', branch_count: '支线数', total_acts: '总幕数',
+  volumes: '卷列表', acts: '幕列表', act: '幕', act_id: '幕编号', act_index: '幕序号',
+  act_count: '幕数', act_chapter_sum: '幕章数合计', chapter_start: '起始章',
+  chapter_end: '结束章', chapter_sum: '章节数合计', ratio: '占比', quotas: '配额',
+  distribution: '分布', rhythm_budget: '节奏预算', hooks: '钩子', reveals: '揭示',
+  reversals: '反转', emotional_peaks: '情绪峰值', golden_three: '黄金三章',
+  hook_strength: '钩子强度', must_establish: '必须建立', min: '最低值', target: '目标值',
+  base_range: '基础区间', base_range_low: '基础区间下界', base_range_high: '基础区间上界',
+  adjusted_range: '调整后区间', range_low: '区间下界', range_high: '区间上界',
+  formula: '公式', field: '字段', scale_field: '数量字段', genre_multiplier: '题材倍率',
+  deviation_reason: '偏离理由', derivation_reasons: '推导理由', derivations: '推导结果',
+  chosen: '已选值', constraints: '约束', no_content_fields: '禁止内容字段',
+  climax_chapters: '高潮章', payoff_chapters: '爽点章', main_lines: '主线',
+  main_line: '主线', branches: '支线', branch: '支线', endings: '结局',
+  information: '信息差', information_gaps: '信息差',
+  // 宏观
+  world: '世界', world_rules: '世界规则', world_setting: '世界设定',
+  power_system: '力量体系', social_order: '社会秩序', taboos: '禁忌',
+  core_imagery: '核心意象', reader_promise: '读者承诺', anti_tropes: '反套路',
+  core_question: '核心问题', core_conflict: '核心冲突', turning_points: '转折点',
+  end_state: '结束状态', internal_conflict: '内部冲突', romance_constraint: '情感线约束',
+  roles: '角色功能位', role_id: '功能位编号', role_slot: '功能位', macro_goal: '宏观目标',
+  arc_question: '弧光问题', expected_strength: '预期强度', participants: '参与者',
+  emotional_arc: '情绪弧', emotion: '情绪', phase: '阶段', intensity: '强度',
+  peaks: '峰值', arc: '弧光', growth: '成长', direction: '方向', level: '层级',
+  required_foreshadow_recovery: '必须回收的伏笔', volume: '卷', volume_id: '卷编号',
+  core_goal: '核心目标', escalation_path: '升级路径', resolution_plan: '解决计划',
+  residual_impact: '残余影响', node_type: '节点类型', resolution: '收束',
+  // 实体
+  characters: '人物', character: '人物', protagonist: '主角', core_supporting: '核心配角',
+  volume_supporting: '卷级配角', core_antagonist: '核心反派', volume_antagonist: '卷级反派',
+  role_slot: '功能位', faction: '势力', description: '描述', flaw: '缺陷',
+  golden_finger: '金手指', information_state: '信息状态', known: '已知', unknown: '未知',
+  false_belief: '误信', catchphrase: '口头禅', rhythm: '节奏', traits: '特征',
+  exit: '退场', short_term: '短期目标', medium_term: '中期目标', long_term: '长期目标',
+  arc: '弧光', stages: '阶段', planned_change: '计划变化', question: '问题',
+  factions: '势力', faction_relations: '势力关系', faction_membership: '成员关系',
+  relations: '关系', character_relations: '人物关系', memberships: '成员关系',
+  from: '从', to: '到', kind: '关系类型', initial_state: '初始状态', trigger: '触发',
+  changes: '变化', position: '位置', resources: '资源', territory: '地盘',
+  internal_conflict: '内部冲突', narrative_function: '叙事功能', locations: '地点',
+  items: '道具', owner: '拥有者', category: '分类', conflicts: '冲突',
+  foreshadows: '伏笔', climaxes: '高潮', payoffs: '爽点', pleasures: '爽点',
+  clues: '线索', setup: '埋设', payoff_target: '回收目标', recovery_requirement: '回收要求',
+  red_herrings: '误导线索', payoff: '兑现', required_setup: '所需铺垫',
+  emotional_effect: '情绪效果', scale: '规模', info_name: '信息名称',
+  who_knows: '知道的人', who_does_not_know: '不知道的人', resolution_method: '揭示方式',
+  writing_ban: '写作禁令', setup: '铺垫', required_setup: '所需铺垫',
+  // 节奏 / 章节
+  chapter_map: '章节地图', chapters: '章节', why: '为什么', how: '怎么写',
+  main_line_nodes: '主线节点', branch_nodes: '支线节点', conflict: '冲突',
+  function_main: '主功能', function_aux: '辅助功能', turn: '转折', ending_hook: '章尾钩子',
+  foreshadow_actions: '伏笔动作', payoff_actions: '爽点动作', information_gaps: '信息差动作',
+  ending_actions: '结局动作', action: '动作', detail: '细节', state: '状态',
+  pov: '视角人物', cast: '出场人物', mentioned: '提及人物', time: '时间',
+  story_day: '故事日', clock: '时钟', duration_minutes: '持续分钟数',
+  word_target: '字数目标', hook: '钩子', strength: '强度',
+  // 细纲
+  chapter: '章节', number: '章号', entry_state: '进入状态', exit_state: '离开状态',
+  locations: '地点', sensory: '感官', role_in_chapter: '本章角色', entry: '进入',
+  exit: '离开', knowledge: '知识状态', scenes: '场景节拍', no: '序号',
+  goal: '目标', obstacle: '阻碍', outcome: '结果', emotion: '情绪',
+  information_gap: '信息差', foreshadow: '伏笔', payoff: '爽点',
+  must_write: '必须写', must_not_write: '绝对不能写', ending: '收束',
+  continuity: '连续性', from_prev: '承接上一章', to_next: '衔接下一章',
+  open_threads: '未闭合线索', coverage: '覆盖矩阵', hard_constraints: '硬约束',
+  soft_suggestions: '软建议', scene_split: '场景拆分', emotion_trend: '情绪趋势',
+  description_focus: '描写重点', pace: '节奏', dialogue_ratio: '对话比例',
+  information_state: '信息状态', knowledge_state: '知识状态',
+  // 台账 / 导出 / 知识时间线
+  ch: '章', knowledge_changes: '知识变化', gained: '获得', lost: '失去',
+  foreshadow_status: '伏笔状态', information_status: '信息差状态',
+  ending_hook: '章尾钩子', word_count: '字数',
+  subject_type: '对象类型', subject_id: '对象编号', change: '变化',
+  knowledge: '知道什么', coverage: '掌握程度', source_character: '来源人物',
+  source_event: '来源事件', scene: '场景', evidence: '依据',
+  initial_knowledge: '初始知识', knowledge_events: '知识事件',
+  from_state: '原状态', to_state: '新状态',
+};
+
+const TOKEN_LABELS = {
+  structure: '结构', branch: '支线', volume: '卷', count: '数量', sum: '合计',
+  character: '人物', characters: '人物', elements: '要素', supporting: '配角',
+  antagonist: '反派', protagonist: '主角', fixed: '固定规则', custom: '自定义公式',
+  conflict: '冲突', conflicts: '冲突', phase: '阶段', item: '道具', items: '道具',
+  location: '地点', locations: '地点', faction: '势力', factions: '势力',
+  foreshadow: '伏笔', foreshadows: '伏笔', climax: '高潮', climaxes: '高潮',
+  pleasure: '爽点', pleasures: '爽点', world: '世界', rule: '规则', rules: '规则',
+  counts: '数量', info: '信息', information: '信息', gaps: '差',
+  relations: '关系', relation: '关系', character_relations: '人物关系',
+  faction_relations: '势力关系', memberships: '成员关系', membership: '成员关系',
+  main: '主线', line: '线', lines: '线', nodes: '节点', node: '节点',
+  start: '开始', end: '结束', high: '上界', low: '下界', range: '区间',
+  base: '基础', adjusted: '调整后', target: '目标', value: '值', values: '值列表',
+  chapter: '章节', chapters: '章节', id: '编号', name: '名称', type: '类型',
+  role: '功能', slot: '位', goal: '目标', stakes: '赌注', theme: '主题',
+  tone: '基调', premise: '前提', promise: '承诺', recognition: '认知',
+  measure: '度量', limits: '限制', limit: '限制', cost: '代价', impact: '影响',
+  scope: '范围', layers: '层级', axes: '维度', description: '描述', content: '内容',
+  note: '备注', reason: '原因', value: '值', label: '标签', order: '顺序',
+  path: '路径', method: '方法', function: '功能', question: '问题',
+  answer: '答案', setup: '铺垫', clues: '线索', payoff: '兑现', target: '目标',
+  red: '误导', herrings: '线索', required: '所需', emotional: '情绪',
+  effect: '效果', info_name: '信息名称', who: '谁', knows: '知道',
+  does: '不', not: '不', know: '知道', resolution: '揭示', writing: '写作',
+  ban: '禁令', chapter_map: '章节地图', main_line: '主线', branch_nodes: '支线节点',
+  main_line_nodes: '主线节点', function_main: '主功能', function_aux: '辅助功能',
+  turn: '转折', ending_hook: '章尾钩子', foreshadow_actions: '伏笔动作',
+  payoff_actions: '爽点动作', information_gaps: '信息差', ending_actions: '结局动作',
+  action: '动作', detail: '细节', state: '状态', pov: '视角人物', cast: '出场人物',
+  mentioned: '提及人物', time: '时间', story_day: '故事日', clock: '时钟',
+  duration_minutes: '持续分钟数', word_target: '字数目标', hook: '钩子',
+  strength: '强度', entry_state: '进入状态', exit_state: '离开状态',
+  role_in_chapter: '本章角色', entry: '进入', exit: '离开', knowledge: '知识状态',
+  scenes: '场景节拍', no: '序号', goal: '目标', obstacle: '阻碍', outcome: '结果',
+  emotion: '情绪', information_gap: '信息差', foreshadow: '伏笔',
+  must_write: '必须写', must_not_write: '绝对不能写', ending: '收束',
+  continuity: '连续性', from_prev: '承接上一章', to_next: '衔接下一章',
+  open_threads: '未闭合线索', coverage: '覆盖矩阵', hard_constraints: '硬约束',
+  soft_suggestions: '软建议', scene_split: '场景拆分', emotion_trend: '情绪趋势',
+  description_focus: '描写重点', pace: '节奏', dialogue_ratio: '对话比例',
+  information_state: '信息状态', knowledge_state: '知识状态', ch: '章',
+  knowledge_changes: '知识变化', gained: '获得', lost: '失去',
+  foreshadow_status: '伏笔状态', information_status: '信息差状态', word_count: '字数',
+  subject_type: '对象类型', subject_id: '对象编号', change: '变化',
+  knowledge_events: '知识事件', initial_knowledge: '初始知识',
+  source_character: '来源人物', source_event: '来源事件', scene: '场景',
+  evidence: '依据', from_state: '原状态', to_state: '新状态',
+};
+
+const VALUE_LABELS = {
+  created: '已创建', progressed: '推进中', resolved: '已解决',
+  planted: '已埋设', recovered: '已回收', reinforced: '已强化',
+  partial: '部分知道', full: '完全知道', unknown: '不知道', false: '误信',
+  witnessed: '亲眼看到', told: '他人告知', inferred: '推断', document: '文书',
+  rumor: '传闻', experience: '亲身经历', none: '无', other: '其他',
+  book: '全书', volume: '卷', serial: '连载', core: '核心',
+  phase: '阶段', branch: '支线', small: '小', medium: '中', large: '大',
+  draft: '草稿', passed: '已通过', stale: '过期', archived: '已归档',
+  learns: '获知', partially_learns: '部分获知', confirms: '确认',
+  corrects: '纠正', forgets: '遗忘', misinforms: '误信',
+  information: '信息差', foreshadow: '伏笔',
+  'ROLE-PROTAGONIST': '主角', 'ROLE-CORE-SUPPORT-01': '核心配角',
+};
+
+// 少量容易漏掉的业务键与枚举键，单独覆盖，避免被通用拆分规则拼成半英文。
+Object.assign(KEY_LABELS, {
+  voice: '语言风格', exit: '退场', interweaves: '交织节点', turning: '转折点',
+  hard_limits: '硬性限制', core: '核心', large: '大', medium: '中', small: '小', character_arc: '人物弧光',
+  social: '社会', symbolic: '象征', aliases: '别名', benchmark: '对标',
+  book_name: '书名', created_at: '创建时间', channel_model: '频道模型',
+  charTotal: '人物总数', core_supporting_appearance_per_10: '核心配角每 10 章出场次数',
+  protagonist_appearance_per_10: '主角每 10 章出场次数', default_words_per_chapter: '默认每章字数',
+  distribution_weights: '分布权重', applies_to_field: '适用字段', apply: '应用',
+  default: '默认', profile: '题材配置', profiles: '题材配置列表',
+  character_elements: '人物要素', climax_elements: '高潮要素', conflict_elements: '冲突要素',
+  ending_elements: '结局要素', faction_elements: '势力要素', foreshadow_elements: '伏笔要素',
+  item_elements: '道具要素', location_elements: '地点要素', pleasure_elements: '爽点要素',
+  world_rule_counts: '世界规则数量', volume_ratio_sum: '卷占比合计',
+  volume_antagonist_count: '卷级反派数量', volume_supporting_count: '卷级配角数量',
+  large_climax_count: '大高潮数量', medium_climax_count: '中高潮数量', small_climax_count: '小高潮数量',
+  branch_conflict_count: '交织冲突数量', phase_conflict_count: '阶段冲突数量',
+  ending_count: '结局数量', faction_count: '势力数量', faction_relation_count: '势力关系数量',
+  large_foreshadow_count: '大伏笔数量', medium_foreshadow_count: '中伏笔数量', small_foreshadow_count: '小伏笔数量',
+  branch_item_count: '支线道具数量', core_item_count: '核心道具数量', symbolic_item_count: '象征道具数量',
+  key_location_count: '关键地点数量', large_pleasure_count: '大爽点数量', medium_pleasure_count: '中爽点数量',
+  small_pleasure_count: '小爽点数量', main_line_count: '主线数量',
+  large_climax: '大高潮', medium_climax: '中高潮', small_climax: '小高潮',
+  large_foreshadow: '大伏笔', medium_foreshadow: '中伏笔', small_foreshadow: '小伏笔',
+  core_setting: '核心设定', base_formula_words_per_chapter: '公式基准每章字数',
+  custom_formula_rule: '自定义公式规则', default_profile: '默认题材配置',
+  emotion_jump_warning: '情绪跳变警告', climax_gap_chapters: '高潮间隔章数',
+  flatline_chapters: '平流章数', expr_high: '表达式上界', expr_low: '表达式下界',
+  BC: '基础章数', CA: '当前幕章数', CC: '冲突数', CS: '章节规模', T: '总章数',
+  V: '卷数', P: '平台系数', n: '数量', Math: '数学函数',
+  channel: '频道', fallback: '回退配置', farming: '种田', first: '第一段',
+  genre: '题材', gt25: '大于 25 章', lt10: '小于 10 章', last: '最后一段',
+  middle: '中间段', missing: '缺失项', new_entities: '新增实体', notes: '备注',
+  one_line_pitch: '一句话卖点', opening_chapters: '开篇章数',
+  opening_hook_multiplier: '开篇钩子倍率', overrides: '覆盖规则',
+  payoff_gap_chapters: '爽点间隔章数', pleasure_density_multiplier: '爽点密度倍率',
+  positioning: '定位', preferred_chapters_per_volume: '每卷推荐章数',
+  profile_file: '题材配置文件', profile_path: '题材配置路径', profile_rule: '题材匹配规则',
+  quality: '质量', reader_value: '读者价值', references: '参考资料',
+  relationships: '关系', rounding: '取整规则', scale_field_rule: '数量字段规则',
+  selling_points: '卖点', shuangwen: '爽文', special_rules: '特殊规则',
+  structure_feature: '结构特征', suspense: '悬疑', version: '版本',
+  volume_length_multiplier: '卷长倍率', volume_supporting_retention: '卷级配角留存率',
+  hook_density_per_chapter: '每章钩子密度', formula_with_multiplier: '带倍率公式',
+  multiplier_category: '倍率分类', multipliers: '倍率',
+  small_foreshadow_recovery: '小伏笔回收', medium_foreshadow_recovery: '中伏笔回收',
+  large_foreshadow_recovery: '大伏笔回收',
+});
+
+function translateValue(value) {
+  if (typeof value !== 'string') return value;
+  return VALUE_LABELS[value] || value;
+}
+
+function translateKey(key) {
+  const raw = String(key);
+  if (KEY_LABELS[raw]) return KEY_LABELS[raw];
+  if (/^V\d{3}$/.test(raw)) return '第 ' + Number(raw.slice(1)) + ' 卷';
+  if (raw.includes('.')) {
+    return raw.split('.').map((part) => KEY_LABELS[part] || TOKEN_LABELS[part] || part).join(' · ');
+  }
+  const parts = raw.split('_').filter(Boolean);
+  if (parts.length > 1) {
+    const translated = parts.map((part) => TOKEN_LABELS[part]);
+    if (translated.every(Boolean)) return translated.join('');
+    return raw;
+  }
+  return TOKEN_LABELS[raw] || raw;
+}
+
+const STAGE_LABEL = {
+  '10-scale': '数量表',
+  '20-macro': '宏观设定',
+  '30-cast': '人物与实体',
+  '40-rhythm': '章节地图与细纲',
+  '50-writing': '正文与台账',
+  '60-deslop': '去味报告',
+};
+
+function heading(level, text) {
+  return '#'.repeat(Math.max(1, Math.min(6, level))) + ' ' + text;
+}
+
+function isObject(value) {
+  return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+
+function isScalar(value) {
+  return value === null || value === undefined || ['string', 'number', 'boolean'].includes(typeof value);
+}
+
+function isScalarArray(value) {
+  return Array.isArray(value) && value.every(isScalar);
+}
+
+function cleanObject(value) {
+  if (!isObject(value)) return value;
+  return Object.fromEntries(Object.entries(value).filter(([key]) => key !== '_meta'));
+}
+
+function oneLine(value) {
+  if (value === null || value === undefined || value === '') return '—';
+  if (typeof value === 'boolean') return value ? '是' : '否';
+  if (Array.isArray(value)) return value.map(oneLine).join('、') || '—';
+  if (isObject(value)) return JSON.stringify(value);
+  const text = String(value).replace(/\r?\n/g, ' ').trim();
+  return text ? translateValue(text) : '—';
+}
+
+function labelOf(item, index = 0) {
+  if (!isObject(item)) return '第 ' + (index + 1) + ' 项';
+  const id = item.id || item.chapter_id;
+  const name = item.name || item.title || item.label || item.info_name;
+  if (id && name) return id + ' ' + name;
+  if (id) return String(id);
+  if (name) return String(name);
+  const chap = item.chapter_id || (item.display_no !== undefined ? '第 ' + item.display_no + ' 章' : '');
+  return chap || ('第 ' + (index + 1) + ' 项');
+}
+
+function fieldLine(key, value, depth = 0) {
+  const pad = '  '.repeat(depth);
+  if (isScalar(value) || isScalarArray(value)) return [pad + '- **' + translateKey(key) + '**：' + oneLine(value)];
+  return [];
+}
+
+/** 实体内部字段：标量用列表，数组/对象继续缩进。 */
+function renderFields(obj, depth, lines) {
+  const data = cleanObject(obj) || {};
+  for (const [key, value] of Object.entries(data)) {
+    if (value === undefined) continue;
+    if (isScalar(value) || isScalarArray(value)) {
+      lines.push(...fieldLine(key, value, depth));
+      continue;
+    }
+    const pad = '  '.repeat(depth);
+    if (Array.isArray(value)) {
+      lines.push(pad + '- **' + translateKey(key) + '**：');
+      if (!value.length) {
+        lines.push('  '.repeat(depth + 1) + '- （空）');
+        continue;
+      }
+      value.forEach((item, index) => {
+        if (isObject(item)) {
+          lines.push('  '.repeat(depth + 1) + '- **' + labelOf(item, index) + '**');
+          renderFields(item, depth + 2, lines);
+        } else {
+          lines.push('  '.repeat(depth + 1) + '- ' + oneLine(item));
+        }
+      });
+      continue;
+    }
+    if (isObject(value)) {
+      lines.push(pad + '- **' + translateKey(key) + '**：');
+      renderFields(value, depth + 1, lines);
+    }
+  }
+}
+
+function renderSection(key, value, level, lines) {
+  lines.push(heading(level, translateKey(key)));
+  lines.push('');
+  if (Array.isArray(value)) {
+    if (!value.length) {
+      lines.push('（空）');
+      lines.push('');
+      return;
+    }
+    value.forEach((item, index) => {
+      if (isObject(item)) {
+        lines.push(heading(level + 1, labelOf(item, index)));
+        lines.push('');
+        renderFields(item, 0, lines);
+        lines.push('');
+      } else {
+        lines.push('- ' + oneLine(item));
+      }
+    });
+    return;
+  }
+  if (isObject(value)) {
+    const entries = Object.entries(cleanObject(value) || {});
+    const objectMap = entries.length > 0 && entries.every(([, child]) => isObject(child));
+    if (objectMap) {
+      for (const [childKey, child] of entries) {
+        const childLabel = child.label || translateKey(childKey);
+        lines.push(heading(level + 1, childLabel));
+        lines.push('');
+        lines.push('- **键名**：`' + childKey + '`');
+        renderFields(child, 0, lines);
+        lines.push('');
+      }
+    } else {
+      renderFields(value, 0, lines);
+      lines.push('');
+    }
+    return;
+  }
+  lines.push(oneLine(value));
+  lines.push('');
+}
+
+function renderTopLevel(data, level, lines) {
+  if (Array.isArray(data)) {
+    renderSection('条目', data, level, lines);
+    return;
+  }
+  const obj = cleanObject(data) || {};
+  const scalars = [];
+  const composites = [];
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === undefined) continue;
+    if (isScalar(value) || isScalarArray(value)) scalars.push([key, value]);
+    else composites.push([key, value]);
+  }
+  if (scalars.length) {
+    for (const [key, value] of scalars) lines.push(...fieldLine(key, value));
+    lines.push('');
+  }
+  for (const [key, value] of composites) renderSection(key, value, level, lines);
+}
+
+function indented(lines, prefix = '  ') {
+  return lines.map((line) => prefix + line);
+}
+
+function actionLines(actions) {
+  const out = [];
+  for (const action of asArray(actions)) {
+    if (!isObject(action)) {
+      out.push('- ' + oneLine(action));
+      continue;
+    }
+    out.push('- **' + (action.id || '条目') + '**');
+    if (action.action !== undefined) out.push('  - ' + translateKey('action') + '：' + translateValue(action.action));
+    if (action.state !== undefined) out.push('  - ' + translateKey('state') + '：' + translateValue(action.state));
+    if (action.detail !== undefined) out.push('  - ' + translateKey('detail') + '：' + oneLine(action.detail));
+    const rest = { ...action };
+    delete rest.id;
+    delete rest.action;
+    delete rest.state;
+    delete rest.detail;
+    if (Object.keys(rest).length) renderFields(rest, 1, out);
+  }
+  return out;
+}
+
+function knowledgeEventLines(event) {
+  const out = [];
+  if (!isObject(event)) return ['- ' + oneLine(event)];
+  out.push('- **' + [event.character, event.subject_id].filter(Boolean).join(' / ') + '**');
+  if (event.subject_type) out.push('  - 对象类型：' + oneLine(event.subject_type));
+  if (event.change) out.push('  - 变化：' + oneLine(event.change));
+  if (event.coverage) out.push('  - 掌握程度：' + oneLine(event.coverage));
+  if (event.knowledge) out.push('  - 知道什么：' + oneLine(event.knowledge));
+  if (event.how) out.push('  - 获知方式：' + oneLine(event.how));
+  if (event.source_character) out.push('  - 来源人物：' + oneLine(event.source_character));
+  if (event.scene) out.push('  - 场景：' + oneLine(event.scene));
+  if (event.evidence) out.push('  - 依据：' + oneLine(event.evidence));
+  return out;
+}
+
+function renderChapter(chapter, lines, level = 3) {
+  const c = chapter || {};
+  lines.push(heading(level, '第' + (c.display_no || '?') + '章 ' + (c.title || '')));
+  lines.push('');
+  lines.push('- **章节编号**：' + (c.chapter_id || '—'));
+  lines.push('- **章节序号**：' + (c.display_no ?? '—'));
+  lines.push('- **卷**：' + (c.volume || '—'));
+  lines.push('- **幕**：' + (c.act || '—'));
+  lines.push('- **视角人物**：' + (c.pov || '—'));
+  lines.push('- **出场人物**：' + oneLine(c.cast));
+  if (asArray(c.mentioned).length) lines.push('- **提及人物**：' + oneLine(c.mentioned));
+  lines.push('- **地点**：' + oneLine(c.locations));
+  if (c.time) {
+    if (c.time.story_day !== undefined) lines.push('- **故事日**：' + c.time.story_day);
+    if (c.time.clock) lines.push('- **时钟**：' + c.time.clock);
+    if (c.time.duration_minutes !== undefined) lines.push('- **持续分钟数**：' + c.time.duration_minutes);
+  }
+  const why = c.why || {};
+  lines.push('- **为什么**：');
+  lines.push('  - 主线节点：' + oneLine(why.main_line_nodes));
+  lines.push('  - 支线节点：' + oneLine(why.branch_nodes));
+  lines.push('  - 冲突：' + oneLine(why.conflict));
+  lines.push('  - 主题：' + oneLine(why.theme));
+  lines.push('  - 赌注：' + oneLine(why.stakes));
+  const how = c.how || {};
+  lines.push('- **怎么写**：');
+  lines.push('  - 主功能：' + oneLine(how.function_main));
+  if (how.function_aux) lines.push('  - 辅功能：' + oneLine(how.function_aux));
+  lines.push('  - 转折：' + oneLine(how.turn));
+  lines.push('  - 章尾钩子：' + oneLine(how.ending_hook));
+  const actionBlocks = [
+    ['伏笔动作', c.foreshadow_actions],
+    ['爽点动作', c.payoff_actions],
+    ['信息差', c.information_gaps],
+    ['结局落点', c.ending_actions],
+  ];
+  for (const [label, actions] of actionBlocks) {
+    if (!asArray(actions).length) continue;
+    lines.push('- **' + label + '**：');
+    lines.push(...indented(actionLines(actions)));
+  }
+  if (asArray(c.knowledge_events).length) {
+    lines.push('- **知识事件**：');
+    lines.push(...indented(asArray(c.knowledge_events).flatMap(knowledgeEventLines)));
+  }
+  if (c.emotion) {
+    if (c.emotion.phase !== undefined) lines.push('- **情绪阶段**：' + oneLine(c.emotion.phase));
+    if (c.emotion.value !== undefined) lines.push('- **情绪强度**：' + c.emotion.value);
+  }
+  if (c.hook) {
+    if (c.hook.type !== undefined) lines.push('- **钩子类型**：' + oneLine(c.hook.type));
+    if (c.hook.strength !== undefined) lines.push('- **钩子强度**：' + translateValue(c.hook.strength));
+  }
+  if (c.word_target !== undefined) lines.push('- **字数目标**：' + c.word_target);
+  lines.push('');
+}
+
+function renderChapterMap(data, lines, level = 3) {
+  const chapters = asArray(data && data.chapters);
+  lines.push(heading(level, '章节地图'));
+  lines.push('');
+  lines.push('> 共 ' + chapters.length + ' 章。每章按 5W 展开，供后续细纲/正文读取。');
+  lines.push('');
+  for (const chapter of chapters) renderChapter(chapter, lines, level + 1);
+}
+
+function renderChapterIndex(data, lines, level = 3) {
+  const chapters = asArray(data && data.chapters);
+  lines.push(heading(level, '章节索引'));
+  lines.push('');
+  lines.push('| 章 | 章节编号 | 标题 | 卷 | 幕 | 细纲路径 | 状态 |');
+  lines.push('|---|---|---|---|---|---|---|');
+  for (const c of chapters) {
+    lines.push('| ' + [c.display_no, c.chapter_id, c.title, c.volume, c.act, c.path, c.status]
+      .map((v) => oneLine(v).replace(/\|/g, '\\|')).join(' | ') + ' |');
+  }
+  lines.push('');
+}
+
+function renderScene(scene, index, lines) {
+  lines.push(heading(4, '场景 ' + (index + 1)));
+  lines.push('');
+  renderFields(scene, 0, lines);
+  lines.push('');
+}
+
+function renderOutline(data, lines, level = 3) {
+  const chapter = (data && data.chapter) || data || {};
+  lines.push(heading(level, '第' + (chapter.number || chapter.display_no || '?') + '章 ' + (chapter.title || '')));
+  lines.push('');
+  lines.push('- **章节编号**：' + (chapter.chapter_id || '—'));
+  lines.push('- **卷**：' + (chapter.volume || '—'));
+  lines.push('- **幕**：' + (chapter.act || '—'));
+  lines.push('- **字数目标**：' + (chapter.word_target ?? '—'));
+  if (chapter.pov) {
+    const pov = chapter.pov;
+    lines.push('- **视角人物**：' + (pov.id || pov.name || '—'));
+    if (pov.entry_state) lines.push('- **视角进入状态**：' + oneLine(pov.entry_state));
+    if (pov.exit_state) lines.push('- **视角离开状态**：' + oneLine(pov.exit_state));
+  }
+  if (chapter.time) {
+    if (isObject(chapter.time)) {
+      if (chapter.time.story_day !== undefined) lines.push('- **故事日**：' + chapter.time.story_day);
+      if (chapter.time.clock) lines.push('- **时钟**：' + chapter.time.clock);
+      if (chapter.time.duration_minutes !== undefined) lines.push('- **持续分钟数**：' + chapter.time.duration_minutes);
+      if (chapter.time.chronology) lines.push('- **叙事顺序**：' + oneLine(chapter.time.chronology));
+    } else {
+      lines.push('- **时间**：' + oneLine(chapter.time));
+    }
+  }
+  if (chapter.locations) {
+    const locs = Array.isArray(chapter.locations) ? chapter.locations : [chapter.locations];
+    lines.push('- **地点**：');
+    for (const loc of locs) {
+      if (isObject(loc)) lines.push('  - ' + [loc.id, loc.name, loc.state ? '（' + oneLine(loc.state) + '）' : ''].filter(Boolean).join(' '));
+      else lines.push('  - ' + oneLine(loc));
+    }
+  }
+  if (asArray(chapter.cast).length) {
+    lines.push('- **出场人物**：');
+    for (const person of chapter.cast) {
+      if (isObject(person)) {
+        lines.push('  - **' + labelOf(person) + '**');
+        if (person.role_in_chapter) lines.push('    - 本章角色：' + oneLine(person.role_in_chapter));
+        if (person.entry) lines.push('    - 进入：' + oneLine(person.entry));
+        if (person.exit) lines.push('    - 离开：' + oneLine(person.exit));
+        if (person.knowledge) {
+          lines.push('    - 知识状态：');
+          for (const item of asArray(person.knowledge)) {
+            if (isObject(item)) {
+              lines.push('      - **' + [item.subject_id, item.character].filter(Boolean).join(' / ') + '**');
+              for (const [k, v] of Object.entries(item)) {
+                if (['subject_id', 'character'].includes(k)) continue;
+                lines.push('        - ' + translateKey(k) + '：' + oneLine(v));
+              }
+            } else {
+              lines.push('      - ' + oneLine(item));
+            }
+          }
+        }
+      } else {
+        lines.push('  - ' + oneLine(person));
+      }
+    }
+  }
+  if (chapter.why) {
+    lines.push('- **为什么**：');
+    renderFields(chapter.why, 1, lines);
+  }
+  if (asArray(chapter.knowledge_events).length) {
+    lines.push('- **知识事件**：');
+    lines.push(...indented(asArray(chapter.knowledge_events).flatMap(knowledgeEventLines)));
+  }
+  const how = chapter.how || {};
+  const scenes = asArray(how.scenes);
+  if (scenes.length) {
+    lines.push('- **场景节拍**：');
+    lines.push('');
+    for (let i = 0; i < scenes.length; i += 1) renderScene(scenes[i], i, lines);
+  }
+  if (how.ending) {
+    lines.push('- **本章收束**：');
+    if (isObject(how.ending)) {
+      if (how.ending.type) lines.push('  - 类型：' + oneLine(how.ending.type));
+      if (how.ending.text) lines.push('  - 文本：' + oneLine(how.ending.text));
+      if (how.ending.hook) lines.push('  - 钩子：' + oneLine(how.ending.hook));
+    } else {
+      lines.push('  - ' + oneLine(how.ending));
+    }
+  }
+  if (chapter.continuity) {
+    lines.push('- **连续性**：');
+    renderFields(chapter.continuity, 1, lines);
+  }
+  if (chapter.coverage) {
+    lines.push('- **覆盖矩阵**：');
+    renderFields(chapter.coverage, 1, lines);
+  }
+  if (chapter.hard_constraints) {
+    lines.push('- **硬约束**：');
+    renderFields(chapter.hard_constraints, 1, lines);
+  }
+  if (chapter.soft_suggestions) {
+    lines.push('- **软建议**：');
+    renderFields(chapter.soft_suggestions, 1, lines);
+  }
+  lines.push('');
+}
+
+function bookNameOf(projectRoot) {
+  const input = readJson(path.join(projectRoot, '设定', '00-baseline', 'input.json'), null)
+    || readJson(stageFile(projectRoot, '00-baseline', 'input.json'), null);
+  return (input && input.book_name) || '';
+}
+
+function stageFiles(projectRoot, stageId) {
+  const dir = stageDir(projectRoot, stageId);
+  const root = fs.readdirSync(dir, { withFileTypes: true })
+    .filter((e) => e.isFile() && e.name.endsWith('.json') && e.name !== 'bundle.json' && !e.name.startsWith('.'))
+    .map((e) => e.name);
+  const preferred = STAGE_FILE_ORDER[stageId] || [];
+  const ordered = preferred.filter((name) => root.includes(name));
+  const rest = root.filter((name) => !ordered.includes(name)).sort();
+  const files = [...ordered, ...rest];
+  const extra = [];
+  if (stageId === '40-rhythm') {
+    const outlineDir = path.join(dir, 'outlines');
+    let names = [];
+    try { names = fs.readdirSync(outlineDir).filter((n) => n.endsWith('.json')).sort(); } catch { names = []; }
+    for (const name of names) extra.push({ rel: 'outlines/' + name, json: true });
+  }
+  if (stageId === '50-writing') {
+    const chapterDir = path.join(dir, 'chapters');
+    let names = [];
+    try { names = fs.readdirSync(chapterDir).filter((n) => n.endsWith('.md')).sort(); } catch { names = []; }
+    for (const name of names) extra.push({ rel: 'chapters/' + name, markdown: true });
+  }
+  if (stageId === '60-deslop') {
+    for (const sub of ['reports', 'revisions']) {
+      const base = path.join(dir, sub);
+      let names = [];
+      try { names = fs.readdirSync(base).sort(); } catch { names = []; }
+      for (const name of names) {
+        if (name.endsWith('.md')) extra.push({ rel: sub + '/' + name, markdown: true });
+        else if (name.endsWith('.json')) extra.push({ rel: sub + '/' + name, json: true });
+      }
+    }
+  }
+  return {
+    dir,
+    files: [...files.map((name) => ({ rel: name, json: true })), ...extra],
+  };
+}
+
+/**
+ * 生成阶段汇总 Markdown。
+ * @returns {{markdown:string, files:string[], stageId:string, title:string}}
+ */
+function sourceFileLabel(files) {
+  const grouped = [];
+  const top = [];
+  let outlines = 0;
+  let chapters = 0;
+  for (const file of files) {
+    if (file.rel.startsWith('outlines/')) outlines += 1;
+    else if (file.rel.startsWith('chapters/')) chapters += 1;
+    else top.push(file.rel);
+  }
+  for (const name of top) grouped.push('`' + name + '`');
+  if (outlines) grouped.push('`outlines/`（' + outlines + ' 个细纲）');
+  if (chapters) grouped.push('`chapters/`（' + chapters + ' 篇正文）');
+  return grouped.join('、');
+}
+
+export function renderStageMarkdown(projectRoot, stageId) {
+  const contract = contractFor(stageId);
+  const label = STAGE_LABEL[stageId] || (contract && contract.title) || stageId;
+  const { files } = stageFiles(projectRoot, stageId);
+  const lines = [];
+  lines.push('# ' + stageId + ' 阶段导出：' + label);
+  lines.push('');
+  lines.push('> 本文件由 fancy-story-builder 2.0 从阶段 JSON 生成，供其它 LLM 直接阅读；不是源目录 JSON 文件的复制。');
+  lines.push('');
+  const book = bookNameOf(projectRoot);
+  if (book) lines.push('- **项目**：' + book);
+  lines.push('- **阶段**：`' + stageId + '`（' + label + '）');
+  lines.push('- **导出时间**：' + new Date().toISOString());
+  lines.push('- **源文件**：' + sourceFileLabel(files));
+  if (contract && contract.purpose) lines.push('- **阶段目的**：' + contract.purpose);
+  if (contract && asArray(contract.readOrder).length) lines.push('- **建议读法**：' + contract.readOrder.join(' → '));
+  lines.push('');
+  lines.push('---');
+  lines.push('');
+
+  let rendered = 0;
+  for (const file of files) {
+    const full = path.join(stageDir(projectRoot, stageId), file.rel);
+    if (file.json) {
+      const data = readJson(full, null);
+      if (data === null) continue;
+      lines.push('## `' + file.rel + '`');
+      lines.push('');
+      if (file.rel === 'chapter_map.json') renderChapterMap(data, lines, 3);
+      else if (file.rel === 'index.json') renderChapterIndex(data, lines, 3);
+      else if (file.rel.startsWith('outlines/')) renderOutline(data, lines, 3);
+      else renderTopLevel(data, 3, lines);
+      lines.push('---');
+      lines.push('');
+      rendered += 1;
+    } else if (file.markdown) {
+      const text = fs.readFileSync(full, 'utf-8');
+      lines.push('## `' + file.rel + '`');
+      lines.push('');
+      lines.push(text.trim());
+      lines.push('');
+      lines.push('---');
+      lines.push('');
+      rendered += 1;
+    }
+  }
+  if (!rendered) {
+    lines.push('（当前阶段没有可导出的 JSON 或正文文件。）');
+    lines.push('');
+  }
+  return {
+    markdown: lines.join('\n'),
+    files: files.map((f) => f.rel),
+    stageId,
+    title: label,
+  };
+}
+
+/** 只导出单章细纲，附带章节地图中该章的条目。 */
+export function renderOutlineMarkdown(projectRoot, chapterId) {
+  const dir = stageDir(projectRoot, '40-rhythm');
+  const outlineFile = path.join(dir, 'outlines', chapterId + '.json');
+  const outline = readJson(outlineFile, null);
+  if (!outline) return null;
+  const map = readJson(path.join(dir, 'chapter_map.json'), null);
+  const chapter = asArray(map && map.chapters).find((c) => String(c.chapter_id) === String(chapterId));
+  const lines = [];
+  lines.push('# 40-rhythm 单章细纲导出：' + chapterId);
+  lines.push('');
+  lines.push('> 本文件由 fancy-story-builder 2.0 从章节地图和单章细纲 JSON 生成，供写作模型直接阅读。');
+  lines.push('');
+  const book = bookNameOf(projectRoot);
+  if (book) lines.push('- **项目**：' + book);
+  lines.push('- **章节**：' + chapterId);
+  lines.push('- **导出时间**：' + new Date().toISOString());
+  lines.push('');
+  lines.push('---');
+  lines.push('');
+  if (chapter) {
+    lines.push('## 章节地图条目');
+    lines.push('');
+    renderChapter(chapter, lines, 3);
+    lines.push('---');
+    lines.push('');
+  }
+  lines.push('## 细纲');
+  lines.push('');
+  renderOutline(outline, lines, 3);
+  return {
+    markdown: lines.join('\n'),
+    chapterId,
+    chapter,
+    outline,
+    files: ['chapter_map.json', 'outlines/' + chapterId + '.json'],
+  };
+}
+