# 类型知识库目录

本知识库为novel-writer的genre-knowledge插件提供类型化写作知识支持。所有知识文件采用扁平化组织和自然语言命名,方便AI通过Glob/Grep动态搜索。

---

## 目录结构

```
knowledge/
├── fundamentals/          # 通用方法论(所有类型适用)
│   ├── emotion-value-core-laws.md           # 商业网文创作五大法则
│   └── scene-mru-structure.md               # MRU场景结构设计法
└── genres/                # 类型专属知识
    ├── fantasy.md                           # 奇幻/玄幻类型综合指导(669行)
    ├── mystery.md                           # 悬疑推理类型综合指导(353行)
    ├── romance.md                           # 言情类型综合指导(378行)
    ├── scifi.md                             # 科幻类型综合指导(530行)
    ├── shuangwen.md                         # 爽文类型综合指导(236行)
    ├── shuangwen-faceslap-pattern.md        # 装逼打脸五步递进法(573行)
    └── shuangwen-golden-opening.md          # 爽文黄金开篇五法则(428行)
```

---

## 通用方法论(fundamentals/)

适用于所有商业类型小说的核心方法论。

### emotion-value-core-laws.md

**商业网文创作五大法则**

- **适用类型**: 商业网文、爽文、玄幻、都市、系统文等
- **适用场景**: 大纲规划、章节设计、情节构建
- **核心内容**:
  - 法则一: 极限铺垫原则(欲扬先抑)
  - 法则二: 期待感管理系统(信息差分层释放)
  - 法则三: 连锁震惊反应(一事多震)
  - 法则四: 角色与剧情的基因锚定与弧光塑造
  - 法则五: 核心创作"套路"库(时间锁、空间锁、道德挑战等)
- **应用指南**: 在/clarify、/plan、/write中的具体应用方法

**何时使用**:
- 规划商业类型小说大纲时
- 设计关键情节转折点时
- 需要增强剧情吸引力时

### scene-mru-structure.md

**MRU场景结构设计法**

- **适用类型**: 所有类型小说
- **适用场景**: 章节场景规划、情节节奏控制
- **核心内容**:
  - 主动场景(M): 目标、冲突、挫折
  - 被动场景(R): 反应、困境、决定
  - 场景链接: 无缝循环
- **实战应用**: 在/plan和/write中的使用方法

**何时使用**:
- 规划章节场景结构时
- 感觉剧情拖沓或跳跃时
- 需要提升情节逻辑性时

---

## 类型专属知识(genres/)

针对特定类型的写作技巧和套路。

### shuangwen-golden-opening.md

**爽文黄金开篇五法则**

- **适用类型**: 爽文、玄幻、都市、系统文等商业网文
- **适用场景**: 开篇前三章或前一万字
- **重要性**: ★★★★★(决定读者是否继续阅读)
- **核心内容**:
  - 法则一: 动态场景切入(禁止静态铺陈)
  - 法则二: 核心冲突前置(第一章抛出困境)
  - 法则三: 避免信息轰炸(滴灌式释放)
  - 法则四: 限制出场人数(≤3人)
  - 法则五: 快速展现金手指(1-3章内)
- **完整流程**: 三章结构模板

**何时使用**:
- 写商业爽文的开篇时
- 感觉开篇无法抓住读者时
- 需要优化前三章结构时

### shuangwen-faceslap-pattern.md

**装逼打脸五步递进法**

- **适用类型**: 爽文、玄幻、都市、重生文、系统文
- **适用场景**: 打脸剧情、装逼爽点、情绪铺垫
- **重要性**: ★★★★★(爽文的核心技巧)
- **核心内容**:
  - 第一步: 上门被拒
  - 第二步: 冷眼相待
  - 第三步: 当众羞辱
  - 第四步: 引入对比(对富二代热情)
  - 第五步: 强迫分手/逼迫屈服
  - 第六步: 反转爆发(打脸)
- **应用变体**: 职场被贬流、天才被轻视流、身份被怀疑流

**何时使用**:
- 设计打脸爽点时
- 需要制造情绪反转时
- 铺垫爽点释放时

### shuangwen.md

**爽文类型综合指导** (已迁移自spec/knowledge/genres/)

- **适用类型**: 爽文、玄幻、都市、系统文等商业网文
- **适用场景**: 爽文创作全流程
- **核心内容**:
  - 核心特征(三大核心要素、三种爽感形式)
  - 常见流派/子类型(开挂流、情节流、情感流、融合流)
  - 关键要素(主角设定、核心机制、配角功能、世界观设定)
  - 澄清问题模板
  - 情节结构建议(开篇钩子、三幕结构、章节节奏)
  - 质量检查标准
  - 常见陷阱与避免

**何时使用**:
- 写爽文类型小说的全流程
- 需要全面了解爽文特征时
- /clarify命令加载类型知识时

**与其他文件关系**:
- 本文件是基础全面指导
- `shuangwen-golden-opening.md`是开篇专项深度
- `shuangwen-faceslap-pattern.md`是打脸专项深度

### fantasy.md

