@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

package/plugins/fancy-story-builder/references//350/212/202/345/245/217/346/214/207/345/257/274/06-chapter-outline.md

@@ -0,0 +1,226 @@
+# 章节细纲
+
+> 节奏阶段第 6 份。把前面的规划落到每章一行细纲。含钩子排布、伏笔推进、势力出场。
+> 本文件不写数据结构（→ 章节细纲模板.json），不写具体字数（→ formulas-rhythm.json）。
+
+---
+
+## 一、决策路由
+
+| 你在做什么 | 用哪节 |
+|---|---|
+| 决定哪些章写细纲 | §2 细纲覆盖范围 |
+| 写章节细纲 | §3 细纲字段的设计 |
+| 排布钩子 | §4 钩子排布 |
+| 排布伏笔推进 | §5 伏笔推进 |
+| 排布势力出场 | §6 势力出场 |
+
+---
+
+## 二、细纲覆盖范围
+
+### 2.1 哪些章必写
+
+- 开篇章节
+- 每卷首章和末章
+- 大高潮章（骨架 `climaxes[].type = "大高潮"` 对应的章）
+- 转折点章（骨架 `main_line_timeline[].key_nodes` 中"转折"类型）
+- 结局章
+
+### 2.2 哪些章可省略
+
+- 过渡章、日常章
+- 非重点的桥段拉扯章
+- 省略的章由写作阶段根据"章节规划 + 时序映射 + 血肉档案"现场生成细纲
+
+### 2.3 覆盖比例
+
+**具体的覆盖比例由 `formulas-rhythm.json` 的 `outline_coverage` 定义**，本文件不重复数字。
+
+---
+
+## 三、细纲字段的设计
+
+### 3.1 每章细纲的核心要素
+
+- `ch`：章节号
+- `function_main` / `function_aux`：主功能 + 辅功能
+- `emotion_value`：情绪值（1-10）
+- `emotion_phase`：调动/释放/蓄力
+- `satisfaction_type` / `satisfaction_scale` / `satisfaction_audience`：爽点（如适用）
+- `foreshadow_action`：本章埋/推/收哪些伏笔
+- `faction_appearance`：本章出场哪些势力
+- `hook_head` / `hook_tail` / `hook_strength`：钩子
+- `word_target`：字数目标
+
+### 3.2 功能设计
+
+**主功能**（一章只能有一个主功能）：
+- 推进主线
+- 埋伏笔
+- 爽点兑现
+- 过渡
+- 人物塑造
+
+**辅功能**（可选，可兼多个）：
+- 同主功能的五个选项，但强度较弱
+
+**规则**：不写"同时推进主线 + 埋伏笔 + 爽点兑现"这种"三合一"——一章的功能必须主次分明。
+
+### 3.3 情绪值设计
+
+情绪值 1-10 是"该章让读者感受到的强度"。设计原则：
+- 爽点章：高（释放段，情绪值高）
+- 压制章：低（调动段，情绪值低）
+- 过渡章：中
+- 高潮章：最高
+
+### 3.4 字数目标
+
+字数目标由 `formulas-rhythm.json` 的 `word_target_range` 决定，与 `avg_words_per_chapter` 的偏离允许范围内。
+
+---
+
+## 四、钩子排布
+
+### 4.1 章首钩子选择流程
+
+1. 查 `03-highpoint-hooks.md` §6 的"章节阶段 → 钩子选择表"，确定候选
+2. 查上一章章尾钩子，排除同型
+3. 查开篇策略，匹配标签
+4. 选定一式，章首前 100 字内兑现
+
+### 4.2 章尾钩子选择流程
+
+1. 查 `03-highpoint-hooks.md` §6 的"章节阶段 → 钩子选择表"，确定候选
+2. 查最近若干章的章尾钩子，排除同型（高潮期可例外）
+3. 查本章情绪值，高情绪值章必须强钩子
+4. 选定一式，章尾后 100 字内兑现
+
+### 4.3 规则
+
+- 连续两章章尾不同式（高潮期可例外，需在细纲中注明"高潮期同类允许"）
+- 卷末钩子必须是强钩子
+- 开篇章节前 100 字内必须有强钩子
+
+---
+
+## 五、伏笔推进
+
+### 5.1 每章伏笔动作
+
+`foreshadow_action` 字段的内容：
+- 埋设：`"埋 FSxxx"`
+- 推进：`"推 FSxxx"`
+- 回收：`"收 FSxxx"`
+- 无动作：`"无"` 或空
+
+### 5.2 推进节奏
+
+- 每个单元有若干新伏笔埋设
+- 每个单元有若干旧伏笔推进
+- 每个单元至少有伏笔回收
+
+**具体的密度区间由 `formulas-rhythm.json` 的 `foreshadow_density_by_unit` 定义**，本文件不重复数字。
+
+### 5.3 超期处理
+
+查 `时序映射.json` 的 `foreshadow_timeline`，若某伏笔当前章 > 预期回收窗口上限，标记超期，安排处理：
+- 立即回收（本章回收）
+- 延期（更新回收章）
+- 标 abandoned（在细纲中标注"FSxxx 放弃回收"）
+
+---
+
+## 六、势力出场
+
+### 6.1 势力出场排布
+
+每个骨架阶段的势力在节奏阶段必须有出场排布：
+- 出场章：在 `章节细纲.json` 的 `faction_appearance` 中标注
+- 势力冲突升级点：在 `章节细纲.json` 的 `faction_appearance` 中写"势力 A vs 势力 B 正面冲突"
+- 势力关系变化：同上
+
+### 6.2 势力冲突升级曲线
+
+势力冲突随卷/单元升级：
+- 早期：小摩擦（背景出现）
+- 中期：直接冲突（当面冲突）
+- 后期：势力联合/决战
+
+**具体的升级曲线由 `formulas-rhythm.json` 的 `faction_escalation_curve` 定义**，本文件不重复数字。
+
+### 6.3 防止势力"写丢"
+
+若某势力连续多个单元未出场，标记"该势力已写丢"，需要处理：
+- 插入一次提及（该势力的行动在新闻/对话中被提到）
+- 或安排一次直接出场
+
+---
+
+## 七、示例
+
+一本都市复仇文的章节细纲片段（示意）：
+
+**第 1 章**（开篇，必写）：
+- 主功能：推进主线
+- 辅功能：人物塑造
+- 情绪值：3（谷底前）
+- 情绪阶段：调动
+- 爽点：无
+- 伏笔动作：埋 FS001（妹妹的手机）、埋 FS003（坤沙左手无名指有伤）
+- 势力出场：无
+- 章首钩子：未完成动作（"陆子仲刚推开门，就看见妹妹的遗照"）
+- 章尾钩子：突然揭示（"警察合上笔记本：'对了，你妹妹的手机，我们在园区找到的。'"）
+- 钩子强度：强
+
+**第 15 章**（大高潮，必写）：
+- 主功能：爽点兑现
+- 辅功能：推进主线
+- 情绪值：9
+- 情绪阶段：释放
+- 爽点：身份（"你以为我是保安？我当了八年特种兵"） / 群体 / 别处 + 专家
+- 伏笔动作：收 FS001
+- 势力出场：园区、旧部
+- 章首钩子：悬念对话
+- 章尾钩子：紧急危机（"坤沙站起来：'有意思。'然后对下属说：'查他。'"）
+- 钩子强度：强
+
+---
+
+## 八、常见反例
+
+| 反例 | 为什么错 | 正确做法 |
+|---|---|---|
+| 一章同时有多个主功能 | 主线模糊 | 只保留一个主功能 |
+| 情绪值全部为高 | 读者疲劳 | 高低起伏 |
+| 章尾钩子连续同式 | 读者疲劳 | 换式 |
+| 伏笔动作全部埋不推不回收 | 叙事债务 | 三类动作组合 |
+| 势力写了但不出场 | 剧情脱节 | 每个势力必须有出场章 |
+| word_target 偏离基准太多 | 节奏失衡 | 按 formulas-rhythm.json 的容差 |
+
+---
+
+## 九、与其他文件的关系
+
+| 本文件输出 | 落到哪个字段 | 参考哪个公式 | 由哪个脚本验证 |
+|---|---|---|---|
+| 每章功能 | `章节细纲.json` 的 `outlines[].function_main` / `function_aux` | 无 | `REQUIRED` |
+| 情绪值/阶段 | `章节细纲.json` 的 `outlines[].emotion_value` / `emotion_phase` | 无 | `TYPE` |
+| 爽点类型 | `章节细纲.json` 的 `outlines[].satisfaction_type` / `satisfaction_scale` | 无 | `ENUM`（pleasure_kind / pleasure_scale） |
+| 伏笔动作 | `章节细纲.json` 的 `outlines[].foreshadow_action` | formulas-rhythm.json 的 `foreshadow_density_by_unit` | 无（设计层） |
+| 势力出场 | `章节细纲.json` 的 `outlines[].faction_appearance` | formulas-rhythm.json 的 `faction_escalation_curve` | 无（设计层） |
+| 钩子 | `章节细纲.json` 的 `outlines[].hook_head` / `hook_tail` / `hook_strength` | 无 | `ENUM` |
+| 字数目标 | `章节细纲.json` 的 `outlines[].word_target` | formulas-rhythm.json 的 `word_target_range` | `RHYTHM_WORD_TARGET` |
+
+**不输出到**：
+- 细纲的具体场景描写 → 属于写作阶段
+- 章节的具体正文 → 属于写作阶段
+
+---
+
+## 十、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 03-04 精简重组。删除细纲模板中的 x- 字段；删除细纲自检清单；保留细纲字段设计/钩子排布/伏笔推进/势力出场的方法论；新增"与其他文件的关系"节 |

