@cloud411716/fancy-webnovel 2.2.0 → 3.0.0

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

@@ -1,324 +1,232 @@
-# 节奏阶段设定分析规范
-
-## 核心目标
-
-分析 `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 | 是否生成 | 说明 |
+# 故事设定分析规范
+
+## Page Types
+
+| Type | Directory | Purpose |
+|------|-----------|---------|
+| 书 | wiki/书/ | 全书根对象 |
+| 卷 | wiki/卷/ | 分卷 |
+| 幕 | wiki/幕/ | 幕 |
+| 章 | wiki/章/ | 章节元数据 |
+| 细纲要求 | wiki/细纲要求/ | 一条细纲要求 |
+| 场景 | wiki/场景/ | 场景 |
+| 人物 | wiki/人物/ | 角色 |
+| 其他实体 | wiki/其他实体/ | 灵魂/神魂/器灵等题材特有存在 |
+| 势力 | wiki/势力/ | 势力 |
+| 地点 | wiki/地点/ | 地点 |
+| 道具 | wiki/道具/ | 关键道具 |
+| 冲突 | wiki/冲突/ | 冲突 |
+| 伏笔 | wiki/伏笔/ | 伏笔 |
+| 高潮 | wiki/高潮/ | 高潮点 |
+| 爽点 | wiki/爽点/ | 爽点 |
+| 结局 | wiki/结局/ | 结局 |
+| 世界观 | wiki/世界观/ | 世界观规则 |
+| 主线 | wiki/主线/ | 主线 |
+| 支线 | wiki/支线/ | 支线 |
+| 关系 | wiki/关系/ | 角色关系 |
+| 势力关系 | wiki/势力关系/ | 势力关系 |
+| 势力成员 | wiki/势力成员/ | 势力成员关系 |
+| 主题 | wiki/主题/ | 主题 |
+| 角色弧光 | wiki/角色弧光/ | 角色弧光 |
+| 角色状态 | wiki/角色状态/ | 角色状态快照 |
+| 时间线 | wiki/时间线/ | 时间线事件 |
+| 正文 | wiki/正文/ | 章节正文 |
+| 来源 | wiki/来源/ | 来源摘要（辅助页） |
+| 信息差 | wiki/信息差/ | 一条信息差及其知情范围 |
+| 章节细纲 | wiki/细纲/ | 每章写作硬约束（时间线/伏笔/爽点/人物/信息差/必须与禁止） |
+
+---
+
+## 核心原则
+
+1. 2.0 项目里 `设定/00-baseline/`、`10-scale/`、`20-macro/`、`30-cast/`、`40-rhythm/`、`50-writing/` 下的阶段 JSON 是**事实源**；`wiki/` 是确定性派生视图。旧 1.x 项目仍以 `设定/raw/sources/骨架|血肉|节奏|写作/` 为事实源。
+2. 上表中的故事对象页由插件的 `schemaingest` 从阶段 JSON 生成。LLM **禁止**创建、改名、移动、删除这些对象页，也**禁止**手工补写它们的 frontmatter。
+3. LLM ingest 只做两件事：
+   - 为每个来源文件写一个 `wiki/来源/*.md` 摘要页（`type: 来源`）；
+   - 写无法结构化归类的补充说明，但不得新增故事对象页。
+4. type 系统是封闭的：只能使用上表定义的值，禁止新增 type 或目录。
+5. 每条人物关系、势力关系、势力成员都生成**独立页面**，供 llm_wiki 做语义检查。关系类型 `kind` 是自由文本，**不设枚举**；插件只校验两端存在、不能自指、变化节点完整，关系是否自洽交给语义检查。
+6. 所有输出必须是中文。唯一例外：代码块、JSON、YAML 中的英文字段名。
+
+---
+
+## ID 规则
+
+| Type | ID 格式 | 示例 |
 |------|---------|------|
-| 时间线 | 有 | 全书主线时间线 |
-| 冲突演变 | 有 | 核心冲突演变 |
-| 卷任务 | 有 | 卷核心任务 |
-| 伏笔布局 | 有 | 伏笔宏观布局 |
-| 分卷 | 无 | 不在本文件中 |
-| ... | ... | ... |
+| 书 | `BOOK` | BOOK |
+| 卷 | `V{NNN}` | V001 |
+| 幕 | `A{NNN}` | A001 |
+| 章 | `CH{NNN}` | CH001 |
+| 细纲要求 | `RQ-CH{NNN}-{NN}` | RQ-CH001-01 |
+| 场景 | `SCN-CH{NNN}-{NN}` | SCN-CH001-01 |
+| 人物 | `C{NNN}` | C001 |
+| 其他实体 | `O{NNN}` | O001 |
+| 势力 | `F{NNN}` | F001 |
+| 地点 | `L{NNN}` | L001 |
+| 道具 | `P{NNN}` | P001 |
+| 冲突 | `X{NNN}` | X001 |
+| 伏笔 | `FS{NNN}` | FS001 |
+| 高潮 | `CL{NNN}` | CL001 |
+| 爽点 | `PL{NNN}` | PL001 |
+| 结局 | `E{NNN}` | E001 |
+| 世界观 | `SR{NNN}` / `R{NNN}` / `I{NNN}` | R001 |
+| 主线 | `M{NNN}` | M001 |
+| 支线 | `B{NNN}` | B001 |
+| 关系 | `REL{NNN}` | REL001 |
+| 势力关系 | `FREL{NNN}` | FREL001 |
+| 势力成员 | `MEM{NNN}` | MEM001 |
+| 主题 | `TH{NNN}` | TH001 |
+| 角色弧光 | `ARC-C{NNN}-V{NNN}` | ARC-C001-V001 |
+| 角色状态 | `CS-C{NNN}-CH{NNN}` | CS-C001-CH001 |
+| 时间线 | `T{NNN}` | T001 |
+| 正文 | `TXT-CH{NNN}` | TXT-CH001 |
+| 来源 | `SRC-{slug}` | SRC-skeleton-entity |
+| 信息差 | `IG-X{NNN}-{NN}` | IG-X001-01 |
+| 章节细纲 | `OB-CH{NNN}` | OB-CH001 |
+
+ID 一经生成必须稳定。后续阶段只能更新同一 ID 的正文或字段，不能换 ID 重建。
+
+---
+
+## 标题规则
+
+所有页面标题必须是：
+
+```text
+<ID>_<中文标题>
 ```
 
-**重要：**
-- "有"的页面**必须生成**
-- "无"的页面**不需要生成**
-- 闭环检查时，如果在"### 本页包含的 type"表格中"是否生成"列为"有"的页面缺失，**必须补充**
+例如：
 
----
-
-## 闭环检查要求（必须执行）
-
-### 1. 检查"### 本页包含的 type"表格中"是否生成"列为"有"的页面是否都已生成
-
-对于每个标记为"有"的 type，必须检查：
-- wiki 中是否存在对应的页面
-- 如果缺失，**必须立即补充页面**才能 ingest 下一个文件
+- `BOOK_香火簿`
+- `V001_除夕分岁`
+- `CH001_第1章`
+- `RQ-CH001-01_CH001 主功能`
+- `C001_陆守拙`
+- `F001_陆氏宗族`
 
+ID 前缀用于排序和定位，后面的中文标题用于阅读。
 
 ---
 
-## Frontmatter 格式示例
+## 链接规则
 
-### 时间线/冲突演变/伏笔布局 类型
+- 页面之间的关系只写在 frontmatter 的 `related` 里。
+- `related` 必须使用 `[[ID|完整标题]]`：链接目标是**文件名里的 ID**，`|` 后面是给人看的标题。
+  只写 `[[完整标题]]` 会让 llm_wiki 去找 `C001_陆守拙.md`，但实际文件是 `C001.md`，UI 会显示 “Related page not found”。
 
 ```yaml
----
-type: 时间线
-title: 全书主线时间线
-sources: [raw/sources/节奏/主线大纲.md]
 related:
-  - type: 冲突演变
-    title: 核心冲突演变
-  - type: 伏笔布局
-    title: 伏笔宏观布局
----
+  - "[[V001|V001_除夕分岁]]"
+  - "[[CH001|CH001_第1章]]"
+  - "[[C001|C001_陆守拙]]"
 ```
 
-### 分卷 类型
+- 不要写 `related: [F001]`，也不要写 `related: [陆氏宗族]`。
+- 正文不要再生成“关系网 / 上级 / 下级 / 相邻”这类区块。  
+  如果正文确实需要内联链接，只使用 `[[ID]]` 占位符作为覆盖锚点，不要用关系表表达关系。
+- 每个页面至少要链接到一个相关页面；所有页面最终要能连成一张网，不能有孤立页面。
+
+### `related` 应该包含什么
+
+| 页面类型 | 建议链接到 |
+|----------|------------|
+| 书 | 卷、主题、主线、世界观、势力、地点、冲突、来源索引 |
+| 卷 | 书、幕、相邻卷 |
+| 幕 | 卷、章、相邻幕 |
+| 章 | 幕、卷、细纲要求、章节细纲、场景、正文、伏笔、高潮、爽点、结局、时间线、相邻章 |
+| 细纲要求 | 章、同章相邻要求 |
+| 场景 | 章、地点、人物、冲突、同章相邻场景 |
+| 正文 | 章、本章细纲要求、相邻正文 |
+| 人物 | 势力、关系、势力成员、角色弧光、角色状态、道具、其他实体、相关章节 |
+| 势力 | 书、人物、势力成员、势力关系 |
+| 地点 | 书、场景、冲突 |
+| 道具 | 拥有者人物/势力、相关场景或章节 |
+| 冲突 | 书、人物、场景、时间线 |
+| 伏笔 | 埋设章、回收章、相关人物 |
+| 高潮 | 章、人物 |
+| 爽点 | 章 |
+| 结局 | 章、人物、相关伏笔 |
+| 世界观 | 书、相关势力/人物/章节 |
+| 主线 | 书、支线、时间线 |
+| 支线 | 主线、相关章节、主角 |
+| 其他实体 | 相关人物、其他实体、关系页 |
+| 关系 | from 人物、to 人物 |
+| 势力关系 | from 势力、to 势力 |
+| 势力成员 | 人物、势力 |
+| 主题 | 书、相关卷 |
+| 角色弧光 | 人物、卷、角色状态 |
+| 角色状态 | 人物、章、地点、关系 |
+| 时间线 | 章、人物、地点、冲突、主线/支线 |
+| 来源 | 来源索引、相关对象页 |
+| 信息差 | 冲突、知情/不知情人物、创建章、解决章 |
+| 章节细纲 | 章、卷、幕、视角人物、出场人物、地点、冲突、伏笔、高潮、爽点、信息差 |
+
+同类型页面（卷、幕、章、细纲要求、场景、正文、时间线等）要互相链接相邻项，形成有序链。
+
+---
+
+## 正文要求
+
+- 故事对象页的正文由插件从 JSON 生成，LLM 不要改写；需要补充说明时写入 `来源` 摘要页或在对话中说明。
+- 正文不要生成“关系网 / 上级 / 下级 / 相邻”区块；关系只放在 `related` 里。
+- 来源摘要页正文第一块必须是 `## 来源`，列出源文件、生成时间和摘要；`related` 至少包含 `[[SRC-INDEX_来源索引]]` 和一个相关对象页。
+- 禁止空页、占位页、只有标题的页面。
+- 禁止把同一对象拆成多个 type 或多个目录的重复页。
+
+---
+
+## 来源摘要页（type: 来源）
+
+来源摘要页是 LLM ingest 唯一可以创建的类型，用于记录“这个源文件讲了什么”。`SRC-INDEX` 由插件维护，LLM 不要创建或改写它。来源页没有 schema link 字段，但仍需通过 `related` 接入关系网。
 
-```yaml
+```markdown
 ---
-type: 分卷
-title: 第一卷
-sources: [raw/sources/节奏/分卷表.md]
-卷号: 1
-卷名: 青云之路
-章节范围: 第1-100章
+type: 来源
+id: SRC-skeleton-entity
+title: SRC-skeleton-entity_骨架-实体
+source_file: raw/sources/骨架/实体.json
+related:
+  - "[[SRC-INDEX|来源索引]]"
+  - "[[BOOK|香火簿]]"
+  - "[[C001|C001_陆守拙]]"
+  - "[[F001|F001_陆氏宗族]]"
+created: 2026-01-01
 ---
-```
 
-### 情绪弧线 类型
+## 来源
 
-```yaml
----
-type: 情绪弧线
-title: V形弧线
-sources: [raw/sources/节奏/情绪节奏.md]
-弧线类型: V形
-适用场景: 重生复仇、破镜重圆、亲情催泪
----
-```
+| 字段 | 值 |
+|------|----|
+| 来源文件 | raw/sources/骨架/实体.json |
+| 生成时间 | 2026-01-01 12:00:00 |
 
-### 高潮点 类型
+## 摘要
 
-```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章
-状态: 已回收
----
-```
-
-### 章节细纲 类型
+1. 禁止创建上表之外的 type 或目录。
+2. 禁止手工创建/修改故事对象页；对象页只由 `schemaingest` 写入。
+3. 禁止用标题、文件名或路径代替 ID 填 link 字段。
+4. 禁止生成“无”“待补充”这类占位页。
+5. 禁止跳过来源摘要；每个被 ingest 的源文件都应有对应的 `来源` 页。
+6. 禁止产生孤立页面或无出站链接页面。
 
-```yaml
----
-type: 章节细纲
-title: 第5章
-sources: [raw/sources/节奏/细纲_005.md]
-章号: 5
-字数目标: 3000
-视角: 第三人称
 ---
-```
-
-### 支线交织 类型
 
-```yaml
----
-type: 支线交织
-title: 交织点1
-sources: [raw/sources/节奏/主线大纲.md]
-交织点: 交织点1
-涉及章节: 第5-8章
-与主线关系: 支线推动主线发展
----
-```
+## 2.0 阶段门禁与同步
 
-### 场景 类型
+- `10-scale` 不同步 wiki、不跑 lint：它只有数字，没有页面。
+- `20-macro` 默认不跑 lint：此时还没有人物/势力/地点页面。
+- `30-cast` 是第一次正式同步点；同步时必须带 `20-macro` 闭包，否则人物页链接的势力/地点会 broken-link。
+- `40-rhythm` 同步 `20-macro + 30-cast + 40-rhythm` 闭包后才跑 schema/link lint。
+- semantic lint 只在 `40-rhythm` PASSED 后开启，避免把“还没写到”误判成矛盾。
+- `schema.json` 的全局 `minimums` 保持为空；阶段最低页数由插件按 `stage_minimums` 检查。
 
-```yaml
----
-type: 场景
-title: 第1章-场景1
-sources: [raw/sources/节奏/细纲_001.md]
-所属章节: 第1章
-场景序号: 1
-场景名称: 百乐门后台
-场景类型: 引入
----
-```
+关系类型 `kind` 不设枚举；每条关系独立成页，页面正文的“语义验证点”交给 llm_wiki 语义检查。