**奇幻/玄幻类型综合指导** (已迁移自spec/knowledge/genres/)

- **适用类型**: 玄幻、仙侠、奇幻
- **适用场景**: 玄幻小说创作全流程
- **核心内容**:
  - 类型特征和常见流派
  - 世界观设定(修炼体系、等级划分、势力结构)
  - 情节结构建议
  - 质量检查标准

**何时使用**:
- 写玄幻/仙侠类型小说时
- 需要设计修炼体系时
- /clarify、/plan、/analyze命令加载类型知识时

### scifi.md

**科幻类型综合指导** (已迁移自spec/knowledge/genres/)

- **适用类型**: 硬科幻、软科幻、未来科技
- **适用场景**: 科幻小说创作全流程
- **核心内容**:
  - 类型特征和常见流派
  - 科技设定原则
  - 世界观构建要点
  - 质量检查标准

**何时使用**:
- 写科幻类型小说时
- 需要设计科技体系时
- /clarify、/plan、/analyze命令加载类型知识时

### romance.md

**言情类型综合指导** (已迁移自spec/knowledge/genres/)

- **适用类型**: 现代言情、古代言情、幻想言情
- **适用场景**: 言情小说创作全流程
- **核心内容**:
  - 类型特征和常见流派
  - 感情线设计原则
  - 人物关系构建要点
  - 质量检查标准

**何时使用**:
- 写言情类型小说时
- 需要设计感情线时
- /clarify、/plan、/analyze命令加载类型知识时

### mystery.md

**悬疑推理类型综合指导** (已迁移自spec/knowledge/genres/)

- **适用类型**: 推理、悬疑、犯罪
- **适用场景**: 悬疑小说创作全流程
- **核心内容**:
  - 类型特征和常见流派
  - 线索布局原则
  - 悬念设计技巧
  - 质量检查标准

**何时使用**:
- 写悬疑/推理类型小说时
- 需要设计线索和悬念时
- /clarify、/plan、/analyze命令加载类型知识时

---

## 知识文件使用指南

### 对AI(Claude)的使用指导

当你是AI并且安装了genre-knowledge插件时,应该这样使用知识库:

#### 在/clarify命令中

**步骤1**: 识别故事类型
```
检查story.md中的类型标签(如"玄幻爽文"、"都市重生")
```

**步骤2**: 搜索相关知识
```
Glob: plugins/genre-knowledge/knowledge/genres/*{类型关键词}*.md
```

**步骤3**: 提炼类型特征
- 快速浏览搜索到的文件
- 提取该类型的关键特征(如爽文需要明确的"极限困境"和"金手指")

**步骤4**: 融入澄清问题
- 在澄清问题中询问这些类型特征
- 帮助作者更好地定位创作方向

#### 在/plan命令中

**步骤1**: 识别故事类型
```
从story.md中提取类型标签
如无明确标签,根据故事内容(金手指、世界观、冲突类型)推断
```

**步骤2**: 按优先级搜索知识

**优先级1 - 通用方法论**(所有类型适用):
```
plugins/genre-knowledge/knowledge/fundamentals/*.md
```
推荐优先阅读:
- `emotion-value-core-laws.md` - 五大商业创作法则
- `scene-mru-structure.md` - MRU场景结构

**优先级2 - 类型专属知识**(根据识别的类型):
```
plugins/genre-knowledge/knowledge/genres/*{类型关键词}*.md
```
示例:
- 爽文类型: 搜索 `*shuangwen*.md`
- 玄幻类型: 搜索 `*xuanhuan*.md`
- 都市类型: 搜索 `*urban*.md`

**步骤3**: 选择性应用知识
- 📖 快速浏览文件,提取与当前章节规划相关的知识点
- ⚠️ 不要全盘照搬,需结合具体故事情况灵活应用
- 🔍 按需搜索,不要一次性加载所有知识

**步骤4**: 应用到规划中

示例:规划"都市重生爽文"开篇3章

**搜索知识**:
```
Glob: plugins/genre-knowledge/knowledge/fundamentals/emotion-value-core-laws.md
Glob: plugins/genre-knowledge/knowledge/genres/shuangwen-golden-opening.md
```

**提取要点**:
- 从五大法则中应用"极限铺垫原则"(开篇构建困境)
- 从黄金开篇中应用"动态场景切入"和"核心冲突前置"

**规划应用**:
- 第1章: 动态场景切入重生瞬间,立刻展现主角困境
- 第2章: 简要揭示重生金手指(核心信息差)
- 第3章: 完成第一个小逆袭(打脸爽点)

#### 在/write命令中(可选)

**快速搜索**:
```
Glob: plugins/genre-knowledge/knowledge/genres/*{类型}*pattern*.md
Glob: plugins/genre-knowledge/knowledge/fundamentals/*structure*.md
```

**应用场景**:
- 写打脸场景时,参考`shuangwen-faceslap-pattern.md`的五步递进法
- 写关键转折时,参考`scene-mru-structure.md`的MRU结构

**注意**: 不要让模式束缚文笔,保持语言的自然流畅。

