@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

package/plugins/fancy-story-builder/flesh-output.js

@@ -0,0 +1,155 @@
+/**
+ * flesh-output.js —— 血肉阶段的产出盘点
+ *
+ * 背景（2026-10 tt5 产物复查）：
+ *   血肉阶段是一次性派活：插件把整个血肉提示词投给 LLM，让它在一个回合里
+ *   依次产出 8 个 JSON。真实规模下这个回合的产出量是
+ *   角色 166KB + 冲突 81KB + 势力 20KB + 剧情 7KB + 地点 22KB
+ *   + 世界观规则 17KB + 关键道具 23KB ≈ 336KB（十几万 token 的输出）。
+ *   回合预算必然在中途耗尽。
+ *
+ *   实测 tt5：7 个文件产出，结局.json 没产出，.stage-status.json 的
+ *   all_check 一直是 PENDING（全量校验从未跑过），而插件这边早就返回了
+ *   "血肉阶段开始" —— 用户看不到任何提示，整个阶段是**静默失败**的。
+ *
+ * 本模块负责回答两个问题：
+ *   1. 血肉阶段到底产出了哪几个文件？（缺哪几个）
+ *   2. 全量校验过了没有？（all_check 是不是 PASSED）
+ *
+ * 有了这两个事实，插件才能在阶段结束时给出**可执行**的结论，
+ * 而不是一句"阶段开始"就撒手。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+// 血肉阶段的 8 个产出文件（顺序 = 提示词里的生成顺序，依赖关系见 02-flesh-prompt.md 第六节）
+export const FLESH_OUTPUT_FILES = [
+  '角色.json',
+  '冲突.json',
+  '势力.json',
+  '剧情.json',
+  '地点.json',
+  '结局.json',
+  '世界观规则.json',
+  '关键道具.json'
+];
+
+/**
+ * 盘点血肉阶段的产出。
+ *
+ * 返回：
+ *   present   已产出的文件名（按 FLESH_OUTPUT_FILES 顺序）
+ *   missing   缺失的文件名
+ *   complete  8 个文件是否齐全
+ */
+export function inspectFleshOutput(stageDir) {
+  const present = [];
+  const missing = [];
+  for (const f of FLESH_OUTPUT_FILES) {
+    const p = path.join(stageDir, f);
+    let ok = false;
+    try {
+      ok = fs.existsSync(p) && fs.statSync(p).size > 0;
+    } catch {
+      ok = false;
+    }
+    if (ok) present.push(f);
+    else missing.push(f);
+  }
+  return { present, missing, complete: missing.length === 0 };
+}
+
+/**
+ * 读血肉阶段的 .stage-status.json，看全量校验的状态。
+ *
+ * 返回 { allCheck, rounds, files, error }：
+ *   allCheck: 'PASSED' | 'FAILED' | 'PENDING' | null（读不到就是 null）
+ *   files:    { 文件名: { status, retries } }，单文件校验结果
+ *   error:    读不到/解析失败的原因
+ */
+export function readFleshStageStatus(stageDir) {
+  const p = path.join(stageDir, '.stage-status.json');
+  if (!fs.existsSync(p)) {
+    return { allCheck: null, rounds: 0, files: {}, error: '.stage-status.json 不存在（血肉阶段还没跑过校验）' };
+  }
+  let s;
+  try {
+    s = JSON.parse(fs.readFileSync(p, 'utf-8'));
+  } catch (e) {
+    return { allCheck: null, rounds: 0, files: {}, error: '.stage-status.json 解析失败：' + e.message };
+  }
+  if (!s || typeof s !== 'object') {
+    return { allCheck: null, rounds: 0, files: {}, error: '.stage-status.json 内容不是对象' };
+  }
+  const all = s.all_check && typeof s.all_check === 'object' ? s.all_check : {};
+  return {
+    allCheck: all.status || null,
+    rounds: all.rounds || 0,
+    files: (s.files && typeof s.files === 'object') ? s.files : {},
+    error: null
+  };
+}
+
+/**
+ * 生成血肉阶段收尾的结论说明（人类可读、可执行）。
+ *
+ * 覆盖四种情况：
+ *   1. 文件齐 + 全量 PASSED      → 通过
+ *   2. 文件齐 + 全量没过          → 文件在，但跨文件一致性没验过
+ *   3. 文件缺 + 全量没过          → 阶段没跑完（最常见：回合预算耗尽）
+ *   4. 文件缺 + 全量 PASSED        → 数据不一致，需要人工核对
+ */
+export function buildFleshCompletionNote(inspect, status) {
+  const lines = [];
+  const allCheck = status.allCheck;
+  const missing = inspect.missing;
+
+  if (inspect.complete && allCheck === 'PASSED') {
+    lines.push('血肉阶段产出检查：8 个 JSON 齐全，全量校验（--all）已通过。');
+    lines.push('');
+    lines.push('产出文件：');
+    for (const f of inspect.present) lines.push('- 设定/raw/sources/血肉/' + f);
+    lines.push('');
+    lines.push('可以进入节奏阶段（节奏阶段的上游门禁要求血肉阶段 all_check.status = PASSED）。');
+    return lines.join('\n');
+  }
+
+  lines.push('血肉阶段产出检查：**未通过**，当前状态如下。');
+
+  if (!inspect.complete) {
+    lines.push('');
+    lines.push('- 缺失文件（' + missing.length + '/' + FLESH_OUTPUT_FILES.length + '）：' + missing.join('、'));
+    lines.push('  常见原因：血肉阶段是一次性派活，8 个文件要在一个回合里全部产出，');
+    lines.push('  真实规模下输出量超过单回合预算，LLM 在中途耗尽预算就停了。');
+  } else {
+    lines.push('');
+    lines.push('- 8 个 JSON 都已产出。');
+  }
+
+  lines.push('');
+  if (allCheck === 'PASSED') {
+    lines.push('- 全量校验：PASSED（但文件集合与校验记录不一致，需要人工核对）。');
+  } else if (allCheck === 'FAILED') {
+    lines.push('- 全量校验：FAILED（跨文件一致性检查没过，错误见校验脚本输出）。');
+  } else if (allCheck === 'PENDING') {
+    lines.push('- 全量校验：**PENDING**（从未跑过 --all，跨文件一致性、配额一致性、引用完整性全都没验过）。');
+  } else {
+    lines.push('- 全量校验：**未运行**（' + (status.error || '状态不可读') + '）。');
+  }
+
+  lines.push('');
+  lines.push('下一步：');
+  if (!inspect.complete) {
+    lines.push('1. 重新运行血肉阶段，补齐缺失文件：' + missing.join('、'));
+    lines.push('2. 8 个文件齐了之后，必须再跑一次全量校验（--all），确认 all_check.status = PASSED；');
+    lines.push('3. 在此之前不要进入节奏阶段 —— 节奏阶段的上游门禁要求血肉阶段全量校验通过。');
+  } else {
+    lines.push('1. 跑一次全量校验（--all），把 errors 逐条改掉；');
+    lines.push('2. 直到 all_check.status = PASSED 再进入节奏阶段。');
+  }
+  lines.push('');
+  lines.push('> 注意：血肉阶段目前**没有**断点续跑机制，重跑会覆盖已有文件（这是有意为之：');
+  lines.push('> 血肉产物要求 id/name 与骨架严格一致，旧文件带着上一轮的措辞，整体覆盖比增量修补更安全）。');
+
+  return lines.join('\n');
+}