novelws 3.0.0 → 4.0.0

package/templates/commands/character.md

@@ -2,6 +2,7 @@
 name: character
 description: "统一角色管理 — 创建、查看、更新角色档案，管理角色关系，设定对话指纹"
 argument-hint: [子命令] [角色名或参数] [--volume vol-XX]
+recommended-model: claude-sonnet-4-5-20250929 # 角色设定中等复杂度；复杂角色可用 opus
 allowed-tools: Read, Write, Glob, Grep, Edit
 ---
 
@@ -9,12 +10,12 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 ## 概述
 
-统一管理故事中所有角色的档案、状态、关系和对话风格。所有角色数据存储在 `spec/tracking/` 目录下。
+统一管理故事中所有角色的档案、状态、关系和对话风格。所有角色数据存储在 `tracking/` 目录下。
 
 ## 前置条件
 
 1. 确认当前故事目录存在：`stories/*/`
-2. 确认 `spec/tracking/` 目录存在，不存在则创建
+2. 确认 `tracking/` 目录存在，不存在则创建
 3. 按三层 Fallback 加载角色数据：
 
 **Layer 1: MCP 查询（优先）**
@@ -22,13 +23,13 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 - `query_relationships` → 关系网络
 - `search_content --query=[角色名]` → 角色出场章节
 
-**Layer 2: 分片 JSON（次优，检测 spec/tracking/volumes/ 是否存在）**
-- 无 --volume：读取 `spec/tracking/summary/characters-summary.json`（活跃角色概览）
-- 有 --volume：读取 `spec/tracking/volumes/vol-XX/character-state.json` 和 `relationships.json`
+**Layer 2: 分片 JSON（次优，检测 tracking/volumes/ 是否存在）**
+- 无 --volume：读取 `tracking/summary/characters-summary.json`（活跃角色概览）
+- 有 --volume：读取 `tracking/volumes/vol-XX/character-state.json` 和 `relationships.json`
 
 **Layer 3: 单文件 JSON（兜底）**
-- `spec/tracking/character-state.json`
-- `spec/tracking/relationships.json`
+- `tracking/character-state.json`
+- `tracking/relationships.json`
 
 ## 子命令决策
 
@@ -52,22 +53,10 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 1: 收集基本信息**
 
-向用户询问以下信息（未提供的标记为待定）：
-
-```
-📝 创建新角色
-━━━━━━━━━━━━━━━━━━━━
-请提供以下信息（可以先填部分，后续用 /character update 补充）：
-
-1. 角色名称：[必填]
-2. 角色类型：主角 / 重要配角 / 次要配角 / 龙套
-3. 一句话描述：[角色的核心定位]
-4. 外貌特征：[关键外貌，不超过 3 个特征]
-5. 性格核心：[1-3 个核心性格词]
-6. 初始状态：[出场时的状态/处境]
-7. 核心目标：[角色想要什么]
-8. 核心冲突：[角色面临的主要矛盾]
-```
+向用户询问以下信息（未提供的标记为待定，可后续用 update 补充）：
+- 角色名称（必填）、角色类型（主角/重要配角/次要配角/龙套）
+- 一句话描述、外貌特征（≤3 个）、性格核心（1-3 词）
+- 初始状态、核心目标、核心冲突
 
 **Step 2: 生成角色档案**
 
@@ -122,19 +111,7 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 3: 输出确认**
 
-```
-✅ 角色创建成功
-━━━━━━━━━━━━━━━━━━━━
-📛 [角色名]（[角色类型]）
-📝 [一句话描述]
-🎯 目标：[核心目标]
-⚡ 冲突：[核心冲突]
-
-💡 后续操作：
-- /character voice [角色名] — 设定对话风格
-- /character relate [角色名] [其他角色] — 建立关系
-- /character update [角色名] — 补充更多信息
-```
+输出角色名、类型、描述、目标、冲突的摘要，并提示后续可用 `voice`、`relate`、`update` 子命令。
 
 ---
 
@@ -150,27 +127,9 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 2: 按类型分组输出**
 
