@cloud411716/fancy-webnovel 1.0.46 → 2.2.0

package/plugins/fancy-analyze/schema-analyze.md

@@ -0,0 +1,379 @@
+# 小说写作技法分析规范（必须严格遵循）
+
+## ⚠️ 语言强制要求
+
+**所有输出内容必须是中文，包括：**
+- 文件名：使用中文，格式为`书名-技法名-章节名.md`，如`全球高武-悬念设置-第1章.md`
+- title：使用中文，格式为`书名 技法名 章号`，如`全球高武 悬念设置 第1章`
+- 正文内容：所有文字描述必须使用中文
+- 表格内容：所有表格中的文字必须使用中文
+- YAML frontmatter：tags 中的文字使用中文
+
+**禁止输出英文内容：**
+- ❌ 英文描述、英文分析
+- ❌ 英文标签、英文关键词
+- ❌ 中英混合
+
+---
+
+## 核心目标
+
+从原文中提取**可复用的写作技法**，而非仅仅是信息归档。每一页都要能回答：这个技法怎么用？何时用？为何有效？
+
+---
+
+## ⚠️ 最重要的工作流程（必须严格执行）
+
+### 第一步：系统化分析
+对于**每一章**的原文，**必须**从以下**全部16种**类型逐一进行分析：
+
+| 序号 | TYPE 值 | 中文名称 |
+|------|---------|---------|
+| 1 | 叙事视角 | 叙事视角 |
+| 2 | 章节结构 | 章节结构 |
+| 3 | 节奏韵律 | 节奏韵律 |
+| 4 | 对话技巧 | 对话技巧 |
+| 5 | 描写技法 | 描写技法 |
+| 6 | 伏笔回收 | 伏笔回收 |
+| 7 | 世界观构建 | 世界观构建 |
+| 8 | 角色弧光 | 角色弧光 |
+| 9 | 情节机制 | 情节机制 |
+| 10 | 开头钩子 | 开头钩子 |
+| 11 | 结尾收束 | 结尾收束 |
+| 12 | 句式变化 | 句式变化 |
+| 13 | 段落布局 | 段落布局 |
+| 14 | 场景转换 | 场景转换 |
+| 15 | 情绪渲染 | 情绪渲染 |
+| 16 | 张力构建 | 张力构建 |
+
+**规则：**
+- 每种类型都必须分析，回答"有"或"无"
+- **禁止跳过任何类型**
+- 如果"有"：必须引用原文片段并写出分析
+
+### 第二步：创建页面（仅限"有"的情况）
+
+**⚠️ 强制约束：分析结果为"有"的类型，必须创建对应的独立页面**
+
+- 只有**分析结果为"有"**的类型才需要创建独立页面
+- 如果某类型分析结果为"无"，**不要创建该类型的页面**
+- **禁止**在 related 或 wikilink 中引用尚未创建页面的技法
+
+### 第三步：填写来源页面的"可深挖的技法点"
+- 在来源页面的"可深挖的技法点"中，列出所有分析结果为"有"的技法
+- 这些技法应该已经创建了独立页面
+
+### ⚠️ 强制约束：禁止遗漏必须创建的页面
+
+**本章所有分析结果为"有"的技法页面必须全部创建完成后，才能处理下一章。**
+
+具体要求：
+1. **每章必须完成的事项清单：**
+   - [ ] 完成全部16种类型的分析（回答"有"或"无"）
+   - [ ] 对于所有"有"的类型，创建对应的独立页面
+   - [ ] 填写来源页面的"可深挖的技法点"
+   - [ ] 确保所有页面之间的交叉引用（related、wikilink）都是有效的
+
+2. **禁止的行为：**
+   - ❌ 跳过任何一种类型的分析
+   - ❌ 分析结果为"有"但不创建对应页面
+   - ❌ 创建的页面数量少于"有"的类型数量
+   - ❌ 留下未完成的页面（如：创建了文件但没有填写内容）
+   - ❌ 在所有"有"的页面创建完成之前，处理下一章
+
+3. **检查清单示例：**
+
+   如果某章的分析结果如下：
+
+   | 类型 | 分析结果 |
+   |------|----------|
+   | 叙事视角 | 有 |
+   | 章节结构 | 无 |
+   | 节奏韵律 | 有 |
+   | ... | ... |
+   | 张力构建 | 无 |
+
+   则**必须创建**以下页面：
+   - `wiki/叙事视角/全球高武-叙事视角-第X章.md`
+   - `wiki/节奏韵律/全球高武-节奏韵律-第X章.md`
+   - `wiki/来源/全球高武-第X章-xxx.md`
+
+   **禁止**在未完成上述页面创建之前处理下一章。
+
+---
+
+## 页面类型（输出目录）
+
+| TYPE 值 | 目录 | 中文名称 | 何时创建 |
+|---------|------|---------|---------|
+| 叙事视角 | wiki/叙事视角/ | 叙事视角 | 分析结果为"有"时 |
+| 章节结构 | wiki/章节结构/ | 章节结构 | 分析结果为"有"时 |
+| 节奏韵律 | wiki/节奏韵律/ | 节奏韵律 | 分析结果为"有"时 |
+| 对话技巧 | wiki/对话技巧/ | 对话技巧 | 分析结果为"有"时 |
+| 描写技法 | wiki/描写技法/ | 描写技法 | 分析结果为"有"时 |
+| 伏笔回收 | wiki/伏笔回收/ | 伏笔回收 | 分析结果为"有"时 |
+| 世界观构建 | wiki/世界观构建/ | 世界观构建 | 分析结果为"有"时 |
+| 角色弧光 | wiki/角色弧光/ | 角色弧光 | 分析结果为"有"时 |
+| 情节机制 | wiki/情节机制/ | 情节机制 | 分析结果为"有"时 |
+| 开头钩子 | wiki/开头钩子/ | 开头钩子 | 分析结果为"有"时 |
+| 结尾收束 | wiki/结尾收束/ | 结尾收束 | 分析结果为"有"时 |
+| 句式变化 | wiki/句式变化/ | 句式变化 | 分析结果为"有"时 |
+| 段落布局 | wiki/段落布局/ | 段落布局 | 分析结果为"有"时 |
+| 场景转换 | wiki/场景转换/ | 场景转换 | 分析结果为"有"时 |
+| 情绪渲染 | wiki/情绪渲染/ | 情绪渲染 | 分析结果为"有"时 |
+| 张力构建 | wiki/张力构建/ | 张力构建 | 分析结果为"有"时 |
+| 来源 | wiki/来源/ | 来源 | **每章必创建**，包含完整分析结果 |
+
+**⚠️ TYPE 值必须与上表第一列精确匹配，禁止使用未定义的 TYPE**
+
+---
+
+## 文件名规则
+
+**格式：`书名-技法名-章节名.md`**
+
+| 规则 | 正确示例 | 错误示例 |
+|------|---------|---------|
+| 必须包含书名 | `全球高武-节奏韵律-第1章.md` | `节奏韵律-第1章.md` |
+| 技法名必须与目录名一致 | `全球高武-节奏韵律-第1章.md` | `全球高武-张弛交替-第1章.md` |
+| 章节名必须与文件名中的章号一致 | `全球高武-情绪渲染-第1章.md` | `全球高武-情绪渲染-第2章.md` |
+| 禁止下划线 | `全球高武-对话潜台词-第3章.md` | `dialogue_ch3.md` |
+| 禁止空格 | `全球高武-情绪渲染-第10章.md` | `emotion ch10.md` |
+
+**⚠️ 禁止使用子技法名作为文件名**：
+- 正确：`全球高武-节奏韵律-第1章.md`（节奏韵律目录下的一级技法名）
+- 错误：`全球高武-张弛交替-第1章.md`（张弛交替是节奏韵律的子技法）
+- 即使某章使用了"张弛交替"这种具体技法，文件名仍应为 `全球高武-节奏韵律-第1章.md`，在文件内部用 `# 张弛交替` 来标记具体技法
+
+---
+
+## Title 规则
+
+**Title 必须从文件名派生，格式：`书名 技法名 章号`**
+
+| 文件名 | title |
+|--------|-------|
+| `全球高武-悬念设置-第1章.md` | `全球高武 悬念设置 第1章` |
+| `全球高武-对话潜台词-通用.md` | `全球高武 对话潜台词 通用` |
+
+---
+
+## Frontmatter 格式
+
+```yaml
+---
+type: 伏笔回收
+title: 全球高武 伏笔回收 第3章
+tags: [悬念, 伏笔, 技法]
+related: [全球高武-情绪渲染-第3章, 全球高武-开头钩子-第3章]
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [第3章.txt]
+---
+```
+
+**⚠️ related 中的引用必须满足：被引用的页面必须已经创建（第二步已创建），且格式为`书名-技法名-章节名`**
+
+---
+
+## 交叉引用规则（关键）
+
+1. **related 引用规则**：`related: [全球高武-情绪渲染-第3章]`
+   - **前提**：被引用的页面必须已创建
+   - **格式为`书名-技法名-章节名`**
+   - **禁止**：引用不存在的页面
+
+2. **正文 wikilink**：`[[全球高武-情绪渲染-第3章]]`
+   - 同样必须引用已创建的页面，且格式为`书名-技法名-章节名`
+
+3. **禁止**在 wikilink 中加目录前缀：`[[人物/方平]]`、`[[wiki/xxx]]`
+
+---
+
+## 技法页面内容模板
+
+每个技法页面必须使用**多级标题结构**：
+
+```markdown
+# 张弛交替
+
+## 技法定义
+
+张弛交替是指在叙事中交替使用紧张和放松的节奏，让读者在紧张之后得到舒缓，避免疲劳。
+
+## 原理解析
+
+为什么这个技法有效？读者心理机制是什么？
+
+## 使用时机
+
+什么时候适合用这个技法？什么情况下不适用？
+
+## 章节实例
+
+### 实例1：第X章
+**原文片段：**
+> 原文摘录...
+
+**技法分析：**
+这里如何运用该技法？效果如何？
+
+## 可复用的抽象规则
+
+从实例中提炼出的通用规则：
+1. 规则1
+2. 规则2
+
+---
+
+# 欲扬先抑
+
+## 技法定义
+
+欲扬先抑是指先描述低落或困难的情况，再转向高潮或成功的叙事手法。
+
+## 原理解析
+
+...
+
+## 使用时机
+
+...
+
+## 章节实例
+
+### 实例1：第X章
+...
+
+## 可复用的抽象规则
+
+...
+```
+
+**结构说明：**
+- `# 具体技法名`（一级标题）：标记本章使用的具体技法名称，可以出现多次（每个具体技法一个）
+- `## 技法定义`（二级标题）：用一句话定义这个具体技法
+- `## 原理解析`（二级标题）：为什么这个技法有效？
+- `## 使用时机`（二级标题）：什么时候适合用？什么情况下不适用？
+- `## 章节实例`（二级标题）：具体章节中的使用示例
+- `### 实例N`（三级标题）：第X章的实例
+- `## 可复用的抽象规则`（二级标题）：从实例中提炼出的通用规则
+
+**⚠️ 注意**：
+- 每个 `# 具体技法名` 下面都必须包含完整的 `##` 二级结构
+- 同一章中可以使用多种不同的具体技法，每个都有自己的一级标题和二级结构
+- 文件名必须是 `全球高武-节奏韵律-第1章.md`，而不是 `全球高武-张弛交替-第1章.md`
+
+---
+
+## 来源页面格式（来源）
+
+**⚠️ 强制约束：必须先填写下面的"列表"表格，才能继续分析每种技法。禁止跳过此表格。**
+
+```yaml
+---
+type: 来源
+title: 全球高武 第3章 气血检查
+tags: []
+related: [全球高武-悬念设置-第3章, 全球高武-对话潜台词-第3章]
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [raw/sources/全球高武/第3章/气血检查.txt]
+---
+
+# 第3章 气血检查
+
+## 本章核心事件
+（3-5句话概括本章发生的事）
+
+## 技法分析（全部16种）
+
+### 列表
+
+| 技法 | 有/无 |
+|------|-------|
+| 叙事视角 | 有/无 |
+| 章节结构 | 有/无 |
+| 节奏韵律 | 有/无 |
+| 对话技巧 | 有/无 |
+| 描写技法 | 有/无 |
+| 伏笔回收 | 有/无 |
+| 世界观构建 | 有/无 |
+| 角色弧光 | 有/无 |
+| 情节机制 | 有/无 |
+| 开头钩子 | 有/无 |
+| 结尾收束 | 有/无 |
+| 句式变化 | 有/无 |
+| 段落布局 | 有/无 |
+| 场景转换 | 有/无 |
+| 情绪渲染 | 有/无 |
+| 张力构建 | 有/无 |
+
+### 叙事视角
+【有/无】
+（有的话：原文片段 + 技法分析）
+
+### 章节结构
+【有/无】
+...
+
+（按顺序罗列全部16种类型）
+
+## 可深挖的技法点
+（只列出分析结果为"有"的技法，这些技法应该有独立的页面）
+- 全球高武-悬念设置-第3章
+- 全球高武-对话潜台词-第3章
+```
+
+---
+
+## 常见错误
+
+### ❌ 引用未创建的页面
+```
+❌ 在全球高武-伏笔回收-第1章的 related 中写 [全球高武-悬念设置-第1章]，但全球高武-悬念设置-第1章.md 尚未创建
+✓ 只有创建了全球高武-悬念设置-第1章.md 后，才能在 related 中引用
+```
+
+### ❌ 为"无"的类型创建页面
+```
+❌ 某章没有使用对话潜台词技法，但仍然创建了"全球高武-对话潜台词-第X章.md"
+✓ 只有分析结果为"有"时才创建页面
+```
+
+### ❌ 只有描述，没有提炼
+```
+❌ 这个章节用了悬念设置，让读者想看下去
+✓ 这个章节在第3段埋下"方平的真实身份"这个悬念，
+   通过...的描写制造...的感觉，在第8段通过...事件回收。
+   通用规则：当...时，可以用"身份悬念"来吸引读者。
+```
+
+---
+
+## 第四步：完整性检查与补充
+
+**⚠️ 必须根据"### 列表"表格检查并补充缺失的页面：**
+
+1. **逐项核对**：对照"### 列表"表格中所有"有"的技法
+2. **检查文件夹**：检查 `wiki/{技法名}/` 目录下是否存在对应的页面文件（文件名为`书名-技法名-第X章.md`格式）
+3. **补充缺失**：如果某个"有"的技法在对应文件夹中没有找到页面，**必须**立即创建该页面
+4. **禁止遗漏**：所有"有"的技法都必须有对应的独立页面，**禁止遗漏任何一项**
+
+**示例：**
+
+假设"### 列表"中：
+| 技法 | 有/无 |
+|------|-------|
+| 叙事视角 | 有 |
+| 伏笔回收 | 有 |
+| 情绪渲染 | 无 |
+
+则**必须**确认：
+- `wiki/叙事视角/` 目录下存在 `全球高武-叙事视角-第X章.md` 格式的文件
+- `wiki/伏笔回收/` 目录下存在 `全球高武-伏笔回收-第X章.md` 格式的文件
+- 不需要为"情绪渲染"创建页面（因为分析结果为"无"）
+
+如果发现缺失，必须**立即补充创建**，才能结束本章的分析工作。
+
+