---

## 知识应用原则

### 优先级规则

```
类型专属知识 > 通用方法论 > 通用规范
```

- 🎯 **类型专属知识**(如`shuangwen-golden-opening.md`)优先级最高
- 📚 **通用方法论**(如`emotion-value-core-laws.md`)次之
- 📖 **通用规范**(如`novel-constitution.md`)保底

### 选择性应用

- ✅ 根据当前任务选择相关知识点
- ✅ 结合具体故事情况灵活调整
- ❌ 不要一次性加载所有知识
- ❌ 不要死板地套用所有规则

### 创意优先

- ⚠️ 知识是工具,不是束缚
- ⚠️ 保持故事的独特性和创新性
- ⚠️ 当知识与创意冲突时,优先保护创意

---

## 扩展知识库

### 添加新知识文件

本知识库采用扁平化结构,支持动态扩展:

**步骤1**: 确定知识类型
- 通用方法论 → 放入`fundamentals/`
- 类型专属知识 → 放入`genres/`

**步骤2**: 命名规则
- 使用自然语言命名(方便Glob搜索)
- 使用连字符分隔单词
- 使用`.md`扩展名

**命名示例**:
- ✅ `xuanhuan-cultivation-system.md`(玄幻修炼体系)
- ✅ `urban-business-war.md`(都市商战)
- ✅ `romance-emotional-rhythm.md`(言情情感节奏)
- ❌ `knowledge-001.md`(无意义命名)

**步骤3**: 文件格式建议

```markdown
# {知识主题}

> 适用类型: {小说类型}
> 适用场景: {创作阶段}
> 重要性: {星级评价(可选)}

---

## 核心理念

{阐述核心理念和价值}

---

## 核心内容

{3-5个核心知识点,结构化呈现}

---

## 应用示例

{具体例子和使用场景}

---

## 注意事项

{使用限制和建议}

---

**版本**: {版本号}
**来源**: {知识来源}
**适用场景**: {简要说明}
**相关知识**: {交叉引用其他知识文件}
```

### 贡献指南

欢迎贡献新的类型知识!

**贡献流程**:
1. 在对应目录创建新文件
2. 遵循命名规则和格式建议
3. 确保内容基于实践经验或成功案例
4. 提交PR到主仓库

**知识质量标准**:
- ✅ 具有实用性,可直接应用到创作中
- ✅ 基于市场验证的成功经验
- ✅ 结构清晰,易于理解和检索
- ✅ 与现有知识形成互补,避免重复

---

## 常见问题

### Q: AI没有应用知识库中的知识?

**A**: 检查以下几点:
1. 插件是否正确安装(增强提示词是否插入核心命令)
2. `plugins/genre-knowledge/`目录是否存在
3. 故事类型是否明确(AI需要类型标签来搜索知识)

### Q: 知识文件太多会影响性能吗?

**A**: 不会。AI是按需搜索,不会一次性加载所有文件。扁平化结构和自然语言命名正是为了支持高效的动态搜索。

### Q: 可以删除或修改知识文件吗?

**A**: 可以。知识库完全由你控制:
- 删除不需要的文件
- 修改现有文件内容
- 添加自定义知识文件

### Q: 适合写严肃文学吗?

**A**: 本知识库主要面向**商业类型小说**(爽文、玄幻、都市等)。如果你写严肃文学或实验性作品,这些知识可能不适用。

### Q: 如何让AI更好地应用知识?

**A**:
1. 在`story.md`中明确标注故事类型
2. 在与AI交互时,明确提及你想应用某个知识点
3. 如果AI没有主动搜索,可以直接指示:"参考爽文黄金开篇的法则来规划"

---

## 更新日志

### v1.1.0 (类型知识扩充)

**新增内容**:
- ✅ 5个核心类型指导文件
  - `fantasy.md` - 奇幻/玄幻类型综合指导(669行)
  - `scifi.md` - 科幻类型综合指导(530行)
  - `romance.md` - 言情类型综合指导(378行)
  - `mystery.md` - 悬疑推理类型综合指导(353行)
  - `shuangwen.md` - 爽文类型综合指导(236行)

**更新时间**: novel-writer v0.17.3

### v1.0.0 (初版)

**新增内容**:
- ✅ 通用方法论2个文件
  - `emotion-value-core-laws.md` - 商业网文创作五大法则
  - `scene-mru-structure.md` - MRU场景结构设计法
- ✅ 类型专属知识2个文件
  - `shuangwen-golden-opening.md` - 爽文黄金开篇五法则
  - `shuangwen-faceslap-pattern.md` - 装逼打脸五步递进法

**来源**: 基于商业网文创作系统v2.0提取

---

## 支持与反馈

- 📖 插件文档: `plugins/genre-knowledge/README.md`
- 🐛 问题反馈: https://github.com/wordflowlab/novel-writer/issues
- 💡 功能建议: https://github.com/wordflowlab/novel-writer/discussions

---

**最后更新**: 2024年
**维护者**: novel-writer团队
**许可证**: MIT License