-```
-📋 角色总览
-━━━━━━━━━━━━━━━━━━━━
-
-👑 主角（[N] 人）
-| 角色 | 状态 | 位置 | 最近出场 | 出场次数 |
-|------|------|------|---------|---------|
-| [名] | [状态] | [位置] | 第 N 章 | M 次 |
+按角色类型（主角 → 重要配角 → 次要配角 → 龙套）分组，每组以表格显示：角色名、状态、位置、最近出场章节、出场次数。次要配角和龙套可用简略列表。
 
-⭐ 重要配角（[N] 人）
-| 角色 | 状态 | 位置 | 最近出场 | 出场次数 |
-|------|------|------|---------|---------|
-| [名] | [状态] | [位置] | 第 N 章 | M 次 |
-
-👤 次要配角（[N] 人）
-[简略列表]
-
-⚠️ 需关注：
-- [角色A]：超过 5 章未出场
-- [角色B]：状态为「受伤」，需跟进
-```
+末尾附加需关注提醒（如超过 5 章未出场、状态异常的角色）。
 
 ---
 
@@ -184,48 +143,15 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 2: 输出完整档案**
 
-```
-📛 [角色名] — [角色类型]
-━━━━━━━━━━━━━━━━━━━━
-
-📝 [一句话描述]
-
-👤 外貌
-[外貌描述]
-
-🧠 性格
-- 核心：[性格词]
-- 优点：[优点]
-- 缺点：[缺点]
-- 习惯：[小习惯/怪癖]
-
-📊 当前状态
-- 状态：[当前状态]
-- 位置：[当前位置]
-- 情绪：[当前情绪]
-- 健康：[健康状况]
-
-🎯 目标与冲突
-- 主要目标：[目标]
-- 核心冲突：[冲突]
-- 弧线阶段：[当前阶段]
-
-🗣️ 对话风格
-- 说话方式：[描述]
-- 常用词汇：[词汇]
-- 口头禅：[口头禅]
-
-🔗 关系网络
-[从 relationships.json 提取与此角色相关的所有关系]
-| 对象 | 关系 | 状态 | 备注 |
-|------|------|------|------|
-| [角色B] | [关系类型] | [当前状态] | [备注] |
-
-📅 出场记录
-- 首次出场：第 [N] 章
-- 最近出场：第 [M] 章
-- 总出场次数：[K] 次
-```
+输出以下分区信息：
+- 基本信息：角色名、类型、一句话描述
+- 外貌：外貌描述和关键特征
+- 性格：核心性格词、优点、缺点、习惯/怪癖
+- 当前状态：状态、位置、情绪、健康
+- 目标与冲突：主要目标、核心冲突、弧线阶段
+- 对话风格：说话方式、常用词汇、口头禅
+- 关系网络：从 relationships.json 提取，表格显示（对象、关系、状态、备注）
+- 出场记录：首次出场、最近出场、总出场次数
 
 ---
 
@@ -237,20 +163,7 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 2: 询问要更新的内容**
 
-```
-🔄 更新 [角色名]
-━━━━━━━━━━━━━━━━━━━━
-请告诉我要更新什么：
-
-1. 状态变化（位置、情绪、健康、处境）
-2. 性格补充（新发现的性格特征）
-3. 目标变化（目标达成、新目标、目标转变）
-4. 弧线推进（角色成长阶段变化）
-5. 外貌变化（受伤、变装、成长）
-6. 其他信息
-
-或者直接描述变化内容，我来判断更新哪些字段。
-```
+支持更新的类别：状态变化（位置/情绪/健康/处境）、性格补充、目标变化、弧线推进、外貌变化、其他。用户也可直接描述变化内容，由 AI 判断更新字段。
 
 **Step 3: 更新 JSON 并确认**
 
@@ -266,43 +179,11 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 2: 收集关系信息**
 
-```
-🔗 建立关系：[角色A] ↔ [角色B]
-━━━━━━━━━━━━━━━━━━━━
-请提供：
-
-1. 关系类型：[师徒/朋友/恋人/敌人/亲属/同门/主从/竞争/...]
-2. 关系状态：[稳定/紧张/发展中/破裂/暧昧/...]
-3. A 对 B 的态度：[信任/警惕/依赖/厌恶/...]
-4. B 对 A 的态度：[信任/警惕/依赖/厌恶/...]
-5. 关系起源：[如何认识的]
-6. 关系走向：[预期发展方向，可为空]
-```
+向用户询问：关系类型（师徒/朋友/恋人/敌人/亲属/同门/主从/竞争等）、关系状态（稳定/紧张/发展中/破裂/暧昧等）、双方态度（A→B / B→A）、关系起源、预期走向。
 
 **Step 3: 更新 relationships.json**
 