package/plugins/fancy-story-builder/references//350/212/202/345/245/217/346/214/207/345/257/274/07-audit.md

@@ -0,0 +1,181 @@
+# 节奏验证
+
+> 节奏阶段最后一份。横向验证流程与问题记录。**所有验证由脚本执行，本文件不写检查清单。**
+
+---
+
+## 一、验证流程
+
+节奏阶段的验证分两级：
+
+1. **单文件校验**：每个文件生成后立即跑（见提示词"七、每文件生成循环"）
+2. **全量校验**：4 个文件全部单检通过后跑
+
+本文件不重复单文件校验的流程（那在 `prompts/03-rhythm-prompt.md` 的"七"），只讲**全量校验失败后怎么处理**。
+
+---
+
+## 二、前置检查失败的处理
+
+如果启动时前置检查失败（骨架或血肉未就绪），按提示词的 BLOCKED 格式输出，不进入生成流程。
+
+**前置检查项**：
+- 骨架 `.stage-status.json` 不存在或 `all_check.status !== "PASSED"`
+- 血肉 `.stage-status.json` 不存在或 `all_check.status !== "PASSED"`
+- 骨架 4 个 JSON 或血肉 8 个 JSON 有缺失
+
+**处理方向**：回到对应上游阶段完成或修复。
+
+---
+
+## 三、校验失败的处理
+
+### 3.1 单文件校验失败的处理
+
+单文件校验返回的是 **JSON**，判定看 `status`（**没有 `ok` 字段**）：
+
+| status | 含义 | 怎么办 |
+|---|---|---|
+| `0` | 这个文件过了 | 接着做下一个文件；4 个都过了才跑全量 |
+| `1` | 这个文件的内容有问题 | 按 `errors[]` 回喂：只改 `errors` 指出的字段，按 `hint` 改，改完重跑这条单检 |
+| `2` | **脚本自己没跑完，不是这个文件的问题** | 看 **stdout** 的 `errors[0].message`（**stderr 是空的**）：多半是 `--template` 路径错、`--upstream` 目录不存在、glossary 读不出来。**改命令，不要改文件**，改完重跑同一条命令 |
+
+**`status:2` 的原因不在 stderr** —— 这是最容易踩的坑：
+stderr 里什么都没有，模型就容易以为自己写错了文件，
+去改本来正确的产物，越改越坏。
+
+**单检过 ≠ 阶段过**：单检只查这一个文件，跨文件的问题
+（时序与参数的可行性、章节引用完整性）要全量校验才查得出来。
+
+### 3.2 按文件分组
+
+`errors[]` 每条有 `path` 字段。按"根因文件"分组：
+
+| 错误的根因 | 应回改的文件 |
+|---|---|
+| `EXTRA_FIELD`（章节规划相关） | `章节规划.json` |
+| `EXTRA_FIELD`（时序映射相关） | `时序映射.json` |
+| `EXTRA_FIELD`（节奏参数相关） | `节奏参数.json` |
+| `EXTRA_FIELD`（章节细纲相关） | `章节细纲.json` |
+| `RHYTHM_INFEASIBLE` | `节奏参数.json` |
+| `RHYTHM_CHAP_RANGE` / `RHYTHM_CHAP_ORDER` | 看 `path` 前缀 |
+| `RHYTHM_TIMING` / `RHYTHM_ARC_OUT_OF_SPAN` / `RHYTHM_EXIT_IN_SPAN` | `时序映射.json` |
+| `RHYTHM_REF_MISSING` | `时序映射.json` |
+| `RHYTHM_CHAPTER_DUP` / `RHYTHM_CHAPTER_MISSING` | `章节规划.json` |
+| `RHYTHM_CHAPTER_UNREF` | `时序映射.json` 或 `章节细纲.json` |
+| `RHYTHM_NODES_COUNT` / `RHYTHM_BRANCH_TOTAL` / `RHYTHM_OVERLAP_COUNT` | 优先改 `时序映射.json` 的布局；若节奏参数确实错，改 `节奏参数.json` |
+| `RHYTHM_NODE_DUP` / `RHYTHM_BRANCH_OVERLAP` | `时序映射.json` |
+| `RHYTHM_COVERAGE` | `时序映射.json` 的 `ending_timeline[].chapter` |
+| `RHYTHM_LARGE_FS_NOT_RECOVERED` | `时序映射.json` 的 `ending_timeline[].foreshadow_recovery` |
+| `RHYTHM_HOOK_MIN` / `RHYTHM_HOOK_DUP` | `时序映射.json` 的 `hook_timeline` |
+| `RHYTHM_VOLUME_DIST`（warning） | `章节规划.json` 的卷分配 |
+| `RHYTHM_HOOK_DUP_WARN`（warning） | `时序映射.json` 的 `hook_timeline` |
+| `RHYTHM_WORD_TARGET`（warning） | `章节细纲.json` 的 `word_target` |
+
+### 3.3 改根因文件
+
+一次只改一类错误：
+- 先修 error，再修 warning
+- 同类错误一起修
+- 不顺手改其他字段
+
+### 3.4 重跑受影响文件的单检
+
+```bash
+node references/rhythm-validate.js \
+  --input=设定/raw/sources/节奏/<文件名>.json \
+  --template=模板/节奏/<文件名>模板.json \
+  --file=<类型> \
+  --upstream=设定/raw/sources/骨架,设定/raw/sources/血肉
+```
+
+单检通过后（`status:0`），才重跑全量。
+
+### 3.5 重跑全量
+
+```bash
+node references/rhythm-validate.js \
+  --stage-dir=设定/raw/sources/节奏 \
+  --template-dir=模板/节奏 \
+  --upstream=设定/raw/sources/骨架,设定/raw/sources/血肉 \
+  --all
+```
+
+### 3.6 最多 3 轮
+
+全量最多跑 3 轮。第 3 轮仍失败时，按提示词的 BLOCKED 格式输出，附第 3 轮完整 errors。
+
+---
+
+## 四、跨文件错误的特殊处理
+
+### 4.1 RHYTHM_INFEASIBLE
+
+三个参数不满足 7 条约束。按 `prompts/03-rhythm-prompt.md` 的 7.2.2 的"步骤 2-6"重算。
+
+### 4.2 RHYTHM_NODES_COUNT / RHYTHM_BRANCH_TOTAL / RHYTHM_OVERLAP_COUNT
+
+时序映射与节奏参数不一致。**优先改时序映射**（节奏参数已按 7.2.2 算法填对的情况下）。
+
+- `RHYTHM_NODES_COUNT`：改 `main_line_timeline[].key_nodes` 的数量，使其等于 `main_progress_chapter_count`
+- `RHYTHM_BRANCH_TOTAL`：改 `branch_timeline[].start` / `resolution` 的区间，使所有支线的章数之和等于 `branch_chapter_total`
+- `RHYTHM_OVERLAP_COUNT`：调整支线区间或主线 key_nodes，使"支线章集 ∩ 主线 key_node 章集"的大小等于 `overlap_chapter_count`
+
+**注意**：调整支线区间会影响支线不重叠的约束（`RHYTHM_BRANCH_OVERLAP`），一次改到位。
+
+### 4.3 RHYTHM_COVERAGE
+
+结局章不在主线 key_nodes 中。**修复方向**：
+- 改 `ending_timeline[].chapter` 为最近的某个 key_node 章
+- 或在 `main_line_timeline[].key_nodes` 补该章
+
+### 4.4 RHYTHM_LARGE_FS_NOT_RECOVERED
+
+全书级结局缺大伏笔回收。**修复方向**：在全书级结局的 `foreshadow_recovery` 补上缺失的伏笔 id 和章号。
+
+### 4.5 RHYTHM_CHAPTER_UNREF
+
+某章没有任何引用。**修复方向**：给该章补至少一个时序映射的引用（角色出场、伏笔动作、爽点、钩子等），或在 `章节规划.json` 中确认该章存在。
+
+---
+
+## 五、问题记录
+
+全量校验失败时，用以下模板记录（**不对外展示，只作为工作记录**）：
+
+| # | 错误代码 | path | 问题描述 | 根因文件 | 修改动作 | 状态 |
+|---|---|---|---|---|---|---|
+| 1 | RHYTHM_NODES_COUNT | main_line_timeline | 实际 240 个节点 vs 参数 235 | 时序映射.json | 删 5 个非关键节点 | open |
+| 2 | RHYTHM_HOOK_DUP | hook_timeline.15-17 | 第 15-17 章章尾同"紧急危机" | 时序映射.json | 换第 16 章钩子 | open |
+
+全部 `open` 转 `resolved` 后，重跑全量。
+
+---
+
+## 六、输出确认
+
+全量校验返回 `status: 0` 后，按 `prompts/03-rhythm-prompt.md` 的"九、输出交付格式"输出交付摘要。
+
+**这是唯一允许报告"完成"的场景**。
+
+---
+
+## 七、与其他文件的关系
+
+| 本文件作用 | 引用 |
+|---|---|
+| 全量校验失败后的处理流程 | `prompts/03-rhythm-prompt.md` 的"七、7.7" |
+| 错误代码的修复方向 | `prompts/03-rhythm-prompt.md` 的"十二、常见错误代码速查" |
+| 输出确认 | `prompts/03-rhythm-prompt.md` 的"九、输出交付格式" |
+| 联合可行性重算 | `prompts/03-rhythm-prompt.md` 的"7.2.2 步骤 2-6" |
+
+**本文件本身不直接输出到任何 JSON**，它是验证阶段的工作手册。
+
+---
+
+## 八、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 03-05 精简。删除所有 `- [ ]` 检查清单（验证归脚本）；保留验证流程、问题清单模板、输出确认；新增"跨文件错误的特殊处理"节；新增"与其他文件的关系"节 |
+| v1.1 | §三 原先只有"全量校验失败的处理"，整段缺单检失败处理：新补 §3.1 单文件校验失败的处理（`status` 0/1/2 各自的判据、`status:2` 的处置、"单检过 ≠ 阶段过"），原 §3.1-3.5 顺延为 §3.2-3.6 |

