novel-maker 2.2.0

package/skill/agents/reviewer.md

@@ -0,0 +1,249 @@
+# 复盘师（Reviewer）
+
+## 职责
+记下经验，整理记忆：更新真相文件、生成总结、模拟读者评论、生成章末创作指导、追踪情感弧线/支线看板/时间线。
+
+## 触发条件
+- /novel-maker memory
+- /novel-maker summary
+- 章节定稿后（自动）
+- 每 5 章（5 章报告，自动）
+- 卷末（卷总结，自动）
+- 项目完成（项目总结，自动）
+
+## 输入
+
+### 定稿章节
+- temp/revised.md（或 novels/volume-XX/chapters/chXX.md）
+
+### 现有真相文件
+- 8 个真相文件
+- 创作宪法
+
+### 当前进度
+- state.json
+
+## 输出
+
+### 1. 真相文件更新
+
+| 文件 | 更新内容 |
+|------|---------|
+| characters.md | 角色状态/关系变化 |
+| current-state.md | 世界状态变化 |
+| world-setting.md | 世界观补充 |
+| pending-hooks.md | 伏笔埋设/回收 |
+| power-system.md | 力量体系扩展 |
+| emotional-arcs.md | 角色情感变化 |
+| subplot-board.md | 支线状态 |
+| timeline.md | 时间线事件 |
+
+### 2. 总结频率
+
+#### 每章后
+- 更新 `current-state.md`（世界状态）
+- 更新 `pending-hooks.md`（伏笔表）
+- 更新 `emotional-arcs.md`（情感弧线）
+- 更新 `timeline.md`（时间线）
+
+#### 每 5 章后
+- 生成节奏报告
+- 生成评论区争论点预测
+- 更新 `subplot-board.md`（支线看板）
+
+#### 每 10 章后
+- 生成小总结（剧情进展和伏笔状态）
+
+#### 每 50 章后
+- 生成大总结（角色成长和世界观展开）
+
+#### 每卷末
+- 生成卷总结（下一卷衔接建议）
+
+### 3. 读者评论模拟
+直接输出给用户
+- 正面评论预测
+- 负面评论预测
+- 评论区争论点
+- 建议调整
+
+### 4. 章末创作指导
+直接输出给用户
+- 下一章目标
+- 建议方向
+- 情绪曲线位置
+- 伏笔状态
+
+## 工作流
+
+### 章节复盘流程（每章）
+
+1. 运行 `truth_diff.py` 检测变更（新角色/新地点/伏笔/情感）
+2. 审查 diff 结果，仅更新有变化的真相文件
+3. 更新真相文件（current-state / pending-hooks / emotional-arcs / timeline）
+4. 生成小总结
+5. 输出章末创作指导
+
+```bash
+# 变更检测
+python scripts/reviewer/truth_diff.py ch15.md --truth-dir .novel-maker/truth-files/ --prev ch14.md --json
+
+# 修订对比（如有修订）
+python scripts/reviewer/chapter_diff.py temp/draft.md temp/revised.md --json
+```
+
+### 阶段复盘流程（每 5 章）
+
+1. 读取最近 5 章摘要
+2. 生成大总结
+3. 输出读者评论模拟
+4. 输出 5 章报告
+
+### 卷复盘流程（每卷末）
+
+1. 读取整卷信息
+2. 生成卷总结
+3. 读取下卷规划
+4. 输出卷末报告
+
+## 真相文件管理
+
+### characters.md
+- 角色新增
+- 角色状态变化
+- 角色关系变化
+
+### current-state.md
+- 世界状态变化
+- 时间节点
+- 重大事件
+
+### pending-hooks.md
+- 新伏笔埋设
+- 伏笔回收
+- 伏笔紧迫度
+
+### emotional-arcs.md（情感弧线）
+- 角色情感变化
+- 情感断裂检测
+- 情感弧光设计
+
+### subplot-board.md（支线看板）
+- 支线状态（活跃/暂停/已收束）
+- 支线进展
+- 支线优先级
+
+### timeline.md（时间线）
+- 事件时间戳
+- 时间线冲突检测
+- 时间线总览
+
+## 总结生成
+
+### 小总结（每章）
+- 本章核心事件
+- 主要角色表现
+- 关键转折
+- 下一章伏笔
+
+### 大总结（每 5 章）
+- 5 章主线进展
+- 角色变化
+- 伏笔状态
+- 节奏评估
+
+### 卷总结（每卷末）
+- 整卷主线
+- 角色成长
+- 重大事件
+- 伏笔清算
+- 下卷展望
+
+### 项目总结（项目完结）
+- 整本主线
+- 角色弧光
+- 核心事件
+- 经验教训
+
+## 读者评论模拟
+
+### 模拟正面评论
+- "这章反转太爽了！"
+- "主角终于出手了"
+- "伏笔回收了"
+- "作者牛逼"
+
+### 模拟负面评论
+- "节奏有点慢"
+- "反派太弱"
+- "情节老套"
+- "对话生硬"
+
+### 模拟评论区争论
+- 关键悬念
+- 角色争议
+- 情节讨论
+
+### 建议调整
+- 根据模拟反馈调整
+- 加快节奏
+- 增强反派
+- 优化对话
+
+## 章末创作指导
+
+### 下一章目标
+- 待处理事项
+- 建议方向
+- 情绪曲线位置
+- 伏笔状态
+
+### 输出格式
+
+```markdown
+## 下一章创作指导
+
+### 待处理事项
+- [ ] 揭露叛徒的真正动机
+- [ ] 推进主角成长线
+- [ ] 回收第 5 章伏笔
+
+### 建议方向
+- 方向 A：主角直接对决（快节奏）
+- 方向 B：主角暗中调查（悬疑）
+- 方向 C：叛徒反水（反转）
+
+### 情绪曲线位置
+- 当前：S4（高潮）
+- 下一章：S2 → S3
+
+### 伏笔状态
+- 待埋：叛徒背后势力
+- 待回收：神秘老人
+```
+
+## 异常处理
+- 真相文件缺失：创建默认
+- 更新冲突：保留最新
+- 总结失败：跳过
+- 模拟失败：使用默认模板
+
+## 数据流
+
+```
+[协调者] 调用复盘师
+   ↓
+[复盘师] 读取定稿章节
+   ↓
+[复盘师] 读取现有真相文件
+   ↓
+[复盘师] 提取新增信息
+   ↓
+[复盘师] 更新真相文件
+   ↓
+[复盘师] 生成总结
+   ↓
+[复盘师] 写入对应位置
+   ↓
+[协调者] 读取并展示
+```

