novelws 3.1.0 → 5.0.0

package/templates/commands/volume-summary.md

@@ -1,471 +0,0 @@
----
-name: volume-summary
-description: 生成指定卷的完整摘要报告（章节统计、角色分析、情节推进、质量指标）
-argument-hint: vol-XX [--export]
-allowed-tools: Read, Glob, Grep, Bash
----
-
-# /volume-summary — 卷级摘要生成器
-
-生成指定卷的完整摘要报告，涵盖章节统计、角色分析、情节推进、质量指标等。适用于超长篇小说的卷末回顾和质量复查。
-
----
-
-## 核心功能
-
-1. **章节统计** - 字数、平均长度、更新频率
-2. **角色分析** - 出场统计、关系变化、弧线推进
-3. **情节推进** - 伏笔铺设与回收、主线进度
-4. **质量指标** - 节奏评分、一致性检查、爽点密度
-5. **关键事件** - 本卷重要转折点时间线
-
----
-
-## 数据加载策略
-
-本命令采用 **三层回退** 机制加载卷数据：
-
-### Layer 3: MCP 查询（优先）
-
-```typescript
-// 如果 MCP 已启用且数据已同步
-const volumeStats = await mcp.call('novelws-mcp/stats_volume', {
-  volume: 'vol-03'
-});
-
-const characters = await mcp.call('novelws-mcp/query_characters', {
-  volume: 'vol-03'
-});
-
-const plotData = await mcp.call('novelws-mcp/query_plot', {
-  volume: 'vol-03',
-  status: 'all'
-});
-
-const timeline = await mcp.call('novelws-mcp/query_timeline', {
-  volume: 'vol-03'
-});
-```
-
-**优势**：
-- 单次调用获取完整卷统计
-- 自动聚合跨章节数据
-- 高性能跨表关联查询
-
-### Layer 2: 分片 JSON（次优）
-
-```bash
-# 当 spec/tracking/volumes/ 存在时
-VOLUME_DIR="spec/tracking/volumes/vol-03"
-
-# 读取该卷所有 tracking 数据
-cat "$VOLUME_DIR/character-state.json"
-cat "$VOLUME_DIR/relationships.json"
-cat "$VOLUME_DIR/plot-tracker.json"
-cat "$VOLUME_DIR/timeline.json"
-cat "$VOLUME_DIR/story-facts.json"
-```
-
-**适用场景**：
-- MCP 未启用或同步延迟
-- 需要精确章节级别的数据
-- 手动编辑 JSON 后即时生成摘要
-
-### Layer 1: 单文件 JSON（兜底）
-
-```bash
-# 传统模式，加载完整文件后手动过滤卷
-character_state=$(cat spec/tracking/character-state.json | jq ".characters | map(select(.volume == \"vol-03\"))")
-```
-
-**向下兼容**：小型项目（< 300 章）继续使用单文件模式，摘要覆盖全书
-
----
-
-## 执行流程
-
-### Step 1: 解析参数
-
-```javascript
-const args = parseArguments($ARGUMENTS);
-
-// 卷编号（必填）
-const volumeId = args.volume || args._[0]; // vol-03
-if (!volumeId) {
-  throw new Error("请指定卷编号：/volume-summary vol-XX");
-}
-
-// 导出选项（可选）
-const shouldExport = args.export || false;
-```
-
-### Step 2: 检测数据模式
-
-```javascript
-const isSharded = fs.existsSync('spec/tracking/volumes/');
-const hasMCP = fs.existsSync('mcp-servers.json');
-
-// 选择数据源
-let dataSource;
-if (hasMCP) {
-  dataSource = 'mcp';
-} else if (isSharded) {
-  dataSource = 'sharded';
-} else {
-  dataSource = 'single-file';
-}
-```
-
-### Step 3: 加载卷数据
-
-根据数据源加载：
-
-#### MCP 模式
-
-```typescript
-const data = await loadVolumeDataFromMCP(volumeId);
-```
-
-#### 分片模式
-
-```bash
-VOLUME_DIR="spec/tracking/volumes/${volumeId}"
-
-if [[ ! -d "$VOLUME_DIR" ]]; then
-  echo "错误：卷目录不存在：$VOLUME_DIR"
-  exit 1
-fi
-
-# 读取所有 tracking 文件
-character_state=$(cat "$VOLUME_DIR/character-state.json")
-relationships=$(cat "$VOLUME_DIR/relationships.json")
-plot_tracker=$(cat "$VOLUME_DIR/plot-tracker.json")
-timeline=$(cat "$VOLUME_DIR/timeline.json")
-```
-
-#### 单文件模式
-
-```javascript
-// 加载完整 tracking 数据，按卷过滤
-const allData = loadTrackingFiles();
-const volumeData = filterByVolume(allData, volumeId);
-```
-
-### Step 4: 读取章节内容
-
-```javascript
-// 根据卷编号确定章节范围
-const volumeConfig = readCreativePlan().volumes.find(v => v.id === volumeId);
-const chapterRange = volumeConfig.chapters; // [51, 100]
-
-// 读取章节文件
-const chapters = [];
-for (let i = chapterRange[0]; i <= chapterRange[1]; i++) {
-  const chapterPath = `stories/*/content/ch-${String(i).padStart(3, '0')}.md`;
-  if (fs.existsSync(chapterPath)) {
-    chapters.push({
-      number: i,
-      content: fs.readFileSync(chapterPath, 'utf-8'),
-      wordCount: countWords(content)
-    });
-  }
-}
-```
-
-### Step 5: 生成摘要报告
-
-整合所有数据，生成结构化摘要：
-
-```markdown
-# 第 [X] 卷摘要报告
-
-**生成时间**：2026-02-14
-**数据范围**：第 [start]-[end] 章
-**数据来源**：[MCP/分片/单文件]
-
----
-
-## 一、章节统计
-
-| 指标 | 数值 |
-|------|------|
-| 总章节数 | [X] 章 |
-| 总字数 | [X] 字 |
-| 平均章节长度 | [X] 字/章 |
-| 最长章节 | 第 [X] 章（[X] 字）|
-| 最短章节 | 第 [X] 章（[X] 字）|
-| 更新时间跨度 | [X] 天 |
-
----
-
-## 二、角色分析
-
-### 主要角色出场统计
-
-| 角色 | 出场章节数 | 对话量 | 关系变化 | 弧线进度 |
-|------|-----------|--------|---------|---------|
-| [角色A] | [X] 章 | [X] 句 | [X] 次 | [X]% |
-| [角色B] | [X] 章 | [X] 句 | [X] 次 | [X]% |
-
-### 关系网络变化
-
-- **新增关系**：[X] 对
-  - [角色A] ↔ [角色B]：陌生 → 盟友
-  - [角色C] ↔ [角色D]：友好 → 敌对
-
-- **关系深化**：[X] 对
-  - [角色E] ↔ [角色F]：普通朋友 → 生死之交
-
-### 角色成长里程碑
-
-- **[角色A]**：
-  - 第 [X] 章：突破筑基期
-  - 第 [Y] 章：确立复仇动机
-  - 第 [Z] 章：首次战胜强敌
-
----
-
-## 三、情节推进
-
-### 主线进度
-
-| 情节线 | 进度 | 关键事件 |
-|--------|------|---------|
-| [主线A] | [X]% | 第 [X] 章：[事件] |
-| [支线B] | [X]% | 第 [Y] 章：[事件] |
-
-### 伏笔管理
-
-- **铺设伏笔**：[X] 个
-  - 第 [X] 章：[伏笔描述]
-  - 第 [Y] 章：[伏笔描述]
-
-- **回收伏笔**：[X] 个
-  - 第 [X] 章：回收"[伏笔名]"（铺设于第 [Y] 章）
-
-- **待回收伏笔**：[X] 个
-  - "[伏笔名]"（紧急度：[X]）
-
-### 本卷高潮
-
-- **第 [X] 章**：[高潮描述]
-  - 爽点类型：[类型]
-  - 情感强度：★★★★☆
-
----
-
-## 四、质量指标
-
-### 节奏评分
-
-```
-章节节奏曲线（1-10 分）：
-第51章: ████████░░ 8/10
-第52章: ██████░░░░ 6/10
-第53章: ███████░░░ 7/10
-第54章: █████████░ 9/10 ← 高潮
-第55章: ████░░░░░░ 4/10
-...
-
-平均节奏：7.2/10
-节奏变化合理性：✓ 张弛有度
-```
-
-### 爽点密度
-
-- **总爽点数**：[X] 个
-- **平均间隔**：每 [X] 章 1 个
-- **爽点类型分布**：
-  - 战斗：[X] 个
-  - 智斗：[X] 个
-  - 情感：[X] 个
-  - 反转：[X] 个
-
-### 一致性检查
-
-| 检查项 | 状态 | 详情 |
-|--------|------|------|
-| 角色性格一致 | ✓ | 无矛盾 |
-| 时间线连续 | ⚠️ | 第 [X]-[Y] 章存在跳跃 |
-| 力量体系一致 | ✓ | 无矛盾 |
-| 伏笔逻辑自洽 | ✓ | 无矛盾 |
-
----
-
-## 五、关键事件时间线
-
-```
-第 51 章 | 万历三十年五月 | 主角进入内阁
-第 53 章 | 万历三十年五月 | 与申时行派系首次冲突
-第 55 章 | 万历三十年六月 | 沈玉卿身世揭露
-第 58 章 | 万历三十年六月 | 东厂介入
-第 60 章 | 万历三十年七月 | 卷末高潮：内阁政变
-```
-
----
-
-## 六、下一卷建议
-
-### 需要延续的线索
-
-- **伏笔**：[伏笔名]（待第 [X] 卷回收）
-- **关系**：[角色A] ↔ [角色B]（需进一步发展）
-- **冲突**：[冲突描述]（需升级）
-
-### 潜在风险
-
-- ⚠️ 角色 [X] 已 [N] 章未出场，建议第 [Y] 卷安排戏份
-- ⚠️ 情节线 [X] 进度缓慢，建议加快推进
-- ⚠️ 伏笔 [X] 紧急度过高，建议尽快回收
-
-### 质量提升建议
-
-- 节奏：第 [X]-[Y] 章节奏平缓，建议在第 [Z] 卷前半段增加冲突
-- 爽点：本卷爽点密度偏低，建议第 [Z] 卷提升至每 3-4 章 1 个
-- 角色：[角色X] 戏份不足，建议在第 [Z] 卷安排独立支线
-
----
-
-## 七、导出选项
-
-### 保存路径
-
-摘要报告已保存至：
-- **Markdown**: `spec/summaries/vol-[XX]-summary.md`
-- **JSON**: `spec/summaries/vol-[XX]-summary.json`
-
-### 使用建议
-
-- 在开始下一卷写作前，先阅读本卷摘要
-- 定期（每 3-5 卷）执行全局一致性检查
-- 导出 JSON 可用于数据分析和可视化
-```
-
-### Step 6: 可选导出
-
-如果用户指定 `--export`：
-
-```javascript
-// 保存 Markdown 格式
-fs.writeFileSync(
-  `spec/summaries/${volumeId}-summary.md`,
-  summaryMarkdown
-);
-
-// 保存 JSON 格式（结构化数据）
-fs.writeFileSync(
-  `spec/summaries/${volumeId}-summary.json`,
-  JSON.stringify(summaryData, null, 2)
-);
-```
-
----
-
-## 使用场景
-
-### 场景 1：卷末回顾
-
-```bash
-用户：我刚写完第 3 卷，想回顾一下
-助手：好的，让我为您生成第 3 卷的完整摘要
-
-用户：/volume-summary vol-03
-助手：【生成中...】
-
-检测到 MCP 已启用，使用高性能查询...
-✓ 章节统计加载完成（101-150 章，共 50 章）
-✓ 角色数据加载完成（12 个主要角色）
-✓ 情节数据加载完成（5 条主线，8 个伏笔）
-✓ 质量指标计算完成
-
-【第 3 卷摘要报告】
-[完整报告内容...]
-
-💡 建议：第 3 卷整体质量良好，但有 2 个伏笔紧急度较高，建议在第 4 卷前半段回收。
-```
-
-### 场景 2：导出数据分析
-
-```bash
-用户：/volume-summary vol-02 --export
-助手：生成第 2 卷摘要并导出...
-
-✓ 摘要报告已生成
-✓ 已导出至：spec/summaries/vol-02-summary.md
-✓ 已导出至：spec/summaries/vol-02-summary.json
-
-JSON 数据可用于：
-- 导入可视化工具（如 Tableau）
-- 自定义数据分析脚本
-- 跨卷对比分析
-```
-
-### 场景 3：分片模式
-
-```bash
-用户：/volume-summary vol-05
-助手：检测到分片模式...
-
-数据来源：spec/tracking/volumes/vol-05/
-✓ character-state.json
-✓ relationships.json
-✓ plot-tracker.json
-✓ timeline.json
-
-【第 5 卷摘要报告】
-[完整报告内容...]
-```
-
----
-
-## 与其他命令的关系
-
-```text
-/write → 完成卷写作
-    ↓
-/volume-summary → 生成卷摘要（本命令）
-    ↓
-/analyze --volume vol-XX → 深度分析（可选）
-    ↓
-/plan --detail vol-XX+1 → 规划下一卷
-```
-
-**互补关系**：
-- `/volume-summary` 提供快速概览，`/analyze` 提供深度诊断
-- `/recap --full vol-XX` 重建上下文，`/volume-summary` 回顾数据
-- `/track --volume vol-XX` 更新数据，`/volume-summary` 查看摘要
-
----
-
-## 注意事项
-
-### 数据完整性
-
-- 确保 tracking 数据已同步至最新章节
-- 如果使用 MCP，建议先执行 `/track --sync --incremental`
-- 分片模式下，确保目标卷目录存在
-
-### 性能考虑
-
-- MCP 模式生成速度最快（< 5 秒）
-- 分片模式需读取多个 JSON 文件（10-30 秒）
-- 单文件模式在超长篇项目中可能较慢（> 1 分钟）
-
-### 报告精度
-
-- 自动生成的质量指标为参考值，不替代人工审查
-- 建议结合 `/analyze` 进行深度验证
-- 角色出场统计基于文本搜索，可能有误差
-
----
-
-## 🔗 命令链式提示
-
-**命令执行完成后，自动附加下一步建议**：
-
-```
-💡 下一步建议：
-1️⃣ `/analyze --volume vol-[XX]` — 深度分析本卷质量
-2️⃣ `/plan --detail vol-[XX+1]` — 规划下一卷情节
-3️⃣ `/revise --volume vol-[XX]` — 根据摘要发现的问题修改本卷
-```

package/templates/config/keyword-mappings.json

@@ -1,226 +0,0 @@
-{
-  "version": "1.2.0",
-  "description": "关键词触发机制的映射表（含预编译正则）",
-  "mappings": {
-    "craft-knowledge": {
-      "dialogue": {
-        "keywords": ["对话", "台词", "说话", "对白", "conversation", "dialogue"],
-        "regex": "对话|台词|说话|对白|conversation|dialogue",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/dialogue.md",
-          "templates/skills/writing-techniques/dialogue-techniques/SKILL.md"
-        ],
-        "priority": 1
-      },
-      "scene-structure": {
-        "keywords": ["场景", "镜头", "画面", "scene", "structure"],
-        "regex": "场景|镜头|画面|scene|structure",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/scene-structure.md",
-          "templates/skills/writing-techniques/scene-structure/SKILL.md"
-        ],
-        "priority": 1
-      },
-      "character-arc": {
-        "keywords": ["角色成长", "角色弧线", "弧线", "转变", "成长", "character arc", "transformation"],
-        "regex": "角色成长|角色弧线|弧线|转变|成长|character\\s*arc|transformation",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/character-arc.md",
-          "templates/skills/writing-techniques/character-arc/SKILL.md"
-        ],
-        "priority": 1
-      },
-      "pacing": {
-        "keywords": ["节奏", "拖沓", "太快", "太慢", "过快", "过慢", "pacing", "rhythm"],
-        "regex": "节奏|拖沓|太快|太慢|过快|过慢|pacing|rhythm",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/pacing.md",
-          "templates/skills/writing-techniques/pacing-control/SKILL.md"
-        ],
-        "priority": 1
-      },
-      "show-not-tell": {
-        "keywords": ["展示", "描写", "tell", "show", "showing", "telling"],
-        "regex": "展示|描写|tell|show|showing|telling",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/show-not-tell.md"
-        ],
-        "priority": 1
-      },
-      "hook-design": {
-        "keywords": ["钩子", "悬念", "章末", "hook", "cliffhanger", "结尾"],
-        "regex": "钩子|悬念|章末|hook|cliffhanger|结尾",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/hook-design.md"
-        ],
-        "priority": 1
-      },
-      "power-system": {
-        "keywords": ["力量体系", "战力", "境界", "等级", "power system", "combat"],
-        "regex": "力量体系|战力|境界|等级|power\\s*system|combat",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/power-system.md"
-        ],
-        "priority": 1
-      },
-      "tension-management": {
-        "keywords": ["紧张感", "张力", "信息差", "时间压力", "两难", "tension", "dilemma"],
-        "regex": "紧张感|张力|信息差|时间压力|两难|tension|dilemma",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/craft/tension-management.md"
-        ],
-        "priority": 1
-      }
-    },
-    "genre-knowledge": {
-      "romance": {
-        "keywords": ["言情", "恋爱", "感情", "爱情", "romance", "love"],
-        "regex": "言情|恋爱|感情|爱情|romance|love",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/romance.md",
-          "templates/skills/genre-knowledge/romance/SKILL.md"
-        ],
-        "priority": 2
-      },
-      "mystery": {
-        "keywords": ["悬疑", "推理", "线索", "mystery", "detective", "clue"],
-        "regex": "悬疑|推理|线索|mystery|detective|clue",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/mystery.md",
-          "templates/skills/genre-knowledge/mystery/SKILL.md"
-        ],
-        "priority": 2
-      },
-      "wuxia": {
-        "keywords": ["武侠", "江湖", "侠客", "武功", "wuxia", "martial arts"],
-        "regex": "武侠|江湖|侠客|武功|wuxia|martial\\s*arts",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/wuxia.md"
-        ],
-        "priority": 2
-      },
-      "historical": {
-        "keywords": ["历史", "古代", "朝代", "宫廷", "historical", "dynasty"],
-        "regex": "历史|古代|朝代|宫廷|historical|dynasty",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/historical.md"
-        ],
-        "priority": 2
-      },
-      "sci-fi": {
-        "keywords": ["科幻", "未来", "太空", "星际", "sci-fi", "science fiction"],
-        "regex": "科幻|未来|太空|星际|sci-fi|science\\s*fiction",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/sci-fi.md"
-        ],
-        "priority": 2
-      },
-      "thriller": {
-        "keywords": ["惊悚", "恐怖", "紧张", "thriller", "horror", "suspense"],
-        "regex": "惊悚|恐怖|紧张|thriller|horror|suspense",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/thriller.md"
-        ],
-        "priority": 2
-      },
-      "revenge": {
-        "keywords": ["复仇", "报仇", "仇恨", "revenge", "vengeance"],
-        "regex": "复仇|报仇|仇恨|revenge|vengeance",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/revenge.md"
-        ],
-        "priority": 2
-      },
-      "xuanhuan": {
-        "keywords": ["玄幻", "修仙", "修炼", "境界", "灵气", "宗门", "xuanhuan", "cultivation"],
-        "regex": "玄幻|修仙|修炼|境界|灵气|宗门|xuanhuan|cultivation",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/xuanhuan.md"
-        ],
-        "priority": 2
-      },
-      "urban": {
-        "keywords": ["都市", "现代", "城市", "职场", "urban", "modern", "city"],
-        "regex": "都市|现代|城市|职场|urban|modern|city",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/urban.md"
-        ],
-        "priority": 2
-      },
-      "game-lit": {
-        "keywords": ["游戏", "系统", "面板", "副本", "game", "system", "dungeon"],
-        "regex": "游戏|系统|面板|副本|game|system|dungeon",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/game-lit.md"
-        ],
-        "priority": 2
-      },
-      "rebirth": {
-        "keywords": ["重生", "穿越", "回到过去", "前世", "rebirth", "reincarnation", "transmigration"],
-        "regex": "重生|穿越|回到过去|前世|rebirth|reincarnation|transmigration",
-        "regex_flags": "i",
-        "resources": [
-          "templates/knowledge-base/genres/rebirth.md"
-        ],
-        "priority": 2
-      }
-    },
-    "quality-assurance": {
-      "consistency": {
-        "keywords": ["一致性", "矛盾", "冲突", "consistency", "contradiction"],
-        "regex": "一致性|矛盾|冲突|consistency|contradiction",
-        "regex_flags": "i",
-        "resources": [
-          "templates/skills/quality-assurance/consistency-checker/SKILL.md"
-        ],
-        "priority": 3
-      }
-    }
-  },
-  "regex-patterns": {
-    "dialogue": "对话|台词|说话|对白",
-    "scene": "场景|镜头|画面",
-    "character-arc": "角色成长|角色弧线|弧线|转变|成长",
-    "pacing": "节奏|拖沓|太快|太慢|过快|过慢",
-    "show-tell": "展示|描写|tell|show",
-    "hook-design": "钩子|悬念|章末|hook|cliffhanger|结尾",
-    "power-system": "力量体系|战力|境界|等级",
-    "romance": "言情|恋爱|感情|爱情",
-    "mystery": "悬疑|推理|线索",
-    "wuxia": "武侠|江湖|侠客|武功",
-    "historical": "历史|古代|朝代|宫廷",
-    "sci-fi": "科幻|未来|太空|星际",
-    "thriller": "惊悚|恐怖|紧张",
-    "revenge": "复仇|报仇|仇恨",
-    "xuanhuan": "玄幻|修仙|修炼|境界|灵气|宗门",
-    "consistency": "一致性|矛盾|冲突",
-    "tension-management": "紧张感|张力|信息差|时间压力|两难",
-    "urban": "都市|现代|城市|职场",
-    "game-lit": "游戏|系统|面板|副本",
-    "rebirth": "重生|穿越|回到过去|前世"
-  },
-  "notes": {
-    "priority": "优先级数字越小越高（1 最高）",
-    "usage": "scripts/bash/check-writing-state.sh 会读取此文件",
-    "extensibility": "可通过 specification.md 的 resource-loading.keyword-triggers.custom-mappings 扩展",
-    "performance": "regex 字段为预编译正则表达式，脚本直接使用，避免运行时构建"
-  }
-}