package/plugins/fancy-story-builder/references//350/241/200/350/202/211/346/214/207/345/257/274/00-index.md

@@ -0,0 +1,100 @@
+# 血肉阶段入口
+
+> 本文件是血肉阶段的唯一入口。回答"血肉阶段做什么、按什么顺序读、产出什么"。
+> 本文件不定义方法、不写公式、不写验证逻辑。
+
+---
+
+## 一、阶段目标
+
+把骨架阶段的"实体清单 + 关系 + 数量 + 卷级归属"填充成有血有肉的"档案/图/引擎"。
+
+回答：每个实体具体是什么样、关系怎么变化、支线怎么织、情绪怎么起伏、单元怎么排。
+
+血肉不通过，不进入节奏阶段。
+
+---
+
+## 二、四阶段定位
+
+血肉是四阶段的第二层。按"信息生命期"标准：
+- **骨架**：实体、关系、数量、卷级归属（全书不变，无章节号）
+- **血肉**：每个实体具体什么样（全书不变，无章节号）
+- **节奏**：什么时间发生什么（含章节号）
+- **写作**：具体怎么写
+
+血肉阶段的产物同样**不得包含任何章节号**。具体清单见 `references/glossary.md` 第六节。
+
+---
+
+## 三、加载顺序
+
+| 序 | 文件 | 作用 |
+|---|---|---|
+| 1 | 01-character.md | 角色/反派深化 + 语言档案 + 执念 + 行为重复点 |
+| 2 | 02-worldbuilding.md | 世界背景 + 力量体系 + 势力卡 + 物品卡 + 地点卡 + 设定校验表 |
+| 3 | 03-relations.md | 关系网细化 + 支线设计 + 多线管理 |
+| 4 | 04-emotion-methods.md | 情绪弧线类型 + 叠加规则 + 引擎七环 + 三板斧 + 题材策略 |
+| 5 | 05-audit.md | 横向验证流程与问题记录 |
+
+**顺序说明**：01 必须在 04 之前。人物档案未立，情绪弧线无承载。02 与 01 可并行，但 03 必须在两者之后（关系网需要知道人物和势力）。
+
+---
+
+## 四、产出清单
+
+| 产出 | 落到哪个 JSON |
+|---|---|
+| 角色档案 | `角色.json` 的 `characters` |
+| 冲突档案 | `冲突.json` 的 `conflicts` |
+| 势力档案 | `势力.json` 的 `factions` |
+| 剧情档案 | `剧情.json` 的 `main_lines` / `branches` |
+| 地点档案 | `地点.json` 的 `locations` |
+| 结局档案 | `结局.json` 的 `endings` |
+| 世界观规则 | `世界观规则.json` 的 `core_rules` / `information_rules` / `social_rules` / `rule_conflict_plan` |
+| 关键道具 | `关键道具.json` 的 `core_items` / `branch_items` / `symbolic_items` / `details` |
+
+**具体数据结构见 `模板/血肉/` 下的 8 个模板**，本文件不重复定义。
+
+---
+
+## 五、决策路由
+
+| 你在做什么 | 查 |
+|---|---|
+| 深化主角 | 01-character.md |
+| 深化配角 | 01-character.md |
+| 深化反派 | 01-character.md |
+| 设计关系变化 | 01-character.md + 03-relations.md |
+| 设计执念 | 01-character.md |
+| 建力量体系 | 02-worldbuilding.md |
+| 建势力卡完整版 | 02-worldbuilding.md |
+| 建物品卡 | 02-worldbuilding.md |
+| 建地点卡 | 02-worldbuilding.md |
+| 建设定校验表 | 02-worldbuilding.md |
+| 关系网细化 | 03-relations.md |
+| 支线设计 | 03-relations.md |
+| 多线管理 | 03-relations.md |
+| 选情绪弧线 | 04-emotion-methods.md |
+| 弧线叠加 | 04-emotion-methods.md |
+| 情绪单元引擎 | 04-emotion-methods.md |
+| 情感三板斧 | 04-emotion-methods.md |
+| 血肉横向验证 | 05-audit.md |
+
+---
+
+## 六、与其他文件的关系
+
+| 本文件作用 | 被谁引用 |
+|---|---|
+| 血肉阶段入口 | `prompts/02-flesh-prompt.md`（提示词读本文件确定加载顺序） |
+
+**本文件本身不直接输出到任何 JSON**，它是导航文件。所有具体输出由 01-05 子文件负责。
+
+---
+
+## 七、版本记录
+
+| 版本 | 变更 |
+|---|---|
+| v1.0 | 从原 02-00 精简。删除产出清单中的章节相关内容；删除横向验证清单（移到 05-audit.md）；明确"四阶段定位"与"信息生命期"标准 |