@cloud411716/fancy-webnovel 1.0.45 → 2.2.0

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

@@ -0,0 +1,140 @@
+/**
+ * rhythm-output.js —— 节奏阶段的产出盘点
+ *
+ * 与 flesh-output.js 同构，但对象是节奏阶段的 4 个产物文件。
+ *
+ * 节奏阶段和血肉阶段的差别在于产出形态：
+ *   血肉   —— 8 个文件，每个文件内部是"大对象"数组
+ *   节奏   —— 4 个文件，其中 3 个是"按章/按实体切"的数组，
+ *              1 个（节奏参数.json）是纯对象
+ *
+ * 盘点要回答两个问题（插件据此决定能不能报"完成"）：
+ *   1. 4 个产物文件是不是都落地了？
+ *   2. 全量校验（--all）过没过？
+ *
+ * 节奏阶段尤其需要第 2 条：节奏的绝大多数校验是跨文件口径
+ * （主线节点数 = 参数、支线章数之和 = 参数、结局章 ⊆ 主线节点），
+ * 单文件校验过不代表阶段过 —— rhythm-validate.js 自己在单文件通过时
+ * 也会附一条 warning："跨文件一致性检查在 --all 模式下进行"。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+// 节奏阶段的 4 个产出文件
+// （顺序 = 生成依赖顺序：章节规划 → 节奏参数 → 时序映射 → 章节细纲，
+//   见 prompts/03-rhythm-prompt.md 的「本阶段产出清单」一节）
+export const RHYTHM_OUTPUT_FILES = [
+  '章节规划.json',
+  '节奏参数.json',
+  '时序映射.json',
+  '章节细纲.json'
+];
+
+/**
+ * 盘点节奏阶段的产出。
+ *
+ * @param {string} stageDir 节奏阶段目录
+ * @returns {Object} { present, missing, complete }
+ */
+export function inspectRhythmOutput(stageDir) {
+  const present = [];
+  const missing = [];
+  for (const f of RHYTHM_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，看全量校验的状态。
+ *
+ * @returns {Object} { allCheck, rounds, files, error }
+ *   allCheck: 'PASSED' | 'FAILED' | 'STALE' | 'PENDING' | null
+ */
+export function readRhythmStageStatus(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
+  };
+}
+
+/**
+ * 生成节奏阶段收尾的结论说明（人类可读、可执行）。
+ *
+ * 与 flesh-output.js 的 buildFleshCompletionNote 同构，但重点不同：
+ * 节奏阶段的失败几乎都是**跨文件口径**的问题，
+ * 所以要明确告诉用户"单文件过了但全量没过"意味着什么。
+ */
+export function buildRhythmCompletionNote(inspect, status) {
+  const lines = [];
+  const allCheck = status.allCheck;
+  const missing = inspect.missing;
+
+  if (inspect.complete && allCheck === 'PASSED') {
+    lines.push('节奏阶段产出检查：4 个 JSON 齐全，全量校验（--all）已通过。');
+    lines.push('');
+    lines.push('产出文件：');
+    for (const f of inspect.present) lines.push('- 设定/raw/sources/节奏/' + f);
+    return lines.join('\n');
+  }
+
+  lines.push('节奏阶段产出检查：**未通过**，当前状态如下。');
+  lines.push('');
+
+  if (!inspect.complete) {
+    lines.push('- 缺失文件（' + missing.length + '/' + RHYTHM_OUTPUT_FILES.length + '）：' + missing.join('、'));
+    lines.push('  常见原因：节奏阶段是逐批派活的，任一段没跑完，下游那一段就不会开工');
+    lines.push('  （章节规划 / 节奏参数 → 时序映射 → 章节细纲，段间有依赖门禁）。');
+  } else {
+    lines.push('- 4 个 JSON 都已产出。');
+  }
+
+  lines.push('');
+  if (allCheck === 'PASSED') {
+    lines.push('- 全量校验：PASSED（但文件集合与校验记录不一致，需要人工核对）。');
+  } else if (allCheck === 'FAILED') {
+    lines.push('- 全量校验：FAILED（跨文件一致性没通过：主线节点数 / 支线章数 / 结局覆盖 / 钩子下限这些口径都在 --all 里查）。');
+  } else if (allCheck === 'STALE') {
+    lines.push('- 全量校验：**STALE**（单文件校验把已通过的全量结论作废了，必须重新跑一次 --all）。');
+  } 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. 4 个文件齐了之后，必须再跑一次全量校验（--all），确认 all_check.status = PASSED。');
+  } else {
+    lines.push('1. 跑一次全量校验（--all），把 errors 逐条改掉；');
+    lines.push('2. 直到 all_check.status = PASSED 再进入写作阶段。');
+  }
+
+  return lines.join('\n');
+}

