@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

package/plugins/fancy-story-builder/scripts/semantic-lint.js

@@ -293,6 +293,7 @@ export function buildSemanticLintPrompt(ctx) {
 export function collectFleshEntities(fleshDir) {
   const FILES = {
     '角色.json': ['characters'],
+    '其他实体.json': ['other_entities'],
     '冲突.json': ['conflicts'],
     '势力.json': ['factions'],
     '剧情.json': ['main_lines', 'branches'],
@@ -342,7 +343,10 @@ export function collectSkeletonRelations(skeletonDir) {
   }
   const out = [];
   for (const r of (data.character_relations || [])) {
-    if (r && r.from && r.to) out.push({ from: r.from, to: r.to, kind: r.relation_kind || '' });
+    if (r && r.from && r.to) out.push({ from: r.from, to: r.to, kind: (r.relation_kind || '') + (r.relation_label ? '/' + r.relation_label : '') });
+  }
+  for (const r of (data.other_relations || [])) {
+    if (r && r.from && r.to) out.push({ from: r.from, to: r.to, kind: r.relation_label || '' });
   }
   for (const r of (data.faction_relations || [])) {
     if (r && r.from && r.to) out.push({ from: r.from, to: r.to, kind: r.relation_type || '' });

package/plugins/fancy-story-builder/scripts/skeleton-validate.js

@@ -1,8 +1,14 @@
 #!/usr/bin/env node
 /**
- * 骨架阶段校验脚本 v2.4
+ * 骨架阶段校验脚本 v2.5
  * 源码中零反引号（所有字符串使用单/双引号或拼接），避免 markdown 渲染问题。
  *
+ * v2.5 变更：
+ * - 新增 NAME_ALIAS_SUSPECT：名称归一化（去括号/标点/常见机构后缀）后
+ *   相同，但字面不同 → warning，提示可能是同一实体的全称/简称/别名。
+ * - CROSS_TYPE_NAME_DUP 改用同一套归一化口径，能抓「企鹅集团 vs 企鹅」
+ *   这种跨类型软重复。
+ *
  * v2.4 变更（修复批次 P0-2 / P2-4 / P2-8）：
  * - P0-2：evalExpr 正则允许 = < > ! & | ? :（原版不允许，导致
  *   formulas-skeleton.json 的 ending_elements.ending_count 的 expr_low/expr_high
@@ -237,7 +243,7 @@ function charsetAndForbiddenCheck(data, errors) {
 // ============================================================
 function idUniquenessCheck(data, fileType, errors) {
   const ID_ARRAYS = {
-    '实体': ['characters', 'conflicts', 'factions', 'locations', 'items', 'endings', 'foreshadows', 'climaxes', 'pleasures', 'world_rules', 'main_lines', 'branches'],
+    '实体': ['characters', 'other_entities', 'conflicts', 'factions', 'locations', 'items', 'endings', 'foreshadows', 'climaxes', 'pleasures', 'world_rules', 'main_lines', 'branches'],
     '层级': ['volumes']
   };
   // 记出现次数：光说"重复"模型不知道该删几条
@@ -260,12 +266,43 @@ function idUniquenessCheck(data, fileType, errors) {
   }
 }
 
+const NAME_ARRAYS_BY_FILE = {
+  '实体': ['characters', 'other_entities', 'conflicts', 'factions', 'locations', 'items', 'endings', 'foreshadows', 'climaxes', 'pleasures', 'world_rules', 'main_lines', 'branches'],
+  '层级': ['volumes']
+};
+
+/**
+ * 归一化实体名，用于发现“同一实体换了写法”：
+ *   - 去空白 / 标点 / 括号注释；
+ *   - 去常见机构后缀（集团/公司/大学/协会…），
+ *     这样「企鹅集团」和「企鹅」会落到同一个 key；
+ *   - 不做拼音/翻译，跨语言别名仍交给 LLM 审计。
+ */
+const GENERIC_NAME_SUFFIXES = [
+  '股份有限公司', '有限公司', '集团', '公司', '大学', '学院', '学校',
+  '医院', '银行', '协会', '商会', '联盟', '家族', '世家', '王朝',
+  '帝国', '组织', '机构', '政府', '部门'
+];
+
+function normalizeEntityName(name) {
+  let s = String(name || '').trim().toLowerCase();
+  s = s.replace(/[（(][^）)]*[）)]/g, '');
+  s = s.replace(/[\s·・,，。.、:：;；!！?？'"“”‘’《》<>【】\[\]（）()\-—_/\\|]/g, '');
+  let changed = true;
+  while (changed) {
+    changed = false;
+    for (const suffix of GENERIC_NAME_SUFFIXES) {
+      if (s.length > suffix.length + 1 && s.endsWith(suffix)) {
+        s = s.slice(0, -suffix.length);
+        changed = true;
+      }
+    }
+  }
+  return s;
+}
+
 function nameUniquenessCheck(data, fileType, errors) {
-  const NAME_ARRAYS = {
-    '实体': ['characters', 'conflicts', 'factions', 'locations', 'items', 'endings', 'foreshadows', 'climaxes', 'pleasures', 'world_rules', 'main_lines', 'branches'],
-    '层级': ['volumes']
-  };
-  for (const key of NAME_ARRAYS[fileType] || []) {
+  for (const key of NAME_ARRAYS_BY_FILE[fileType] || []) {
     const seen = new Map();
     for (const item of data[key] || []) {
       const n = item.name;
@@ -279,6 +316,35 @@ function nameUniquenessCheck(data, fileType, errors) {
   }
 }
 
+/**
+ * 软重复检查：名称归一化后相同，但字面不同。
+ * 只报 warning，不自动合并 —— 可能是同一实体，也可能是“阳城”与“阳城大学”
+ * 这种上下位关系，必须让作者/模型确认。
+ */
+function nameAliasCheck(data, fileType, warnings) {
+  for (const key of NAME_ARRAYS_BY_FILE[fileType] || []) {
+    const byNormalized = new Map();
+    for (const item of data[key] || []) {
+      if (!item.name) continue;
+      const normalized = normalizeEntityName(item.name);
+      if (!normalized) continue;
+      if (!byNormalized.has(normalized)) byNormalized.set(normalized, []);
+      byNormalized.get(normalized).push({ id: item.id, name: String(item.name) });
+    }
+    for (const [normalized, entries] of byNormalized) {
+      const distinctNames = [...new Set(entries.map((e) => e.name))];
+      if (distinctNames.length <= 1) continue;
+      warnings.push({
+        code: 'NAME_ALIAS_SUSPECT',
+        path: key + '.' + distinctNames.join(' / '),
+        message: '名称 ' + distinctNames.map((n) => '"' + n + '"').join('、') +
+          ' 归一化后相同（' + normalized + '），可能是同一实体的全称/简称/别名',
+        hint: '确认是同一实体时只保留一个正式名，把另一个的设定合并过去；不要把称呼、简称、集团/公司后缀单独建成新实体'
+      });
+    }
+  }
+}
+
 // ============================================================
 // 自环关系检查
 // ============================================================
@@ -294,6 +360,17 @@ function selfRelationCheck(data, errors) {
       });
     }
   }
+  for (let i = 0; i < (data.other_relations || []).length; i++) {
+    const r = data.other_relations[i];
+    if (r.from && r.to && r.from === r.to) {
+      errors.push({
+        code: 'NO_SELF_RELATION',
+        path: 'other_relations[' + i + ']',
+        message: '其他实体关系 from 和 to 不能相同（' + r.from + '）',
+        hint: '自环关系无意义；改为指向人物或另一个实体'
+      });
+    }
+  }
   for (let i = 0; i < (data.faction_relations || []).length; i++) {
     const r = data.faction_relations[i];
     if (r.from && r.to && r.from === r.to) {
@@ -307,6 +384,36 @@ function selfRelationCheck(data, errors) {
   }
 }
 
+// ============================================================
+// 扩展关系标签检查
+// ============================================================
+// `其他` 是词表外的扩展出口。只写"其他"等于没写关系；
+// 必须用 relation_label 说清是附身、寄生、契约还是别的。
+function relationLabelCheck(data, errors) {
+  for (const [i, r] of (data.character_relations || []).entries()) {
+    if (!r || r.relation_kind !== '其他') continue;
+    const label = typeof r.relation_label === 'string' ? r.relation_label.trim() : '';
+    if (!label) {
+      errors.push({
+        code: 'REL_LABEL_REQUIRED',
+        path: 'character_relations[' + i + '].relation_label',
+        message: 'relation_kind="其他" 时必须填 relation_label，写清具体关系（如 附身/寄生/契约/共生）',
+        hint: 'relation_label 是词表外关系的唯一语义来源；只写"其他"下游无法判断该怎么写'
+      });
+    }
+  }
+  for (const [i, r] of (data.other_relations || []).entries()) {
+    if (!r || typeof r.relation_label !== 'string' || !r.relation_label.trim()) {
+      errors.push({
+        code: 'REL_LABEL_REQUIRED',
+        path: 'other_relations[' + i + '].relation_label',
+        message: 'other_relations 必须填 relation_label，写清具体关系（如 附身/寄宿/共生/镇压）',
+        hint: '非人物实体的关系没有词表可依，relation_label 是唯一语义来源'
+      });
+    }
+  }
+}
+
 // ============================================================
 // 关系数组组合重复检查（7 类）
 // ============================================================
@@ -340,6 +447,20 @@ function relationDupCheck(data, errors) {
     crSet.set(k, r.relation_kind);
   }
 
+  const orSet = new Set();
+  for (const r of (data.other_relations || [])) {
+    const k = r.from + '→' + r.to;
+    if (orSet.has(k)) {
+      errors.push({
+        code: 'ID_DUP',
+        path: 'other_relations.' + k,
+        message: '其他实体关系 ' + k + ' 重复',
+        hint: '同一对存在只能保留一条关系；不同关系请用 relation_label 写清，不要重复建行'
+      });
+    }
+    orSet.add(k);
+  }
+
   const frSet = new Set();
   for (const r of (data.faction_relations || [])) {
     const k = r.from + '→' + r.to;
@@ -439,7 +560,8 @@ function relationDupCheck(data, errors) {
 // ============================================================
 function derivationCheck(data, formulas, errors, warnings) {
   const der = data.derivations || {};
-  const formulaKeys = new Set(Object.keys(formulas));
+  // v2 的 custom.* 公式只用于 10-scale 的 scale.json；旧骨架阶段不消费它们。
+  const formulaKeys = new Set(Object.keys(formulas).filter((k) => !k.startsWith('custom.')));
   const derKeys = new Set(Object.keys(der));
 
   for (const k of formulaKeys) {
@@ -466,6 +588,7 @@ function derivationCheck(data, formulas, errors, warnings) {
 
   const ctx = buildFormulaContext(data);
   for (const [k, spec] of Object.entries(formulas)) {
+    if (k.startsWith('custom.')) continue;
     const d = der[k];
     if (!d) continue;
     let realLow, realHigh;
@@ -641,7 +764,8 @@ function relationRefCheck(data, entityData, errors) {
     items: new Set((entityData.items || []).map(i => i.id)),
     endings: new Set((entityData.endings || []).map(e => e.id)),
     branches: new Set((entityData.branches || []).map(b => b.id)),
-    main_lines: new Set((entityData.main_lines || []).map(m => m.id))
+    main_lines: new Set((entityData.main_lines || []).map(m => m.id)),
+    other_entities: new Set((entityData.other_entities || []).map(o => o.id))
   };
 
   const ref = (val, set, label, pathStr) => {
@@ -660,6 +784,11 @@ function relationRefCheck(data, entityData, errors) {
     ref(r.from, ids.characters, '角色', 'character_relations[' + i + '].from');
     ref(r.to, ids.characters, '角色', 'character_relations[' + i + '].to');
   }
+  for (const [i, r] of (data.other_relations || []).entries()) {
+    ref(r.from, ids.other_entities, '其他实体', 'other_relations[' + i + '].from');
+    if (String(r.to || '').startsWith('C')) ref(r.to, ids.characters, '角色', 'other_relations[' + i + '].to');
+    else ref(r.to, ids.other_entities, '其他实体', 'other_relations[' + i + '].to');
+  }
   for (const [i, r] of (data.faction_membership || []).entries()) {
     ref(r.character, ids.characters, '角色', 'faction_membership[' + i + '].character');
     ref(r.faction, ids.factions, '势力', 'faction_membership[' + i + '].faction');
@@ -1121,25 +1250,29 @@ function checkWorldRuleCategory(entityData, errors) {
 // ============================================================
 function crossTypeNameDupCheck(entityData, warnings) {
   if (!entityData) return;
-  const types = ['characters', 'factions', 'conflicts', 'locations'];
-  const typeLabels = { characters: '角色', factions: '势力', conflicts: '冲突', locations: '地点' };
+  const types = ['characters', 'other_entities', 'factions', 'conflicts', 'locations'];
+  const typeLabels = { characters: '角色', other_entities: '其他实体', factions: '势力', conflicts: '冲突', locations: '地点' };
   const nameMap = new Map();
   for (const t of types) {
     for (const item of (entityData[t] || [])) {
       if (!item.name) continue;
-      if (!nameMap.has(item.name)) nameMap.set(item.name, []);
-      nameMap.get(item.name).push({ type: t, id: item.id });
+      const key = normalizeEntityName(item.name);
+      if (!key) continue;
+      if (!nameMap.has(key)) nameMap.set(key, []);
+      nameMap.get(key).push({ type: t, id: item.id, name: String(item.name) });
     }
   }
-  for (const [name, entries] of nameMap) {
+  for (const [normalized, entries] of nameMap) {
     if (entries.length <= 1) continue;
     const typeSet = new Set(entries.map(e => e.type));
     if (typeSet.size <= 1) continue;
     const typesInvolved = [...typeSet].map(t => typeLabels[t]).join(' / ');
+    const names = [...new Set(entries.map((e) => e.name))];
     warnings.push({
       code: 'CROSS_TYPE_NAME_DUP',
-      path: 'name: ' + name,
-      message: '名称 "' + name + '" 在多个实体类型中重复出现（' + typesInvolved + '）',
+      path: 'name: ' + names.join(' / '),
+      message: '名称 ' + names.map((n) => '"' + n + '"').join('、') +
+        ' 在多个实体类型中重复出现（' + typesInvolved + '；归一化 key=' + normalized + '）',
       hint: '不同类型同名可能导致引用歧义（如 faction.members[].name 与 faction.relations[].target_name 无法靠名字区分），建议改名'
     });
   }
@@ -1157,7 +1290,7 @@ function buildGraph(entityData, relationData, errors, warnings) {
     ['locations', 'location'], ['items', 'item'], ['endings', 'ending'],
     ['foreshadows', 'foreshadow'], ['climaxes', 'climax'], ['pleasures', 'pleasure'],
     ['main_lines', 'main_line'], ['branches', 'branch'],
-    ['world_rules', 'world_rule']
+    ['world_rules', 'world_rule'], ['other_entities', 'other_entity']
   ]) {
     for (const x of (entityData[arr] || [])) {
       graph.addNode(x.id, { type: type, name: x.name });
@@ -1174,6 +1307,7 @@ function buildGraph(entityData, relationData, errors, warnings) {
   };
 
   for (const r of (relationData.character_relations || [])) addEdge(r.from, r.to, 'related_to');
+  for (const r of (relationData.other_relations || [])) addEdge(r.from, r.to, r.relation_label || 'related_to');
   for (const r of (relationData.faction_membership || [])) addEdge(r.character, r.faction, 'member_of');
   for (const r of (relationData.faction_relations || [])) addEdge(r.from, r.to, 'faction_related');
   for (const r of (relationData.conflict_participants || [])) {
@@ -1366,6 +1500,7 @@ function renderFramework(data) {
 // 实体文件的渲染（12 类实体数组）
 const ENTITY_ARRAYS = [
   ['characters', '角色'],
+  ['other_entities', '其他实体'],
   ['conflicts', '冲突'],
   ['factions', '势力'],
   ['locations', '地点'],
@@ -1393,6 +1528,7 @@ function renderEntity(data) {
 // 关系文件的渲染（9 类关系数组）
 const RELATION_ARRAYS = [
   ['character_relations', '角色关系'],
+  ['other_relations', '其他关系'],
   ['faction_membership', '势力成员'],
   ['faction_relations', '势力关系'],
   ['conflict_participants', '冲突参与'],
@@ -1568,6 +1704,7 @@ function validateSingle(args) {
   safeCheck('charsetAndForbiddenCheck', () => charsetAndForbiddenCheck(data, errors), errors);
   safeCheck('idUniquenessCheck', () => idUniquenessCheck(data, file, errors), errors);
   safeCheck('nameUniquenessCheck', () => nameUniquenessCheck(data, file, errors), errors);
+  safeCheck('nameAliasCheck', () => nameAliasCheck(data, file, warnings), errors);
 
   if (file === '框架') {
     safeCheck('frameworkSpecificCheck', () => frameworkSpecificCheck(data, errors, warnings), errors);
@@ -1576,6 +1713,7 @@ function validateSingle(args) {
   } else if (file === '关系') {
     safeCheck('selfRelationCheck', () => selfRelationCheck(data, errors), errors);
     safeCheck('relationDupCheck', () => relationDupCheck(data, errors), errors);
+    safeCheck('relationLabelCheck', () => relationLabelCheck(data, errors), errors);
     safeCheck('relationRefCheck', () => relationRefCheck(data, upstreamEntities, errors), errors);
     // 支线挂主线的覆盖度：关系文件对着实体清单查（tt5 实测的静默缺失）
     safeCheck('checkBranchMainLineCoverage', () => checkBranchMainLineCoverage(upstreamEntities, data, errors), errors);
@@ -1702,6 +1840,7 @@ function validatePartial(args) {
   if (file === '关系') {
     safeCheck('selfRelationCheck', () => selfRelationCheck(scoped, errors), errors);
     safeCheck('relationDupCheck', () => relationDupCheck(scoped, errors), errors);
+    safeCheck('relationLabelCheck', () => relationLabelCheck(scoped, errors), errors);
     safeCheck('relationRefCheck', () => relationRefCheck(scoped, upstreamEntities, errors), errors);
     safeCheck('characterRelationSymmetryCheck', () => characterRelationSymmetryCheck(scoped, errors), errors);
     safeCheck('factionRelationSymmetryCheck', () => factionRelationSymmetryCheck(scoped, errors), errors);
@@ -1767,6 +1906,7 @@ function validateAll(args) {
     safeCheck('charsetAndForbiddenCheck', () => charsetAndForbiddenCheck(data, errors), errors);
     safeCheck('idUniquenessCheck', () => idUniquenessCheck(data, f.type, errors), errors);
     safeCheck('nameUniquenessCheck', () => nameUniquenessCheck(data, f.type, errors), errors);
+    safeCheck('nameAliasCheck', () => nameAliasCheck(data, f.type, warnings), errors);
 
     if (f.type === '框架') {
       safeCheck('frameworkSpecificCheck', () => frameworkSpecificCheck(data, errors, warnings), errors);
@@ -1774,6 +1914,7 @@ function validateAll(args) {
     } else if (f.type === '关系') {
       safeCheck('selfRelationCheck', () => selfRelationCheck(data, errors), errors);
       safeCheck('relationDupCheck', () => relationDupCheck(data, errors), errors);
+      safeCheck('relationLabelCheck', () => relationLabelCheck(data, errors), errors);
       safeCheck('relationRefCheck', () => relationRefCheck(data, loaded['实体'], errors), errors);
       // 支线挂主线的覆盖度（tt5 实测：只写 1 行也 PASSED，9 条支线静默孤儿）
       safeCheck('checkBranchMainLineCoverage', () => checkBranchMainLineCoverage(loaded['实体'], data, errors), errors);

package/plugins/fancy-story-builder/scripts/stage-batches.js

@@ -71,6 +71,15 @@ export const FLESH_FILE_SPECS = [
       { key: 'characters', source: 'characters' }
     ]
   },
+  {
+    type: '其他实体',
+    file: '其他实体.json',
+    template: '其他实体模板.json',
+    optionalSource: 'other_entities',
+    groups: [
+      { key: 'other_entities', source: 'other_entities' }
+    ]
+  },
   {
     type: '冲突',
     file: '冲突.json',
@@ -169,7 +178,9 @@ export const SKELETON_FILE_SPECS = [
     file: '实体.json',
     template: '实体模板.json',
     groups: [
-      { key: 'characters', quotaDriven: true, maxItems: 20 },
+      // 角色批次顺带写可选的题材扩展实体（灵魂/神魂/器灵…）。
+      // other_entities 不在 quota 里：没有就写空数组，有就从 O001 起编号。
+      { key: 'characters', quotaDriven: true, maxItems: 20, extraArrays: ['other_entities'], optionalArrays: ['other_entities'] },
       { key: 'conflicts', quotaDriven: true, maxItems: 20 },
       { key: 'factions', quotaDriven: true, maxItems: 20 },
       { key: 'locations', quotaDriven: true, maxItems: 20 },
@@ -215,6 +226,8 @@ export const SKELETON_FILE_SPECS = [
       //     · main_line_branch_relation 按主线切（只有 1 条主线）→ 提示词说 1 条
       //       → 模型写 1 行 → 10 条支线里 9 条静默没挂主线，校验器还不报。
       { key: 'character_relations', source: 'characters', ownerField: 'from', refs: ['characters'], rows: 'semantic', maxItems: 8 },
+      // 非人物实体参与的关系（附身/寄宿/共生/镇压…）。没有 other_entities 时整组跳过。
+      { key: 'other_relations', source: 'other_entities', ownerField: 'from', refs: ['other_entities', 'characters'], rows: 'semantic', maxItems: 8, optionalSource: 'other_entities' },
       { key: 'faction_membership', source: 'factions', ownerField: 'faction', refs: ['characters', 'factions'], rows: 'semantic', maxItems: 8 },
       { key: 'faction_relations', source: 'factions', ownerField: 'from', refs: ['factions'], rows: 'quota', quotaPath: 'faction_relation_count', multiplier: 2, maxItems: 8 },
       { key: 'conflict_participants', source: 'conflicts', ownerField: 'conflict', refs: ['conflicts', 'characters'], rows: 'perEntity', maxItems: 8 },
@@ -282,6 +295,9 @@ export const RHYTHM_FILE_SPECS = [
     template: '时序映射模板.json',
     groups: [
       { key: 'character_timeline', source: 'characters', maxItems: 50 },
+      // 角色关系的阶段落点：按关系起点角色切批，每批只写 from 属于本批的行。
+      { key: 'relationship_timeline', source: 'characters', ownerField: 'from', rows: 'optional', maxItems: 8 },
+      { key: 'faction_relationship_timeline', source: 'factions', ownerField: 'from', rows: 'optional', maxItems: 8 },
       { key: 'conflict_timeline', source: 'conflicts', maxItems: 50 },
       { key: 'foreshadow_timeline', source: 'foreshadows', maxItems: 50 },
       { key: 'climax_timeline', source: 'climaxes', maxItems: 50 },
@@ -490,6 +506,11 @@ export function planStageBatches(opts) {
 
   for (let fileIndex = 0; fileIndex < specs.length; fileIndex++) {
     const spec = specs[fileIndex];
+    // 题材扩展文件是条件产物：骨架没有 other_entities 时整份文件不生成，
+    // 不能把"不需要写"误报成"切不出批次"。
+    if (spec.optionalSource && (!skeletonEntities || !Array.isArray(skeletonEntities[spec.optionalSource]) || skeletonEntities[spec.optionalSource].length === 0)) {
+      continue;
+    }
     const templateSpec = readJson(path.join(templateDir, spec.template));
     if (!templateSpec) {
       return {
@@ -504,6 +525,10 @@ export function planStageBatches(opts) {
 
     for (let groupIndex = 0; groupIndex < spec.groups.length; groupIndex++) {
       const group = spec.groups[groupIndex];
+      // 可选关系组：源实体为空时跳过，不要生成"0 条"的空批次。
+      if (group.optionalSource && (!skeletonEntities || !Array.isArray(skeletonEntities[group.optionalSource]) || skeletonEntities[group.optionalSource].length === 0)) {
+        continue;
+      }
 
       // 整文件就是一个对象（节奏参数.json）：只有一批，条目是整个对象
       if (group.wholeObject) {
@@ -741,6 +766,11 @@ export function computeKeyChapters(opts) {
     if (e && typeof e.chapter === 'number') set.add(e.chapter);
   }
 
+  // 关系变化章
+  for (const r of (Array.isArray(timeline.relationship_timeline) ? timeline.relationship_timeline : [])) {
+    if (r && typeof r.start_chapter === 'number') set.add(r.start_chapter);
+  }
+
   // 钩子章
   const hookTimeline = Array.isArray(timeline.hook_timeline) ? timeline.hook_timeline : [];
   for (const h of hookTimeline) {
@@ -783,7 +813,11 @@ function makeBatch(ctx) {
     objectKeys: ctx.objectKeys || [],
     // details 必须跟着 summary 一起合并：校验器要求两者 id 一一对应，
     // 只合并 summary 会让关键道具.json 永远缺 details（FLESH_DETAILS_ORPHAN）。
-    arrays: group.key ? (group.detail ? [group.key, group.detail] : [group.key]) : [],
+    arrays: group.key
+      ? [group.key, ...(group.detail ? [group.detail] : []), ...(group.extraArrays || [])]
+      : [],
+    extraArrays: (group.extraArrays || []).slice(),
+    optionalArrays: (group.optionalArrays || []).slice(),
     summaryArray: group.key,
     detailArray: group.detail || null,
     shard: shard,

package/plugins/fancy-story-builder/scripts/stage-contract.js

@@ -89,6 +89,7 @@ export function pickContractSections(content, names) {
  */
 const RELATION_TABLES = {
   character_relations: { match: ['from', 'to'], anchor: ['from'] },
+  other_relations: { match: ['from', 'to'], anchor: null },
   faction_membership: { match: ['character', 'faction'], anchor: null },
   faction_relations: { match: ['from', 'to'], anchor: ['from'] },
   conflict_participants: { match: ['conflict', 'protagonist_side', 'main_antagonist', 'secondary_antagonist', 'third_party'], anchor: null },
@@ -258,6 +259,12 @@ export function buildRhythmChapterRefs(opts) {
       mainNodesByCh.get(n.chapter).push({ main_id: m.main_id, event_ref: n.event_ref });
     }
   }
+  const relationshipByCh = new Map();
+  for (const r of (timeline.relationship_timeline || [])) {
+    if (!r || typeof r.start_chapter !== 'number') continue;
+    if (!relationshipByCh.has(r.start_chapter)) relationshipByCh.set(r.start_chapter, []);
+    relationshipByCh.get(r.start_chapter).push(r);
+  }
   const branchByCh = new Map();
   for (const b of (timeline.branch_timeline || [])) {
     if (!b || typeof b !== 'object') continue;
@@ -284,6 +291,11 @@ export function buildRhythmChapterRefs(opts) {
     for (const n of (mainNodesByCh.get(ch) || [])) {
       parts.push('主线节点 ' + n.main_id + nameOf(n.main_id, names) + '：' + str(n.event_ref));
     }
+    for (const r of (relationshipByCh.get(ch) || [])) {
+      parts.push('关系阶段 ' + r.from + nameOf(r.from, names) + ' → ' + r.to + nameOf(r.to, names) +
+        '：' + str(r.stage) + ' / ' + str(r.state) +
+        (r.trigger_event ? '（触发：' + str(r.trigger_event) + '）' : ''));
+    }
     for (const b of (branchByCh.get(ch) || [])) {
       parts.push('支线 ' + b);
     }