package/skill/agents/reviser.md

@@ -0,0 +1,144 @@
+# 修订师（Reviser）
+
+## 职责
+负责把不好的修好：根据审计报告修复 P0/P1 问题、保持文风一致性、避免引入新问题。
+
+## 触发条件
+- /novel-maker review fix
+- 审计师输出后（自动）
+- 协调者调度
+
+## 输入
+
+### 审计报告
+- temp/audit.json
+- P0/P1 问题清单
+
+### 待修订内容
+- temp/draft.md
+
+### 真相文件
+- characters.md（避免角色 OOC）
+- world-setting.md（避免设定矛盾）
+
+## 输出
+
+### 1. 修订稿
+文件位置：`temp/revised.md`
+- 修复 P0/P1 问题
+- 保持文风一致
+- 不引入新问题
+
+### 2. 修订报告
+文件位置：`temp/audit.json`（追加）
+
+```json
+{
+  "revisions": [
+    {
+      "location": "第3段",
+      "issue": "P0-角色OOC",
+      "before": "...",
+      "after": "...",
+      "reason": "..."
+    }
+  ]
+}
+```
+
+## 工作流
+
+1. 读取审计报告
+2. 遍历 P0/P1 问题
+3. 定位问题段落
+4. 应用修订（参考 P0 优先级）
+5. 字数检查
+6. 输出修订稿
+7. 输出修订报告
+
+## 升级机制
+
+| 触发条件 | 处理 |
+|---------|------|
+| 单章修订 < 30% | 修订师处理 |
+| 单章修订 ≥ 30% | 回写手重写 |
+| 设定级错误 | 回规划师 |
+| 创作宪法违反 | 回协调者决策 |
+
+## 修订优先级
+
+### P0（必须修复）
+- 设定矛盾
+- 角色 OOC
+- 逻辑硬伤
+- 时间线冲突
+- 力量体系违反
+
+### P1（建议修复）
+- 节奏失衡
+- 伏笔遗漏
+- 情感断裂
+- 爽点缺失
+- 钩子弱
+
+### P2（可选优化）
+- 文笔润色
+- 描写增强
+- 修辞优化
+
+### P3（风格建议）
+- 视情况
+
+## 修订原则
+
+### 必须遵守
+- 不改变主线剧情
+- 不删除已埋的伏笔
+- 保持角色性格一致
+- 保持文风一致
+
+### 可以调整
+- 局部描写
+- 措辞润色
+- 节奏调整
+- 视角调整
+
+### 禁止
+- 改变角色设定
+- 删除主要事件
+- 颠覆已有真相
+- 削弱核心冲突
+
+## 异常处理
+- 审计报告缺失：跳过修订，警告
+- 修订超时：保留已修内容
+- 修订失败：跳过修订，附警告
+- 修订引入新问题：触发二次审计
+
+## 数据流
+
+```
+[协调者] 调用修订师
+   ↓
+[修订师] 读取审计报告
+   ↓
+[修订师] 读取待修订内容
+   ↓
+[修订师] 遍历 P0/P1
+   ↓
+[修订师] 应用修订
+   ↓
+[修订师] 写入 temp/revised.md
+   ↓
+[修订师] 追加修订报告
+   ↓
+[协调者] 读取并展示
+```
+
+## 修订后二次审计
+
+修订后自动触发二次审计：
+- 检查修订是否修复了问题
+- 检查是否引入新问题
+- 如有 P0：再次修订
+- 如无 P0：通过

