novel-maker 2.2.0

package/skill/references/memory-system.md

@@ -0,0 +1,288 @@
+# 记忆系统详解
+
+## 三重记忆架构
+
+NovelMaker 采用三重记忆机制，确保AI在长篇写作中不忘事、不混乱。
+
+```
+┌─────────────────────────────────────────┐
+│           三重记忆架构                    │
+├─────────────────────────────────────────┤
+│ 第一层：真相文件（Truth Files）           │
+│  - 持久化的世界状态和设定                 │
+│  - 手动更新+自动同步                      │
+│  - 相当于"设定集"                         │
+├─────────────────────────────────────────┤
+│ 第二层：长程上下文（Context）             │
+│  - 前文摘要和相关章节                     │
+│  - 写作时自动检索注入                     │
+│  - 相当于"前情提要"                       │
+├─────────────────────────────────────────┤
+│ 第三层：实体关系（Entity Graph）          │
+│  - 角色关系、地点关联、物品追踪           │
+│  - 自动维护和更新                         │
+│  - 相当于"人物关系图"                     │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 第一层：真相文件 (Truth Files)
+
+真相文件是持久化的设定文档，由作者和AI共同维护。
+
+### 文件清单
+
+| 文件名 | 内容 | 更新频率 | 维护者 |
+|--------|------|---------|--------|
+| `current-state.md` | 世界当前状态 | 每章后 | 复盘师 |
+| `characters.md` | 角色档案 | 角色变化时 | 复盘师+规划师 |
+| `world-setting.md` | 世界观设定 | 新设定时 | 协调者+复盘师 |
+| `pending-hooks.md` | 待处理伏笔 | 每章后 | 复盘师 |
+| `power-system.md` | 力量体系 | 体系变化时 | 复盘师 |
+| `emotional-arcs.md` | 情感弧线追踪 | 每章后 | 复盘师 |
+| `subplot-board.md` | 支线看板 | 支线变化时 | 复盘师 |
+| `timeline.md` | 时间线追踪 | 每章后 | 复盘师 |
+
+### current-state.md 模板
+
+```markdown
+# 世界当前状态
+
+## 时间线
+- 当前时间：[故事内时间]
+- 距离开篇：[时间跨度]
+
+## 主角状态
+- 位置：[当前地点]
+- 境界/等级：[当前等级]
+- 持有物品：[重要物品列表]
+- 当前目标：[短期目标]
+
+## 活跃剧情线
+- 主线：[主线剧情进展]
+- 支线1：[支线剧情进展]
+- 支线2：[支线剧情进展]
+
+## 近期事件
+- [最近发生的重要事件]
+
+## 待解决冲突
+- [尚未解决的矛盾]
+```
+
+### characters.md 模板
+
+```markdown
+# 角色档案
+
+## [角色名]
+- **身份**：[角色身份]
+- **性格**：[性格特点]
+- **能力**：[拥有的能力]
+- **关系**：[与其他角色的关系]
+- **当前状态**：[当前位置/状态]
+- **目标**：[角色目标]
+- **秘密**：[隐藏信息]
+- **成长轨迹**：[角色变化历程]
+```
+
+### pending-hooks.md 模板
+
+```markdown
+# 伏笔追踪表
+
+| 伏笔 | 设置章节 | 预期回收 | 状态 | 备注 |
+|------|---------|---------|------|------|
+| [伏笔描述] | 第X章 | 第Y章 | 未回收 | [说明] |
+```
+
+---
+
+## 第二层：长程上下文 (Context)
+
+长程上下文是AI写作时自动检索的相关信息。
+
+### 上下文构建规则
+
+写作第N章时，自动注入：
+
+1. **前3章摘要** - 最近发生的事情
+2. **相关角色档案** - 本章出场角色的设定
+3. **相关伏笔** - 与本章情节相关的伏笔
+4. **世界状态** - 当前的世界状态
+5. **大纲参考** - 本章在大纲中的定位
+
+### 上下文注入示例
+
+```markdown
+【写作参考】
+
+## 前情摘要
+- 第N-3章：[摘要]
+- 第N-2章：[摘要]
+- 第N-1章：[摘要]
+
+## 本章出场角色
+- [角色A]：[关键设定]
+- [角色B]：[关键设定]
+
+## 相关伏笔
+- [伏笔1]：[描述]，设置于第X章，待回收
+
+## 当前世界状态
+- 时间：[时间]
+- 地点：[地点]
+- 状态：[状态]
+
+## 本章大纲目标
+[本章需要完成的情节目标]
+```
+
+---
+
+## 第三层：实体关系 (Entity Graph)
+
+实体关系是角色、地点、物品之间的关联网络。
+
+### 关系类型
+
+| 关系类型 | 说明 | 示例 |
+|---------|------|------|
+| 人物关系 | 角色之间的关联 | 师徒、父子、仇敌 |
+| 地点关联 | 地点之间的关联 | 相邻、从属 |
+| 物品归属 | 物品的所有者 | 谁拥有某物品 |
+| 事件关联 | 事件的因果关联 | A事件导致B事件 |
+
+### 关系维护规则
+
+1. **新角色出场** - 记录与其他角色的关系
+2. **关系变化** - 更新关系状态
+3. **物品转移** - 更新物品归属
+4. **地点变化** - 更新角色位置
+
+---
+
+## 记忆更新流程
+
+### 写前准备
+
+1. 读取真相文件
+2. 检索前文摘要
+3. 加载相关角色档案
+4. 构建写作上下文
+
+### 写后更新
+
+1. 更新当前世界状态
+2. 生成章节摘要
+3. 更新伏笔状态
+4. 更新角色状态
+5. 保存真相文件
+
+---
+
+## AI 自动检索规则（RAG 增强）
+
+本节定义 AI 在执行不同指令时应自动检索的内容范围。AI 应主动执行检索，无需用户指定文件。
+
+### 检索优先级
+
+AI 在检索时应按以下优先级顺序：
+
+```
+优先级 1：真相文件（truth-files/）→ 当前设定的权威来源
+优先级 2：大纲文件（novels/outline.md、volume-XX/plan.md）→ 剧情目标
+优先级 3：前文摘要（.novel-maker/summaries/）→ 最近剧情回顾
+优先级 4：相关章节（novels/volume-XX/chapters/）→ 细节参考
+优先级 5：文风库（styles/）→ 风格参考
+```
+
+### 指令驱动的检索矩阵
+
+| 用户意图关键词 | 应检索的文件 | 检索目标 |
+|--------------|-------------|---------|
+| 写/继续/下一章 | truth-files/* + outline.md + 前3章 | 角色设定、世界观、力量体系、前情、大纲目标 |
+| 主角/角色/人物 | truth-files/characters.md + 相关章节 | 角色档案、出场历史、成长轨迹 |
+| 等级/修炼/力量 | truth-files/power-system.md + current-state.md | 力量体系规则、当前等级 |
+| 地点/世界/设定 | truth-files/world-setting.md + current-state.md | 世界观设定、当前地点 |
+| 伏笔/悬念/回收 | truth-files/pending-hooks.md + 相关章节 | 未回收伏笔、设置位置 |
+| 检查/矛盾/一致 | truth-files/* + 被检查章节 | 全部设定+前文，做一致性对比 |
+| 规划/大纲/计划 | outline.md + truth-files/* + 已写卷 | 总大纲、当前设定、已有内容 |
+| 灵感/建议/走向 | truth-files/* + outline.md + 前文 | 当前剧情线、未解冲突、大纲目标 |
+
+### 语义检索规则
+
+AI 不应仅依赖文件名，而应理解用户意图后检索相关内容：
+
+1. **角色相关查询**：
+   - 用户问"主角现在什么等级"→ 检索 `characters.md` + `current-state.md` + `power-system.md`
+   - 用户说"写主角遇到师父"→ 检索 `characters.md` 找"师父"相关角色 + 前文出场历史
+
+2. **设定相关查询**：
+   - 用户问"这个世界有什么力量"→ 检索 `power-system.md` + `world-setting.md`
+   - 用户说"主角突破到下一境界"→ 检索 `power-system.md` 确认境界名称和规则
+
+3. **剧情相关查询**：
+   - 用户问"之前埋了什么伏笔"→ 检索 `pending-hooks.md` + 相关章节
+   - 用户说"继续上一章的剧情"→ 检索前一章全文 + 前情摘要
+
+### 检索上下文构建模板
+
+AI 检索后，应按以下结构构建写作上下文（内部使用，无需展示给用户）：
+
+```markdown
+【写作上下文】
+
+## 角色状态（来自 truth-files/characters.md + current-state.md）
+- [角色A]：当前等级/位置/状态/目标
+- [角色B]：当前等级/位置/状态/目标
+
+## 世界设定（来自 truth-files/world-setting.md + power-system.md）
+- 相关世界观：[与本章相关的设定]
+- 力量体系：[本章涉及的境界/能力规则]
+
+## 前情摘要（来自 .novel-maker/summaries/ + 前3章）
+- 最近事件：[前3章关键情节]
+- 未解冲突：[尚未解决的矛盾]
+- 待回收伏笔：[相关伏笔列表]
+
+## 本章目标（来自 outline.md / volume-XX/plan.md）
+- 大纲要求：[本章应完成的情节]
+- 角色成长：[应推进的角色发展]
+- 伏笔处理：[应埋设/回收的伏笔]
+```
+
+### 检索失败处理
+
+如果 AI 无法找到相关文件（如文件不存在或内容为空）：
+
+1. **首次写作**：真相文件可能未初始化 → 提示用户先执行 `/novel-maker init`
+2. **缺少设定**：用户询问不存在的角色/设定 → 询问用户是否要创建新设定
+3. **前文缺失**：找不到前文 → 告知用户这是第一章，无需前情参考
+
+---
+
+## 使用建议
+
+### 新手
+
+- 保持真相文件简洁
+- 每章后更新摘要
+- 定期整理伏笔表
+
+### 进阶
+
+- 细化角色档案
+- 建立详细的时间线
+- 维护力量体系文档
+
+### 专家
+
+- 自定义真相文件结构
+- 建立完整的实体关系图
+- 使用多线索追踪系统
+
+---
+
+*参考文档：NovelMaker 记忆系统 v1.0*

package/skill/references/pacing-analysis.md

@@ -0,0 +1,201 @@
+# Pacing Analysis 节奏分析
+
+## 系统原理
+
+Pacing Analysis 自动分析章节和卷的节奏，确保张弛有度，
+避免连续紧张或连续平淡，维持读者的追读兴趣。
+
+---
+
+## 一、节奏层级
+
+### 1. 章节内节奏（Scene Level）
+
+每个场景的节奏评级：
+
+| 等级 | 名称 | 特征 | 适用场景 |
+|------|------|------|---------|
+| S5 | 极高潮 | 生死关头、终极对决 | 卷末、大高潮 |
+| S4 | 高潮 | 战斗、突破、打脸 | 每10章一次 |
+| S3 | 上升 | 准备、计划、推进 | 高潮前铺垫 |
+| S2 | 平缓 | 日常、对话、探索 | 高潮后缓冲 |
+| S1 | 低谷 | 纯说明、设定介绍 | 开篇、过渡 |
+
+### 2. 章节间节奏（Chapter Level）
+
+连续章节的节奏变化：
+
+```
+理想节奏曲线：
+S2 → S3 → S4 → S2 → S1 → S3 → S4 → S5 → S2 → S3...
+  ^       ^         ^           ^
+  铺垫    上升      小高潮      大高潮
+```
+
+**节奏规则**：
+- 不能连续3章S4或S5（读者疲劳）
+- 不能连续3章S1或S2（读者弃读）
+- 每5-8章必须有S4或S5
+- 每3章必须有S3或更高
+
+### 3. 卷节奏（Volume Level）
+
+整卷的节奏分布：
+
+| 阶段 | 章节范围 | 节奏 | 内容 |
+|------|---------|------|------|
+| 起 | 1-5章 | S1→S2→S3 | 引入新事件/场景 |
+| 承 | 6-15章 | S2→S3→S4 | 发展冲突 |
+| 转 | 16-25章 | S3→S4→S4 | 中点转折 |
+| 合 | 26-35章 | S4→S5→S2 | 高潮+余韵 |
+
+---
+
+## 二、节奏分析指标
+
+### 1. Hook 点密度
+
+每章应该有的 Hook 点数量：
+
+| 章节位置 | Hook 点数量 | 类型 |
+|---------|------------|------|
+| 开篇章 | 2-3 | 引入悬念 |
+| 发展章 | 1-2 | 推进悬念 |
+| 高潮章 | 1-2 | 结果悬念 |
+| 过渡章 | 1-2 | 新事件引子 |
+
+**Hook 冷却**：
+- 同类 Hook 不能连续使用
+- 每5章必须有 Hook 兑现
+- 未兑现的 Hook 不能超过10章
+
+### 2. 爽点密度
+
+| 题材 | 爽点间隔 | 爽点类型要求 |
+|------|---------|-------------|
+| 爽文 | 每2-3章 | 打脸、逆袭、突破 |
+| 悬疑 | 每5-8章 | 解谜、反转 |
+| 言情 | 每3-5章 | 感情推进、误会解除 |
+| 凡人流 | 每5-10章 | 突破、收获 |
+
+### 3. 信息密度
+
+每章应该包含的信息量：
+
+| 信息类型 | 每章数量 | 说明 |
+|---------|---------|------|
+| 新设定 | 0-2 | 不能过多新设定 |
+| 新角色 | 0-2 | 不能同时引入太多角色 |
+| 情节进展 | 1-2 | 必须有实际进展 |
+| 伏笔 | 1-3 | 埋设或回收 |
+
+### 4. 情感波动
+
+连续章节的情感变化：
+
+```
+理想情感曲线：
+轻松 → 紧张 → 感动 → 愤怒 → 爽快 → 温暖 → 悬念...
+```
+
+**规则**：
+- 不能连续3章同种情感
+- 必须有情感对比（先抑后扬）
+- 高潮必须有情感爆发
+
+---
+
+## 三、节奏分析工具
+
+### 章节节奏卡片
+
+```
+# 第X章 节奏分析
+
+## 基本信息
+- 字数：2500
+- 场景数：3
+- 节奏等级：S4（高潮）
+
+## 场景节奏
+| 场景 | 节奏 | 类型 | Hook | 爽点 |
+|------|------|------|------|------|
+| 1 | S3 | 准备 | 悬念引子 | - |
+| 2 | S4 | 战斗 | - | 打脸反派 |
+| 3 | S2 | 收尾 | 新危机 | 获得宝物 |
+
+## 节奏评估
+- 本章节奏：✅ 良好（张弛有度）
+- Hook数量：2个 ✅
+- 爽点数量：1个 ⚠️ 偏少
+- 信息密度：适中 ✅
+- 情感波动：紧张→爽快 → ✅
+
+## 前后章节对比
+- 前3章节奏：S2 → S3 → S4 ✅ 上升
+- 后3章建议：S2 → S1 → S3  缓冲后上升
+
+## 问题
+- 连续2章战斗场景，建议下一章日常缓冲
+- Hook点H005已埋设8章未回收，建议尽快
+```
+
+### 卷节奏概览
+
+```
+# 第一卷 节奏概览
+
+## 节奏分布
+S5: ██ (2章) 6%
+S4: ████████ (8章) 23%
+S3: ████████████ (12章) 34%
+S2: ████████ (8章) 23%
+S1: ████ (5章) 14%
+
+## 问题区域
+- 第10-15章连续6章S2，节奏偏缓 ⚠️
+- 第20-22章连续3章S4，可能疲劳 ⚠️
+- 第25-30章节奏完美 ✅
+
+## 追读力趋势
+第1-5章：★★★★☆  (开篇吸引)
+第6-10章：★★★☆☆  (节奏偏缓)
+第11-20章：★★★★★  (高潮迭起)
+第21-30章：★★★★☆  (完美收尾)
+
+## 改进建议
+- 第12章加入小高潮
+- 第21章后安排缓冲
+- 第28章增加Hook
+```
+
+---
+
+## 四、使用指令
+
+节奏分析已整合到 `/novel-maker review` 指令中：
+
+```
+/novel-maker review pacing 分析当前章节节奏
+/novel-maker review pacing volume 分析整卷节奏
+/novel-maker review pacing compare 对比前后章节节奏
+/novel-maker review pacing suggest 建议下一章节奏
+/novel-maker review pacing report 生成完整节奏报告
+```
+
+---
+
+## 五、自动优化建议
+
+### 检测到问题时的建议
+
+| 问题 | 建议 |
+|------|------|
+| 连续3章S4+ | 下一章安排日常缓冲 |
+| 连续3章S2- | 下一章安排冲突/高潮 |
+| Hook超5章未回收 | 尽快兑现或说明原因 |
+| 无爽点超过5章 | 安排打脸/逆袭/突破 |
+| 信息密度过高 | 拆分到后续章节 |
+| 信息密度过低 | 增加情节/设定/角色 |
+| 情感单一 | 安排情感对比 |
+| 角色出场不均 | 安排多角色互动 |