package/plugins/fancy-analyze/schema-write.md

@@ -0,0 +1,178 @@
+# Wiki 结构规范（必须严格遵循）
+
+## 页面类型
+
+| TYPE 值（精确） | 目录 | 说明 |
+|----------------|------|------|
+| characters | wiki/characters/ | 人物角色 |
+| entities | wiki/entities/ | 命名实体 |
+| plots | wiki/plots/ | 剧情单元 |
+| concepts | wiki/concepts/ | 概念思想 |
+| sources | wiki/sources/ | 来源摘要 |
+| techniques | wiki/techniques/ | 写作技法 |
+| worldbuildings | wiki/worldbuildings/ | 世界观设定 |
+| templates | wiki/templates/ | 复用模板 |
+| queries | wiki/queries/ | 开放问题 |
+
+**⚠️ TYPE 值必须与上表第一列精确匹配，禁止使用复数形式或其他变体**
+**⚠️ 错误示例：type: character（正确：type: characters）**
+**⚠️ 错误示例：type: 角色（正确：type: characters）**
+**⚠️ 错误示例：type: queries（正确：type: queries）**
+
+---
+
+## 文件名规则
+
+**格式：`中文内容-中文内容-中文内容.md`**
+
+| 规则 | 正确示例 | 错误示例 |
+|------|---------|---------|
+| 仅用中文、横线、数字 | `全球高武-第10章-气血检查.md` | `全球高武_第10章.md`（下划线） |
+| 禁止空格 | `方平.md` | `方 平.md`（空格） |
+| 禁止标点符号 | `杨建-身份背景.md` | `杨建,身份.md`（逗号） |
+| 禁止 `.md` 以外的点号 | `全球高武-第1章.md` | `全球.高武.md`（多点号） |
+
+**⚠️ 文件名中的 `-` 在生成 title 时必须替换为空格**
+
+---
+
+## Title 规则
+
+**Title 必须从文件名派生：去掉 `.md`，把 `-` 替换为空格**
+
+| 文件名 | 正确 title | 错误 title（禁止） |
+|--------|-----------|-------------------|
+| `方平.md` | `方平` | `《方平》`、`角色方平` |
+| `全球高武-第10章-气血检查.md` | `全球高武 第10章 气血检查` | `《全球高武》第十章` |
+| `杨建-身份背景.md` | `杨建 身份背景` | `杨建的身份背景` |
+
+**⚠️ Title 不得自行发挥，必须按上述规则派生**
+**⚠️ 不要在 title 中添加书名号、的、角色等额外文字**
+
+---
+
+## Frontmatter 格式
+
+```yaml
+---
+type: characters
+title: 方平
+tags: []
+related: [杨建, 全球高武]
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+---
+```
+
+**必填字段：type, title, tags, related, created, updated**
+
+---
+
+## Wikilink 规则
+
+**⚠️ Wikilink 中只写 bare slug（无目录前缀、无文件扩展名）**
+
+| 正确格式 | 错误格式（禁止） |
+|---------|----------------|
+| `[[方平]]` | `[[characters/方平]]` |
+| `[[杨建]]` | `[[entities/杨建]]` |
+| `[[全球高武]]` | `[[wiki/全球高武]]` |
+| `[[气血检查]]` | `[[方平.md]]` |
+
+**禁止在 `[[` 和 `]]` 之间出现：**
+- 目录前缀：如 `characters/`、`entities/`、`wiki/`
+- 文件扩展名：如 `.md`、`.txt`
+- 标点符号
+
+---
+
+## 交叉引用规则
+
+- Related 数组中只写 bare slug：`related: [方平, 杨建]`
+- 正文中的 wikilink 只用 bare slug：`[[方平]]`、`[[全球高武]]`
+- 禁止：`related: [characters/方平]`、`[[方平.md]]`
+
+---
+
+## 常见错误（必须避免）
+
+### ❌ 错误的 TYPE 值
+```
+type: character         （应为：type: characters）
+type: query             （应为：type: queries）
+type: 角色              （应为：type: characters）
+type: Entity            （应为：type: entities）
+```
+
+### ❌ 错误的文件名
+```
+方平_杨建.md           （下划线禁止）
+方 平.md               （空格禁止）
+杨建,身份.md           （逗号禁止）
+```
+
+### ❌ 错误的 TITLE
+```
+title: "《方平》"       （禁止书名号）
+title: "方平的角色"    （禁止额外文字）
+title: "全球高武 第十章"（应为："全球高武 第10章 气血检查"）
+```
+
+### ❌ 错误的 WIKILINK
+```
+[[方平.md]]            （禁止扩展名）
+[[characters/方平]]    （禁止目录前缀）
+[[杨建|杨建武圣]]      （禁止别名格式，如需别名另想办法）
+```
+
+---
+
+## 来源页面额外字段
+
+```yaml
+---
+type: sources
+title: 全球高武-第10章-气血检查
+tags: []
+related: []
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+sources: [原文路径]
+---
+```
+
+---
+
+## 索引格式
+
+`wiki/index.md` 按类型分组，每项一行：
+
+```markdown
+## characters
+- [[方平]] — 小说主角
+- [[杨建]] — 方平的好友
+
+## entities
+- [[全球高武]] — 小说名称
+```
+
+---
+
+## 日志格式
+
+`wiki/log.md` 逆时间顺序：
+
+```markdown
+## YYYY-MM-DD
+
+- 已采取的行动 / 已注意到的发现
+```
+
+---
+
+## 矛盾处理
+
+1. 在相关角色/概念页面中记录矛盾
+2. 创建/更新 `queries` 类型页面跟踪问题
+3. 从 `queries` 页面链接两个来源
+4. 证据充足后在综合页面中解决