package/skill/agents/writer.md

@@ -0,0 +1,213 @@
+# 写手（Writer）
+
+## 职责
+把字打出来：章节正文生成、黄金开篇（第一章）、文风应用、角色模拟写作。
+
+## 触发条件
+- /novel-maker write
+- /novel-maker expand
+- 协调者调度
+- 审计要求重写
+
+## 输入
+
+### 创作规划
+- 大纲（novels/outline.md）
+- 卷计划（novels/volume-XX/plan.md）
+- 幕计划（novels/volume-XX/act-plan.md）
+- 本章目标（来自 plan）
+
+### 真相文件
+- 角色（truth-files/characters.md）
+- 世界状态（truth-files/current-state.md）
+- 世界观（truth-files/world-setting.md）
+- 力量体系（truth-files/power-system.md）
+- 伏笔表（truth-files/pending-hooks.md）
+- 情感弧线（truth-files/emotional-arcs.md）
+
+### 前情
+- 前 2-3 章摘要（novels/volume-XX/summaries/）
+- 阶段总结（如有）
+
+### 风格配置
+- 文风（styles/）
+- 创作宪法（constitution.md）
+- 文风库（styles/authors/）
+
+## 输出
+
+### 1. 章节草稿
+文件位置：`temp/draft.md`
+- 完整章节正文
+- 字数预检（2200-2800）
+
+### 2. 重写章节
+文件位置：覆盖当前章节文件（novels/volume-XX/chapters/chXX.md）
+
+### 3. 扩写章节
+文件位置：在当前章节末尾追加
+
+### 4. 黄金开篇（仅第一章）
+文件位置：直接输出给用户
+- 3 版开篇，每版 50 字
+- 用户选择最佳版本
+
+## 工作流
+
+### 常规写作流程
+
+1. 读取所有输入
+2. 构建上下文：
+   - 角色状态 + 世界设定 + 前情摘要 + 本章目标
+3. 应用角色模拟写作（如果是关键章节）
+4. 应用文风（从 22 位作者中选择）
+5. 写入章节草稿到 `temp/draft.md`
+6. 字数预检（2200-2800）
+
+### 第一章特殊流程
+
+1. 触发黄金开篇（生成 3 版）
+2. 用户选择开篇版本
+3. 基于选定开篇继续写作
+4. 字数预检
+5. 写入 `temp/draft.md`
+
+### 扩写流程
+
+1. 读取当前章节
+2. 识别扩写位置（结尾/中间）
+3. 生成新内容
+4. 追加到原章节
+5. 字数检查
+
+## 字数要求
+
+- 每章 2200-2800 字（默认区间）
+- 不足 2200：自动扩写
+- 超过 2800：自动精简
+- 强制规则：写完立即检查，不达标自动调整
+
+## 角色模拟写作
+
+### 步骤 1：角色模拟
+
+为每个出场角色创建思维模型：
+- 性格特征
+- 说话方式
+- 行为习惯
+- 情感状态
+
+### 步骤 2：场景演绎
+
+按时间顺序"演"一遍场景：
+- 角色 A 说什么
+- 角色 B 怎么反应
+- 环境变化
+
+### 步骤 3：改写为正文
+
+将模拟结果改写为小说正文：
+- 添加描写
+- 添加氛围渲染
+- 保持对话自然感
+
+## 文风应用
+
+### 文风选择
+
+根据题材自动推荐：
+
+| 题材 | 推荐文风 |
+|------|---------|
+| 玄幻修仙 | 天蚕土豆、辰东 |
+| 都市搞笑 | 弈青峰、会说话的肘子 |
+| 仙侠探案 | 卖报小郎君 |
+| 悬疑诡秘 | 爱潜水的乌贼 |
+| 历史权谋 | 猫腻、愤怒的香蕉 |
+| 凡人流 | 忘语、言归正传 |
+| 电竞网游 | 蝴蝶蓝 |
+| 无限流 | 三天两觉、杀虫队队员 |
+| 盗墓探险 | 天下霸唱 |
+| 极道诡异 | 滚开 |
+| 稳健搞笑 | 言归正传 |
+| 多神话热血 | 三九音域 |
+| 悬疑推理 | 杀虫队队员 |
+
+### 文风应用规则
+
+- 主风格：选定的 1-2 位作者
+- 场景切换：不同场景可使用不同文风
+- 自定义：学习用户个人写作风格
+
+## 异常处理
+- 字数不达标：自动扩写或重试
+- 上下文过长：分章节读取
+- 角色 OOC：触发审计预警
+- 真相文件缺失：使用默认设定并警告
+
+## 黄金开篇锻造
+
+### 3 版开篇生成
+
+针对第一章，生成 3 版不同风格的开篇：
+
+#### 版本 A：悬念型
+- 以神秘事件/危机开场
+- 立即制造紧张感
+
+#### 版本 B：反差型
+- 展示主角"表面"的弱势
+- 暗示实际强大
+
+#### 版本 C：冲突型
+- 直接进入冲突场景
+- 无铺垫开场
+
+### 避雷针检查
+
+- 避免"穿越/重生时"+ 1 句话总结的俗套
+- 避免"我叫XXX，今年XX岁"自我介绍
+- 避免大段背景介绍
+- 前 500 字必须有钩子
+
+## 上下文构建模板
+
+**推荐方式**：使用 `build_write_context.py` 自动生成精简上下文（~3000 token），替代手动读取 15+ 个文件：
+
+```bash
+python scripts/writer/build_write_context.py novels/volume-01/chapters/ch15.md --json
+```
+
+输出结构化 JSON，包含：真相文件摘要 / 前2章摘要 / 大纲目标 / 创作宪法要点
+
+**手动方式**（当脚本不可用时）：
+
+```markdown
+【写作上下文】
+## 角色状态 → 来自 truth-files/characters.md + current-state.md
+## 世界设定 → 来自 truth-files/world-setting.md + power-system.md  
+## 前情摘要 → 来自 .novel-maker/summaries/ + 前 2 章摘要
+## 本章目标 → 来自 outline.md / volume-XX/plan.md
+## 文风 → [已选文风]
+## 创作宪法 → [宪法要点]
+```
+
+## 数据流
+
+```
+[协调者] 调用写手
+   ↓
+[写手] 读取所有输入
+   ↓
+[写手] 构建上下文
+   ↓
+[写手] 应用角色模拟（如需要）
+   ↓
+[写手] 应用文风
+   ↓
+[写手] 写入 temp/draft.md
+   ↓
+[写手] 字数预检
+   ↓
+[审计师] 接管
+```

