@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-story-builder/prompts/04-writing-prompt.md

@@ -0,0 +1,188 @@
+# 04 写作执行须知
+
+> 本文件是写作阶段的**产物契约**：写什么文件、写成什么格式、什么会被校验拦下。
+> 怎么写（场景、对话、开篇、文风、诊断）在 `references/写作指导/`。
+> 写作的流程编排由插件的写作驱动负责：它按批派活、逐章校验、把错误发回来。
+> **你不需要自己跑校验脚本，也不需要自己决定写第几章。**
+
+---
+
+## 一、核心铁律（违反任意一条都会被校验拦下）
+
+> 1. **只写驱动指定的章**。本轮要写哪几章、写到哪个路径，驱动会在派活时写清楚。按给定顺序写，不要跳章、不要多写、不要写别的章号。
+>
+> 2. **章首第一行必须是 `# 第N章 <标题>`**（N 为阿拉伯数字或中文数字，如 `# 第1章 引入` / `# 第001章 灭门` / `# 第十二章 高潮`），且标题中的章号必须与驱动指定的章号一致。正文小标题用 `##` 或 `###`，**不得再出现 `#` 一级标题**。`CHAPTER_TITLE` / `CHAPTER_TITLE_DUP` 会拦截。
+>
+> 3. **不出现 AI 分析口吻**（`基本一致` / `无重大问题`）。`FORBIDDEN_WORD` 会拦截。
+>
+> 4. **不出现占位符**：`[X]` / `[Y]` / `[Z]` / `[W]` 出现在正文任何位置都会被拦；`待确认` / `待定` / `待补充` / `TBD` / `N/A` / `未定` / `xxx` **独占一行**时会被拦（正文里当普通词用不算）。统一报 `PLACEHOLDER`。
+>
+> 5. **每写完一章就更新台账**。章/人物/伏笔/时间线四个台账必须与已写章节同步。
+>
+> 6. **不修改 `模板/` 和 `references/` 下的任何文件**。这两个目录是只读输入。
+
+---
+
+## 二、产物清单
+
+| 产物 | 路径 | 说明 |
+|---|---|---|
+| 第 N 章正文 | `设定/raw/sources/写作/第NNN章.md` | N 三位补零，如 `第001章.md` |
+| 章台账 | `设定/raw/sources/写作/台账/章台账.json` | 每写完一章追加一条 |
+| 人物台账 | `设定/raw/sources/写作/台账/人物台账.json` | 只更新本章出场角色 |
+| 伏笔台账 | `设定/raw/sources/写作/台账/伏笔台账.json` | 只更新 open / progressing 状态 |
+| 时间线台账 | `设定/raw/sources/写作/台账/时间线台账.json` | 推进 in-world-time |
+
+**正文第一行**：`# 第NNN章 <标题>`，三位补零与文件名保持一致。
+
+---
+
+## 三、怎么写
+
+写作方法在 `references/写作指导/`，按需读：
+
+| 文件 | 什么时候读 |
+|---|---|
+| `00-index.md` | 不知道该读哪篇时先读它 |
+| `01-scene.md` | 每一章都要用：场景五要素（目标/冲突/转折/结果/余味） |
+| `02-chapter-workflow.md` | 成章流程：怎么从一个场景推进到下一个 |
+| `03-opening-chapter.md` | 第 1 章，或需要写强开篇的章 |
+| `04-dialogue-mastery.md` | 写对话前：权力博弈、潜台词、语言档案 |
+| `05-genre-formulas.md` | 题材套路公式（该题材怎么写才成立） |
+| `06-tone-ensemble.md` | 文风与语气：多人同场时怎么区分声音 |
+| `07-ledger-audit.md` | 台账怎么记、怎么审 |
+| `08-diagnosis-revision.md` | 收到校验错误后怎么定位并改写 |
+| `09-reading-power.md` | 钩子 13 式 / 章首引子 7 式 / 微兑现 7 种 / 30-40-30 结构 |
+
+${benchmark_refs_block}
+
+**每章的硬性要求**：
+
+- 按细纲的 `function_main`（本章主功能）组织场景，通常 2-4 个场景
+- **章首钩子**：按细纲的 `hook_head` 类型，前 100 字内兑现
+- **章尾钩子**：按细纲的 `hook_tail` 类型，章尾后 100 字内兑现，强度按 `hook_strength`
+- **爽点**：按细纲的 `satisfaction_type` / `satisfaction_scale` 写
+- **伏笔动作**：埋设自然融入场景；推进给提示不揭示；回收兑现读者预期
+- **对话**：遮住角色名能分辨出是谁在说话
+- **字数**：贴近细纲的 `word_target`，偏差超过 ±20% 会被 `WORD_COUNT` 拦下
+- **角色出场**：本章**至少要提到一个已建档角色**，否则报 `NO_CHARACTER_MENTION`（warning）。提到角色后另有 `CHARACTER_MENTION`（信息性 warning，列出本章出场角色与出现次数）。校验器**不读细纲、不检查未建档的角色名** —— 该出场的角色没写不会被它拦，得自己对照细纲。
+- **钩子类型**：章首用 7 式章首引子之一、章末用 13 式章末钩子之一，取值见 `09-reading-power.md`；登记进章台账的 `hook_head_type` / `hook_tail_type`，写错会被 `HOOK_TYPE_INVALID` 拦下
+- **钩子不重复**：不得连续 3 章用同一种章末钩子（同一大分类也不行），否则 `HOOK_REPEAT`
+- **微兑现**：每章至少 1 个微兑现（信息/关系/能力/资源/认可/情绪/线索），登记进章台账的 `micro_payoffs`，缺了会被 `MICRO_PAYOFF_MISSING` 拦下
+
+---
+
+## 四、台账格式
+
+**章台账.json**（每章追加一条；**重写某章时要替换掉同 ch 的旧条目，不要留两条**）：
+
+```json
+{
+  "ch": 1,
+  "actual_word_count": 2050,
+  "scene_count": 3,
+  "hook_head_type": "未完成动作引子",
+  "hook_tail_type": "突然揭示",
+  "hook_strength": "强",
+  "micro_payoffs": ["信息兑现", "情绪兑现"],
+  "revival_events": [],
+  "main_progress": "灭门 + 收到妹妹手机",
+  "foreshadow_actions": ["埋 FS001", "埋 FS003"],
+  "character_status_changes": ["陆子仲：从保安 → 决定复仇"],
+  "in_world_time_start": "第 1 年秋，夜",
+  "in_world_time_end": "第 1 年秋，深夜"
+}
+```
+
+| 字段 | 取值 | 说明 |
+|---|---|---|
+| `hook_head_type` | 7 式章首引子之一 | 见 `09-reading-power.md` |
+| `hook_tail_type` | 13 式章末钩子之一 | 见 `09-reading-power.md`；不得连续 3 章用同一种 |
+| `micro_payoffs` | 7 种微兑现，至少 1 个 | 信息/关系/能力/资源/认可/情绪/线索 |
+| `revival_events` | 角色名列表 | 本章有角色复生时登记，格式 `"角色名：因何复生"`；否则空数组 |
+
+**人物台账.json**（key 是角色名）：
+
+```json
+{
+  "陆子仲": {
+    "current_location": "城中村出租屋",
+    "current_goal": "确认妹妹死因",
+    "known_info": ["妹妹的手机在园区被找到", "坤沙是园区老板"],
+    "status": "轻伤（左臂）",
+    "last_appear_chapter": 1
+  }
+}
+```
+
+**伏笔台账.json**（key 是伏笔 id）：
+
+```json
+{
+  "FS001": {
+    "type": "小伏笔",
+    "content": "妹妹的旧手机",
+    "buried_chapter": 1,
+    "expected_recovery_chapter": 15,
+    "status": "open",
+    "actual_recovery_chapter": null
+  }
+}
+```
+
+**时间线台账.json**：
+
+```json
+{
+  "current_time": "第 1 年秋，深夜",
+  "elapsed_days": 1,
+  "events": [
+    {"ch": 1, "time": "第 1 年秋，夜", "event": "妹妹遗照", "location": "城中村"}
+  ]
+}
+```
+
+---
+
+## 五、会被校验拦下的东西
+
+| 类别 | 具体 | 错误码 |
+|---|---|---|
+| 标题 | 首行格式错 / 章号与驱动指定的不一致 / 多个一级标题 | `CHAPTER_TITLE` / `CHAPTER_TITLE_DUP` |
+| 正文 | 全文为空 / 正文过短（< 50 非空白字符）/ 空段落过多 | `EMPTY_CHAPTER` / `EMPTY_BODY` / `EMPTY_PARAGRAPH` |
+| 字数 | 偏离基准或细纲 `word_target` 超过 ±20% | `WORD_COUNT` / `WORD_TARGET_MISMATCH` |
+| 字符集 | 韩文谚文 / 日文假名 | `CHARSET_KO` / `CHARSET_JP` |
+| 占位 | `[X]`（任意位置）/ `待确认` / `xxx`（独占一行）等 | `PLACEHOLDER` |
+| 禁用词 | `基本一致` / `无重大问题` | `FORBIDDEN_WORD` |
+| 钩子 | 细纲钩子强度为"强"时，章首/章尾各 100 字内的有效内容不足 30 字 | `HOOK_HEAD_MISSING` / `HOOK_TAIL_MISSING` |
+| 钩子 | 台账登记的钩子类型不在 7 式/13 式之内 | `HOOK_TYPE_INVALID` |
+| 钩子 | 连续 3 章用了同一种（或同一大分类）章末钩子 | `HOOK_REPEAT` |
+| 微兑现 | 本章没有登记微兑现，或类型不在 7 种之内 | `MICRO_PAYOFF_MISSING` |
+| 死人 | 已死亡角色在本章正文出现（且未登记复生） | `DEAD_CHARACTER_APPEARS` |
+| 台账 | 章台账里没有本章条目 | `LEDGER_ENTRY_MISSING` |
+| 角色 | 本章出场角色与出现次数（信息性提示，不检查未建档的角色名） | `CHARACTER_MENTION` |
+| 细纲 | 本章没有细纲（重点章应补上） | `OUTLINE_MISSING`（warning） |
+| 角色 | 本章没提到任何建档角色 | `NO_CHARACTER_MENTION`（warning） |
+| 上游 | 上游数据不完整 / 上游未提供 / 上游未通过全量校验 | `UPSTREAM_PARTIAL`（warning）/ `UPSTREAM_MISSING` / `UPSTREAM_NOT_PASSED` |
+| 规则文件 | 关系词表与元数据不同步 | `REL_KIND_META_DRIFT`（脚本缺陷，停止并上报） |
+
+---
+
+## 六、收到错误后怎么改
+
+驱动会把校验错误原样发回来（`code` / `path` / `message` / `hint`）。按这个顺序处理：
+
+1. **只改错误指向的字段**。错误没提到的部分不要动——前面已通过的章更要一字不动。
+2. **按 `hint` 的方向改**，不要绕过（例如字数不够就扩写场景，不要改细纲）。
+3. 改完**重写整章**（章节文件是整份覆盖，不是打补丁）。
+4. 如果一个错误无法只靠改这一章解决（例如需要前情铺垫），在汇报里说明原因，由驱动决定怎么处理。
+
+**汇报格式**（写完本轮后给一段话）：
+
+```
+本轮完成：第 11-20 章
+- 第11章《标题》（实际 2080 字），钩子 悬念对话/突然揭示（强），出场 陆子仲、陈队
+- ...
+埋设：FS003；回收：FS001
+无细纲的章：第 14 章
+```

