@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

package/plugins/fancy-story-builder/wiki-references.js

@@ -0,0 +1,204 @@
+/**
+ * wiki-references.js
+ * 对标参考（对标/wiki/）的目录清单与注入文本
+ *
+ * 抽出来单独成模块的理由：这段逻辑决定了"哪些对标文件真的可以读"，
+ * 必须能被直接测。放在 index.js 里只能靠跑整个插件来覆盖，测不动。
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+
+// 各目录的作用说明（注入提示词时用）
+export const DIRECTORY_DESCRIPTIONS = {
+  '叙事视角': '叙事视角：分析视角选择和切换策略',
+  '章节结构': '章节结构：分析章节的起承转合结构',
+  '节奏韵律': '节奏韵律：分析叙事节奏的张弛控制',
+  '对话技巧': '对话技巧：分析对话中的言外之意和潜台词',
+  '描写技法': '描写技法：分析环境、动作，心理描写的技巧',
+  '伏笔回收': '伏笔回收：分析伏笔的埋设和回收技巧',
+  '世界观构建': '世界观构建：分析世界观设定的呈现方式',
+  '角色弧光': '角色弧光：分析角色在不同章节的成长弧线变化',
+  '情节机制': '情节机制：分析情节推进的内在逻辑',
+  '开头钩子': '开头钩子：分析开篇吸引读者的技巧',
+  '结尾收束': '结尾收束：分析章节结尾的收束技法',
+  '句式变化': '句式变化：分析句子的长短和节奏变化',
+  '段落布局': '段落布局：分析段落的疏密和布局',
+  '场景转换': '场景转换：分析场景切换的技巧',
+  '情绪渲染': '情绪渲染：分析情感氛围的营造方式',
+  '张力构建': '张力构建：分析冲突和悬念的构建方式',
+  '来源摘要': '来源摘要：章节的完整分析和要点提炼'
+};
+
+// 各阶段对应的 wiki 目录
+//
+// 映射依据：**这一层产物要回答什么问题**，再挑对标技法里对得上的那些。
+// 判据是"样本里的那招能不能直接指导本层的一个字段"，不是"主题沾边"。
+//
+//   骨架：有哪些实体、怎么连、有多少、分几卷几幕
+//     → 情节机制（主线支线怎么构成）/ 张力构建（冲突与门槛怎么叠）
+//     → 伏笔回收（伏笔清单怎么埋）/ 角色弧光（成长型支线的走向）
+//     → 结尾收束（结局怎么设计）/ 世界观构建（规则与势力怎么成体系）
+//   血肉：实体长什么样（角色卡、世界观、关系、情绪）
+//     → 世界观构建 / 描写技法 / 对话技巧 / 场景转换 / 情绪渲染
+//     → 角色弧光 / 伏笔回收 / 情节机制
+//   节奏：什么时间发生（升级、弧线、高潮钩子、爽点、伏笔密度、章节切分）
+//     → 节奏韵律 / 张力构建 / 章节结构 / 伏笔回收 / 情绪渲染
+//     → 开头钩子 / 结尾收束 / 情节机制 / 角色弧光
+//   写作：具体怎么写（场景、章节工作流、开篇、对话、句式、语气）
+//     → 开头钩子 / 结尾收束 / 对话技巧 / 描写技法 / 段落布局 / 句式变化
+//     → 叙事视角 / 场景转换 / 节奏韵律
+export const PHASE_DIRECTORIES = {
+  skeleton: ['世界观构建', '情节机制', '张力构建', '伏笔回收', '角色弧光', '结尾收束'],
+  flesh: ['世界观构建', '描写技法', '对话技巧', '场景转换', '情绪渲染', '角色弧光', '伏笔回收', '情节机制'],
+  rhythm: ['节奏韵律', '张力构建', '章节结构', '伏笔回收', '情绪渲染', '开头钩子', '结尾收束', '情节机制', '角色弧光'],
+  // 写作阶段以前没有对应键 → readWikiReferences 会退回 skeleton 那套，
+  // 结果是写章节时拿到的是骨架阶段的目录（角色弧光/伏笔回收…），
+  // 真正该读的对话、句式、段落反而一个都没有（2026-10-27 查到）。
+  writing: ['开头钩子', '结尾收束', '对话技巧', '描写技法', '段落布局', '句式变化', '叙事视角', '场景转换', '节奏韵律'],
+  // 去味阶段不注入对标参考：改写的是"像不像人话"，不是"写得好不好"，
+  // 拿别人的写法当参照反而会把旧稿的毛病一起抄进去。
+  deslop: [],
+  analyze: ['角色弧光', '伏笔回收', '结尾收束', '张力构建', '情节机制', '开头钩子', '节奏韵律', '世界观构建', '章节结构', '情绪渲染', '对话技巧', '场景转换', '描写技法']
+};
+
+/**
+ * 各阶段的"插件指导目录"与本阶段重点。
+ *
+ * 用来在提示词里把两层参考分开讲清楚：
+ *   references/<阶段>指导/  = 高维方法论（这一层该怎么设计）
+ *   对标/wiki/              = 市场验证过的落地样本（某招在成品里怎么生效）
+ */
+export const PHASE_GUIDANCE = {
+  skeleton: {
+    guideDir: 'references/骨架指导',
+    focus: '有哪些实体、实体怎么连、有多少、分几卷几幕'
+  },
+  flesh: {
+    guideDir: 'references/血肉指导',
+    focus: '实体长什么样：目标、缺陷、资源、关系、情绪怎么落到实处'
+  },
+  rhythm: {
+    guideDir: 'references/节奏指导',
+    focus: '什么时间发生：升级、弧线、高潮钩子、爽点、伏笔密度、章节怎么切'
+  },
+  writing: {
+    guideDir: 'references/写作指导',
+    focus: '具体怎么写：场景、章节工作流、开篇、对话、句式、语气'
+  }
+};
+
+/**
+ * 找出当前阶段真正可读的对标总结文件。
+ *
+ * 只认 `<目录名>-总结.md`；目录在但总结文件不在的，记为 missing。
+ *
+ * @returns {{ available: Array<{dir:string, path:string}>, missing: string[] }}
+ */
+export function collectWikiReferences(projectRoot, phase = 'skeleton') {
+  const wikiDir = join(projectRoot, '对标', 'wiki');
+  const phaseDirs = PHASE_DIRECTORIES[phase] || PHASE_DIRECTORIES.skeleton;
+  const available = [];
+  const missing = [];
+  for (const dir of Array.from(phaseDirs).sort()) {
+    const summaryFile = join(wikiDir, dir, dir + '-总结.md');
+    if (existsSync(summaryFile)) {
+      available.push({ dir, path: '对标/wiki/' + dir + '/' + dir + '-总结.md' });
+    } else {
+      missing.push(dir);
+    }
+  }
+  return { available, missing };
+}
+
+/**
+ * 生成注入提示词的对标参考文本。
+ *
+ * 只注入**实际存在**的文件；缺失的目录明确告知"没有"，避免 LLM 去读不存在的
+ * 路径后自行编造内容。
+ */
+export function readWikiReferences(projectRoot, phase = 'skeleton') {
+  const wikiDir = join(projectRoot, '对标', 'wiki');
+  if (!existsSync(wikiDir)) return '';
+
+  const { available, missing } = collectWikiReferences(projectRoot, phase);
+  if (available.length === 0 && missing.length === 0) return '';
+
+  const output = [];
+  output.push('## 对标参考（本次可读的对标分析文件）\n\n');
+  for (const a of available) {
+    const desc = DIRECTORY_DESCRIPTIONS[a.dir] || '写作技法分析';
+    output.push('- `' + a.path + '`：' + desc + '\n');
+  }
+  if (missing.length > 0) {
+    output.push('\n**以下对标目录没有对应的总结文件，本阶段请不要引用它们**：' + missing.join('、') + '\n');
+  }
+  return output.join('');
+}
+
+/**
+ * 生成"参考分层"说明段，注入到各阶段提示词的参考小节。
+ *
+ * ## 为什么要单独生成这一段
+ *
+ * 插件自带的 `references/<阶段>指导/` 和项目里的 `对标/wiki/` 是**两种性质
+ * 完全不同**的参考，模型很容易混着用：
+ *
+ *   - `references/<阶段>指导/` = **高维方法论**：这一层该怎么设计的通则
+ *     （数量怎么定、实体卡写什么、节奏怎么排）。是"怎么想"。
+ *   - `对标/wiki/<技法>/<技法>-总结.md` = **市场验证过的落地样本**：
+ *     从真实商业小说里提炼的"某招在成品里怎么生效"。是"怎么落地"。
+ *
+ * 混用的后果不是文风问题，是**设定污染**：拿别人的成品当规则 → 照抄专名、
+ * 情节、句子、金手指 → 撞设定、涉嫌抄袭。所以这一段必须把两层的边界、
+ * 优先级和红线一次讲清楚，并给出"本阶段该读哪几个"的明确清单。
+ *
+ * ## 为什么还必须注入到批次提示词
+ *
+ * 以前这份对标参考只挂在**系统提示词**上，而系统提示词那几个生成函数
+ * （generateSkeletonSystemPrompt 等）**从来没有被调用** ——
+ * 真正派给模型的是每批的批次提示词。结果就是：对标参考一次都没到过模型手里
+ * （tt5 实测：39 条骨架批次指令里 0 条含"对标"，整个会话 0 次"对标参考"）。
+ *
+ * @param {string} projectRoot 项目根目录
+ * @param {string} phase 阶段（skeleton / flesh / rhythm / writing）
+ * @returns {string} 注入文本（没有对标目录时返回空串）
+ */
+export function renderBenchmarkGuidance(projectRoot, phase = 'skeleton') {
+  const guide = PHASE_GUIDANCE[phase];
+  if (!guide) return '';
+  const wikiDir = join(projectRoot, '对标', 'wiki');
+  if (!existsSync(wikiDir)) return '';
+
+  const { available, missing } = collectWikiReferences(projectRoot, phase);
+
+  const lines = [];
+  lines.push('### 参考分三层，各读各的，别混\n');
+  lines.push('| 层 | 位置 | 是什么 | 怎么用 |');
+  lines.push('|---|---|---|---|');
+  lines.push('| 硬契约 | `模板/`、`references/glossary.md` | 字段、枚举、id 规则 —— 校验器就按它判 | **必读**，动笔前先对齐 |');
+  lines.push('| 高维方法论 | `' + guide.guideDir + '/` | ' + guide.focus + '的通则 | **必读**，按本批文件选篇 |');
+  lines.push('| 市场验证样本 | `对标/wiki/` 下的 `<技法名>-总结.md` | 真实商业小说里某一招怎么生效 | **选读**，用来校准手法 |');
+  lines.push('');
+  lines.push('**读法**：先读 `' + guide.guideDir + '/`（决定"该怎么想"），再按需翻对标样本（校准"怎么落地"）。');
+  lines.push('');
+  lines.push('**红线**：对标样本是**别人的成品**，只学结构与手法 —— '
+    + '禁止照搬专名、情节、句子、金手指设定；'
+    + '样本里的角色名/地名/机构名一律不许进本项目。');
+  lines.push('');
+
+  if (available.length) {
+    lines.push('**本阶段可读的对标文件**（读哪些由你判断，读后不重读）：\n');
+    for (const a of available) {
+      const desc = DIRECTORY_DESCRIPTIONS[a.dir] || '写作技法分析';
+      lines.push('- `' + a.path + '` —— ' + desc);
+    }
+    lines.push('');
+  } else {
+    lines.push('**本阶段没有可读的对标文件**（对标/wiki 下还没有总结文件）：不要凭空编造"对标分析"，照插件指导写。\n');
+  }
+  if (missing.length) {
+    lines.push('**以下对标目录本阶段没有总结文件，不要引用**：' + missing.join('、'));
+    lines.push('');
+  }
+  return lines.join('\n');
+}