novel-maker 2.2.0

package/skill/rules/smart-query.md

@@ -0,0 +1,263 @@
+# 智能查询规则
+
+## 核心原则
+
+智能查询系统提供4种意图的快速查询，帮助用户快速获取小说相关信息，无需手动翻阅文档。
+
+---
+
+## 查询类型
+
+### 1. 角色查询
+
+**查询内容**：
+- 角色设定（姓名、身份、背景）
+- 角色状态（等级、位置、情绪）
+- 角色关系（血缘、师徒、敌对、恋人）
+- 角色技能（能力、功法、武器）
+
+**示例查询**：
+```
+用户：林风是什么等级？
+AI：林风当前等级为高级修士，擅长剑法，拥有"御风术"技能。
+
+用户：苏雨和林风什么关系？
+AI：苏雨和林风是恋人关系，第3章相遇，第20章表白。
+
+用户：列出所有反派角色
+AI：当前主要反派角色：
+1. 张天（林风的师兄，黑化叛变）
+2. 魔尊（终极BOSS，幕后黑手）
+```
+
+**查询来源**：
+- `truth-files/characters.md` - 角色档案
+- `truth-files/current-state.md` - 世界状态
+- `novels/volume-XX/chapters/` - 章节内容
+
+### 2. 设定查询
+
+**查询内容**：
+- 世界观设定（地理、历史、文化）
+- 力量体系（等级、修炼、技能）
+- 社会制度（等级、法律、习俗）
+- 特殊设定（魔法、科技、规则）
+
+**示例查询**：
+```
+用户：这个世界有几种修炼体系？
+AI：本世界有3种修炼体系：
+1. 剑修体系（初级→中级→高级→大师→宗师）
+2. 法修体系（初级→中级→高级→大师→宗师）
+3. 体修体系（初级→中级→高级→大师→宗师）
+
+用户：王都在哪里？
+AI：王都位于大陆中央，是政治、经济、文化中心。从北境骑马需要7天，从东海坐船需要3天。
+```
+
+**查询来源**：
+- `truth-files/world-setting.md` - 世界观设定
+- `truth-files/power-system.md` - 力量体系
+- `skill/genre-packs/` - 题材包设定
+
+### 3. 剧情查询
+
+**查询内容**：
+- 章节摘要（某章发生了什么）
+- 事件追踪（某事件的详细过程）
+- 角色经历（某角色遇到过什么）
+- 剧情进展（当前剧情到哪里）
+
+**示例查询**：
+```
+用户：第三章发生了什么？
+AI：第三章主要内容：
+- 林风在山林中遇到神秘老人
+- 老人赠予林风一把古剑
+- 林风发现古剑有封印
+- 章末伏笔：老人身份成谜
+
+用户：主角遇到过哪些敌人？
+AI：林风遇到的主要敌人：
+1. 第5章：山贼（被林风击败）
+2. 第15章：张天（师兄，黑化后成为敌人）
+3. 第30章：魔尊手下（试探性攻击）
+```
+
+**查询来源**：
+- `novels/volume-XX/chapters/` - 章节内容
+- `.novel-maker/summaries/` - 阶段总结
+- `novels/outline.md` - 总大纲
+
+### 4. 伏笔查询
+
+**查询内容**：
+- 伏笔状态（已埋设/已回收/未回收）
+- 伏笔详情（埋设章节、内容、预期回收）
+- 伏笔关联（与其他伏笔的关系）
+- 回收建议（如何回收某个伏笔）
+
+**示例查询**：
+```
+用户：有哪些未回收的伏笔？
+AI：当前未回收的伏笔：
+1. 第3章：神秘老人赠剑（预期第50章回收）
+2. 第10章：古籍预言（预期第80章回收）
+3. 第15章：林风的怪病（未设定回收点）
+
+用户：神秘老人的剑后来怎样了？
+AI：神秘老人的剑（古剑·风吟）：
+- 第3章埋设：老人赠剑，剑有封印
+- 第20章进展：林风尝试解封，失败
+- 第50章回收：剑中封印觉醒，释放剑灵
+- 当前状态：已回收
+```
+
+**查询来源**：
+- `truth-files/pending-hooks.md` - 伏笔表
+- `novels/volume-XX/chapters/` - 章节内容
+
+---
+
+## 查询引擎实现
+
+### 查询意图识别
+
+```python
+def detect_query_intent(query: str) -> str:
+    """识别查询意图"""
+    # 角色相关关键词
+    character_keywords = ["角色", "人物", "主角", "反派", "等级", "技能", "关系", "谁", "名字"]
+    
+    # 设定相关关键词
+    setting_keywords = ["世界", "设定", "体系", "规则", "地理", "历史", "制度", "魔法", "修炼"]
+    
+    # 剧情相关关键词
+    plot_keywords = ["剧情", "章节", "发生", "事件", "遇到", "经历", "进展", "故事"]
+    
+    # 伏笔相关关键词
+    hook_keywords = ["伏笔", "埋设", "回收", "悬念", "谜团", "暗示", "铺垫"]
+    
+    # 关键词匹配
+    for keyword in character_keywords:
+        if keyword in query:
+            return "character"
+    
+    for keyword in setting_keywords:
+        if keyword in query:
+            return "setting"
+    
+    for keyword in plot_keywords:
+        if keyword in query:
+            return "plot"
+    
+    for keyword in hook_keywords:
+        if keyword in query:
+            return "hook"
+    
+    # 默认为剧情查询
+    return "plot"
+```
+
+### 查询路由
+
+```python
+def route_query(intent: str, query: str) -> str:
+    """根据意图路由查询"""
+    if intent == "character":
+        return query_character(query)
+    elif intent == "setting":
+        return query_setting(query)
+    elif intent == "plot":
+        return query_plot(query)
+    elif intent == "hook":
+        return query_hook(query)
+    else:
+        return "抱歉，我无法理解您的查询。请尝试更具体的描述。"
+```
+
+### 查询结果格式化
+
+```python
+def format_query_result(intent: str, result: dict) -> str:
+    """格式化查询结果"""
+    if intent == "character":
+        return format_character_result(result)
+    elif intent == "setting":
+        return format_setting_result(result)
+    elif intent == "plot":
+        return format_plot_result(result)
+    elif intent == "hook":
+        return format_hook_result(result)
+    else:
+        return str(result)
+```
+
+---
+
+## 使用方式
+
+### 指令触发
+
+```
+/novel-maker query 林风是什么等级？
+/novel-maker query 有哪些未回收的伏笔？
+/novel-maker query 第三章发生了什么？
+```
+
+### 自然语言触发
+
+```
+用户：主角现在什么境界？
+AI：[自动识别为角色查询] 林风当前等级为高级修士...
+
+用户：这个世界有几种修炼体系？
+AI：[自动识别为设定查询] 本世界有3种修炼体系...
+```
+
+### 查询结果展示
+
+```markdown
+## 查询结果
+
+**查询**：林风是什么等级？
+
+**结果**：
+- **当前等级**：高级修士
+- **擅长技能**：剑法、御风术
+- **武器**：古剑·风吟（已解封）
+- **状态**：健康，正在前往王都
+
+**来源**：
+- 角色档案：truth-files/characters.md
+- 世界状态：truth-files/current-state.md
+- 最新章节：第50章
+```
+
+---
+
+## 查询优化
+
+### 1. 缓存机制
+
+- 缓存常用查询结果
+- 缓存失效策略：章节更新后自动失效
+
+### 2. 模糊匹配
+
+- 支持角色别名（如"主角"→"林风"）
+- 支持同义词（如"等级"→"境界"）
+
+### 3. 上下文关联
+
+- 记忆用户之前的查询
+- 支持追问（如"他有什么技能？"）
+
+---
+
+## 参考资源
+
+- 角色档案：`truth-files/characters.md`
+- 世界状态：`truth-files/current-state.md`
+- 伏笔表：`truth-files/pending-hooks.md`
+- 章节内容：`novels/volume-XX/chapters/`