package/plugins/fancy-story-builder/schema-setting.md

@@ -0,0 +1,324 @@
+# 节奏阶段设定分析规范
+
+## 核心目标
+
+分析 `raw/sources/节奏/` 目录下的节奏阶段文件，提炼结构化内容到 `wiki/` 目录。
+
+---
+
+## ⚠️ 类型系统(type)约束
+
+**本 schema 定义的类型系统是【封闭的】。LLM 禁止创建新的 type 或新的目录。**
+
+---
+
+## Wiki 目录结构
+
+| type | directory | description |
+|------|-----------|-------------|
+| 时间线 | wiki/时间线/ | 全书主线时间线、卷任务、时间线 |
+| 冲突演变 | wiki/冲突演变/ | 核心冲突演变阶段 |
+| 伏笔布局 | wiki/伏笔布局/ | 伏笔宏观布局 |
+| 分卷 | wiki/分卷/ | 分卷表 |
+| 情绪弧线 | wiki/情绪弧线/ | 情绪弧线类型 |
+| 高潮点 | wiki/高潮点/ | 小高潮、中高潮、大高潮分布 |
+| 爽点 | wiki/爽点/ | 小爽点，大爽点设计 |
+| 主线推进 | wiki/主线推进/ | 主线推进节点 |
+| 角色弧光 | wiki/角色弧光/ | 角色弧光节点 |
+| 信息释放 | wiki/信息释放/ | 信息释放节奏 |
+| 章节钩子 | wiki/章节钩子/ | 章节钩子设计 |
+| 伏笔 | wiki/伏笔/ | 伏笔表条目 |
+| 章节细纲 | wiki/细纲/ | 章节细纲 |
+| 支线交织 | wiki/支线交织/ | 支线交织点与主线关系 |
+| 场景 | wiki/场景/ | 场景分解 |
+| 来源 | wiki/来源/ | 源文件摘要 |
+
+---
+
+## 文件名规则
+
+| type | 文件名格式 | 示例 |
+|------|-----------|------|
+| 时间线 | 时间线-{名称}.md | 时间线-全书主线.md |
+| 冲突演变 | 冲突演变-{阶段}.md | 冲突演变-第一阶段.md |
+| 伏笔布局 | 伏笔布局.md | 伏笔布局.md |
+| 分卷 | 分卷-{卷号}.md | 分卷-第一卷.md |
+| 情绪弧线 | 情绪弧线-{卷号}.md | 情绪弧线-第一卷.md |
+| 高潮点 | 高潮点-{卷号}.md | 高潮点-第一卷.md |
+| 爽点 | 爽点-{章节号}.md | 爽点-第5章.md |
+| 主线推进 | 主线推进-{卷号}.md | 主线推进-第一卷.md |
+| 角色弧光 | 角色弧光-{角色名}.md | 角色弧光-主角.md |
+| 信息释放 | 信息释放-{卷号}.md | 信息释放-第一卷.md |
+| 章节钩子 | 章节钩子-{章节号}.md | 章节钩子-第5章.md |
+| 伏笔 | 伏笔-{ID}.md | 伏笔-S001.md |
+| 章节细纲 | 细纲-{NNN}.md | 细纲-005.md |
+| 支线交织 | 支线交织-{交织点}.md | 支线交织-交织点1.md |
+| 场景 | 场景-{章节号}-{场景序号}.md | 场景-第1章-场景1.md |
+
+---
+
+## ⚠️ 语言强制要求
+
+**所有输出内容必须是中文，包括：**
+
+1. **文件名**：使用中文，如 `时间线-全书主线.md`
+2. **title**：使用中文，如 `全书主线时间线`
+3. **正文内容**：所有文字描述必须使用中文
+4. **表格内容**：所有表格中的文字必须使用中文
+5. **type 值**：所有 type 的值必须是中文，如 `时间线`、`冲突演变`
+
+**禁止输出英文内容。唯一例外：代码块、JSON、YAML 格式中的英文键名（如 `type:`、`title:`）。**
+
+---
+
+## ⚠️ 绝对禁止的行为
+
+1. **禁止创建新的 type** - 只能使用本 schema 定义的 type
+2. **禁止创建新的目录** - 只能使用本 schema 定义的目录
+3. **禁止生成"无"的页面** - 来源表格中标记为"无"的 type 不需要生成
+4. **禁止跳过闭环检查** - 必须检查所有"有"的页面是否存在
+5. **缺失必须补充** - 如果"有"的页面缺失，必须生成 review 并补充
+
+---
+
+## 各文件 heading 到 type 的映射
+
+### 1. 主线大纲.md
+
+| heading | 提取的 type | 说明 |
+|---------|-------------|------|
+| 全书主线时间线 | 时间线 | 表格：阶段、章节范围、核心任务、关键情节点 |
+| 核心冲突演变 | 冲突演变 | 列表：第一阶段/第二阶段/...：章节范围、冲突描述 |
+| 卷核心任务 | 时间线 | 表格：卷号、卷名、核心任务、期望情感弧 |
+| 伏笔宏观布局 | 伏笔布局 | 表格：伏笔ID、类型、内容摘要、预期回收阶段 |
+| 主线推进节点 | 主线推进 | 列表：章节范围、推进内容 |
+| 章节钩子分布 | 章节钩子 | 表格：章节号、钩子类型、钩子内容 |
+| 情绪节奏概览 | 情绪弧线 | 概览内容 |
+| 爽点密度规划 | 爽点 | 表格：章节范围、爽点类型、爽点描述 |
+| 高潮设计 | 高潮点 | 表格：高潮类型、章节位置、情绪峰值 |
+| 角色弧光节点分布 | 角色弧光 | 表格：角色名、弧光节点章节、弧光描述 |
+| 支线交织点与主线关系 | 支线交织 | 表格：交织点、涉及章节、与主线关系 |
+
+### 2. 分卷表.md
+
+| heading | 提取的 type | 说明 |
+|---------|-------------|------|
+| 整体结构 | 分卷 | 结构概述 |
+| 分卷详情 | 分卷 | 详细分卷信息 |
+| 卷内节奏起伏 | 分卷 | 节奏起伏描述 |
+| 卷内伏笔布局 | 分卷 | 伏笔布局描述 |
+| 卷末收束要素 | 分卷 | 卷末收束要素描述 |
+| 章节阶段分配 | 分卷 | 表格：阶段、章节范围、核心任务 |
+
+### 3. 情绪节奏.md
+
+| heading | 提取的 type | 说明 |
+|---------|-------------|------|
+| 整体情绪弧线 | 情绪弧线 | 弧线类型（V形/倒V形/W形/递进/延迟满足） |
+| 各卷情绪分布 | 情绪弧线 | 表格：卷号、开局/中段/高潮/收束情绪 |
+| 高潮点分布 | 高潮点 | 表格：小高潮/中高潮/大高潮的章节位置、情绪峰值 |
+
+### 4. 伏笔表.md
+
+| heading | 提取的 type | 说明 |
+|---------|-------------|------|
+| 伏笔列表 | 伏笔 | 表格：ID、类型、内容摘要、埋设章节、推进章节、回收章节、状态 |
+| 伏笔状态 | 伏笔 | 状态说明：埋设 → 推进中 → 已回收/已失效/已放弃 |
+| 伏笔排布原则 | 伏笔 | 排布原则描述 |
+| 伏笔与章节对照 | 伏笔 | 伏笔与章节对照表 |
+
+### 5. `细纲_*.md`（每个文件对应一个章节）
+
+| heading | 提取的 type | 说明 |
+|---------|-------------|------|
+| 基本信息 | 章节细纲 | 表格：章号、标题、字数目标、视角 |
+| 章节定位 | 章节细纲 | 主线进度、副线进度 |
+| 章节时间线 | 章节细纲 | 起点/终点时间 |
+| 必覆盖节点 | 章节细纲 | 节点列表（≥3个） |
+| 爽点设计 | 爽点 | 类型（打脸/收获/身份/情感/智力/探索/团战）、设计内容 |
+| 伏笔动作 | 伏笔 | 埋设/推进/回收的伏笔ID |
+| 章首钩子内容 | 章节钩子 | 章首钩子具体内容 |
+| 章末钩子内容 | 章节钩子 | 章末钩子具体内容 |
+| 本章禁区 | 章节细纲 | 绝对不能出现的内容 |
+| 场景分解 | 场景 | 场景列表 |
+| 与前序/后续章节关系 | 章节细纲 | 章节关系描述 |
+
+---
+
+## 来源要求（必须执行）
+
+**每个 wiki 页面必须包含"来源"章节，作为第一个内容块。**
+
+来源格式示例：
+
+```markdown
+## 来源
+
+| 字段 | 值 |
+|------|---|
+| 来源文件 | raw/sources/节奏/主线大纲.md |
+| 来源类型 | 主线大纲 |
+| 生成时间 | YYYY-MM-DD HH:mm:ss |
+
+### 本页包含的 type
+
+| type | 是否生成 | 说明 |
+|------|---------|------|
+| 时间线 | 有 | 全书主线时间线 |
+| 冲突演变 | 有 | 核心冲突演变 |
+| 卷任务 | 有 | 卷核心任务 |
+| 伏笔布局 | 有 | 伏笔宏观布局 |
+| 分卷 | 无 | 不在本文件中 |
+| ... | ... | ... |
+```
+
+**重要：**
+- "有"的页面**必须生成**
+- "无"的页面**不需要生成**
+- 闭环检查时，如果在"### 本页包含的 type"表格中"是否生成"列为"有"的页面缺失，**必须补充**
+
+---
+
+## 闭环检查要求（必须执行）
+
+### 1. 检查"### 本页包含的 type"表格中"是否生成"列为"有"的页面是否都已生成
+
+对于每个标记为"有"的 type，必须检查：
+- wiki 中是否存在对应的页面
+- 如果缺失，**必须立即补充页面**才能 ingest 下一个文件
+
+
+---
+
+## Frontmatter 格式示例
+
+### 时间线/冲突演变/伏笔布局 类型
+
+```yaml
+---
+type: 时间线
+title: 全书主线时间线
+sources: [raw/sources/节奏/主线大纲.md]
+related:
+  - type: 冲突演变
+    title: 核心冲突演变
+  - type: 伏笔布局
+    title: 伏笔宏观布局
+---
+```
+
+### 分卷 类型
+
+```yaml
+---
+type: 分卷
+title: 第一卷
+sources: [raw/sources/节奏/分卷表.md]
+卷号: 1
+卷名: 青云之路
+章节范围: 第1-100章
+---
+```
+
+### 情绪弧线 类型
+
+```yaml
+---
+type: 情绪弧线
+title: V形弧线
+sources: [raw/sources/节奏/情绪节奏.md]
+弧线类型: V形
+适用场景: 重生复仇、破镜重圆、亲情催泪
+---
+```
+
+### 高潮点 类型
+
+```yaml
+---
+type: 高潮点
+title: 小高潮分布
+sources: [raw/sources/节奏/情绪节奏.md]
+高潮类型: 小高潮
+---
+```
+
+### 爽点 类型
+
+```yaml
+---
+type: 爽点
+title: 第5章爽点
+sources: [raw/sources/节奏/细纲_005.md]
+爽点类型: 打脸
+所属章节: 第5章
+---
+```
+
+### 章节钩子 类型
+
+```yaml
+---
+type: 章节钩子
+title: 第5章钩子
+sources: [raw/sources/节奏/细纲_005.md]
+章首类型: 悬念对话引子
+章尾类型: 突然揭示
+所属章节: 第5章
+---
+```
+
+### 伏笔 类型
+
+```yaml
+---
+type: 伏笔
+title: S001
+sources: [raw/sources/节奏/伏笔表.md]
+伏笔ID: S001
+伏笔类型: 物件型
+埋设章节: 第1章
+回收章节: 第30章
+状态: 已回收
+---
+```
+
+### 章节细纲 类型
+
+```yaml
+---
+type: 章节细纲
+title: 第5章
+sources: [raw/sources/节奏/细纲_005.md]
+章号: 5
+字数目标: 3000
+视角: 第三人称
+---
+```
+
+### 支线交织 类型
+
+```yaml
+---
+type: 支线交织
+title: 交织点1
+sources: [raw/sources/节奏/主线大纲.md]
+交织点: 交织点1
+涉及章节: 第5-8章
+与主线关系: 支线推动主线发展
+---
+```
+
+### 场景 类型
+
+```yaml
+---
+type: 场景
+title: 第1章-场景1
+sources: [raw/sources/节奏/细纲_001.md]
+所属章节: 第1章
+场景序号: 1
+场景名称: 百乐门后台
+场景类型: 引入
+---
+```