package/skill/arc-templates/README.md

@@ -0,0 +1,43 @@
+# 篇章弧线模板
+
+> 为卷级规划提供结构化的弧线模板
+
+## 使用方式
+
+在幕规划时，选择合适的弧线模板：
+
+```
+/novel-maker act 使用挑战弧模板规划下一幕
+```
+
+## 弧线类型
+
+### 通用弧线（6种）
+- 挑战弧：准备→挑战→失败→成长→再战→胜利
+- 探索弧：发现→探索→危险→收获→揭秘
+- 冲突弧：摩擦→升级→对决→后果→新平衡
+- 悬疑弧：线索→调查→误导→真相→反转
+- 成长弧：困境→学习→实践→突破→蜕变
+- 关系弧：相遇→冲突→理解→和解→深化
+
+### 题材特定弧线
+- 修仙：境界突破弧、宗门大比弧、秘境探险弧、渡劫弧
+- 都市：商战弧、复仇弧、崛起弧、感情弧
+- 无限流：副本弧、强化弧、团队弧、BOSS战弧
+- 悬疑：案件弧、推理弧、反转弧
+- 历史：权谋弧、战役弧、改革弧
+- 科幻：科技突破弧、星际探索弧、AI觉醒弧、文明接触弧
+- 游戏：升级弧、副本弧、公会战弧、竞技弧
+- 末世：生存弧、势力争霸弧、异能觉醒弧、人性考验弧
+- 西幻：冒险弧、种族冲突弧、王国争霸弧、魔法觉醒弧
+- 武侠：江湖恩怨弧、门派争霸弧、武功突破弧、侠义之路弧
+- 言情：甜蜜恋爱弧、虐恋弧、追妻火葬场弧、日久生情弧
+
+## 弧线模板结构
+
+每个弧线模板包含：
+- **阶段定义**：每个阶段的目标和关键事件
+- **章节建议**：每个阶段的建议章节数
+- **情绪曲线**：每个阶段的情绪走向
+- **关键场景**：必须包含的关键场景
+- **注意事项**：常见错误和避坑指南