package/skill/scripts/README.md

@@ -0,0 +1,380 @@
+# 辅助脚本
+
+预处理章节数据和项目文件，将全文（~4000 token）压缩为结构化 JSON（~200 token），**节省约 90% token 消耗**。
+
+所有脚本共用 `nm_utils.py` 公共模块，提供 Markdown 清理、字数统计、角色提取、地点提取、钩子检测、章节排序、摘要生成、节奏评级、大纲解析、真相文件读取等工具函数。
+
+---
+
+## nm_utils.py — 公共工具模块
+
+所有脚本共用的基础函数，脚本通过 `from nm_utils import ...` 调用：
+
+| 函数 | 说明 |
+|------|------|
+| `clean_markdown(text)` | 去除 Markdown 格式标记 |
+| `count_chinese(text)` | 统计中文字符数 |
+| `extract_title(content)` | 提取章节标题 |
+| `read_chapter(filepath)` | 读取章节，返回 `(raw, title, clean, wc)` |
+| `extract_content_from_chapter(path)` | 提取章节正文（跳过标题行） |
+| `extract_characters(text)` | 从对话模式提取角色名（已过滤代词/动词噪音） |
+| `extract_locations(text)` | 从位移模式提取地点名 |
+| `detect_hook(text)` | 检测章节结尾钩子类型（6种） |
+| `detect_hook_type_from_patterns(text)` | 用预编译正则快速检测钩子类型 |
+| `generate_summary(text)` | 生成开头+结尾摘要 |
+| `detect_structure(text)` | 检测对话/动作/描写比例 |
+| `estimate_pacing(text)` | 估算章节节奏等级（S1-S5） |
+| `parse_outline_headings(text)` | 解析 Markdown 大纲标题树 |
+| `read_truth_section(filepath)` | 解析真相文件分段内容 |
+| `chapter_sort_key(filepath)` | 章节文件名排序键（支持中文数字） |
+| `list_chapters(dir, recent_n)` | 列出目录中排序后的章节文件 |
+
+---
+
+## init_guide.py — 初始化引导脚本
+
+**用途：** 交互式引导脚本，帮助用户完成初始化流程
+
+**使用方式：**
+```bash
+python scripts/common/init_guide.py [--ide trae|claude] [--auto] [--verify]
+```
+
+**参数说明：**
+- `--ide`: 指定IDE类型（trae 或 claude）
+- `--auto`: 自动模式，使用默认配置
+- `--verify`: 验证安装是否成功
+
+**示例：**
+```bash
+# 交互式引导
+python scripts/common/init_guide.py
+
+# 指定IDE类型
+python scripts/common/init_guide.py --ide trae
+
+# 自动模式
+python scripts/common/init_guide.py --auto
+
+# 验证安装
+python scripts/common/init_guide.py --verify
+```
+
+---
+
+## 统一分析脚本 (推荐)
+
+### analyze.py — 三合一分析
+
+整合了 `chapter_info.py` + `style_check.py` + `hook_report.py` 的功能,支持三种模式:
+
+```bash
+# 单章分析 (代替 chapter_info.py)
+python scripts/common/analyze.py novels/volume-01/chapters/ch01.md --mode single --json
+
+# 风格检测 (代替 style_check.py)
+python scripts/common/analyze.py novels/volume-01/chapters/ch01.md --mode style --json
+
+# 批量分析 (代替 hook_report.py + 卷级统计)
+python scripts/common/analyze.py novels/volume-01/chapters/ --mode batch --recent 5 --json
+```
+
+**输出模式**:
+- `--json`: 纯JSON格式(供AI读取)
+- 默认: 人类可读格式
+
+**批量模式增强功能**:
+- 钩子类型分布 + 连续相同钩子警告
+- 节奏S1-S5分布 + 连续高潮/平淡警告
+- 总字数/均章字数统计
+
+---
+
+## 写作流程脚本
+
+### check_wordcount.py — 字数检查
+
+```bash
+python scripts/writer/check_wordcount.py novels/volume-01/chapters/ch01.md
+python scripts/writer/check_wordcount.py novels/volume-01/chapters/ch01.md 2500 3500  # 自定义区间
+python scripts/writer/check_wordcount.py --all novels/volume-01/chapters/              # 批量检查
+```
+
+### chapter_info.py — 单章结构化提取
+
+```bash
+python scripts/writer/chapter_info.py novels/volume-01/chapters/ch01.md --json
+```
+
+输出：`word_count` / `characters` / `locations` / `structure` / `hook` / `summary`
+
+### volume_batch.py — 卷级批量汇总
+
+```bash
+python scripts/coordinator/volume_batch.py novels/volume-01/chapters/ --json
+python scripts/coordinator/volume_batch.py novels/volume-01/chapters/ --recent 5 --json
+```
+
+输出：`total_chapters` / `total_words` / `chapters[]` / `main_characters` / `character_matrix` / `foreshadowing_summary` / `hook_distribution`
+
+---
+
+## 审查脚本
+
+### consistency_scan.py — 一致性扫描
+
+```bash
+python scripts/auditor/consistency_scan.py novels/volume-01/chapters/ novels/volume-01/truth-files/ --json
+```
+
+输出：`truth_characters_count` / `summary`（新角色/等级冲突/警告）
+
+### style_check.py — AI味检测
+
+```bash
+python scripts/auditor/style_check.py novels/volume-01/chapters/ch01.md --json
+python scripts/auditor/style_check.py novels/volume-01/chapters/ --recent 5 --json
+```
+
+输出：`ai_density_per_1000` / `ai_words_found` / `repetitive_words` / `dialogue_ratio_pct` / `issues`
+
+### hook_report.py — 钩子密度报告
+
+```bash
+python scripts/auditor/hook_report.py novels/volume-01/chapters/ --json
+python scripts/auditor/hook_report.py novels/volume-01/chapters/ --recent 5 --json
+```
+
+输出：`hook_distribution` / `warnings`（连续相同钩子/未知钩子）
+
+### pacing_report.py — 卷级节奏报告
+
+```bash
+python scripts/auditor/pacing_report.py novels/volume-01/chapters/ --json
+python scripts/auditor/pacing_report.py novels/volume-01/chapters/ --recent 10 --json
+```
+
+输出：`pacing_distribution`（S1-S5分布） / `problems`（连续高潮/平淡/峰值间隔） / `read_trends`（追读力趋势） / `suggestions`
+
+---
+
+## 统计与总结脚本
+
+### stats_report.py — 项目统计报告
+
+```bash
+python scripts/coordinator/stats_report.py novels/ --json
+python scripts/coordinator/stats_report.py novels/ --volume volume-01 --json
+```
+
+输出：`volumes` / `total_chapters` / `total_words` / `volume_details`（章节/角色/场景/节奏分布）
+
+### summary_generator.py — 阶段总结辅助
+
+```bash
+python scripts/reviewer/summary_generator.py novels/volume-01/chapters/ --range 1-10 --json
+python scripts/reviewer/summary_generator.py novels/volume-01/chapters/ --last 5 --json
+```
+
+输出：`timeline`（每章角色/开头/结尾/钩子） / `characters_involved` / `locations_visited`
+
+---
+
+## 大纲与实体脚本
+
+### outline_extractor.py — 大纲快速提取
+
+```bash
+python scripts/planner/outline_extractor.py novels/ --json
+python scripts/planner/outline_extractor.py novels/outline.md --json
+```
+
+输出：`outline` / `volume-01` / `volume-01/act-plan` 等文件的标题树
+
+### truth_manager.py — 真相文件管理器
+
+```bash
+python scripts/reviewer/truth_manager.py .novel-maker/truth-files/ --json
+python scripts/reviewer/truth_manager.py .novel-maker/truth-files/ --entity characters --json
+```
+
+输出：`characters`（角色名提取） / `pending-hooks`（伏笔提取） / `power-system` / `world-setting` / `current-state`
+
+---
+
+## 安装脚本
+
+### install.py — Python 安装脚本
+
+当 `npx novel-maker` 不可用时的备选方案：
+
+```bash
+python scripts/common/install.py [--tool trae|claude|cursor] [--list]
+```
+
+---
+
+## 智能查询脚本
+
+### query_engine.py — 智能查询引擎
+
+4种查询类型：角色查询、设定查询、剧情查询、伏笔查询。
+
+```bash
+python scripts/planner/query_engine.py '林风是什么等级？'
+python scripts/planner/query_engine.py --type character '林风'
+python scripts/planner/query_engine.py --type foreshadow '魔剑'
+```
+
+---
+
+## 风格分析脚本
+
+### style_anchor.py — 风格锚点提取
+
+从最近5章提取句长分布、对话比例、高频词，输出 style-anchor.json。
+
+```bash
+python scripts/writer/style_anchor.py novels/volume-01/chapters/
+python scripts/writer/style_anchor.py novels/volume-01/chapters/ --recent 10 --json
+```
+
+输出：`avg_sentence_length` / `dialogue_ratio` / `top_words` / `style_signature`
+
+---
+
+## 节奏报告脚本（含可视化）
+
+### pacing_report.py — 卷级节奏报告
+
+分析卷内所有章节的节奏分布、问题区域、追读力趋势，支持 emoji 可视化。
+
+```bash
+python scripts/auditor/pacing_report.py 章节目录 --json
+python scripts/auditor/pacing_report.py 章节目录 --visualize
+python scripts/auditor/pacing_report.py 章节目录 --recent 10
+```
+
+输出：`pacing_distribution`（S1-S5分布） / `problems`（问题区域） / `read_trends`（追读力趋势） / `hook_distribution`（钩子分布） / `suggestions`（改进建议） / `heatmap`（热力图，--visualize时） / `emotion_stats`（情绪统计，--visualize时）
+
+**功能说明：**
+- 节奏分布统计（S1-S5五级）
+- 问题区域检测（连续高潮/连续平淡/峰值间隔）
+- 追读力趋势评估（每5章一组）
+- 钩子类型分布
+- 后续写作建议
+- 节奏热力图（--visualize）
+- 多维度情绪统计（--visualize）
+
+---
+
+## Token 优化脚本
+
+### build_write_context.py — 写手上下文构建器
+
+一键生成写作所需的精简上下文，将 15+ 个文件压缩为 ~3000 token 的 JSON。
+
+```bash
+python scripts/writer/build_write_context.py novels/volume-01/chapters/ch15.md --json
+python scripts/writer/build_write_context.py --chapter 15 --volume 01 --json
+```
+
+输出：`truth_files`（精简真相文件） / `prev_chapters`（前章摘要） / `outline`（大纲目标） / `constitution`（宪法要点）
+
+**节省：每章约 40,000-60,000 token**
+
+### pre_audit.py — 预审计管线
+
+一键运行所有可自动化的审计维度（字数/钩子/节奏/AI味/一致性）。
+
+```bash
+python scripts/auditor/pre_audit.py novels/volume-01/chapters/ch15.md --json
+```
+
+输出：`word_count` / `characters` / `hook` / `pacing` / `ai_style` / `consistency` / `summary`
+
+**节省：每章约 20,000-30,000 token**
+
+### truth_diff.py — 真相文件变更检测
+
+自动检测章节变更并生成更新 diff（新角色/新地点/伏笔/情感）。
+
+```bash
+python scripts/reviewer/truth_diff.py ch15.md --truth-dir .novel-maker/truth-files/ --prev ch14.md --json
+```
+
+输出：`new_characters` / `new_locations` / `hook_keywords` / `emotions` / `continuing_characters`
+
+**节省：每章约 35,000-50,000 token**
+
+### planner_context.py — 规划师上下文包
+
+一键生成规划所需的精简上下文，将 10+ 个文件压缩为 ~5000 token 的 JSON。
+
+```bash
+python scripts/planner/planner_context.py --volume 01 --act 2 --json
+```
+
+输出：`volume_progress`（卷进度） / `truth_files`（真相文件摘要） / `outline`（大纲目标） / `active_hooks`（活跃伏笔） / `active_subplots`（活跃支线）
+
+**节省：每次规划约 25,000 token**
+
+### chapter_diff.py — 章节修订对比
+
+比较原稿和修订稿的结构化差异（角色/伏笔/字数/结构/节奏）。
+
+```bash
+python scripts/reviewer/chapter_diff.py temp/draft.md temp/revised.md --json
+```
+
+输出：`word_count` / `characters` / `locations` / `hook` / `structure` / `pacing` / `summary`
+
+**节省：每次修订约 8,000 token**
+
+---
+
+## 验证脚本
+
+### validate.py — 技能完整性验证
+
+验证所有技能文件的完整性和正确性（脚本语法/文件引用/角色/题材包/弧线模板/规则/模板/Hook）。
+
+```bash
+python scripts/common/validate.py
+```
+
+输出：134项检查结果（通过/警告/失败），覆盖8个维度。
+
+---
+
+## 在 NovelMaker 工作流中的位置
+
+```
+/novel-maker write 继续
+    ↓ ① python scripts/writer/chapter_info.py 前章.md --json  → AI 读 ~200 token 代替 ~4000 token
+    ↓ ② AI 写作 → 审查 → 更新大纲/记忆
+    ↓ ③ python scripts/writer/check_wordcount.py 本章.md      → 验证字数达标
+
+/novel-maker review
+    ↓ ① python scripts/auditor/consistency_scan.py 章节/ 真相/ --json  → 一致性扫描
+    ↓ ② python scripts/auditor/style_check.py 章节/ --json     → AI味检测
+    ↓ ③ python scripts/auditor/hook_report.py 章节/ --json     → 钩子密度
+    ↓ ④ python scripts/auditor/pacing_report.py 章节/ --json   → 节奏报告
+
+/novel-maker act 下一幕怎么走
+    ↓ ① python scripts/coordinator/volume_batch.py chapters/ --recent 5 --json  → 批量上下文
+    ↓ ② python scripts/auditor/hook_report.py chapters/ --recent 5 --json   → 钩子趋势
+    ↓ ③ AI 展示现状 + 6条分支 → 用户选择 → 偏离检查 → 同步更新
+
+/novel-maker stats
+    ↓ python scripts/coordinator/stats_report.py novels/ --json    → 项目统计
+
+/novel-maker summary
+    ↓ python scripts/reviewer/summary_generator.py chapters/ --last 10 --json  → 阶段总结辅助
+
+/novel-maker memory outline
+    ↓ python scripts/planner/outline_extractor.py novels/ --json → 大纲树
+
+/novel-maker memory entity
+    ↓ python scripts/reviewer/truth_manager.py truth-files/ --json → 真相文件管理
+```