novel-maker 2.2.0

package/skill/hooks/README.md

@@ -0,0 +1,102 @@
+# Hook 系统
+
+## 概述
+
+Hook 系统提供5个自动化钩子，在写作流程的关键节点自动执行预定义操作，提升写作效率。
+
+## Hook 列表
+
+| Hook | 触发时机 | 功能 |
+|------|----------|------|
+| [context-injection](context-injection.md) | 写作前 | 自动注入上下文（角色状态、世界观、前情摘要） |
+| [intent-detection](intent-detection.md) | 用户输入时 | 检测用户意图，自动路由到对应功能 |
+| [chapter-complete](chapter-complete.md) | 章节完成后 | 自动更新大纲、记忆文件、伏笔表 |
+| [review-trigger](review-trigger.md) | 每章完成后 | 自动触发质量审查 |
+| [summary-trigger](summary-trigger.md) | 每10章/50章后 | 自动生成阶段总结 |
+
+## 工作原理
+
+```
+用户输入 → [intent-detection] → 识别意图 → 路由到对应功能
+                                        ↓
+写作前 → [context-injection] → 注入上下文 → 开始写作
+                                        ↓
+写作中 → AI 生成内容 → 用户确认
+                                        ↓
+章节完成 → [chapter-complete] → 更新大纲/记忆/伏笔
+                                        ↓
+           [review-trigger] → 质量审查 → 生成报告
+                                        ↓
+           [summary-trigger] → 检查是否需要总结 → 生成总结
+```
+
+## 使用方式
+
+### 自动触发
+
+Hook 会在对应时机自动触发，无需手动调用。
+
+### 手动触发
+
+```
+/novel-maker hook context-injection  # 手动注入上下文
+/novel-maker hook chapter-complete   # 手动触发章节完成流程
+/novel-maker hook review-trigger     # 手动触发质量审查
+/novel-maker hook summary-trigger    # 手动触发阶段总结
+```
+
+### 禁用 Hook
+
+```
+/novel-maker hook disable context-injection  # 禁用上下文注入
+/novel-maker hook enable context-injection   # 启用上下文注入
+/novel-maker hook status                     # 查看 Hook 状态
+```
+
+## 配置
+
+Hook 配置文件位于 `.novel-maker/config.json`：
+
+```json
+{
+  "hooks": {
+    "context-injection": {
+      "enabled": true,
+      "priority": 1
+    },
+    "intent-detection": {
+      "enabled": true,
+      "priority": 0
+    },
+    "chapter-complete": {
+      "enabled": true,
+      "priority": 2
+    },
+    "review-trigger": {
+      "enabled": true,
+      "priority": 3
+    },
+    "summary-trigger": {
+      "enabled": true,
+      "priority": 4
+    }
+  }
+}
+```
+
+## 执行顺序
+
+Hook 按优先级顺序执行：
+
+1. **intent-detection** (优先级 0) - 最先执行，识别用户意图
+2. **context-injection** (优先级 1) - 写作前注入上下文
+3. **chapter-complete** (优先级 2) - 章节完成后更新状态
+4. **review-trigger** (优先级 3) - 触发质量审查
+5. **summary-trigger** (优先级 4) - 检查是否需要总结
+
+## 注意事项
+
+1. Hook 执行不影响主流程，即使 Hook 失败也不会中断写作
+2. Hook 结果会自动应用到项目中
+3. 可以通过配置禁用不需要的 Hook
+4. Hook 执行日志保存在 `.novel-maker/logs/hooks.log`

package/skill/hooks/chapter-complete.md

