novelws 4.0.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
-# 当 tracking/volumes/ 存在时
-VOLUME_DIR="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 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('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="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
-助手：检测到分片模式...
-
-数据来源：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/knowledge/audit-config.json

@@ -1,26 +0,0 @@
-{
-  "version": "1.0",
-  "connector_phrases": [
-    "首先", "其次", "再次", "然后", "然而", "总而言之", "综上所述",
-    "在某种程度", "众所周知", "在当下", "随着"
-  ],
-  "empty_phrases": [
-    "广泛关注", "引发热议", "影响深远", "具有重要意义", "有效提升",
-    "具有一定的指导意义", "值得我们思考"
-  ],
-  "cliche_pairs": [
-    ["世界上没有轻松的成功", "说具体一次你咬牙挺过去的时刻"],
-    ["坚持就是胜利", "写出坚持里最难熬的那个动作和气味"]
-  ],
-  "sentence_length": {
-    "max_run_long": 4,
-    "max_run_short": 5,
-    "short_threshold": 12,
-    "long_threshold": 35
-  },
-  "abstract_nouns": [
-    "价值", "意义", "认知", "体系", "模式", "路径", "方法论", "趋势"
-  ],
-  "min_concrete_details": 3
-}
-

package/templates/knowledge/character-profiles.md

@@ -1,152 +0,0 @@
-# 角色档案
-
-## 主角
-
-### [主角姓名]
-
-#### 基本信息
-- **年龄**：
-- **性别**：
-- **身份/职业**：
-- **出身背景**：
-
-#### 外貌特征
-- **身高体型**：
-- **相貌特点**：
-- **穿着风格**：
-- **特殊标记**：
-
-#### 性格特征
-- **核心性格**：
-- **优点**：
-- **缺点**：
-- **行为习惯**：
-- **说话方式**：
-
-#### 能力设定
-- **特殊能力**：
-- **技能特长**：
-- **战斗力**：
-- **智力水平**：
-- **弱点**：
-
-#### 背景故事
-[详细的人物背景]
-
-**童年经历**：
-**成长历程**：
-**重要事件**：
-**人生转折**：
-
-#### 人物动机
-- **核心追求**：
-- **内心恐惧**：
-- **价值观**：
-- **人生目标**：
-
-#### 成长规划
-- **初期状态**：
-- **中期发展**：
-- **后期蜕变**：
-- **最终形态**：
-
-#### 人际关系
-- **家人**：
-- **朋友**：
-- **敌人**：
-- **爱人**：
-- **导师**：
-
----
-
-## 重要配角
-
-### [配角姓名]
-
-#### 基本信息
-- **角色定位**：[如：导师/对手/伙伴/爱人]
-- **与主角关系**：
-- **出场章节**：
-- **重要程度**：⭐⭐⭐⭐⭐
-
-#### 人物特征
-- **外貌简述**：
-- **性格要点**：
-- **能力水平**：
-- **说话风格**：
-
-#### 角色功能
-- **剧情作用**：
-- **推动主线**：
-- **性格对比**：
-
-#### 人物背景
-[简要背景说明]
-
-#### 发展轨迹
-- **初次登场**：
-- **关系变化**：
-- **最终去向**：
-
----
-
-## 次要角色
-
-### [角色组/势力]
-
-#### 群体角色
-- **所属组织**：
-- **共同特征**：
-- **代表人物**：
-
-#### 功能角色
-| 姓名 | 身份 | 作用 | 出场章节 | 备注 |
-|------|------|------|----------|------|
-| | | | | |
-| | | | | |
-
----
-
-## 角色关系图谱
-
-### 主要关系线
-```
-[主角] ─── 爱慕 ──→ [角色A]
-   │                    ↑
-   │                    │敌对
-   ├── 师徒 ──→ [角色B]│
-   │                    │
-   └── 对手 ←── [角色C]─┘
-```
-
-### 势力关系
-- **正派阵营**：
-- **反派阵营**：
-- **中立势力**：
-
-## 角色成长timeline
-
-### 主角成长节点
-1. **第X章**：[事件] → [变化]
-2. **第X章**：[事件] → [变化]
-3. **第X章**：[事件] → [变化]
-
-### 关系发展节点
-1. **第X章**：[角色A+角色B] → [关系变化]
-2. **第X章**：[角色C登场] → [新关系建立]
-
-## 角色设计备注
-
-### 创作要点
-- 保持人物行为的逻辑一致性
-- 角色成长要循序渐进
-- 对话要符合人物身份和性格
-- 避免角色工具化
-
-### 参考原型
-[如有参考的真实人物或其他作品角色]
-
----
-*创建时间：[日期]*
-*最后更新：[日期]*
-*版本：1.0*