@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

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

@@ -0,0 +1,390 @@
+/**
+ * patch-driver.js —— 用户意见 → llm_wiki 影响分析 → DSH LLM 修订
+ *
+ * 设计原则：
+ *   - 影响分析先于修改；分析结果不可靠时按“有影响”处理，要求用户确认。
+ *   - patch 只改已生成阶段的事实源 JSON，不创建未生成阶段，不直接改 wiki。
+ *   - 修改后按阶段级联校验：改骨架就校验骨架+血肉+节奏；只改血肉就校验血肉+节奏。
+ *   - 纯函数（提示词、解析、阶段检测）与网络/LLM 调用分离，方便测试。
+ */
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { referenceLogPromptBlock } from './scripts/reference-log.js';
+
+export const PATCH_STAGE_ORDER = ['skeleton', 'flesh', 'rhythm'];
+export const PATCH_STAGE_LABEL = { skeleton: '骨架', flesh: '血肉', rhythm: '节奏', writing: '写作' };
+export const PATCH_STAGE_DIR = { skeleton: '骨架', flesh: '血肉', rhythm: '节奏', writing: '写作' };
+
+const SRC = ['设定', 'raw', 'sources'];
+
+export function patchStageDir(projectRoot, stage) {
+  return join(projectRoot, ...SRC, PATCH_STAGE_DIR[stage] || stage);
+}
+
+function jsonFilesIn(dir) {
+  if (!existsSync(dir)) return [];
+  try {
+    return readdirSync(dir)
+      .filter((name) => name.endsWith('.json') && !name.startsWith('.'))
+      .sort()
+      .map((name) => join(dir, name));
+  } catch {
+    return [];
+  }
+}
+
+/** 当前已经产出、可以被 patch 的结构化阶段。 */
+export function detectGeneratedStages(projectRoot) {
+  const stages = [];
+  if (existsSync(join(patchStageDir(projectRoot, 'skeleton'), '实体.json'))) stages.push('skeleton');
+  if (jsonFilesIn(patchStageDir(projectRoot, 'flesh')).length > 0) stages.push('flesh');
+  if (jsonFilesIn(patchStageDir(projectRoot, 'rhythm')).length > 0) stages.push('rhythm');
+  return stages;
+}
+
+/** 写作阶段只提示，不自动 patch。 */
+export function hasWritingFiles(projectRoot) {
+  const dir = patchStageDir(projectRoot, 'writing');
+  if (!existsSync(dir)) return false;
+  try {
+    return readdirSync(dir).some((name) => /^第\d+章\.md$/.test(name));
+  } catch {
+    return false;
+  }
+}
+
+/** patch 的事实源文件：只收各阶段顶层 JSON，派生文件（细纲/档案）不算。 */
+export function collectPatchFiles(projectRoot, stages) {
+  const out = [];
+  for (const stage of stages || []) {
+    if (PATCH_STAGE_ORDER.indexOf(stage) < 0) continue;
+    for (const file of jsonFilesIn(patchStageDir(projectRoot, stage))) out.push(file);
+  }
+  return out;
+}
+
+/** 文件快照：path → 内容。 */
+export function snapshotPatchFiles(files) {
+  const map = new Map();
+  for (const file of files || []) {
+    try { map.set(file, readFileSync(file, 'utf-8')); } catch { /* ignore */ }
+  }
+  return map;
+}
+
+/** 和快照相比，哪些阶段发生了实际变化（含新增 JSON 文件）。 */
+export function changedPatchStages(projectRoot, stages, before) {
+  const changed = [];
+  for (const stage of stages || []) {
+    const dir = patchStageDir(projectRoot, stage);
+    const files = jsonFilesIn(dir);
+    const prefix = dir + '/';
+    const deleted = before
+      ? [...before.keys()].some((file) => file.startsWith(prefix) && !existsSync(file))
+      : false;
+    const modified = files.some((file) => {
+      if (!before || !before.has(file)) return true;
+      try { return readFileSync(file, 'utf-8') !== before.get(file); } catch { return true; }
+    });
+    if (deleted || modified) changed.push(stage);
+  }
+  return changed;
+}
+
+/** 修改意见 → 影响分析提示词。 */
+export function buildImpactAnalysisPrompt(opts) {
+  const o = opts || {};
+  const userRequest = String(o.userRequest || '').trim();
+  const stages = Array.isArray(o.generatedStages) ? o.generatedStages : [];
+  return [
+    '你是小说设定影响分析器。用户提出了一条对当前故事的修改意见，请判断它会带来什么影响。',
+    '',
+    '## 用户意见',
+    userRequest,
+    '',
+    '## 当前已生成阶段',
+    stages.length ? stages.map((s) => '- ' + (PATCH_STAGE_LABEL[s] || s)).join('\n') : '- （无）',
+    '',
+    '## 你的任务',
+    '只基于当前 LLM Wiki 中真实存在的页面分析，不要发明页面里没有的设定。',
+    '重点检查：',
+    '- 角色关系类型与关系阶段；',
+    '- 冲突参与方、主线/支线；',
+    '- 伏笔的埋设与回收；',
+    '- 章节时间线、角色状态、信息差；',
+    '- 已写正文是否出现与该修改相反的既成事实。',
+    '',
+    '## 输出格式（必须是 JSON，不要只写散文）',
+    '```json',
+    '{',
+    '  "verdict": "ok" | "impact" | "unknown",',
+    '  "confidence": "high" | "medium" | "low",',
+    '  "summary": "一句话结论",',
+    '  "effects": ["具体影响 1", "具体影响 2"],',
+    '  "affected_pages": ["页面 ID 或标题"],',
+    '  "affected_stages": ["skeleton", "flesh", "rhythm", "writing"],',
+    '  "recommendation": "建议怎么处理"',
+    '}',
+    '```',
+    '',
+    '规则：',
+    '- 只有确认没有任何矛盾、没有下游变化时，才允许 verdict="ok"。',
+    '- 不确定时必须 verdict="unknown"，不能猜 ok。',
+    '- 如果修改会改变关系，必须检查双方关系类型、关系阶段、章节落点和正文。',
+    '- 如果修改只影响措辞、不影响事实和下游引用，才可以 ok。',
+  ].join('\n');
+}
+
+/** llm_wiki /chat 的深度分析请求体。 */
+export function buildImpactAnalysisRequest(opts) {
+  const o = opts || {};
+  return {
+    message: buildImpactAnalysisPrompt(o),
+    mode: 'deep',
+    retrievalMode: 'smart',
+    tools: { wiki: true, web: false, anytxt: false },
+    topK: 10,
+    includeContent: true,
+    history: [],
+    historyExplicit: true,
+    persistSession: false,
+    stream: false,
+  };
+}
+
+/** 从文本里提取第一个完整 JSON 对象（容忍代码块/前后说明）。 */
+export function extractFirstJsonObject(text) {
+  const source = String(text || '');
+  for (let start = source.indexOf('{'); start >= 0; start = source.indexOf('{', start + 1)) {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < source.length; i++) {
+      const ch = source[i];
+      if (inString) {
+        if (escaped) { escaped = false; continue; }
+        if (ch === '\\') { escaped = true; continue; }
+        if (ch === '"') inString = false;
+        continue;
+      }
+      if (ch === '"') { inString = true; continue; }
+      if (ch === '{') depth += 1;
+      else if (ch === '}') {
+        depth -= 1;
+        if (depth === 0) {
+          try { return JSON.parse(source.slice(start, i + 1)); } catch { break; }
+        }
+      }
+    }
+  }
+  return null;
+}
+
+function asStringArray(value) {
+  const format = (x) => {
+    if (x === null || x === undefined) return '';
+    if (typeof x === 'string') return x.trim();
+    if (typeof x === 'object') {
+      try { return JSON.stringify(x); } catch { return String(x); }
+    }
+    return String(x);
+  };
+  if (Array.isArray(value)) return value.map(format).filter(Boolean);
+  if (typeof value === 'string' && value.trim()) return [value.trim()];
+  if (value && typeof value === 'object') return [format(value)];
+  return [];
+}
+
+function normalizeVerdict(value) {
+  const v = String(value || '').trim().toLowerCase();
+  if (v === 'ok' || v === 'no-impact' || v === 'no_impact' || v === 'no impact' || v === 'pass' || v === '无影响') return 'ok';
+  if (v === 'impact' || v === 'affected' || v === 'change' || v === '有影响') return 'impact';
+  return 'unknown';
+}
+
+function normalizeConfidence(value) {
+  const v = String(value || '').trim().toLowerCase();
+  if (v === 'high' || v === 'medium' || v === 'low') return v;
+  if (v === '高' || v === '高置信') return 'high';
+  if (v === '中' || v === '中置信') return 'medium';
+  if (v === '低' || v === '低置信') return 'low';
+  return 'medium';
+}
+
+/**
+ * 解析影响分析答案。
+ * JSON 优先；没有 JSON 时接受 PATCH_IMPACT/VERDICT 标记。
+ * 无法解析时返回 unknown（宁可多让用户确认一次，也不自动改错）。
+ */
+export function parseImpactAnalysis(text) {
+  const raw = String(text || '').trim();
+  const json = extractFirstJsonObject(raw);
+  if (json && typeof json === 'object') {
+    return {
+      verdict: normalizeVerdict(json.verdict || json.status || json.result),
+      confidence: normalizeConfidence(json.confidence),
+      summary: String(json.summary || json.why || '').trim(),
+      effects: asStringArray(json.effects || json.impact || json.impacts),
+      affectedPages: asStringArray(json.affected_pages || json.affectedPages),
+      affectedStages: asStringArray(json.affected_stages || json.affectedStages)
+        .map((s) => ({ 骨架: 'skeleton', 血肉: 'flesh', 节奏: 'rhythm', 写作: 'writing', 正文: 'writing' }[s] || s))
+        .filter((s) => PATCH_STAGE_ORDER.indexOf(s) >= 0 || s === 'writing'),
+      recommendation: String(json.recommendation || '').trim(),
+      raw,
+    };
+  }
+
+  const marker = /(?:PATCH_IMPACT|VERDICT|影响结论)\s*[:：]\s*(OK|IMPACT|UNKNOWN|无影响|有影响|不确定)/i.exec(raw);
+  if (marker) {
+    const v = marker[1].toLowerCase();
+    return {
+      verdict: (v === 'ok' || v === '无影响') ? 'ok' : (v === 'unknown' || v === '不确定' ? 'unknown' : 'impact'),
+      confidence: 'medium',
+      summary: raw.slice(0, 300),
+      effects: [],
+      affectedPages: [],
+      affectedStages: [],
+      recommendation: '',
+      raw,
+    };
+  }
+
+  return {
+    verdict: 'unknown',
+    confidence: 'low',
+    summary: raw ? raw.slice(0, 300) : '影响分析没有返回内容',
+    effects: [],
+    affectedPages: [],
+    affectedStages: [],
+    recommendation: '影响分析结果无法解析，请人工确认后再修改。',
+    raw,
+  };
+}
+
+/** 只有明确的 ok + high 才自动改；其余都让用户确认。 */
+export function shouldAutoApplyImpact(impact) {
+  return !!impact
+    && impact.verdict === 'ok'
+    && impact.confidence === 'high'
+    && (!impact.effects || impact.effects.length === 0)
+    && (!impact.affectedPages || impact.affectedPages.length === 0)
+    && (!impact.affectedStages || impact.affectedStages.length === 0);
+}
+
+export function formatImpactForUser(impact) {
+  const i = impact || {};
+  if (i.verdict === 'ok') {
+    return '影响分析：未发现明确的下游影响。' + (i.summary ? '\n\n' + i.summary : '');
+  }
+  const effects = Array.isArray(i.effects) ? i.effects : [];
+  const affectedPages = Array.isArray(i.affectedPages) ? i.affectedPages : [];
+  const affectedStages = Array.isArray(i.affectedStages) ? i.affectedStages : [];
+  const lines = ['影响分析：这次修改可能会影响以下内容。'];
+  if (i.summary) lines.push('', i.summary);
+  if (effects.length) {
+    lines.push('', '具体影响：');
+    for (const x of effects) lines.push('- ' + x);
+  }
+  if (affectedPages.length) {
+    lines.push('', '涉及页面：' + affectedPages.join('、'));
+  }
+  if (affectedStages.length) {
+    lines.push('', '涉及阶段：' + affectedStages.map((s) => PATCH_STAGE_LABEL[s] || s).join('、'));
+  }
+  if (i.recommendation) lines.push('', '建议：' + i.recommendation);
+  if (!effects.length && !affectedPages.length && i.summary) {
+    lines.push('', '（模型没有列出具体条目，建议按“有影响”处理。）');
+  }
+  return lines.join('\n');
+}
+
+function stageScopeLines(opts) {
+  const o = opts || {};
+  const stages = Array.isArray(o.generatedStages) ? o.generatedStages : [];
+  const patchStages = Array.isArray(o.patchStages) ? o.patchStages : [];
+  const lines = [];
+  lines.push('已生成阶段：' + (stages.length ? stages.map((s) => PATCH_STAGE_LABEL[s] || s).join('、') : '无'));
+  lines.push('本次允许修改阶段：' + (patchStages.length ? patchStages.map((s) => PATCH_STAGE_LABEL[s] || s).join('、') : '无'));
+  if (!stages.includes('rhythm')) {
+    lines.push('节奏阶段尚未生成：**不要创建节奏目录或节奏 JSON**。');
+  }
+  if (o.hasWriting) {
+    lines.push('写作阶段已有正文：**不要改正文**；如有影响，在报告里列出受影响章节，由用户另行处理。');
+  }
+  return lines;
+}
+
+/** DSH LLM 的 patch 提示词。 */
+export function buildPatchPrompt(opts) {
+  const o = opts || {};
+  const userRequest = String(o.userRequest || '').trim();
+  const impact = o.impact || null;
+  const patchStages = Array.isArray(o.patchStages) ? o.patchStages : [];
+  const validationErrors = Array.isArray(o.validationErrors) ? o.validationErrors : [];
+  const attempt = o.attempt || 1;
+  const lines = [];
+  lines.push('# 本轮任务：按用户意见修订已生成的故事设定');
+  lines.push('');
+  lines.push('这是第 ' + attempt + ' 轮 patch。');
+  lines.push('');
+  lines.push('## 用户意见');
+  lines.push(userRequest);
+  lines.push('');
+  if (impact) {
+    lines.push('## llm_wiki 影响分析');
+    lines.push(formatImpactForUser(impact));
+    lines.push('');
+  }
+  lines.push('## 阶段边界（硬约束）');
+  lines.push(stageScopeLines(o));
+  lines.push('');
+  lines.push('只允许修改这些阶段的事实源 JSON：');
+  for (const stage of patchStages) {
+    lines.push('- `' + join('设定/raw/sources', PATCH_STAGE_DIR[stage]) + '/`（' + (PATCH_STAGE_LABEL[stage] || stage) + '）');
+  }
+  lines.push('');
+  lines.push('## 允许改的文件');
+  for (const file of (o.files || [])) {
+    lines.push('- `' + file + '`');
+  }
+  lines.push('');
+  lines.push('## 修改规则');
+  lines.push('1. 只改与用户意见直接相关的最小字段；不要重写整个文件，不要删无关条目。');
+  lines.push('2. 保留所有 id、name、枚举、章节号、已有引用；新增/改名会制造下游错误。');
+  lines.push('3. 关系类型改变时，必须同步骨架 `关系.json` 和血肉 `角色.json` 的 `relationships[]`。');
+  lines.push('4. 关系阶段改变时，只有在节奏阶段已生成时才改 `时序映射.json` 的 `relationship_timeline`；未生成时不要创建。');
+  lines.push('5. 血肉阶段不要写章节号；章节落点属于节奏阶段。');
+  lines.push('6. 不要修改 `设定/wiki/`、`模板/`、`references/`、校验脚本、`档案/`、`节奏/细纲/`。');
+  lines.push('7. 不要修改写作正文（`写作/第NNN章.md`）。');
+  lines.push('8. 改完就停，不要运行校验脚本；插件会跑阶段校验器并把错误回喂。');
+  lines.push('');
+  if (validationErrors.length) {
+    lines.push('## 上一轮校验错误（只修这些）');
+    lines.push('');
+    for (const e of validationErrors) {
+      lines.push('- [' + (e.code || 'ERROR') + '] ' + (e.stage ? '[' + (PATCH_STAGE_LABEL[e.stage] || e.stage) + '] ' : '') +
+        (e.path || '(无路径)') + '：' + (e.message || '') + (e.hint ? '（' + e.hint + '）' : ''));
+    }
+    lines.push('');
+    lines.push('**只修上面点名的字段**，其余内容保持原样。');
+    lines.push('');
+  }
+  lines.push(referenceLogPromptBlock('patch', { type: 'patch' }, {
+    allowedFileText: '除本阶段允许修改的事实源 JSON 外，`设定/.reference-decisions.md` 是本轮唯一允许写的额外文件；不要修改 wiki、模板、references 目录或其它阶段。',
+  }));
+  lines.push('## 交付');
+  lines.push('');
+  lines.push('改完用一句话说明改了哪些文件/字段，然后停下。');
+  return lines.join('\n');
+}
+
+/** 修改后需要校验的阶段：从最早被改的结构化阶段，到所有已生成的下游阶段。 */
+export function buildPatchValidationStages(changedStages, generatedStages) {
+  const generated = Array.isArray(generatedStages) ? generatedStages : [];
+  const changed = Array.isArray(changedStages) ? changedStages : [];
+  const structured = PATCH_STAGE_ORDER.filter((s) => generated.includes(s));
+  const changedStructured = changed.filter((s) => PATCH_STAGE_ORDER.includes(s));
+  if (!structured.length || !changedStructured.length) return [];
+  const earliest = Math.min(...changedStructured.map((s) => PATCH_STAGE_ORDER.indexOf(s)));
+  return structured.filter((s) => PATCH_STAGE_ORDER.indexOf(s) >= earliest);
+}