@@ -0,0 +1,176 @@
+# Chapter Complete Hook
+
+## 概述
+
+在章节完成后自动更新大纲、记忆文件、伏笔表等，确保项目状态与写作进度同步。
+
+## 触发时机
+
+- `/novel-maker write` 执行完成后
+- 用户确认章节内容后
+
+## 更新内容
+
+### 1. 更新大纲
+
+**操作**：标记当前章节为已完成状态
+
+**文件**：`novels/outline.md`
+
+**更新内容**：
+- 将章节状态从"待写"改为"已完成"
+- 添加章节完成时间
+- 添加章节摘要
+
+**示例**：
+```markdown
+## 第三幕：高潮
+
+### 第50章 王都风云 [已完成] 2026-06-26
+- 林风进入王都
+- 遭遇皇室势力
+- 古剑·风吟封印觉醒
+- 字数：3200字
+```
+
+### 2. 更新记忆文件
+
+**操作**：更新世界状态和角色状态
+
+**文件**：`truth-files/current-state.md`
+
+**更新内容**：
+- 角色状态变化
+- 世界状态变化
+- 新获得的物品/技能
+
+**示例**：
+```markdown
+## 世界状态
+
+### 角色状态
+- 林风：高级修士，当前在王都，获得古剑·风吟（已解封）
+- 苏雨：医修，当前在林风身边
+
+### 物品状态
+- 古剑·风吟：已解封，剑灵觉醒
+```
+
+### 3. 更新伏笔表
+
+**操作**：标记伏笔回收状态
+
+**文件**：`truth-files/pending-hooks.md`
+
+**更新内容**：
+- 标记已回收的伏笔
+- 添加新埋设的伏笔
+- 更新伏笔状态
+
+**示例**：
+```markdown
+## 伏笔表
+
+### 古剑·风吟 [已回收]
+- 埋设：第3章，神秘老人赠剑
+- 回收：第50章，剑中封印觉醒
+- 状态：已回收
+
+### 神秘老人身份 [未回收]
+- 埋设：第3章，老人身份成谜
+- 预期回收：第80章
+- 状态：未回收
+```
+
+### 4. 生成章节摘要
+
+**操作**：生成本章摘要供后续参考
+
+**文件**：`.novel-maker/summaries/chapter-XX-summary.md`
+
+**摘要内容**：
+- 章节主要事件
+- 角色状态变化
+- 新埋设的伏笔
+- 关键转折点
+
+**示例**：
+```markdown
+# 第50章摘要
+
+## 主要事件
+- 林风进入王都
+- 遭遇皇室势力阻挠
+- 古剑·风吟封印觉醒，剑灵现身
+
+## 角色变化
+- 林风：获得剑灵协助，实力提升
+- 苏雨：与林风汇合
+
+## 伏笔
+- 新埋设：皇室势力的目的
+- 已回收：古剑·风吟封印
+
+## 关键转折
+- 剑灵觉醒，揭示古剑来历
+```
+
+## 实现逻辑
+
+```python
+def chapter_complete(project_dir: str, chapter_num: int, chapter_content: str):
+    """章节完成后的自动更新"""
+    
+    # 1. 更新大纲
+    update_outline(project_dir, chapter_num, status="已完成")
+    
+    # 2. 更新记忆文件
+    update_current_state(project_dir, chapter_content)
+    
+    # 3. 更新伏笔表
+    update_pending_hooks(project_dir, chapter_num, chapter_content)
+    
+    # 4. 生成章节摘要
+    generate_chapter_summary(project_dir, chapter_num, chapter_content)
+```
+
+## 输出格式
+
+```markdown
+【章节完成更新】
+
+✅ 大纲已更新：第50章标记为已完成
+✅ 记忆文件已更新：角色状态、世界状态
+✅ 伏笔表已更新：标记1个伏笔回收，新增1个伏笔
+✅ 章节摘要已生成：.novel-maker/summaries/chapter-50-summary.md
+
+【幕内进度】
+当前幕：第三幕 - 高潮
+进度：第50章 / 共60章（83%）
+下一章：第51章 - 皇室阴谋
+```
+
+## 配置选项
+
+```json
+{
+  "chapter-complete": {
+    "enabled": true,
+    "priority": 2,
+    "options": {
+      "update_outline": true,
+      "update_memory": true,
+      "update_hooks": true,
+      "generate_summary": true,
+      "show_progress": true
+    }
+  }
+}
+```
+
+## 注意事项
+
+1. 章节完成后必须执行此 Hook，确保项目状态同步
+2. 如果某些文件不存在，会跳过对应更新
+3. 更新操作是增量的，不会覆盖已有内容
+4. 章节摘要会保存供后续章节参考

package/skill/hooks/context-injection.md