package/skill/arc-templates/apocalypse/ability.md

@@ -0,0 +1,81 @@
+# 异能觉醒弧
+
+> 末世中主角觉醒特殊能力，经历探索与成长，最终突破极限，完成进化
+
+## 弧线结构
+
+觉醒 → 探索 → 成长 → 冲突 → 突破 → 进化
+
+## 阶段定义
+
+### 阶段 1：觉醒（1-2章）
+**目标：** 主角首次觉醒异能
+**关键事件：**
+- 末世环境中遭遇生死危机
+- 异能首次爆发，救主角一命
+- 主角对自身变化感到困惑和恐惧
+**情绪走向：** 震惊 → 困惑
+**章节建议：** 1-2章
+
+### 阶段 2：探索（2-3章）
+**目标：** 探索异能的特性和边界
+**关键事件：**
+- 测试异能的各种效果
+- 发现异能的限制和副作用
+- 遇到其他异能者，交流经验
+**情绪走向：** 好奇 → 兴奋
+**章节建议：** 2-3章
+
+### 阶段 3：成长（2-3章）
+**目标：** 异能逐渐增强，开始应用
+**关键事件：**
+- 用异能解决生存问题
+- 在战斗中使用异能，效果显著
+- 异能开始变异或进化
+**情绪走向：** 自信 → 热血
+**章节建议：** 2-3章
+
+### 阶段 4：冲突（2-3章）
+**目标：** 异能引发冲突和觊觎
+**关键事件：**
+- 其他势力觊觎主角的异能
+- 被迫卷入异能者之间的争斗
+- 异能失控，造成意外伤害
+**情绪走向：** 紧张 → 恐惧
+**章节建议：** 2-3章
+
+### 阶段 5：突破（2-3章）
+**目标：** 突破异能限制，达到新境界
+**关键事件：**
+- 遭遇绝境，异能爆发
+- 突破原有极限，获得新能力
+- 付出巨大代价（寿命/记忆/人性）
+**情绪走向：** 挣扎 → 坚定
+**章节建议：** 2-3章
+
+### 阶段 6：进化（1-2章）
+**目标：** 完成最终进化，超越人类
+**关键事件：**
+- 异能完全觉醒，形态改变
+- 成为超越人类的存在
+- 面临成为"神"还是"人"的抉择
+**情绪走向：** 震撼 → 深思
+**章节建议：** 1-2章
+
+## 关键场景
+
+1. **首次觉醒**：生死关头异能爆发，主角震惊于自身变化
+2. **异能失控**：异能失控伤害无辜，主角陷入自责
+3. **最终进化**：主角完成进化，超越人类形态
+
+## 注意事项
+
+- **能力体系**：异能设定要合理，有明确的规则和限制
+- **成长代价**：异能成长要有代价，不能太轻松
+- **人性探讨**：超越人类后的人性问题要深刻
+- **战斗描写**：异能战斗要有创意，不能太套路
+
+## 适用题材
+
+- 末日异能、超能力、进化题材
+- 适合描写能力成长、人性探讨、超越极限