@cloud411716/fancy-webnovel 2.2.0 → 3.0.3

package/plugins/fancy-story-builder/writing-driver.js

@@ -23,6 +23,7 @@ import { existsSync, readFileSync, readdirSync } from 'fs';
 import { join } from 'path';
 
 import { countEffectiveChars } from './scripts/content-quality.js';
+import { absolutizeInlinePaths } from './templates.js';
 
 // 每批章数
 export const WRITING_BATCH_SIZE = 10;
@@ -61,6 +62,9 @@ export function chapterFileName(ch) {
 export function writingDirs(projectRoot) {
   const src = join(projectRoot, '设定', 'raw', 'sources');
   return {
+    // 项目根：提示词里的参考文件路径要靠它绝对化
+    // （参考文件在**项目根**的 references/ 下，相对路径会被拼到 设定/ 底下读不到）
+    root: projectRoot,
     sources: src,
     skeleton: join(src, '骨架'),
     flesh: join(src, '血肉'),
@@ -192,6 +196,43 @@ export function readWritingState(dirs, T) {
   return { existing, ledgers, prevTail, prevChapter, invalid };
 }
 
+/** 读取每章细纲（节奏/细纲/第NNN章.json）。 */
+function readChapterBriefs(dirs) {
+  const out = new Map();
+  const dir = join(dirs.rhythm, '细纲');
+  if (!existsSync(dir)) return out;
+  let files = [];
+  try { files = readdirSync(dir); } catch { return out; }
+  for (const name of files) {
+    const match = /^第(\d+)章\.json$/.exec(name);
+    if (!match) continue;
+    const data = readJsonSafe(join(dir, name));
+    if (!data || typeof data.ch !== 'number') continue;
+    out.set(data.ch, data);
+  }
+  return out;
+}
+
+/** 读取角色完整档案（写作时只取本章 cast 的小档案）。 */
+function readCharacterProfiles(dirs) {
+  const data = readJsonSafe(join(dirs.flesh, '角色.json')) || {};
+  const map = new Map();
+  for (const c of (data.characters || [])) {
+    if (c && c.id) map.set(c.id, c);
+  }
+  return map;
+}
+
+/** 读取题材扩展实体档案（其他实体.json，可不存在）。 */
+function readOtherEntityProfiles(dirs) {
+  const data = readJsonSafe(join(dirs.flesh, '其他实体.json')) || {};
+  const map = new Map();
+  for (const o of (data.other_entities || [])) {
+    if (o && o.id) map.set(o.id, o);
+  }
+  return map;
+}
+
 export function loadWritingContext(projectRoot) {
   const dirs = writingDirs(projectRoot);
   const framework = readJsonSafe(join(dirs.skeleton, '框架.json'));
@@ -216,10 +257,18 @@ export function loadWritingContext(projectRoot) {
   const chapterContext = buildChapterContext(planRaw, timelineRaw, entity, fleshChars, roster);
 
   const state = readWritingState(dirs, T);
+  const briefs = readChapterBriefs(dirs);
+  const characterProfiles = readCharacterProfiles(dirs);
+  const otherEntityProfiles = readOtherEntityProfiles(dirs);
+  const skeletonRelations = readJsonSafe(join(dirs.skeleton, '关系.json')) || {};
 
   return {
     T,
     outlines,
+    briefs,
+    characterProfiles,
+    otherEntityProfiles,
+    otherRelations: Array.isArray(skeletonRelations.other_relations) ? skeletonRelations.other_relations : [],
     chapterContext,
     existing: state.existing,
     prevTail: state.prevTail,
@@ -267,6 +316,10 @@ export function refreshWritingContext(context) {
  * 本章该出场谁、该推进哪条线。
  */
 export function buildChapterContext(planRaw, timelineRaw, entity, fleshChars, roster) {
+  const plannedChapters = ((planRaw && planRaw.chapters) || [])
+    .map((c) => (c && typeof c.ch === 'number' ? c.ch : 0))
+    .filter((n) => n > 0);
+  const maxChapter = plannedChapters.length ? Math.max(...plannedChapters) : 0;
   const nameById = new Map();
   for (const c of (roster && roster.characters) || []) nameById.set(c.id, c.name);
   for (const c of (roster && roster.fleshCharacters) || []) nameById.set(c.id, c.name);
@@ -296,7 +349,7 @@ export function buildChapterContext(planRaw, timelineRaw, entity, fleshChars, ro
         volume: null, act: null, sceneFocus: '',
         characters: [], locations: [], items: [],
         conflicts: [], foreshadows: [], climax: null, pleasure: null,
-        hook: null, ending: null
+        hook: null, ending: null, relationships: []
       });
     }
     return ctx.get(ch);
@@ -378,6 +431,39 @@ export function buildChapterContext(planRaw, timelineRaw, entity, fleshChars, ro
     get(it.ch).hook = { head: it.hook_head || '', tail: it.hook_tail || '', strength: it.hook_strength || '' };
   }
 
+  // 关系阶段：把 relationship_timeline 的每个阶段铺到它生效的章节区间。
+  // 没有 end_chapter 时，默认持续到同一对关系的下一个阶段开始前（或全书结束）。
+  const relRows = (t.relationship_timeline || []).filter((r) =>
+    r && r.from && r.to && typeof r.start_chapter === 'number');
+  const rowsByPair = new Map();
+  for (const r of relRows) {
+    const key = [r.from, r.to].sort().join('↔');
+    if (!rowsByPair.has(key)) rowsByPair.set(key, []);
+    rowsByPair.get(key).push(r);
+  }
+  for (const rows of rowsByPair.values()) {
+    rows.sort((a, b) => a.start_chapter - b.start_chapter);
+    for (let i = 0; i < rows.length; i++) {
+      const r = rows[i];
+      const explicitEnd = typeof r.end_chapter === 'number' ? r.end_chapter : null;
+      const nextStart = i + 1 < rows.length ? rows[i + 1].start_chapter : null;
+      const end = explicitEnd !== null ? explicitEnd : (nextStart !== null ? nextStart - 1 : maxChapter);
+      for (let ch = r.start_chapter; ch <= Math.min(end, maxChapter); ch++) {
+        get(ch).relationships.push({
+          from: r.from,
+          to: r.to,
+          from_name: nameById.get(r.from) || r.from,
+          to_name: nameById.get(r.to) || r.to,
+          stage: r.stage || '',
+          state: r.state || '',
+          trigger_event: r.trigger_event || '',
+          start_chapter: r.start_chapter,
+          changed_this_chapter: ch === r.start_chapter,
+        });
+      }
+    }
+  }
+
   return ctx;
 }
 
@@ -403,6 +489,7 @@ export function buildEntityRoster(dirs) {
     locations: collectNamed(entity.locations),
     items: collectNamed(entity.items),
     endings: collectNamed(entity.endings),
+    otherEntities: collectNamed(entity.other_entities),
     fleshCharacters: collectNamed(flesh.characters)
   };
 }
@@ -473,6 +560,213 @@ function formatOutline(o) {
   return lines.length ? lines.join('\n') : '（本章无细纲）';
 }
 
+/**
+ * 把每章细纲渲染成写作提示词里的“硬约束”。
+ *
+ * 这里不是复述 JSON，而是把 LLM 写作时必须遵守的东西按“写什么/怎么写/必须/禁止”重排：
+ *   - 本章时间线：这一章在故事时间上发生什么；
+ *   - 出场角色/地点/道具/冲突/伏笔/高潮/爽点/结局：本章必须组织的要素；
+ *   - 信息差：谁还不知道什么，因此本章绝对不能提；
+ *   - 开场/推进/转折/收束：这一章的结构与技法；
+ *   - must_write / must_not_write：硬性清单。
+ */
+function formatBrief(brief) {
+  if (!brief || typeof brief !== 'object') return '';
+  const lines = [];
+  lines.push('## 本章细纲：第 ' + brief.ch + ' 章（硬约束，必须执行）');
+  lines.push('');
+  lines.push('- 卷/幕：' + (brief.volume || '未指定') + ' / ' + (brief.act || '未指定'));
+  lines.push('- 视角：' + (brief.pov_name || brief.pov || '未指定') + (brief.pov ? '（' + brief.pov + '）' : ''));
+  if (brief.scene_focus) lines.push('- 场景焦点：' + brief.scene_focus);
+  if (brief.function_main) lines.push('- 主功能：' + brief.function_main + (brief.function_aux ? '；辅助：' + brief.function_aux : ''));
+  if (brief.emotion && (brief.emotion.value !== null || brief.emotion.phase)) {
+    lines.push('- 情绪：' + (brief.emotion.phase || '') + (brief.emotion.value !== null ? '（强度 ' + brief.emotion.value + '）' : ''));
+  }
+  if (brief.word_target) lines.push('- 字数目标：约 ' + brief.word_target + ' 字');
+  if (brief.hooks) {
+    lines.push('- 钩子：章首 ' + (brief.hooks.head || '未指定') + ' / 章尾 ' + (brief.hooks.tail || '未指定') + (brief.hooks.strength ? '（强度 ' + brief.hooks.strength + '）' : ''));
+  }
+  lines.push('');
+
+  const tl = Array.isArray(brief.timeline_events) ? brief.timeline_events : [];
+  if (tl.length) {
+    lines.push('### 本章时间线（必须覆盖）');
+    for (const e of tl) lines.push('- ' + (e.type || '事件') + '：' + (e.description || e.ref || ''));
+    lines.push('');
+  }
+
+  const relationshipChanges = Array.isArray(brief.relationship_changes) ? brief.relationship_changes : [];
+  if (relationshipChanges.length) {
+    lines.push('### 本章关系阶段变化（必须发生，不能写成没发生过）');
+    for (const r of relationshipChanges) {
+      lines.push('- ' + (r.from_name || r.from) + ' → ' + (r.to_name || r.to) + '：' +
+        (r.stage ? '【' + r.stage + '】' : '') + (r.state || '') +
+        (r.trigger_event ? '；触发：' + r.trigger_event : '') +
+        (r.description ? '；' + r.description : ''));
+    }
+    lines.push('');
+  }
+
+  const cast = Array.isArray(brief.cast) ? brief.cast : [];
+  if (cast.length) {
+    lines.push('### 本章必须出场');
+    lines.push('- ' + cast.map((c) => c.id + '（' + c.name + (c.reason ? '，' + c.reason : '') + '）').join('、'));
+    lines.push('');
+  }
+
+  if (brief.location) lines.push('### 本章地点\n- ' + brief.location.id + '（' + brief.location.name + '）\n');
+  if (Array.isArray(brief.items) && brief.items.length) {
+    lines.push('### 本章道具\n- ' + brief.items.map((x) => x.id + '（' + x.name + '）').join('、') + '\n');
+  }
+  if (Array.isArray(brief.conflicts) && brief.conflicts.length) {
+    lines.push('### 本章冲突');
+    for (const c of brief.conflicts) lines.push('- ' + c.id + '（' + c.name + '）：' + (c.node_type || '推进'));
+    lines.push('');
+  }
+  if (Array.isArray(brief.foreshadow_actions) && brief.foreshadow_actions.length) {
+    lines.push('### 本章伏笔动作');
+    for (const f of brief.foreshadow_actions) lines.push('- ' + f.action + ' ' + f.id + '（' + f.name + '）');
+    lines.push('');
+  }
+  const big = [];
+  if (brief.climax) big.push('高潮 ' + brief.climax.id + '（' + brief.climax.name + '）');
+  if (brief.pleasure) big.push('爽点 ' + brief.pleasure.id + '（' + brief.pleasure.name + '）');
+  if (brief.ending) big.push('结局节点 ' + brief.ending.id + '（' + brief.ending.name + '）');
+  if (big.length) lines.push('### 本章必须兑现\n- ' + big.join('\n- ') + '\n');
+
+  const gaps = Array.isArray(brief.information_gaps) ? brief.information_gaps : [];
+  if (gaps.length) {
+    lines.push('### 本章信息差（必须处理）');
+    for (const g of gaps) {
+      lines.push('- [' + g.status + '] ' + g.info_name + '（' + g.id + '）');
+      if (g.who_knows && g.who_knows.length) lines.push('  - 已知：' + g.who_knows.join('、'));
+      if (g.who_does_not_know && g.who_does_not_know.length) lines.push('  - 尚不知道：' + g.who_does_not_know.join('、'));
+      for (const line of (g.forbidden_mentions || [])) lines.push('  - ⛔ ' + line);
+    }
+    lines.push('');
+  }
+
+  const boundaries = Array.isArray(brief.information_boundaries) ? brief.information_boundaries : [];
+  if (boundaries.length) {
+    lines.push('### 信息边界（角色不知道/误以为的事，不能写漏）');
+    for (const b of boundaries) {
+      if (b.unknown_secrets) lines.push('- ⛔ ' + b.name + '（' + b.id + '）不知道：' + String(b.unknown_secrets).replace(/[。；;]+$/, '') + '。本章不得让其提及、知情或据此行动。');
+      if (b.false_beliefs) lines.push('- ⛔ ' + b.name + '（' + b.id + '）误以为：' + String(b.false_beliefs).replace(/[。；;]+$/, '') + '。除非本章信息差动作明确揭示，否则不得让旁白或他人直接纠正。');
+    }
+    lines.push('');
+  }
+
+  const how = brief.how_to_write || {};
+  lines.push('### 怎么写（按这个结构组织本章）');
+  if (how.pov_rule) lines.push('- 视角规则：' + how.pov_rule);
+  if (how.opening && how.opening.technique) {
+    lines.push('- 开场技法' + (how.opening.hook_type ? '（' + how.opening.hook_type + '）' : '') + '：' + how.opening.technique);
+  }
+  if (how.ending && how.ending.technique) {
+    lines.push('- 收束技法' + (how.ending.hook_type ? '（' + how.ending.hook_type + '）' : '') + '：' + how.ending.technique);
+  }
+  const beats = Array.isArray(how.scene_beats) ? how.scene_beats : [];
+  if (beats.length) {
+    for (const b of beats) {
+      lines.push('- ' + (b.name || '节拍') + '：' + (b.goal || ''));
+      for (const x of (b.must || [])) lines.push('  - 必须：' + x);
+      for (const x of (b.avoid || [])) lines.push('  - 避免：' + x);
+    }
+  } else {
+    if (how.opening) lines.push('- 开场：' + how.opening.technique);
+    if (how.development) lines.push('- 推进：' + how.development.goal);
+    if (how.turn) lines.push('- 转折：' + how.turn.goal);
+    if (how.ending) lines.push('- 收束：' + how.ending.technique);
+  }
+  lines.push('');
+
+  const must = Array.isArray(brief.must_write) ? brief.must_write : (Array.isArray(brief.mandatory) ? brief.mandatory : []);
+  if (must.length) {
+    lines.push('### 必须写');
+    for (const x of must) lines.push('- ' + x);
+    lines.push('');
+  }
+  const forbidden = Array.isArray(brief.must_not_write) ? brief.must_not_write : (Array.isArray(brief.forbidden) ? brief.forbidden : []);
+  if (forbidden.length) {
+    lines.push('### 绝对不允许写（违反视为本章失败）');
+    for (const x of forbidden) lines.push('- ⛔ ' + x);
+    lines.push('');
+  }
+  return lines.join('\n');
+}
+
+/** 本章 cast 的完整小档案（语言/缺陷/目标/关系/信息状态）。 */
+function formatCharacterDossiers(context, briefs) {
+  const profiles = context.characterProfiles || new Map();
+  const ids = [];
+  for (const brief of briefs || []) {
+    for (const c of (brief.cast || [])) if (c && c.id && !ids.includes(c.id)) ids.push(c.id);
+  }
+  if (!ids.length || !profiles.size) return '';
+  const lines = ['## 本章角色档案（写对话/动作前先看）'];
+  let count = 0;
+  for (const id of ids) {
+    if (count >= 12) break;
+    const c = profiles.get(id);
+    if (!c) continue;
+    count += 1;
+    const lp = c.language_profile || {};
+    lines.push('');
+    lines.push('### ' + id + ' ' + (c.name || ''));
+    if (lp.catchphrase) lines.push('- 口头禅：' + lp.catchphrase);
+    if (lp.speech_rhythm) lines.push('- 说话节奏：' + lp.speech_rhythm);
+    if (lp.info_preference) lines.push('- 信息偏好：' + lp.info_preference);
+    if (lp.stance) lines.push('- 立场姿态：' + lp.stance);
+    if (lp.personality_tone) lines.push('- 语气：' + lp.personality_tone);
+    if (c.core_flaw) lines.push('- 核心缺陷：' + c.core_flaw);
+    if (c.goals) lines.push('- 目标：短期=' + (c.goals.short_term || '') + '；中期=' + (c.goals.medium_term || '') + '；长期=' + (c.goals.long_term || ''));
+    if (Array.isArray(c.traits) && c.traits.length) {
+      lines.push('- 独有特征：' + c.traits.join('；'));
+    }
+    if (Array.isArray(c.behavior_repeat_points) && c.behavior_repeat_points.length) {
+      lines.push('- 习惯动作：' + c.behavior_repeat_points.join('；'));
+    }
+    const targetNames = new Set((briefs || []).flatMap((b) => (b.cast || []).map((x) => x.name)));
+    const rels = (c.relationships || []).filter((r) => targetNames.has(r.target_name));
+    if (rels.length) {
+      lines.push('- 与本章角色关系：' + rels.map((r) => r.target_name + '（' + r.relationship_type + '）' + (r.description ? '：' + r.description : '')).join('；'));
+    }
+    if (c.information_state) {
+      const info = c.information_state;
+      if (info.known_secrets) lines.push('- 已知：' + info.known_secrets);
+      if (info.unknown_secrets) lines.push('- 不知道：' + info.unknown_secrets);
+      if (info.false_beliefs) lines.push('- 错误认知：' + info.false_beliefs);
+    }
+  }
+  return lines.length > 1 ? lines.join('\n') : '';
+}
+
+function formatOtherEntityDossiers(context, briefs) {
+  const profiles = context.otherEntityProfiles || new Map();
+  const relations = context.otherRelations || [];
+  if (!profiles.size || !relations.length) return '';
+  const castIds = new Set();
+  for (const brief of briefs || []) for (const c of (brief.cast || [])) if (c && c.id) castIds.add(c.id);
+  if (!castIds.size) return '';
+  const lines = ['## 本章特殊存在（非人物实体，不能写成普通角色）'];
+  let count = 0;
+  for (const [id, o] of profiles) {
+    const rel = relations.find((r) => r && (r.from === id || r.to === id) &&
+      (castIds.has(r.from) || castIds.has(r.to)));
+    if (!rel) continue;
+    count += 1;
+    if (count > 6) break;
+    lines.push('');
+    lines.push('### ' + id + ' ' + (o.name || '') + '（' + (o.kind || '其他实体') + '）');
+    lines.push('- 与本章角色关系：' + (rel.relation_label || '相关') + '（' + rel.from + ' → ' + rel.to + '）');
+    if (Array.isArray(o.traits) && o.traits.length) lines.push('- 独有特征：' + o.traits.join('；'));
+    if (Array.isArray(o.abilities) && o.abilities.length) lines.push('- 能力：' + o.abilities.join('；'));
+    if (Array.isArray(o.limits) && o.limits.length) lines.push('- 限制：' + o.limits.join('；'));
+    if (o.description) lines.push('- 描述：' + o.description);
+  }
+  return count ? lines.join('\n') : '';
+}
+
 function formatRoster(roster) {
   const seg = (label, arr) => {
     if (!arr || arr.length === 0) return '';
@@ -483,7 +777,8 @@ function formatRoster(roster) {
     seg('势力', roster.factions),
     seg('地点', roster.locations),
     seg('道具', roster.items),
-    seg('冲突', roster.conflicts)
+    seg('冲突', roster.conflicts),
+    seg('其他实体', roster.otherEntities)
   ].filter(Boolean);
   return parts.join('\n');
 }
@@ -551,6 +846,18 @@ function formatChapterContext(context, ch) {
   if (c.climax) lines.push('- 本章高潮：' + c.climax.id + '（' + c.climax.name + '）');
   if (c.pleasure) lines.push('- 本章爽点：' + c.pleasure.id + '（' + c.pleasure.name + '）');
   if (c.ending) lines.push('- 本章结局：' + c.ending.id + '（' + c.ending.name + '）');
+  {
+    const present = new Set((c.characters || []).map((x) => x.id));
+    const rels = (c.relationships || []).filter((r) => present.has(r.from) && present.has(r.to));
+    if (rels.length) {
+      for (const r of rels) {
+        lines.push('- 关系阶段：' + r.from_name + ' → ' + r.to_name + ' ' +
+          (r.stage ? '【' + r.stage + '】' : '') + (r.state || '') +
+          (r.trigger_event ? '（触发：' + r.trigger_event + '）' : '') +
+          (r.changed_this_chapter ? '（本章发生变化）' : ''));
+      }
+    }
+  }
   if (c.hook) {
     lines.push('- 钩子：章首 ' + (c.hook.head || '未指定') + ' / 章尾 ' + (c.hook.tail || '未指定') +
       (c.hook.strength ? '（强度 ' + c.hook.strength + '）' : ''));
@@ -571,6 +878,18 @@ export function buildBatchPrompt(context, batch, attempt, failures, contract) {
   const isRetry = attempt > 1 && failures && failures.length > 0;
   const targetChapters = isRetry ? failures.map((f) => f.ch) : batch.chapters;
   const parts = [];
+  const briefsInBatch = [];
+  const pushChapter = (ch) => {
+    const brief = context.briefs && context.briefs.get(ch);
+    if (brief) {
+      briefsInBatch.push(brief);
+      parts.push(formatBrief(brief));
+      return;
+    }
+    const cc = formatChapterContext(context, ch);
+    if (cc) parts.push(cc);
+    parts.push(formatOutline(context.outlines.get(ch)));
+  };
 
   if (contract) {
     parts.push(contract.trim());
@@ -595,10 +914,8 @@ export function buildBatchPrompt(context, batch, attempt, failures, contract) {
         parts.push('- [' + e.code + '] ' + (e.path || '(无路径)') + '：' + e.message + (e.hint ? '（' + e.hint + '）' : ''));
       }
       parts.push('');
-      const cc = formatChapterContext(context, f.ch);
-      if (cc) parts.push(cc);
       parts.push('该章细纲：');
-      parts.push(formatOutline(context.outlines.get(f.ch)));
+      pushChapter(f.ch);
       parts.push('');
     }
     parts.push('**只重写上面列出的章**，其它已通过的章不要动，也不要重复写。');
@@ -613,13 +930,22 @@ export function buildBatchPrompt(context, batch, attempt, failures, contract) {
     for (const ch of batch.chapters) {
       parts.push('### 第 ' + ch + ' 章');
       parts.push('');
-      const cc = formatChapterContext(context, ch);
-      if (cc) parts.push(cc);
-      parts.push(formatOutline(context.outlines.get(ch)));
+      pushChapter(ch);
       parts.push('');
     }
   }
 
+  const dossiers = formatCharacterDossiers(context, briefsInBatch);
+  if (dossiers) {
+    parts.push(dossiers);
+    parts.push('');
+  }
+  const otherDossiers = formatOtherEntityDossiers(context, briefsInBatch);
+  if (otherDossiers) {
+    parts.push(otherDossiers);
+    parts.push('');
+  }
+
   parts.push('## 落盘路径');
   parts.push('');
   for (const ch of targetChapters) {
@@ -667,7 +993,8 @@ export function buildBatchPrompt(context, batch, attempt, failures, contract) {
   parts.push('5. 全部写完后，用一段话汇报：本轮写了哪几章、每章标题与字数、埋/收了哪些伏笔、哪些章没有细纲。');
   parts.push('');
 
-  return parts.join('\n');
+  // 参考文件路径绝对化：基准钉死到项目根，模型不会把 references/ 拼到 设定/ 底下
+  return absolutizeInlinePaths(parts.join('\n'), (context && context.dirs && context.dirs.root) || '');
 }
 
 // ============================================================