@@ -0,0 +1,152 @@
+# Context Injection Hook
+
+## 概述
+
+在写作前自动注入上下文信息，包括角色状态、世界观设定、前情摘要等，确保 AI 写作时有足够的背景信息。
+
+## 触发时机
+
+- `/novel-maker write` 执行前
+- 用户开始新章节写作时
+
+## 注入内容
+
+### 1. 角色状态
+
+**来源**：`truth-files/characters.md` + `truth-files/current-state.md`
+
+**注入内容**：
+- 主要角色当前状态（等级、位置、情绪）
+- 角色关系网络
+- 角色近期经历
+
+**示例**：
+```markdown
+【角色状态】
+- 林风：高级修士，当前在王都，情绪：警惕
+- 苏雨：医修，当前在林风身边，情绪：担忧
+- 关系：林风与苏雨是恋人关系
+```
+
+### 2. 世界观设定
+
+**来源**：`truth-files/world-setting.md` + `truth-files/power-system.md`
+
+**注入内容**：
+- 当前地点设定
+- 相关力量体系规则
+- 社会制度约束
+
+**示例**：
+```markdown
+【世界观设定】
+- 当前地点：王都，大陆中央，政治经济中心
+- 修炼体系：剑修/法修/体修，等级：初级→中级→高级→大师→宗师
+- 社会制度：皇权至上，修士有特权但受皇室约束
+```
+
+### 3. 前情摘要
+
+**来源**：`.novel-maker/summaries/` + 前2章内容
+
+**注入内容**：
+- 前2章摘要
+- 当前剧情进展
+- 未解决的伏笔
+
+**示例**：
+```markdown
+【前情摘要】
+- 第48章：林风击败张天，获得古剑·风吟的线索
+- 第49章：林风与苏雨汇合，准备前往王都
+- 未解决伏笔：神秘老人身份、古籍预言、林风的怪病
+```
+
+### 4. 本章目标
+
+**来源**：`outline.md` / `volume-XX/plan.md`
+
+**注入内容**：
+- 本章在大纲中的定位
+- 预期剧情走向
+- 需要埋设/回收的伏笔
+
+**示例**：
+```markdown
+【本章目标】
+- 大纲定位：第50章，第三幕高潮
+- 预期走向：林风进入王都，遭遇皇室势力
+- 伏笔回收：古剑·风吟封印觉醒
+```
+
+## 实现逻辑
+
+```python
+def context_injection(project_dir: str, chapter_num: int) -> str:
+    """注入上下文信息"""
+    context = []
+    
+    # 1. 加载角色状态
+    characters = load_characters(project_dir)
+    current_state = load_current_state(project_dir)
+    context.append(format_character_status(characters, current_state))
+    
+    # 2. 加载世界观设定
+    world_setting = load_world_setting(project_dir)
+    power_system = load_power_system(project_dir)
+    context.append(format_world_setting(world_setting, power_system))
+    
+    # 3. 加载前情摘要
+    summaries = load_recent_summaries(project_dir, count=2)
+    context.append(format_previous_summary(summaries))
+    
+    # 4. 加载本章目标
+    outline = load_outline(project_dir)
+    chapter_goal = extract_chapter_goal(outline, chapter_num)
+    context.append(format_chapter_goal(chapter_goal))
+    
+    return "\n\n".join(context)
+```
+
+## 输出格式
+
+```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
+[本章目标内容]
+```
+
+## 配置选项
+
+```json
+{
+  "context-injection": {
+    "enabled": true,
+    "priority": 1,
+    "options": {
+      "include_characters": true,
+      "include_world_setting": true,
+      "include_previous_summary": true,
+      "include_chapter_goal": true,
+      "summary_count": 2,
+      "max_context_length": 2000
+    }
+  }
+}
+```
+
+## 注意事项
+
+1. 上下文注入不会修改任何文件，只读取信息
+2. 如果某些文件不存在，会跳过对应部分
+3. 上下文长度有上限，避免占用过多 token
+4. 可以通过配置禁用不需要的部分

package/skill/hooks/intent-detection.md