package/plugins/fancy-story-builder/prompts/05-deslop-prompt.md

@@ -0,0 +1,96 @@
+# 05 去 AI 味执行须知
+
+> 本文件是去味阶段的**产物契约**：改什么文件、改成什么样、什么会被拦下。
+> 改写手法（怎么把 AI 腔改成人话）在 `references/写作指导/10-deslop.md`。
+> 去味的流程编排由插件的去味驱动负责：它逐章检测、备份、派活、复扫、判改动比例、
+> 必要时会自动回滚原文。
+> **你不需要自己跑检测脚本，也不需要自己决定改哪一章。**
+
+---
+
+## 一、核心铁律
+
+> 1. **只改 AI 味，不改剧情**。人物、事件、因果、伏笔、事实、字数结构一律不动。
+>    去味是"换个说法"，不是"重写这一章"。
+>
+> 2. **只改驱动指出的目标文件**，直接覆盖原文件。不要新建文件、不要改文件名、
+>    不要改第一行的标题（`# 第N章 <标题>`）。
+>
+> 3. **不要动台账**。`设定/raw/sources/写作/台账/` 下的文件由写作阶段维护，
+>    本阶段碰了会和写作阶段的登记对不上。
+>
+> 4. **不要动 `模板/` 和 `references/` 下的任何文件**。这两个目录是只读输入。
+>
+> 5. **改动幅度要小**。驱动按改动比例判级：超过 35% 会**自动回滚原文**，
+>    你的这一轮等于白做。改得少而准，比改得多而狠有用。
+
+---
+
+## 二、产物清单
+
+| 产物 | 路径 | 谁写 |
+|---|---|---|
+| 第 N 章正文（改写后） | `设定/raw/sources/写作/第NNN章.md` | 你（覆盖原文件） |
+| 原文备份 | `设定/raw/sources/写作/.revisions/第NNN章_<时间戳>.md` | 驱动（改写前自动备份） |
+| 去味报告 | `审查报告/第NNN章_去AI味报告.md` | 驱动（按检测结果生成） |
+
+你只负责第一项。备份和报告都由驱动写，你不要碰。
+
+---
+
+## 三、怎么改
+
+**手法见 `references/写作指导/10-deslop.md`**，那里有四种手法（拔高→事实 / 抽象→动作 /
+套话→具体 / 排比→断句）、每种的例子，以及"不要做的事"。
+
+本阶段特别强调两条：
+
+1. **改句式，不删信息**。把拔高句换成具体动作或具体后果，不是把句子删短。
+2. **不要机械替换**。把"此外，"整段删掉会让句子散架，把"至关重要"换成"重要"会丢掉语气。
+   AI 腔是句式问题，不是词的问题。
+
+---
+
+## 四、会被拦下的东西
+
+驱动在改写后会**再扫一遍**（复扫），`blocking` 类没清零就不算改完：
+
+| 级别 | 错误码 | 含义 | 后果 |
+|---|---|---|---|
+| `blocking` | `AI_PATTERN_BLOCKING` | 命中就要改 | 复扫仍有命中 → 驱动会带着剩余清单再派一轮 |
+| `advisory` | `AI_PATTERN_ADVISORY` | 只提示 | 不拦，但会写进报告 |
+
+完整清单（24 类，每类带改法）见提示词末尾的「AI 模式清单」。
+
+**驱动判定的三件事**（不是你能商量的）：
+
+1. **复扫**：改完必须清掉全部 `blocking`。
+2. **改动比例**：超过 35% → 原文被回滚，本轮作废。
+3. **回滚**：改动幅度或复扫结果不达标时，原文会被还原成改写前的样子。
+   所以不要在一次改写里塞太多东西。
+
+---
+
+## 五、收到复扫结果后怎么改
+
+驱动重派时会告诉你上一轮为什么没过：
+
+| 情况 | 驱动的话 | 你该怎么改 |
+|---|---|---|
+| 改动超限被回滚 | "改动幅度超过 35%，原文已还原" | 只改列出的那几处，其余句子一个字不动 |
+| 复扫仍有命中 | "仍有 N 处 blocking 没清掉" | 只针对剩下的类目继续改，别重写整章 |
+| 文件没变 | "目标文件内容没有变化" | 确认你真的写回了文件，而不是只贴在回复里 |
+
+---
+
+## 六、汇报格式
+
+改完给一段话：
+
+```
+第 12 章去味完成
+- 改了 6 处：三段式法则 3 处（第 5、12、30 行）、破折号 2 处（第 8、19 行）、过度限定 1 处（第 22 行）
+- 第 5 行：原文"他愤怒、悲伤、绝望"，改为三句短句
+- 第 8 行：破折号改为逗号，并把后半句提为独立句
+- 剧情、人物、伏笔未改动
+```

