@cloud411716/fancy-webnovel 1.0.46 → 3.0.0

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. 证据充足后在综合页面中解决