@@ -0,0 +1,183 @@
+# Intent Detection Hook
+
+## 概述
+
+在用户输入时自动检测意图，将自然语言请求路由到对应的功能模块，提供更智能的交互体验。
+
+## 触发时机
+
+- 用户输入任何文本时
+- 在其他 Hook 执行前
+
+## 意图类型
+
+### 1. 写作意图
+
+**关键词**：写、创作、续写、继续、下一章、开始写
+
+**路由目标**：`/novel-maker write`
+
+**示例**：
+```
+用户：帮我写第一章
+→ 识别为写作意图
+→ 执行 /novel-maker write 写第一章
+
+用户：继续写，主角遇到了敌人
+→ 识别为写作意图
+→ 执行 /novel-maker write 继续写，主角遇到了敌人
+```
+
+### 2. 查询意图
+
+**关键词**：什么、谁、哪里、怎么、为什么、查询、查看
+
+**路由目标**：`/novel-maker query`
+
+**示例**：
+```
+用户：林风是什么等级？
+→ 识别为查询意图（角色查询）
+→ 执行 /novel-maker query 林风是什么等级？
+
+用户：第三章发生了什么？
+→ 识别为查询意图（剧情查询）
+→ 执行 /novel-maker query 第三章发生了什么？
+```
+
+### 3. 审查意图
+
+**关键词**：检查、审查、看看、有没有问题、质量、矛盾
+
+**路由目标**：`/novel-maker review`
+
+**示例**：
+```
+用户：帮我看看这一章
+→ 识别为审查意图
+→ 执行 /novel-maker review
+
+用户：检查有没有矛盾
+→ 识别为审查意图
+→ 执行 /novel-maker review consistency
+```
+
+### 4. 规划意图
+
+**关键词**：大纲、规划、计划、下一幕、走向、剧情
+
+**路由目标**：`/novel-maker plan` 或 `/novel-maker act`
+
+**示例**：
+```
+用户：帮我生成总大纲
+→ 识别为规划意图
+→ 执行 /novel-maker plan 帮我生成总大纲
+
+用户：下一幕怎么走
+→ 识别为规划意图
+→ 执行 /novel-maker act 下一幕怎么走
+```
+
+### 5. 设置意图
+
+**关键词**：文风、风格、切换、设置、配置
+
+**路由目标**：`/novel-maker style`
+
+**示例**：
+```
+用户：换个文风
+→ 识别为设置意图
+→ 执行 /novel-maker style
+
+用户：用辰东的风格
+→ 识别为设置意图
+→ 执行 /novel-maker style 用辰东的风格
+```
+
+## 实现逻辑
+
+```python
+def detect_intent(user_input: str) -> dict:
+    """检测用户意图"""
+    intent_keywords = {
+        "write": ["写", "创作", "续写", "继续", "下一章", "开始写"],
+        "query": ["什么", "谁", "哪里", "怎么", "为什么", "查询", "查看"],
+        "review": ["检查", "审查", "看看", "有没有问题", "质量", "矛盾"],
+        "plan": ["大纲", "规划", "计划", "下一幕", "走向", "剧情"],
+        "style": ["文风", "风格", "切换", "设置", "配置"]
+    }
+    
+    # 统计每个意图的关键词匹配数
+    intent_scores = {}
+    for intent, keywords in intent_keywords.items():
+        score = sum(1 for keyword in keywords if keyword in user_input)
+        intent_scores[intent] = score
+    
+    # 返回得分最高的意图
+    if max(intent_scores.values()) > 0:
+        primary_intent = max(intent_scores, key=intent_scores.get)
+        return {
+            "intent": primary_intent,
+            "confidence": intent_scores[primary_intent],
+            "input": user_input
+        }
+    
+    # 默认为写作意图
+    return {
+        "intent": "write",
+        "confidence": 0,
+        "input": user_input
+    }
+```
+
+## 路由逻辑
+
+```python
+def route_to_function(intent: str, user_input: str) -> str:
+    """根据意图路由到对应功能"""
+    routes = {
+        "write": "/novel-maker write",
+        "query": "/novel-maker query",
+        "review": "/novel-maker review",
+        "plan": "/novel-maker plan",
+        "style": "/novel-maker style"
+    }
+    
+    command = routes.get(intent, "/novel-maker write")
+    return f"{command} {user_input}"
+```
+
+## 输出格式
+
+```markdown
+【意图检测】
+- 输入：帮我写第一章
+- 检测意图：write（写作意图）
+- 置信度：3
+- 路由命令：/novel-maker write 帮我写第一章
+```
+
+## 配置选项
+
+```json
+{
+  "intent-detection": {
+    "enabled": true,
+    "priority": 0,
+    "options": {
+      "default_intent": "write",
+      "confidence_threshold": 1,
+      "show_detection_result": false
+    }
+  }
+}
+```
+
+## 注意事项
+
+1. 意图检测是第一优先级的 Hook，最先执行
+2. 如果置信度低于阈值，使用默认意图
+3. 可以通过配置显示检测结果，方便调试
+4. 意图检测结果会影响后续 Hook 的执行