package/plugins/fancy-story-builder/purpose-template.md

@@ -0,0 +1,107 @@
+# Project Purpose
+
+## Goal
+
+分析 `raw/sources/骨架/`、`raw/sources/血肉/`、`raw/sources/节奏/` 三个目录下的设定文件，根据 heading 层级结构提炼内容到 `wiki/` 对应的子目录。
+
+## Key Questions
+
+1. `raw/sources/骨架/` 目录下的框架要素、角色、冲突是否完整？
+2. `raw/sources/血肉/` 目录下的势力、物品、地点是否与骨架目录一致？
+3. `raw/sources/节奏/` 目录下的细纲、分卷、伏笔是否与骨架、血肉匹配？
+4. 三个目录下的设定之间是否存在冲突、矛盾或遗漏？
+5. 伏笔的埋设、推进、回收是否形成完整闭环？
+
+## Scope
+
+**In scope:**
+- `raw/sources/骨架/` 目录：框架要素、核心冲突、核心角色、主线支线、结局方向
+- `raw/sources/血肉/` 目录：世界观、势力、物品、地点、关系网
+- `raw/sources/节奏/` 目录：主线大纲、分卷表、情绪节奏、伏笔表、章节细纲
+- 冲突检测：量化冲突、角色冲突、伏笔冲突、关系冲突
+- 缺失检测：骨架缺失、血肉缺失、节奏缺失
+
+**Out of scope:**
+- `*闭环检查报告.md` 文件
+- `故事框架.md` 文件
+- 具体的章节正文内容
+- 文笔、语句优化
+
+## Thesis
+
+> TBD
+
+## Analysis Workflow
+
+1. **第一步：骨架分析**
+   - 分析 `raw/sources/骨架/` 目录下的文件
+   - 每个 `## heading` 生成一个独立的 wiki 页面
+   - 根据 heading 名称推断 type
+
+2. **第二步：血肉分析**
+   - 分析 `raw/sources/血肉/` 目录下的文件
+   - 势力/物品/地点文件根据 `## 基本信息` 等 heading 提取
+   - 生成关系网页面
+
+3. **第三步：节奏分析**
+   - 分析 `raw/sources/节奏/` 目录下的文件
+   - 细纲_*.md 直接对应章节细纲
+   - 伏笔表生成伏笔回收页面
+
+4. **第四步：冲突检测**
+   - 对比骨架、血肉、节奏三个目录的分析结果
+   - 检测量化冲突、角色冲突、伏笔冲突、关系冲突
+   - 生成 review 条目到 `.llm-wiki/review.json`
+
+5. **第五步：缺失检测**
+   - 检查骨架、血肉、节奏三个目录是否有缺失内容
+   - 生成 review 条目
+
+## Expected Outputs
+
+- `wiki/框架-容量/`：容量.md
+- `wiki/框架-结构/`：结构.md
+- `wiki/框架-角色/`：角色.md
+- `wiki/框架-冲突/`：冲突.md
+- `wiki/框架-弧光/`：弧光.md
+- `wiki/核心冲突/`：核心冲突详情
+- `wiki/人物/`：角色详情
+- `wiki/结构-三幕/`：三幕结构.md
+- `wiki/结构-主线/`：主线.md
+- `wiki/结构-支线/`：支线-{N}.md
+- `wiki/结局/`：结局.md
+- `wiki/世界观/`：世界观.md
+- `wiki/势力/`：势力详情
+- `wiki/物品/`：物品详情
+- `wiki/地点/`：地点详情
+- `wiki/关系/`：关系网.md
+- `wiki/技能/`：技能详情
+- `wiki/节奏-大纲/`：主线大纲.md
+- `wiki/节奏-分卷/`：分卷表.md
+- `wiki/节奏-情绪/`：情绪节奏.md
+- `wiki/节奏-伏笔/`：伏笔表.md
+- `wiki/细纲/`：细纲_{NNN}.md
+- `wiki/审查-冲突/`：冲突检测结果
+- `wiki/审查-缺失/`：缺失检测结果
+- `.llm-wiki/review.json`：结构化的冲突/缺失列表
+
+## Heading to Type Mapping
+
+| Heading Name | Inferred Type |
+|--------------|-----------|
+| 容量要素 | 框架-容量 |
+| 结构要素 | 框架-结构 |
+| 角色要素 | 框架-角色 |
+| 冲突要素 | 框架-冲突 |
+| 弧光要素 | 框架-弧光 |
+| 基本信息 | base type（根据文件路径） |
+| 核心成员 / 角色名 | 角色 |
+| 势力设定 / 世界观设定 | 继承父级 |
+| 势力资源 / 物品 | 物品/地点 |
+| 与其他势力的关系 | 关系 |
+| 卷数与章节分配 | 分卷表 |
+
+## Files to Skip
+
+- `*闭环检查报告.md` - 分析报告，不需要提炼
+- `故事框架.md` - 纯描述性内容