@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

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

@@ -0,0 +1,409 @@
+/**
+ * v2/macro.js —— 20-macro：先定世界、故事、卷/幕、主支线、结局、情绪曲线、角色功能位。
+ *
+ * 宏观阶段只允许 ROLE-* 功能位，不允许具体人物姓名。
+ * 具体人物、势力、地点、道具、冲突、伏笔、爽点、关系、信息差全部留到 30-cast。
+ */
+import {
+  asArray,
+  indexById,
+  v2Error,
+} from './core.js';
+
+export const MACRO_FILES = ['world.json', 'story.json', 'volumes.json', 'lines.json', 'endings.json', 'emotion.json', 'roles.json'];
+
+const ROLE_FUNCTION_TO_QUOTA = {
+  '主角': 'protagonist',
+  '核心配角': 'core_supporting',
+  '贯穿级核心配角': 'core_supporting',
+  '卷级配角': 'volume_supporting',
+  '卷级重要配角': 'volume_supporting',
+  '核心反派': 'core_antagonist',
+  '贯穿级核心反派': 'core_antagonist',
+  '卷级反派': 'volume_antagonist',
+};
+
+const WORLD_CATEGORY = {
+  '核心': 'core',
+  '信息': 'information',
+  '社会': 'social',
+  core: 'core',
+  information: 'information',
+  social: 'social',
+};
+
+function requireString(errors, obj, path, field, contract) {
+  const value = obj && obj[field];
+  if (typeof value !== 'string' || !value.trim()) {
+    errors.push(v2Error('MACRO_REQUIRED_FIELD', {
+      path: path + '.' + field,
+      message: '缺少必填文本字段',
+      actual: value,
+      contract,
+    }));
+  }
+}
+
+function validateLocationRef(errors, value, volumes, acts, path, contract) {
+  if (typeof value !== 'string' || !value.trim()) {
+    errors.push(v2Error('MACRO_REF', { path, message: '缺少卷/幕引用', contract }));
+    return;
+  }
+  const [volume, act] = value.split('/');
+  if (!volume || !volumes.has(volume)) {
+    errors.push(v2Error('MACRO_REF', { path, message: '引用了不存在的卷：' + value, contract }));
+    return;
+  }
+  if (act && !acts.has(volume + '/' + act) && !acts.has(act)) {
+    errors.push(v2Error('MACRO_REF', { path, message: '引用了不存在的幕：' + value, contract }));
+  }
+}
+
+export function validateMacro(macro, scale, opts = {}) {
+  const errors = [];
+  const warnings = [];
+  const docs = macro || {};
+  const world = docs.world || {};
+  const story = docs.story || {};
+  const volumesDoc = docs.volumes || {};
+  const lines = docs.lines || {};
+  const endings = docs.endings || {};
+  const emotion = docs.emotion || {};
+  const rolesDoc = docs.roles || {};
+
+  const scaleVolumes = asArray(scale && scale.structure && scale.structure.volumes);
+  const scaleActs = asArray(scale && scale.structure && scale.structure.acts);
+  const quotas = (scale && scale.quotas) || {};
+  const volumeIds = new Set(scaleVolumes.map((v) => v.volume_id || v.id).filter(Boolean));
+  const actIds = new Set(scaleActs.map((a) => a.act_id).filter(Boolean));
+  const actByVolume = new Map();
+  for (const a of scaleActs) {
+    if (!actByVolume.has(a.volume_id)) actByVolume.set(a.volume_id, []);
+    actByVolume.get(a.volume_id).push(a);
+  }
+  const validVolumeAct = new Set();
+  for (const a of scaleActs) validVolumeAct.add(a.volume_id + '/' + a.act_id);
+
+  // ---- world ----
+  requireString(errors, world, 'world', 'premise', '20-macro/README.md#world');
+  requireString(errors, world, 'world', 'tone', '20-macro/README.md#world');
+  const theme = world.theme;
+  if (!(typeof theme === 'string' && theme.trim()) && !(Array.isArray(theme) && theme.length)) {
+    errors.push(v2Error('MACRO_REQUIRED_FIELD', { path: 'world.theme', message: '缺少主题', contract: '20-macro/README.md#world' }));
+  }
+  const worldRules = asArray(world.world_rules);
+  const ruleIds = new Set();
+  const ruleCounts = { core: 0, information: 0, social: 0 };
+  for (let i = 0; i < worldRules.length; i += 1) {
+    const r = worldRules[i] || {};
+    if (!r.id) errors.push(v2Error('MACRO_WORLD_RULE_ID', { path: 'world.world_rules[' + i + '].id', message: '缺少规则 ID', contract: '20-macro/README.md#world' }));
+    else if (ruleIds.has(r.id)) errors.push(v2Error('MACRO_WORLD_RULE_ID_DUP', { path: 'world.world_rules[' + i + '].id', message: '规则 ID 重复：' + r.id, contract: '20-macro/README.md#world' }));
+    else ruleIds.add(r.id);
+    for (const f of ['name', 'content', 'scope', 'cost', 'impact']) {
+      requireString(errors, r, 'world.world_rules[' + i + ']', f, '20-macro/README.md#world');
+    }
+    const cat = WORLD_CATEGORY[r.category] || WORLD_CATEGORY[r.kind] || 'core';
+    ruleCounts[cat] += 1;
+  }
+  const expectedRules = quotas.world_rules || {};
+  for (const [cat, expected] of Object.entries(expectedRules)) {
+    if (ruleCounts[cat] !== Number(expected)) {
+      errors.push(v2Error('MACRO_WORLD_RULE_QUOTA', {
+        path: 'world.world_rules',
+        message: '世界规则数量与 scale.quotas.world_rules 不一致：' + cat,
+        expected: Number(expected), actual: ruleCounts[cat],
+        contract: '20-macro/README.md#world',
+        reference: '10-scale/scale.json#quotas.world_rules.' + cat,
+      }));
+    }
+  }
+
+  // ---- story ----
+  requireString(errors, story, 'story', 'core_question', '20-macro/README.md#story');
+  requireString(errors, story, 'story', 'core_conflict', '20-macro/README.md#story');
+  const structure = story.structure || {};
+  const storyActs = asArray(structure.acts);
+  if (!storyActs.length) {
+    errors.push(v2Error('MACRO_STORY_ACTS', { path: 'story.structure.acts', message: '故事结构必须覆盖每一幕', contract: '20-macro/README.md#story' }));
+  }
+  const storyActIds = new Set();
+  for (let i = 0; i < storyActs.length; i += 1) {
+    const a = storyActs[i] || {};
+    if (!a.act_id) errors.push(v2Error('MACRO_STORY_ACT_ID', { path: 'story.structure.acts[' + i + '].act_id', message: '缺少 act_id', contract: '20-macro/README.md#story' }));
+    else if (!actIds.has(a.act_id)) errors.push(v2Error('MACRO_STORY_ACT_REF', { path: 'story.structure.acts[' + i + '].act_id', message: '引用了 scale 中不存在的幕：' + a.act_id, contract: '20-macro/README.md#story' }));
+    else storyActIds.add(a.act_id);
+    for (const f of ['goal', 'turn', 'end_state']) requireString(errors, a, 'story.structure.acts[' + i + ']', f, '20-macro/README.md#story');
+  }
+  for (const id of actIds) {
+    if (!storyActIds.has(id)) {
+      errors.push(v2Error('MACRO_STORY_ACT_GAP', {
+        path: 'story.structure.acts', message: '故事结构没有覆盖幕：' + id,
+        contract: '20-macro/README.md#story', reference: '10-scale/scale.json#structure.acts',
+      }));
+    }
+  }
+  requireString(errors, structure, 'story.structure', 'climax', '20-macro/README.md#story');
+  requireString(errors, structure, 'story.structure', 'resolution', '20-macro/README.md#story');
+
+  // ---- volumes ----
+  const volumes = asArray(volumesDoc.volumes);
+  if (volumes.length !== scaleVolumes.length) {
+    errors.push(v2Error('MACRO_VOLUME_COUNT', {
+      path: 'volumes.volumes',
+      message: '卷纲数量必须等于 scale.structure.volume_count',
+      expected: scaleVolumes.length, actual: volumes.length,
+      contract: '20-macro/README.md#volumes',
+      reference: '10-scale/scale.json#structure.volume_count',
+    }));
+  }
+  const volumeById = indexById(volumes);
+  let expectedStart = 1;
+  for (let i = 0; i < scaleVolumes.length; i += 1) {
+    const sv = scaleVolumes[i];
+    const id = sv.volume_id || sv.id;
+    const v = volumeById.get(id);
+    if (!v) {
+      errors.push(v2Error('MACRO_VOLUME_MISSING', {
+        path: 'volumes.volumes', message: '缺少卷：' + id,
+        contract: '20-macro/README.md#volumes', reference: '10-scale/scale.json#structure.volumes',
+      }));
+      expectedStart += Number(sv.chapters || 0);
+      continue;
+    }
+    if (Number(v.chapter_start) !== Number(sv.chapter_start) || Number(v.chapter_end) !== Number(sv.chapter_end)) {
+      errors.push(v2Error('MACRO_VOLUME_RANGE', {
+        path: 'volumes.volumes[' + i + ']',
+        message: '卷章节区间必须与 scale 一致',
+        expected: sv.chapter_start + '-' + sv.chapter_end,
+        actual: v.chapter_start + '-' + v.chapter_end,
+        contract: '20-macro/README.md#volumes',
+        reference: '10-scale/scale.json#structure.volumes',
+      }));
+    }
+    requireString(errors, v, 'volumes.volumes[' + i + ']', 'title', '20-macro/README.md#volumes');
+    requireString(errors, v, 'volumes.volumes[' + i + ']', 'goal', '20-macro/README.md#volumes');
+    requireString(errors, v, 'volumes.volumes[' + i + ']', 'core_conflict', '20-macro/README.md#volumes');
+    requireString(errors, v, 'volumes.volumes[' + i + ']', 'emotional_arc', '20-macro/README.md#volumes');
+    requireString(errors, v, 'volumes.volumes[' + i + ']', 'ending_hook', '20-macro/README.md#volumes');
+    const vActs = asArray(v.acts);
+    const expectedActs = asArray(sv.acts);
+    if (vActs.length !== expectedActs.length) {
+      errors.push(v2Error('MACRO_ACT_COUNT', {
+        path: 'volumes.volumes[' + i + '].acts',
+        message: '幕纲数量必须与本卷 scale 幕数一致',
+        expected: expectedActs.length, actual: vActs.length,
+        contract: '20-macro/README.md#volumes',
+        reference: '10-scale/scale.json#structure.volumes',
+      }));
+    }
+    const vActIds = new Set();
+    for (let j = 0; j < expectedActs.length; j += 1) {
+      const sa = expectedActs[j];
+      const a = vActs[j] || {};
+      if (a.act_id && a.act_id !== sa.act_id) {
+        errors.push(v2Error('MACRO_ACT_ID', {
+          path: 'volumes.volumes[' + i + '].acts[' + j + '].act_id',
+          message: '幕 ID 必须与 scale 一致',
+          expected: sa.act_id, actual: a.act_id,
+          contract: '20-macro/README.md#volumes',
+        }));
+      }
+      if (a.act_id) vActIds.add(a.act_id);
+      if (Number(a.chapter_start) !== Number(sa.chapter_start) || Number(a.chapter_end) !== Number(sa.chapter_end)) {
+        errors.push(v2Error('MACRO_ACT_RANGE', {
+          path: 'volumes.volumes[' + i + '].acts[' + j + ']',
+          message: '幕章节区间必须与 scale 一致',
+          expected: sa.chapter_start + '-' + sa.chapter_end,
+          actual: a.chapter_start + '-' + a.chapter_end,
+          contract: '20-macro/README.md#volumes',
+        }));
+      }
+      for (const f of ['goal', 'climax']) requireString(errors, a, 'volumes.volumes[' + i + '].acts[' + j + ']', f, '20-macro/README.md#volumes');
+    }
+    for (const sa of expectedActs) {
+      if (sa.act_id && !vActIds.has(sa.act_id)) {
+        errors.push(v2Error('MACRO_ACT_MISSING', { path: 'volumes.volumes[' + i + '].acts', message: '缺少幕：' + sa.act_id, contract: '20-macro/README.md#volumes' }));
+      }
+    }
+    expectedStart = Number(sv.chapter_end) + 1;
+  }
+  if (Number(scale && scale.capacity && scale.capacity.target_chapters) && expectedStart !== Number(scale.capacity.target_chapters) + 1) {
+    errors.push(v2Error('MACRO_VOLUME_GAP', { path: 'volumes.volumes', message: '卷纲没有连续覆盖全部章节', expected: Number(scale.capacity.target_chapters), actual: expectedStart - 1, contract: '20-macro/README.md#volumes' }));
+  }
+
+  // ---- lines ----
+  const mainLine = lines.main_line || {};
+  if (!mainLine.id) errors.push(v2Error('MACRO_MAIN_LINE', { path: 'lines.main_line.id', message: '缺少主线 ID', contract: '20-macro/README.md#lines' }));
+  requireString(errors, mainLine, 'lines.main_line', 'name', '20-macro/README.md#lines');
+  const nodes = asArray(mainLine.nodes);
+  const nodeIds = new Set();
+  const nodeVolumes = new Set();
+  for (let i = 0; i < nodes.length; i += 1) {
+    const n = nodes[i] || {};
+    if (!n.id) errors.push(v2Error('MACRO_MAIN_NODE_ID', { path: 'lines.main_line.nodes[' + i + '].id', message: '缺少主线节点 ID', contract: '20-macro/README.md#lines' }));
+    else if (nodeIds.has(n.id)) errors.push(v2Error('MACRO_MAIN_NODE_ID_DUP', { path: 'lines.main_line.nodes[' + i + '].id', message: '主线节点 ID 重复：' + n.id, contract: '20-macro/README.md#lines' }));
+    else nodeIds.add(n.id);
+    if (!volumeIds.has(n.volume)) {
+      errors.push(v2Error('MACRO_MAIN_NODE_VOLUME', { path: 'lines.main_line.nodes[' + i + '].volume', message: '主线节点引用了不存在的卷：' + n.volume, contract: '20-macro/README.md#lines' }));
+    } else {
+      nodeVolumes.add(n.volume);
+    }
+    if (n.act && !actIds.has(n.act)) {
+      errors.push(v2Error('MACRO_MAIN_NODE_ACT', { path: 'lines.main_line.nodes[' + i + '].act', message: '主线节点引用了不存在的幕：' + n.act, contract: '20-macro/README.md#lines' }));
+    }
+    for (const f of ['goal', 'turn']) requireString(errors, n, 'lines.main_line.nodes[' + i + ']', f, '20-macro/README.md#lines');
+  }
+  for (const id of volumeIds) {
+    if (!nodeVolumes.has(id)) {
+      errors.push(v2Error('MACRO_MAIN_LINE_GAP', {
+        path: 'lines.main_line.nodes', message: '主线没有覆盖卷：' + id,
+        contract: '20-macro/README.md#lines', reference: '10-scale/scale.json#structure.volumes',
+      }));
+    }
+  }
+  if (quotas.main_lines !== undefined && Number(quotas.main_lines) !== 1) {
+    warnings.push(v2Error('MACRO_MAIN_LINE_COUNT', { path: 'lines.main_line', message: '2.0 目前只支持 1 条主线', severity: 'warning', contract: '20-macro/README.md#lines' }));
+  }
+
+  const branches = asArray(lines.branches);
+  const expectedBranches = Number(quotas.branches || 0);
+  if (branches.length !== expectedBranches) {
+    errors.push(v2Error('MACRO_BRANCH_COUNT', {
+      path: 'lines.branches', message: '支线数量必须等于 scale.quotas.branches',
+      expected: expectedBranches, actual: branches.length,
+      contract: '20-macro/README.md#lines', reference: '10-scale/scale.json#quotas.branches',
+    }));
+  }
+  const branchIds = new Set();
+  for (let i = 0; i < branches.length; i += 1) {
+    const b = branches[i] || {};
+    if (!b.id) errors.push(v2Error('MACRO_BRANCH_ID', { path: 'lines.branches[' + i + '].id', message: '缺少支线 ID', contract: '20-macro/README.md#lines' }));
+    else if (branchIds.has(b.id)) errors.push(v2Error('MACRO_BRANCH_ID_DUP', { path: 'lines.branches[' + i + '].id', message: '支线 ID 重复：' + b.id, contract: '20-macro/README.md#lines' }));
+    else branchIds.add(b.id);
+    requireString(errors, b, 'lines.branches[' + i + ']', 'name', '20-macro/README.md#lines');
+    requireString(errors, b, 'lines.branches[' + i + ']', 'goal', '20-macro/README.md#lines');
+    for (const field of ['start', 'turning', 'resolution']) {
+      validateLocationRef(errors, b[field], volumeIds, validVolumeAct, 'lines.branches[' + i + '].' + field, '20-macro/README.md#lines');
+    }
+    const interweaves = asArray(b.interweaves);
+    for (const nid of interweaves) {
+      if (!nodeIds.has(nid)) {
+        errors.push(v2Error('MACRO_BRANCH_INTERWEAVE', { path: 'lines.branches[' + i + '].interweaves', message: '支线交织了不存在的主线节点：' + nid, contract: '20-macro/README.md#lines' }));
+      }
+    }
+  }
+
+  // ---- endings ----
+  const endingRows = asArray(endings.endings);
+  const expectedEndings = Number(quotas.endings || 0);
+  if (endingRows.length !== expectedEndings) {
+    errors.push(v2Error('MACRO_ENDING_COUNT', {
+      path: 'endings.endings', message: '结局数量必须等于 scale.quotas.endings',
+      expected: expectedEndings, actual: endingRows.length,
+      contract: '20-macro/README.md#endings', reference: '10-scale/scale.json#quotas.endings',
+    }));
+  }
+  const endingIds = new Set();
+  let bookLevel = 0;
+  for (let i = 0; i < endingRows.length; i += 1) {
+    const e = endingRows[i] || {};
+    if (!e.id) errors.push(v2Error('MACRO_ENDING_ID', { path: 'endings.endings[' + i + '].id', message: '缺少结局 ID', contract: '20-macro/README.md#endings' }));
+    else if (endingIds.has(e.id)) errors.push(v2Error('MACRO_ENDING_ID_DUP', { path: 'endings.endings[' + i + '].id', message: '结局 ID 重复：' + e.id, contract: '20-macro/README.md#endings' }));
+    else endingIds.add(e.id);
+    requireString(errors, e, 'endings.endings[' + i + ']', 'direction', '20-macro/README.md#endings');
+    if (e.level === '全书级') bookLevel += 1;
+    for (const fs of asArray(e.required_foreshadow_recovery)) {
+      if (!/^FS\d{3,}$/.test(String(fs))) {
+        errors.push(v2Error('MACRO_ENDING_FORESHADOW_REF', { path: 'endings.endings[' + i + '].required_foreshadow_recovery', message: '伏笔 ID 格式应为 FS001：' + fs, contract: '20-macro/README.md#endings' }));
+      }
+    }
+  }
+  if (bookLevel !== 1) {
+    errors.push(v2Error('MACRO_ENDING_BOOK_LEVEL', {
+      path: 'endings.endings', message: '必须恰好有 1 个 level=全书级 的结局',
+      expected: 1, actual: bookLevel,
+      contract: '20-macro/README.md#endings',
+    }));
+  }
+
+  // ---- emotion ----
+  const curve = asArray(emotion.volumes);
+  const curveIds = new Set(curve.map((x) => x && x.volume_id).filter(Boolean));
+  for (const id of volumeIds) {
+    if (!curveIds.has(id)) {
+      errors.push(v2Error('MACRO_EMOTION_GAP', {
+        path: 'emotion.volumes', message: '全局情绪曲线缺少卷：' + id,
+        contract: '20-macro/README.md#emotion', reference: '10-scale/scale.json#structure.volumes',
+      }));
+    }
+  }
+  for (let i = 0; i < curve.length; i += 1) {
+    const row = curve[i] || {};
+    if (row.volume_id && !volumeIds.has(row.volume_id)) {
+      errors.push(v2Error('MACRO_EMOTION_REF', { path: 'emotion.volumes[' + i + '].volume_id', message: '情绪曲线引用了不存在的卷：' + row.volume_id, contract: '20-macro/README.md#emotion' }));
+    }
+    requireString(errors, row, 'emotion.volumes[' + i + ']', 'arc', '20-macro/README.md#emotion');
+  }
+
+  // ---- roles ----
+  const roles = asArray(rolesDoc.roles);
+  const expectedRoleCounts = {
+    protagonist: Number((quotas.characters && quotas.characters.protagonist) || 0),
+    core_supporting: Number((quotas.characters && quotas.characters.core_supporting) || 0),
+    volume_supporting: Number((quotas.characters && quotas.characters.volume_supporting) || 0),
+    core_antagonist: Number((quotas.characters && quotas.characters.core_antagonist) || 0),
+    volume_antagonist: Number((quotas.characters && quotas.characters.volume_antagonist) || 0),
+  };
+  const expectedTotal = Object.values(expectedRoleCounts).reduce((a, b) => a + b, 0);
+  if (roles.length !== expectedTotal) {
+    errors.push(v2Error('MACRO_ROLE_COUNT', {
+      path: 'roles.roles', message: '角色功能位数量必须等于人物配额总和',
+      expected: expectedTotal, actual: roles.length,
+      contract: '20-macro/README.md#roles', reference: '10-scale/scale.json#quotas.characters',
+    }));
+  }
+  const roleIds = new Set();
+  const roleCounts = { protagonist: 0, core_supporting: 0, volume_supporting: 0, core_antagonist: 0, volume_antagonist: 0 };
+  for (let i = 0; i < roles.length; i += 1) {
+    const r = roles[i] || {};
+    if (!r.role_id) {
+      errors.push(v2Error('MACRO_ROLE_ID', { path: 'roles.roles[' + i + '].role_id', message: '缺少 role_id', contract: '20-macro/README.md#roles' }));
+    } else if (!/^ROLE-[A-Z0-9-]+$/.test(r.role_id)) {
+      errors.push(v2Error('MACRO_ROLE_ID', { path: 'roles.roles[' + i + '].role_id', message: 'role_id 必须形如 ROLE-PROTAGONIST', actual: r.role_id, contract: '20-macro/README.md#roles' }));
+    } else if (roleIds.has(r.role_id)) {
+      errors.push(v2Error('MACRO_ROLE_ID_DUP', { path: 'roles.roles[' + i + '].role_id', message: 'role_id 重复：' + r.role_id, contract: '20-macro/README.md#roles' }));
+    } else {
+      roleIds.add(r.role_id);
+    }
+    const key = ROLE_FUNCTION_TO_QUOTA[r.function];
+    if (!key) {
+      errors.push(v2Error('MACRO_ROLE_FUNCTION', {
+        path: 'roles.roles[' + i + '].function', message: '未知角色功能：' + r.function,
+        expected: Object.keys(ROLE_FUNCTION_TO_QUOTA).join(' / '),
+        contract: '20-macro/README.md#roles',
+      }));
+    } else {
+      roleCounts[key] += 1;
+    }
+    for (const f of ['arc_question', 'macro_goal']) requireString(errors, r, 'roles.roles[' + i + ']', f, '20-macro/README.md#roles');
+  }
+  for (const [key, expected] of Object.entries(expectedRoleCounts)) {
+    if (roleCounts[key] !== expected) {
+      errors.push(v2Error('MACRO_ROLE_QUOTA', {
+        path: 'roles.roles', message: '角色功能位数量与人物配额不一致：' + key,
+        expected, actual: roleCounts[key],
+        contract: '20-macro/README.md#roles', reference: '10-scale/scale.json#quotas.characters.' + key,
+      }));
+    }
+  }
+
+  return { ok: errors.length === 0, errors, warnings, data: docs };
+}
+
+export function macroRoleMap(rolesDoc) {
+  const map = new Map();
+  for (const r of asArray(rolesDoc && rolesDoc.roles)) {
+    if (r && r.role_id) map.set(r.role_id, r);
+  }
+  return map;
+}