-```json
-{
-  "id": "[自动生成]",
-  "characterA": "[角色A的ID]",
-  "characterB": "[角色B的ID]",
-  "type": "[关系类型]",
-  "status": "[关系状态]",
-  "attitudeAtoB": "[A对B的态度]",
-  "attitudeBtoA": "[B对A的态度]",
-  "origin": "[关系起源]",
-  "trajectory": "[预期走向]",
-  "history": [
-    {
-      "chapter": null,
-      "event": "关系建立",
-      "date": "[ISO日期]"
-    }
-  ],
-  "createdAt": "[ISO日期]",
-  "updatedAt": "[ISO日期]"
-}
-```
+写入关系条目，包含字段：`id`, `characterA`, `characterB`, `type`, `status`, `attitudeAtoB`, `attitudeBtoA`, `origin`, `trajectory`, `history`（事件数组），`createdAt`, `updatedAt`。
 
 ---
 
@@ -314,42 +195,13 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 **Step 2: 收集对话风格信息**
 
-```
-🗣️ 设定 [角色名] 的对话风格
-━━━━━━━━━━━━━━━━━━━━
-请提供以下信息（可部分填写）：
-
-1. 说话方式：[简洁/啰嗦/文雅/粗犷/冷淡/热情/...]
-2. 常用句式：[例如：总是用反问句、喜欢用比喻]
-3. 口头禅：[例如："有意思"、"哼"]
-4. 禁忌用语：[这个角色绝对不会说的话]
-5. 语气词偏好：[例如：常用"嗯"、不用"哈哈"]
-6. 方言/口音：[如有]
-7. 教育水平体现：[用词复杂度]
-8. 情绪表达方式：[直接/含蓄/压抑/爆发]
-
-💡 也可以提供一段示例对话，我来分析提取风格特征。
-```
+向用户询问：说话方式（简洁/啰嗦/文雅/粗犷等）、常用句式、口头禅、禁忌用语、语气词偏好、方言/口音、教育水平体现、情绪表达方式。也可接受示例对话由 AI 分析提取。
 
 **Step 3: 更新 character-state.json 的 voice 字段**
 
 **Step 4: 输出对话风格卡片**
 
-```
-🗣️ [角色名] 对话风格卡片
-━━━━━━━━━━━━━━━━━━━━
-说话方式：[描述]
-常用句式：[描述]
-口头禅：[列表]
-禁忌用语：[列表]
-语气词：[偏好]
-情绪表达：[方式]
-
-📝 示例对话：
-"[基于风格设定生成的示例对话]"
-
-💡 写作时，/write 会自动加载此角色的对话风格作为参考。
-```
+输出角色对话风格摘要（说话方式、句式、口头禅、禁忌、语气词、情绪表达）及一段基于风格设定生成的示例对话。提示 `/write` 会自动加载此风格。
 
 ---
 
@@ -401,14 +253,14 @@ allowed-tools: Read, Write, Glob, Grep, Edit
 
 当 `/character` 更新角色数据时：
 
-**分片模式（检测到 spec/tracking/volumes/ 存在）**：
+**分片模式（检测到 tracking/volumes/ 存在）**：
 1. 确定角色最后出场章节所属的卷
 2. 更新该卷的 `character-state.json` 或 `relationships.json`
-3. 同步更新全局摘要：`spec/tracking/summary/characters-summary.json`
+3. 同步更新全局摘要：`tracking/summary/characters-summary.json`
 4. 如果 MCP 可用，调用 `sync_from_json` 同步到 SQLite
 
 **单文件模式**：
-- 直接更新 `spec/tracking/character-state.json` 和 `relationships.json`
+- 直接更新 `tracking/character-state.json` 和 `relationships.json`
 
 ### 数据校验
 

package/templates/commands/checklist.md

@@ -4,8 +4,8 @@ description: 生成或执行质量检查清单（规格验证 + 内容扫描）
 argument-hint: [检查类型] [--volume vol-XX | --pre-write | --post-write | --volume-end]
 allowed-tools: Read, Bash, Write, Edit, Glob, Grep
 scripts:
-  sh: .specify/scripts/bash/common.sh
-  ps: .specify/scripts/powershell/common.ps1
+  sh: resources/scripts/bash/common.sh
+  ps: resources/scripts/powershell/common.ps1
 ---
 
 # 质量检查清单（Checklist）
@@ -18,10 +18,10 @@ scripts:
 验证规划文档本身的质量（类似"需求的单元测试"）：
 
 - `大纲质量` - 检查 creative-plan.md 的完整性、清晰度、一致性
