@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

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

@@ -0,0 +1,232 @@
+# 故事设定分析规范
+
+## 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>_<中文标题>
+```
+
+例如：
+
+- `BOOK_香火簿`
+- `V001_除夕分岁`
+- `CH001_第1章`
+- `RQ-CH001-01_CH001 主功能`
+- `C001_陆守拙`
+- `F001_陆氏宗族`
+
+ID 前缀用于排序和定位，后面的中文标题用于阅读。
+
+---
+
+## 链接规则
+
+- 页面之间的关系只写在 frontmatter 的 `related` 里。
+- `related` 必须使用 `[[ID|完整标题]]`：链接目标是**文件名里的 ID**，`|` 后面是给人看的标题。
+  只写 `[[完整标题]]` 会让 llm_wiki 去找 `C001_陆守拙.md`，但实际文件是 `C001.md`，UI 会显示 “Related page not found”。
+
+```yaml
+related:
+  - "[[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` 接入关系网。
+
+```markdown
+---
+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
+---
+
+## 来源
+
+| 字段 | 值 |
+|------|----|
+| 来源文件 | raw/sources/骨架/实体.json |
+| 生成时间 | 2026-01-01 12:00:00 |
+
+## 摘要
+
+用中文概括该来源文件的结构、数量和需要人工关注的问题。
+```
+
+---
+
+## 禁止行为
+
+1. 禁止创建上表之外的 type 或目录。
+2. 禁止手工创建/修改故事对象页；对象页只由 `schemaingest` 写入。
+3. 禁止用标题、文件名或路径代替 ID 填 link 字段。
+4. 禁止生成“无”“待补充”这类占位页。
+5. 禁止跳过来源摘要；每个被 ingest 的源文件都应有对应的 `来源` 页。
+6. 禁止产生孤立页面或无出站链接页面。
+
+---
+
+## 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` 检查。
+
+关系类型 `kind` 不设枚举；每条关系独立成页，页面正文的“语义验证点”交给 llm_wiki 语义检查。