-- `角色设定` - 检查 spec/knowledge/characters.md
-- `世界观` - 检查 spec/knowledge/world-setting.md 及相关文档
+- `角色设定` - 检查 resources/knowledge/characters.md
+- `世界观` - 检查 resources/knowledge/world-setting.md 及相关文档
 - `创作计划` - 检查 creative-plan.md / specification.md
-- `伏笔管理` - 检查 spec/tracking/plot-tracker.json 的伏笔定义
+- `伏笔管理` - 检查 tracking/plot-tracker.json 的伏笔定义
 
 ### 第二类：内容验证检查（结果报告式）
 扫描已写章节，验证实际内容：
@@ -47,11 +47,11 @@ $ARGUMENTS
 ### 默认加载
 
 自动加载以下资源用于生成检查清单：
-- `.specify/memory/constitution.md`（创作宪法）
+- `resources/memory/constitution.md`（创作宪法）
 - `stories/*/specification.md`（故事规格）
 - `stories/*/tasks.md`（当前任务）
-- `spec/tracking/plot-tracker.json`（情节追踪）
-- `spec/tracking/character-state.json`（角色状态）
+- `tracking/plot-tracker.json`（情节追踪）
+- `tracking/character-state.json`（角色状态）
 
 ### 可选加载
 
@@ -118,8 +118,8 @@ const plotData = await mcp.call('novelws-mcp/query_plot', {
 ### Layer 2: 分片 JSON（次优）
 
 ```bash
-# 当 spec/tracking/volumes/ 存在时
-for volume_dir in spec/tracking/volumes/vol-*; do
+# 当 tracking/volumes/ 存在时
+for volume_dir in tracking/volumes/vol-*; do
   if [[ -n "$VOLUME_FILTER" ]] && [[ "$volume_dir" != *"$VOLUME_FILTER"* ]]; then
     continue
   fi
@@ -139,8 +139,8 @@ done
 
 ```bash
 # 传统模式，加载完整文件
-cat spec/tracking/plot-tracker.json
-cat spec/tracking/character-state.json
+cat tracking/plot-tracker.json
+cat tracking/character-state.json
 # ...
 ```
 
@@ -183,7 +183,7 @@ cat spec/tracking/character-state.json
 
 **读取文件**：
 - `creative-plan.md` 或 `stories/*/creative-plan.md`
-- `spec/tracking/plot-tracker.json`（如果存在）
+- `tracking/plot-tracker.json`（如果存在）
 
 **生成检查项维度**：
 
@@ -258,9 +258,9 @@ cat spec/tracking/character-state.json
 ##### 2.2 角色设定检查
 
 **读取文件**：
-- `spec/knowledge/characters.md`
-- `spec/tracking/character-state.json`
-- `spec/tracking/relationships.json`
+- `resources/knowledge/characters.md`
+- `tracking/character-state.json`
+- `tracking/relationships.json`
 
 **生成检查项维度**：
 
@@ -288,10 +288,10 @@ cat spec/tracking/character-state.json
 ##### 2.3 世界观检查
 
 **读取文件**：
-- `spec/knowledge/world-setting.md`
-- `spec/knowledge/locations.md`
-- `spec/knowledge/culture.md`
-- `spec/knowledge/rules.md`
+- `resources/knowledge/world-setting.md`
+- `resources/knowledge/locations.md`
+- `resources/knowledge/culture.md`
+- `resources/knowledge/rules.md`
 
 **生成检查项维度**：
 
@@ -340,7 +340,7 @@ cat spec/tracking/character-state.json
 ##### 2.5 伏笔管理检查
 
 **读取文件**：
-- `spec/tracking/plot-tracker.json`
+- `tracking/plot-tracker.json`
 - `creative-plan.md`
 
 **生成检查项维度**：
@@ -370,7 +370,7 @@ cat spec/tracking/character-state.json
 
 执行命令：
 ```bash
-bash .specify/scripts/bash/check-world.sh --checklist
+bash resources/scripts/bash/check-world.sh --checklist
 ```
 
 如果脚本不存在，提示用户该功能正在开发中。
@@ -379,21 +379,21 @@ bash .specify/scripts/bash/check-world.sh --checklist
 
 执行命令：
 ```bash
-bash .specify/scripts/bash/check-plot.sh --checklist
+bash resources/scripts/bash/check-plot.sh --checklist
 ```
 
 ##### 2.7 数据同步检查
 
 执行命令：
 ```bash
-bash .specify/scripts/bash/check-consistency.sh --checklist
+bash resources/scripts/bash/check-consistency.sh --checklist
 ```
 
 ##### 2.8 时间线检查
 
 执行命令：
 ```bash
-bash .specify/scripts/bash/check-timeline.sh check --checklist
+bash resources/scripts/bash/check-timeline.sh check --checklist
 ```
 
 ##### 2.9 写作状态检查
@@ -426,7 +426,7 @@ bash .specify/scripts/bash/check-timeline.sh check --checklist
 
 如果存在脚本，执行：
 ```bash
-bash .specify/scripts/bash/check-writing-state.sh --checklist
+bash resources/scripts/bash/check-writing-state.sh --checklist
 ```
 
 否则，手动检查上述项目并生成报告。
@@ -446,7 +446,7 @@ bash .specify/scripts/bash/check-writing-state.sh --checklist
   /style-learning
 
 或手动创建：
-  .specify/memory/personal-voice.md
+  resources/memory/personal-voice.md
 ```
 
 ### 3. 输出 Checklist

package/templates/commands/clarify.md

@@ -4,8 +4,8 @@ argument-hint: [关键词或焦点领域]
 allowed-tools: Read(//stories/**), Read(//stories/**), Read(//plugins/**), Read(plugins/**), Write(//stories/*/specification.md), Write(//stories/*/specification.md), Bash(ls:*), Bash(find:*), Bash(*)
 disable-model-invocation: false
 scripts:
-  sh: .specify/scripts/bash/clarify-story.sh --json --paths-only
-  ps: .specify/scripts/powershell/clarify-story.ps1 -Json -PathsOnly
+  sh: resources/scripts/bash/clarify-story.sh --json --paths-only
+  ps: resources/scripts/powershell/clarify-story.ps1 -Json -PathsOnly
 ---
 
 焦点区域（可选）：$ARGUMENTS

package/templates/commands/constitution.md

@@ -1,10 +1,10 @@
 ---
 description: 创建或更新小说创作宪法，定义不可妥协的创作原则
 argument-hint: [创作原则描述]
-allowed-tools: Write(//.specify/memory/constitution.md), Write(//.specify/memory/constitution.md), Read(//.specify/memory/**), Read(//.specify/memory/**), Bash(find:*), Bash(*)
+allowed-tools: Write(//resources/memory/constitution.md), Write(//resources/memory/constitution.md), Read(//resources/memory/**), Read(//resources/memory/**), Bash(find:*), Bash(*)
 scripts:
-  sh: .specify/scripts/bash/constitution.sh
-  ps: .specify/scripts/powershell/constitution.ps1
+  sh: resources/scripts/bash/constitution.sh
+  ps: resources/scripts/powershell/constitution.ps1
 ---
 
 用户输入：$ARGUMENTS
@@ -39,18 +39,18 @@ resource-loading:
 
 **首先检查是否存在风格参考文档**（来自 `/book-internalize`）：
 ```bash
-test -f .specify/memory/style-reference.md && echo "exists" || echo "not-found"
+test -f resources/memory/style-reference.md && echo "exists" || echo "not-found"
 ```
 
-- 如果存在，使用 Read 工具读取 `.specify/memory/style-reference.md`
+- 如果存在，使用 Read 工具读取 `resources/memory/style-reference.md`
 - 然后告诉用户："检测到您已完成对标作品分析，我将参考该风格帮您起草宪法。"
 
 **然后检查现有宪法**：
 ```bash
-test -f .specify/memory/constitution.md && echo "exists" || echo "not-found"
+test -f resources/memory/constitution.md && echo "exists" || echo "not-found"
 ```
 
-- 如果存在（输出 "exists"），使用 Read 工具读取 `.specify/memory/constitution.md` 并准备更新
+- 如果存在（输出 "exists"），使用 Read 工具读取 `resources/memory/constitution.md` 并准备更新
 - 如果不存在（输出 "not-found"），跳过读取步骤，直接准备创建新宪法
 
 ### 2. 收集创作原则
@@ -212,7 +212,7 @@ test -f .specify/memory/constitution.md && echo "exists" || echo "not-found"
 
 ### 7. 输出和保存
 
-- 将宪法保存到 `.specify/memory/constitution.md`
+- 将宪法保存到 `resources/memory/constitution.md`
 - 输出创建/更新成功消息
 - 提示下一步：`/specify` 定义故事规格
 

package/templates/commands/expert.md

@@ -1,7 +1,7 @@
 ---
 description: 专家模式 - 获取专业写作指导
 argument-hint: [plot | character | world | style]
-allowed-tools: Read(//.specify/experts/**), Read(//.specify/experts/**), Read(//plugins/**/experts/**), Read(//plugins/**/experts/**), Bash(find:*), Bash(ls:*), Bash(*)
+allowed-tools: Read(//resources/experts/**), Read(//resources/experts/**), Read(//plugins/**/experts/**), Read(//plugins/**/experts/**), Bash(find:*), Bash(ls:*), Bash(*)
 scripts:
   sh: echo ""
   ps: Write-Output ""
@@ -75,7 +75,7 @@ resource-loading:
 
 ### 执行步骤：
 1. **确认专家类型**
-   - 核心专家：读取 `.specify/experts/core/<type>.md`
+   - 核心专家：读取 `resources/experts/core/<type>.md`
    - 插件专家：读取对应插件的专家文件
 
 2. **加载专家配置**
@@ -131,7 +131,7 @@ resource-loading:
 - 如果专家文件读取失败：
   ```
   专家配置加载失败，请检查文件是否存在：
-  .specify/experts/core/<type>.md
+  resources/experts/core/<type>.md
   ```
 
 ---

package/templates/commands/facts.md

@@ -1,10 +1,10 @@
 ---
 description: 管理和校验故事设定事实的一致性
 argument-hint: [check | update <fact-id> | add | remove <fact-id>] [--volume vol-XX | --range ch-XXX-YYY]
-allowed-tools: Read(//spec/tracking/**), Read(//stories/**/content/**), Write(//spec/tracking/story-facts.json), Bash(bash:*), Bash(powershell:*)
+allowed-tools: Read(//tracking/**), Read(//stories/**/content/**), Write(//tracking/story-facts.json), Bash(bash:*), Bash(powershell:*)
 scripts:
-  sh: .specify/scripts/bash/check-facts.sh
-  ps: .specify/scripts/powershell/check-facts.ps1
+  sh: resources/scripts/bash/check-facts.sh
+  ps: resources/scripts/powershell/check-facts.ps1
 ---
 
 # /facts - 故事设定事实管理
@@ -15,7 +15,7 @@ scripts:
 
 ## 数据源：story-facts.json
 
-**单一数据源原则**：所有可量化的设定事实都应注册在 `spec/tracking/story-facts.json` 中，作为唯一可信来源（Single Source of Truth）。
+**单一数据源原则**：所有可量化的设定事实都应注册在 `tracking/story-facts.json` 中，作为唯一可信来源（Single Source of Truth）。
 
 ### 数据结构示例
 
@@ -125,12 +125,12 @@ scripts:
 - 支持 `--range ch-XXX-YYY` 过滤：`query_facts --chapter_from=XXX --chapter_to=YYY`
 
 **Layer 2: 分片 JSON（次优）**
-- 检测 `spec/tracking/volumes/` 是否存在
-- 无 --volume 参数：读取 `spec/tracking/story-facts.json`（全局事实文件，不按卷分片）
+- 检测 `tracking/volumes/` 是否存在
+- 无 --volume 参数：读取 `tracking/story-facts.json`（全局事实文件，不按卷分片）
 - 有 --volume 参数：读取全局事实文件，按 `source` 字段过滤属于该卷的事实
 
 **Layer 3: 单文件 JSON（兜底）**
-- 读取 `spec/tracking/story-facts.json`
+- 读取 `tracking/story-facts.json`
 
 ### 章节扫描范围
 
@@ -148,7 +148,7 @@ scripts:
 
 #### 执行步骤
 
-1. 读取 `spec/tracking/story-facts.json`
+1. 读取 `tracking/story-facts.json`
 2. 按 category 分组展示所有已注册事实
 3. 展示 rules 列表及当前校验状态（算术是否成立）
 4. 提示用户可用操作：add / remove / update
@@ -418,7 +418,7 @@ scripts:
       当前: "每月收入仅有五百灵石"
       修改为: "每月收入仅有八百灵石"
 
-   3. spec/tracking/plot-tracker.json
+   3. tracking/plot-tracker.json
       当前: "finance-monthly-income": 500
       修改为: "finance-monthly-income": 800
    ```