novelws 3.1.0 → 4.0.0

package/templates/commands/timeline.md

@@ -2,10 +2,10 @@
 name: timeline
 description: 管理和验证故事时间线
 argument-hint: [add | check | show | sync] [--volume vol-XX | --recent N]
-allowed-tools: Read(//spec/tracking/timeline.json), Read(//spec/tracking/timeline.json), Write(//spec/tracking/timeline.json), Write(//spec/tracking/timeline.json), Read(//stories/**/content/**), Read(//stories/**/content/**), Bash(find:*), Bash(*)
+allowed-tools: Read(//tracking/timeline.json), Read(//tracking/timeline.json), Write(//tracking/timeline.json), Write(//tracking/timeline.json), Read(//stories/**/content/**), Read(//stories/**/content/**), Bash(find:*), Bash(*)
 scripts:
-  sh: .specify/scripts/bash/check-timeline.sh
-  ps: .specify/scripts/powershell/check-timeline.ps1
+  sh: resources/scripts/bash/check-timeline.sh
+  ps: resources/scripts/powershell/check-timeline.ps1
 ---
 
 # 时间线管理
@@ -53,8 +53,8 @@ const events = await mcp.call('novelws-mcp/query_timeline', {
 ### Layer 2: 分片 JSON（次优）
 
 ```bash
-# 当 spec/tracking/volumes/ 存在时
-timeline_data=$(cat spec/tracking/volumes/vol-03/timeline.json)
+# 当 tracking/volumes/ 存在时
+timeline_data=$(cat tracking/volumes/vol-03/timeline.json)
 ```
 
 **适用场景**：
@@ -66,7 +66,7 @@ timeline_data=$(cat spec/tracking/volumes/vol-03/timeline.json)
 
 ```bash
 # 传统模式，加载完整文件
-timeline_data=$(cat spec/tracking/timeline.json)
+timeline_data=$(cat tracking/timeline.json)
 ```
 
 **向下兼容**：小型项目（< 300 章）继续使用单文件模式
@@ -109,7 +109,7 @@ timeline_data=$(cat spec/tracking/timeline.json)
 
 ## 时间线数据
 
-时间线信息存储在 `spec/tracking/timeline.json` 中：
+时间线信息存储在 `tracking/timeline.json` 中：
 - 故事内时间（年/月/日）
 - 章节对应关系
 - 重要事件标记
@@ -136,7 +136,7 @@ timeline_data=$(cat spec/tracking/timeline.json)
 
 时间线数据更新遵循以下协议：
 
-### 分片模式（spec/tracking/volumes/ 存在）
+### 分片模式（tracking/volumes/ 存在）
 
 1. **确定目标卷**：
    - 如果命令指定 `--volume vol-XX`，写入对应卷
@@ -150,13 +150,13 @@ timeline_data=$(cat spec/tracking/timeline.json)
 2. **写入分片文件**：
    ```bash
    # 写入指定卷的 timeline.json
-   Write(spec/tracking/volumes/${target_volume}/timeline.json)
+   Write(tracking/volumes/${target_volume}/timeline.json)
    ```
 
 3. **更新全局摘要**（如果事件跨度影响摘要统计）：
    ```bash
    # 更新 timeline-summary.json 的统计信息
-   Write(spec/tracking/summary/timeline-summary.json)
+   Write(tracking/summary/timeline-summary.json)
    ```
 
 4. **触发 MCP 同步**（如果启用）：
@@ -171,7 +171,7 @@ timeline_data=$(cat spec/tracking/timeline.json)
 
 直接写入完整 `timeline.json`：
 ```bash
-Write(spec/tracking/timeline.json)
+Write(tracking/timeline.json)
 ```
 
 ### 写入示例
@@ -184,8 +184,8 @@ const targetVolume = `vol-${String(volumeNum).padStart(2, '0')}`;
 
 // 读取目标卷的 timeline 分片
 const timelinePath = isSharded
-  ? `spec/tracking/volumes/${targetVolume}/timeline.json`
-  : 'spec/tracking/timeline.json';
+  ? `tracking/volumes/${targetVolume}/timeline.json`
+  : 'tracking/timeline.json';
 
 const timeline = JSON.parse(fs.readFileSync(timelinePath));
 

package/templates/commands/track-init.md

@@ -1,10 +1,10 @@
 ---
 name: track-init
 description: 初始化追踪系统，基于故事大纲设置追踪数据
-allowed-tools: Read(//stories/**/specification.md), Read(//stories/**/specification.md), Read(//stories/**/creative-plan.md), Read(//stories/**/creative-plan.md), Write(//spec/tracking/**), Write(//spec/tracking/**), Bash(find:*), Bash(grep:*), Bash(wc:*), Bash(*)
+allowed-tools: Read(//stories/**/specification.md), Read(//stories/**/specification.md), Read(//stories/**/creative-plan.md), Read(//stories/**/creative-plan.md), Write(//tracking/**), Write(//tracking/**), Bash(find:*), Bash(grep:*), Bash(wc:*), Bash(*)
 scripts:
-  sh: .specify/scripts/bash/init-tracking.sh
-  ps: .specify/scripts/powershell/init-tracking.ps1
+  sh: resources/scripts/bash/init-tracking.sh
+  ps: resources/scripts/powershell/init-tracking.ps1
 ---
 
 # 初始化追踪系统
@@ -38,13 +38,13 @@ resource-loading:
 1. **读取基础数据**
    - 读取 `stories/*/specification.md` 获取故事设定
    - 读取 `stories/*/creative-plan.md` 获取章节规划
-   - 读取 `.specify/config.json` 获取写作方法
+   - 读取 `resources/config/config.json` 获取写作方法
 
 2. **初始化追踪文件**
 
    **重要**：优先从 `specification.md` 第五章读取线索管理规格，填充到追踪文件。
 
-   创建或更新 `spec/tracking/plot-tracker.json`：
+   创建或更新 `tracking/plot-tracker.json`：
    - 从 `specification.md 5.1节` 读取所有线索定义
    - 从 `specification.md 5.3节` 读取所有交汇点
    - 从 `specification.md 5.4节` 读取所有伏笔
@@ -111,15 +111,15 @@ resource-loading:
    }
    ```
 
-   创建或更新 `spec/tracking/timeline.json`：
+   创建或更新 `tracking/timeline.json`：
    - 根据章节规划设置时间节点
    - 标记重要时间事件
 
-   创建或更新 `spec/tracking/relationships.json`：
+   创建或更新 `tracking/relationships.json`：
    - 从角色设定提取初始关系
    - 设置派系分组
 
-   创建或更新 `spec/tracking/character-state.json`：
+   创建或更新 `tracking/character-state.json`：
    - 初始化角色状态
    - 设置起始位置
 

package/templates/commands/track.md

@@ -3,10 +3,10 @@ name: track
 description: 综合追踪小说创作进度和内容
 argument-hint: [--brief | --plot | --stats | --check [--volume vol-XX] | --fix | --sync [--incremental] | --migrate [--auto | --volumes "1-100,101-200"] | --log]
 recommended-model: claude-haiku-4-5-20251001 # --sync 数据更新速度优先；--check 深度检查可用 sonnet
-allowed-tools: Read(//spec/tracking/**), Read(//spec/tracking/**), Read(//stories/**), Read(//stories/**), Bash(find:*), Bash(wc:*), Bash(grep:*), Bash(*)
+allowed-tools: Read(//tracking/**), Read(//tracking/**), Read(//stories/**), Read(//stories/**), Bash(find:*), Bash(wc:*), Bash(grep:*), Bash(*)
 scripts:
-  sh: .specify/scripts/bash/track-progress.sh
-  ps: .specify/scripts/powershell/track-progress.ps1
+  sh: resources/scripts/bash/track-progress.sh
+  ps: resources/scripts/powershell/track-progress.ps1
 ---
 
 # 综合进度追踪
@@ -53,12 +53,12 @@ resource-loading:
 
 整合多个追踪文件的信息：
 - `progress.json` - 写作进度
-- `spec/tracking/plot-tracker.json` - 情节追踪
-- `spec/tracking/timeline.json` - 时间线
-- `spec/tracking/relationships.json` - 关系网络
-- `spec/tracking/character-state.json` - 角色状态
-- `spec/tracking/narrative-threads.json` - **[新增]** 多线叙事追踪（POV调度、信息差、线程交汇）
-- `spec/tracking/validation-rules.json` - **[新增]** 验证规则（用于--check和--fix）
+- `tracking/plot-tracker.json` - 情节追踪
+- `tracking/timeline.json` - 时间线
+- `tracking/relationships.json` - 关系网络
+- `tracking/character-state.json` - 角色状态
+- `tracking/narrative-threads.json` - **[新增]** 多线叙事追踪（POV调度、信息差、线程交汇）
+- `tracking/validation-rules.json` - **[新增]** 验证规则（用于--check和--fix）
 
 ---
 
@@ -196,7 +196,7 @@ resource-loading:
 
 ### 实现逻辑
 
-1. 读取 `spec/tracking/tracking-log.md`，解析日志格式
+1. 读取 `tracking/tracking-log.md`，解析日志格式
 2. 根据过滤条件筛选，按时间倒序排列
 3. 默认仅加载摘要（轻量级），选择"查看详情"时加载完整 diff
 4. 大型日志（>1000 条）分页显示
@@ -209,7 +209,7 @@ resource-loading:
 
 ```
 ℹ️ 提示：tracking-log.md 不存在
-- 位置：spec/tracking/tracking-log.md
+- 位置：tracking/tracking-log.md
 - 原因：尚未执行过任何 tracking 更新命令
 - 建议：执行 /write 或 /plan 命令后会自动创建
 ```
@@ -335,7 +335,7 @@ resource-loading:
 **数据收集**：
 - 读取所有章节文件（`content/*.md`）
 - 读取 `tasks.md`、`creative-plan.md`
-- 读取 `spec/tracking/character-state.json`、`spec/tracking/plot-tracker.json`
+- 读取 `tracking/character-state.json`、`tracking/plot-tracker.json`
 
 #### 总览面板
 
@@ -515,7 +515,7 @@ Phase 3: 生成综合报告
 
 只处理上次同步后的新章节：
 
-1. 读取 `spec/tracking/tracking-log.md` 最后一条记录，获取 last_sync_chapter
+1. 读取 `tracking/tracking-log.md` 最后一条记录，获取 last_sync_chapter
 2. 扫描 `stories/[current]/content/` 中编号 > last_sync_chapter 的章节
 3. 只对这些新章节执行 tracking 更新
 4. 更新 tracking-log.md 记录本次同步
@@ -591,17 +591,17 @@ Phase 3: 生成综合报告
 
 读取 tracking 数据时按以下优先级：
 1. **MCP 查询（优先）**：调用对应 MCP 工具获取精确数据
-2. **分片 JSON（次优）**：读取 `spec/tracking/volumes/[currentVolume]/` 下的分片文件
-3. **单文件 JSON（兜底）**：读取 `spec/tracking/` 下的单文件
+2. **分片 JSON（次优）**：读取 `tracking/volumes/[currentVolume]/` 下的分片文件
+3. **单文件 JSON（兜底）**：读取 `tracking/` 下的单文件
 
 **分片模式写入：**
 1. 确定当前章节属于哪个卷（从 volume-summaries.json 的 chapters 范围判断）
-2. 更新该卷的分片文件（如 `spec/tracking/volumes/vol-03/character-state.json`）
+2. 更新该卷的分片文件（如 `tracking/volumes/vol-03/character-state.json`）
 3. 同步更新全局摘要文件（如 characters-summary.json 的 activeCount）
 4. 如果 MCP 可用，调用 `sync_from_json` 同步到 SQLite
 
 **单文件模式写入：**
-- 直接更新 `spec/tracking/` 下的文件（现有逻辑）
+- 直接更新 `tracking/` 下的文件（现有逻辑）
 
 ---
 
@@ -646,7 +646,7 @@ powershell -File {SCRIPT_DIR}/migrate-tracking.ps1 -Mode auto -Json
 
 按卷边界拆分 character-state / timeline / relationships / plot-tracker 四个文件：
 - 拆分原则：按 chapter 分配数据到对应卷，跨卷数据保留引用
-- 写入 `spec/tracking/volumes/vol-XX/`
+- 写入 `tracking/volumes/vol-XX/`
 
 拆分规则概要：
 | 文件 | 拆分方式 |
@@ -657,7 +657,7 @@ powershell -File {SCRIPT_DIR}/migrate-tracking.ps1 -Mode auto -Json
 | plot-tracker.json | foreshadowing 按 planted.chapter 分配（跨卷未解决伏笔保留引用）；plotlines 每卷记录进展；checkpoints 按卷分配 |
 
 **阶段 4：生成全局摘要**
-- 生成 4 个摘要文件到 `spec/tracking/summary/`：
+- 生成 4 个摘要文件到 `tracking/summary/`：
   - characters-summary.json — 活跃/归档角色统计
   - plot-summary.json — 未解决伏笔汇总、回收统计
   - timeline-summary.json — 每卷关键里程碑、故事时间范围
@@ -678,15 +678,15 @@ powershell -File {SCRIPT_DIR}/migrate-tracking.ps1 -Mode auto -Json
 ━━━━━━━━━━━━━━━━━━━
 迁移前：单文件模式，总大小 XXX KB
 迁移后：N 卷分片，每卷平均 XX KB
-备份位置：spec/tracking/backup/YYYYMMDD-HHMMSS/
+备份位置：tracking/backup/YYYYMMDD-HHMMSS/
 ```
 
 ### 错误处理
 
 任何步骤失败时，提示用户从备份恢复：
 ```
-迁移失败。备份文件在 spec/tracking/backup/YYYYMMDD-HHMMSS/
-可以手动将备份文件复制回 spec/tracking/ 恢复原状。
+迁移失败。备份文件在 tracking/backup/YYYYMMDD-HHMMSS/
+可以手动将备份文件复制回 tracking/ 恢复原状。
 ```
 不自动删除备份，由用户手动清理。
 

package/templates/commands/volume-summary.md

@@ -55,8 +55,8 @@ const timeline = await mcp.call('novelws-mcp/query_timeline', {
 ### Layer 2: 分片 JSON（次优）
 
 ```bash
-# 当 spec/tracking/volumes/ 存在时
-VOLUME_DIR="spec/tracking/volumes/vol-03"
+# 当 tracking/volumes/ 存在时
+VOLUME_DIR="tracking/volumes/vol-03"
 
 # 读取该卷所有 tracking 数据
 cat "$VOLUME_DIR/character-state.json"
@@ -75,7 +75,7 @@ cat "$VOLUME_DIR/story-facts.json"
 
 ```bash
 # 传统模式，加载完整文件后手动过滤卷
-character_state=$(cat spec/tracking/character-state.json | jq ".characters | map(select(.volume == \"vol-03\"))")
+character_state=$(cat tracking/character-state.json | jq ".characters | map(select(.volume == \"vol-03\"))")
 ```
 
 **向下兼容**：小型项目（< 300 章）继续使用单文件模式，摘要覆盖全书
@@ -102,7 +102,7 @@ const shouldExport = args.export || false;
 ### Step 2: 检测数据模式
 
 ```javascript
-const isSharded = fs.existsSync('spec/tracking/volumes/');
+const isSharded = fs.existsSync('tracking/volumes/');
 const hasMCP = fs.existsSync('mcp-servers.json');
 
 // 选择数据源
@@ -129,7 +129,7 @@ const data = await loadVolumeDataFromMCP(volumeId);
 #### 分片模式
 
 ```bash
-VOLUME_DIR="spec/tracking/volumes/${volumeId}"
+VOLUME_DIR="tracking/volumes/${volumeId}"
 
 if [[ ! -d "$VOLUME_DIR" ]]; then
   echo "错误：卷目录不存在：$VOLUME_DIR"
@@ -406,7 +406,7 @@ JSON 数据可用于：
 用户：/volume-summary vol-05
 助手：检测到分片模式...
 
-数据来源：spec/tracking/volumes/vol-05/
+数据来源：tracking/volumes/vol-05/
 ✓ character-state.json
 ✓ relationships.json
 ✓ plot-tracker.json

package/templates/commands/write.md

@@ -4,8 +4,8 @@ argument-hint: [章节编号或任务ID] [--fast] [--batch N] [--volume vol-XX]
 recommended-model: claude-opus-4-6 # 创作质量最高；--fast 时可用 sonnet
 allowed-tools: Read(//**), Write(//stories/**/content/**), Bash(ls:*), Bash(find:*), Bash(wc:*), Bash(grep:*), Bash(*)
 scripts:
-  sh: .specify/scripts/bash/check-writing-state.sh
-  ps: .specify/scripts/powershell/check-writing-state.ps1
+  sh: resources/scripts/bash/check-writing-state.sh
+  ps: resources/scripts/powershell/check-writing-state.ps1
 ---
 
 基于七步方法论流程执行章节写作。
@@ -77,26 +77,71 @@ powershell -File {SCRIPT} -Json
 3. 按顺序加载 `resources.knowledge-base` 和 `resources.skills`
 4. 跳过 `resources.disabled` 中的资源
 
+### 增量缓存加载（性能优化核心）
+
+⚠️ **此机制大幅减少重复加载，连续写作时跳过未变化的资源。**
+
+**步骤 0: 检查缓存**
+
+```
+1. 读取 .claude/.cache/resource-digest.json
+   ├─ 不存在 → 首次加载（全量），生成 digest + context
+   └─ 存在 → 进入增量检查
+
+2. 对比每个已缓存文件的 mtime（用 Bash stat 命令）
+   ├─ 全部未变 → 直接复用 .claude/.cache/write-context.json，跳到 L0 加载
+   └─ 有变化 → 只重新读取变化的文件
+
+3. 更新 write-context.json 中变化的部分
+   ├─ L1 文件变化 → 重新生成该文件的摘要（200-300字）
+   └─ L2 文件变化 → 重新缓存全文
+
+4. 写回更新后的 resource-digest.json + write-context.json
+```
+
+**资源分级**：
+
+| 级别 | 内容 | 策略 |
+|------|------|------|
+| L0 必读 | tasks.md、上一章最后500字、当前活跃角色 | 每次读取全文，不缓存 |
+| L1 摘要 | constitution.md、specification.md、creative-plan.md、plot-tracker.json、relationships.json | 首次读全文生成摘要，后续只在 mtime 变化时重新生成 |
+| L2 按需 | craft/、genres/、styles/、requirements/、skills/ | 仅在关键词触发或配置指定时加载，加载后缓存全文 |
+
+**缓存复用判定**：
+- 如果 `write-context.json` 存在且 `digest_version` 与 `resource-digest.json` 的 `version` 一致 → 复用 L1 摘要 + L2 缓存
+- 如果 `digest_version` 不一致 → 全量重建
+- 用户删除 `.claude/.cache/` → 下次全量重建
+
+**首次加载（无缓存）**：按下方完整查询协议执行，完成后生成两个缓存文件。
+
+**后续加载（有缓存且未过期）**：
+1. 直接使用 `write-context.json` 中的 `l1_summaries` 作为 L1 上下文
+2. 直接使用 `l2_loaded` 中的缓存资源
+3. 仅实时加载 L0 资源（tasks.md、上一章、活跃角色）
+4. 合并 L0 + L1 缓存 + L2 缓存 → 进入写作
+
+---
+
 ### 查询协议（必读顺序 + 三层资源加载）
 
-⚠️ **严格按以下顺序查询文档**：
+⚠️ **严格按以下顺序查询文档**（首次加载或缓存失效时执行完整流程）：
 
-1. **先查（最高优先级）**：
+1. **先查（最高优先级）**【L1 — 缓存摘要】：
    - `memory/constitution.md`（创作宪法）
    - `memory/personal-voice.md`（个人风格指南 - 如有）
    - `memory/style-reference.md`（风格参考 - 如有）
 
-2. **再查（规格和计划）**：
+2. **再查（规格和计划）**【L1 — 缓存摘要】：
    - `stories/*/specification.md`（故事规格）
    - `stories/*/creative-plan.md`（创作计划）
-   - `stories/*/tasks.md`（当前任务）
+   - `stories/*/tasks.md`（当前任务）【L0 — 每次必读】
 
 2.1. **风格学习前置检查**：
    - 如果 `memory/personal-voice.md` 不存在且已写 ≥ 3 章，提示用户执行 `/style-learning`
 
 2.5. **自动加载写作风格和规范（基于配置）**：
    - 读取 `specification.md` 的 YAML frontmatter
-   - 如配置了 `writing-style`，加载 `.specify/templates/knowledge-base/styles/[name].md`
+   - 如配置了 `writing-style`，加载 `resources/styles/[name].md`
    - 如配置了 `writing-requirements`，加载对应规范文档
 
 2.6. **第三层智能资源加载（三层机制）**
@@ -108,11 +153,11 @@ powershell -File {SCRIPT} -Json
 如果 specification.md 未配置 `resource-loading`，自动加载：
 
 **Knowledge-base (craft)**:
-- `templates/knowledge-base/craft/dialogue.md`
-- `templates/knowledge-base/craft/scene-structure.md`
-- `templates/knowledge-base/craft/character-arc.md`
-- `templates/knowledge-base/craft/pacing.md`
-- `templates/knowledge-base/craft/show-not-tell.md`
+- `resources/craft/dialogue.md`
+- `resources/craft/scene-structure.md`
+- `resources/craft/character-arc.md`
+- `resources/craft/pacing.md`
+- `resources/craft/show-not-tell.md`
 
 **Skills (writing-techniques)**:
 - `templates/skills/writing-techniques/dialogue-techniques/SKILL.md`
@@ -151,7 +196,7 @@ resource-loading:
 
 **执行流程**:
 1. 收集待扫描文本（命令参数 + 任务描述 + 用户输入）
-2. 读取 `templates/config/keyword-mappings.json` 映射表
+2. 读取 `resources/config/keyword-mappings.json` 映射表
 3. 合并 specification.md 中的自定义映射
 4. 执行关键词匹配，跳过已加载资源
 5. 如有匹配，提示用户确认加载：
@@ -169,28 +214,28 @@ resource-loading:
 
 > **性能优化**：参见 CLAUDE.md 中的「会话级资源复用」章节。
 
-3. **再查（状态和数据 — 三层 Fallback）**：
+3. **再查（状态和数据 — 三层 Fallback）**【L0/L1 混合】：
 
    按以下优先级加载 tracking 数据：
 
-   **Layer 1: MCP 查询（优先）**
+   **Layer 1: MCP 查询（优先）**【L0 — 每次查询】
    - `query_characters --status=active --limit=20` → 活跃角色
    - `query_relationships --volume=[当前卷号]` → 当前卷关系
    - `query_plot --status=active` → 活跃伏笔
    - `query_facts` → 设定事实
    - 如果指定了 `--volume vol-XX`，所有查询限定到该卷
 
-   **Layer 2: 分片 JSON（次优，检测 spec/tracking/volumes/ 是否存在）**
+   **Layer 2: 分片 JSON（次优，检测 tracking/volumes/ 是否存在）**【L1 — 缓存摘要】
    - 确定当前章节属于哪个卷（从 volume-summaries.json 的 chapters 范围判断）
-   - 读取该卷的分片文件：`spec/tracking/volumes/[currentVolume]/character-state.json` 等
-   - 读取全局摘要：`spec/tracking/summary/characters-summary.json`（活跃角色概览）
+   - 读取该卷的分片文件：`tracking/volumes/[currentVolume]/character-state.json` 等
+   - 读取全局摘要：`tracking/summary/characters-summary.json`（活跃角色概览）
 
-   **Layer 3: 单文件 JSON（兜底，现有逻辑）**
-   - `spec/tracking/character-state.json`（角色状态）
-   - `spec/tracking/relationships.json`（关系网络）
-   - `spec/tracking/plot-tracker.json`（情节追踪 - 如有）
-   - `spec/tracking/validation-rules.json`（验证规则 - 如有）
-   - `spec/tracking/story-facts.json`（设定事实 - 如有）
+   **Layer 3: 单文件 JSON（兜底，现有逻辑）**【L1 — 缓存摘要】
+   - `tracking/character-state.json`（角色状态）
+   - `tracking/relationships.json`（关系网络）
+   - `tracking/plot-tracker.json`（情节追踪 - 如有）
+   - `tracking/validation-rules.json`（验证规则 - 如有）
+   - `tracking/story-facts.json`（设定事实 - 如有）
 
    **📋 本章引用的设定事实**（如当前章节已有 `<!-- story-facts: ... -->` 注释）：
 
@@ -210,17 +255,17 @@ resource-loading:
 
    - **快写模式（--fast）**: 跳过详细展示，但保留数据加载
 
-4. **再查（知识库）**：
-   - `spec/knowledge/` 相关文件（世界观、角色档案等）
+4. **再查（知识库）**【L2 — 按需缓存】：
+   - `resources/knowledge/` 相关文件（世界观、角色档案等）
    - `stories/*/content/`（前文内容 - 了解前情）
 
-5. **再查（写作规范）**：
+5. **再查（写作规范）**【L2 — 按需缓存】：
    - `memory/personal-voice.md`（个人语料 - 如有）
-   - `spec/knowledge/natural-expression.md`（自然化表达 - 如有）
-   - **⚠️ 必须加载**：`templates/knowledge-base/requirements/anti-ai-v4.md`（禁用词与替换策略权威参考）
+   - `resources/knowledge/natural-expression.md`（自然化表达 - 如有）
+   - **⚠️ 必须加载**：`resources/requirements/anti-ai-v4.md`（禁用词与替换策略权威参考）
 
 6. **条件查询（前三章专用）**：
-   - **如果章节编号 ≤ 3 或总字数 < 10000字**，额外查询 `spec/presets/golden-opening.md`
+   - **如果章节编号 ≤ 3 或总字数 < 10000字**，额外查询 `resources/presets/golden-opening.md`
 
 ### ⚠️ 强制完成确认
 
@@ -233,7 +278,7 @@ resource-loading:
 ✓ 2. stories/*/specification.md - 故事规格
 ✓ 3. stories/*/creative-plan.md - 创作计划
 ✓ 4. stories/*/tasks.md - 当前任务
-✓ 5. spec/tracking/ - 角色状态、关系、情节
+✓ 5. tracking/ - 角色状态、关系、情节
 
 🆕 三层资源加载：
 ✓ Layer 1-3 加载完成
@@ -244,6 +289,48 @@ resource-loading:
 
 ⚠️ **禁止跳过此步骤**：这是防止AI在长篇创作中失焦的核心机制。
 
+### 缓存写回
+
+**首次加载或有文件变化时**，将加载结果写入缓存：
+
+1. **生成 resource-digest.json**：记录所有已读文件的 mtime 和 size
+```json
+{
+  "version": 1,
+  "updated_at": "[ISO时间]",
+  "files": {
+    "resources/memory/constitution.md": { "mtime": [毫秒时间戳], "size": [字节] },
+    "tracking/character-state.json": { "mtime": [毫秒时间戳], "size": [字节] }
+  }
+}
+```
+
+2. **生成 write-context.json**：保存 L1 摘要和 L2 缓存状态
+```json
+{
+  "version": 1,
+  "story": "[故事目录名]",
+  "last_chapter": [章节号],
+  "generated_at": "[ISO时间]",
+  "digest_version": 1,
+  "context": {
+    "l1_summaries": {
+      "constitution": "[200字摘要]",
+      "specification": "[300字摘要]",
+      "creative_plan": "[200字摘要]",
+      "active_plots": [{"id": "", "name": "", "status": "", "progress": ""}],
+      "active_relationships": [{"from": "", "to": "", "type": "", "tension": ""}]
+    },
+    "l2_loaded": {
+      "resources/craft/dialogue.md": "已缓存",
+      "resources/requirements/anti-ai-v5-balanced.md": "已缓存"
+    }
+  }
+}
+```
+
+3. 使用 `Write` 工具写入 `.claude/.cache/resource-digest.json` 和 `.claude/.cache/write-context.json`
+
 <!-- PLUGIN_HOOK: genre-knowledge-write -->
 
 ---
@@ -259,7 +346,7 @@ resource-loading:
 **仅加载以下 3 项**（跳过三层资源加载）：
 1. **当前任务**：`stories/*/tasks.md` 中 `pending` 或 `in_progress` 的任务
 2. **上一章内容**：最近完成的章节文件（最后 500 字）
-3. **角色状态**：`spec/tracking/character-state.json`（仅当前活跃角色）
+3. **角色状态**：`tracking/character-state.json`（仅当前活跃角色）
 
 ### Fast-2. 极简写作提醒
 
@@ -290,7 +377,7 @@ resource-loading:
 
 ### 恢复检测
 
-在开始写作前，检查 `spec/tracking/write-checkpoint.json`：
+在开始写作前，检查 `tracking/write-checkpoint.json`：
 - 如存在且 `status` 为 `in_progress` 且未过期（24小时内）→ 提示恢复
 - 用户选择「继续写作」→ 从断点恢复
 - 用户选择「重新开始」→ 删除 checkpoint，正常流程
@@ -380,7 +467,7 @@ resource-loading:
 **📋 禁用词与替换策略**：
 
 > **引用外部规范**：完整的禁用词黑名单（200+ 词）和替换策略表，请参阅：
-> `templates/knowledge-base/requirements/anti-ai-v4.md`
+> `resources/requirements/anti-ai-v4.md`
 >
 > ⚠️ **写作时必须加载此文件**，作为禁用词和替换的权威参考。
 
@@ -415,7 +502,7 @@ resource-loading:
 
 写完一段后，主动识别并替换抽象表达。
 
-> **完整清单和示例**：首次写作时读取 `templates/knowledge-base/requirements/concretization.md`
+> **完整清单和示例**：首次写作时读取 `resources/requirements/concretization.md`
 >
 > 核心要点：
 > - 时间具体化（避免"最近"、"很久"）
@@ -437,7 +524,7 @@ resource-loading:
 
 **字数统计**：使用项目提供的脚本验证：
 ```bash
-source .specify/scripts/bash/common.sh
+source resources/scripts/bash/common.sh
 count_chinese_words "stories/*/content/第X章.md"
 ```
 ⚠️ 不要使用 `wc -w` 统计中文字数。
@@ -471,12 +558,12 @@ count_chinese_words "stories/*/content/第X章.md"
 3. **合并更新**：将新内容增量合并到现有数据
 4. **写入 tracking 数据**：
    - **分片模式**：确定当前章节所属卷，更新该卷的分片文件，同步更新全局摘要
-   - **单文件模式**：直接更新 `spec/tracking/` 下的文件
+   - **单文件模式**：直接更新 `tracking/` 下的文件
 5. **MCP 同步**（如果可用）：
    - `log_writing_session` — 记录本次写作的章节号、字数
    - `sync_from_json` — 将更新后的 tracking 数据同步到 SQLite
    - 更新 FTS 索引 — 将新章节内容索引到全文检索
-6. **记录日志**：追加到 `spec/tracking/tracking-log.md`
+6. **记录日志**：追加到 `tracking/tracking-log.md`
 
 > **详细格式和示例**：参见 `.claude/skills/auto-tracking/SKILL.md`
 

package/templates/dot-claude/CLAUDE.md

@@ -9,7 +9,7 @@
 - **句式**：短句优先（15-25 字），白话替代文绉绉
 - **描写**：删除装饰性形容词，一个准确细节胜过三个堆砌
 - **禁止**：「然而」「殊不知」「缓缓」「深邃」「仿佛...一般」等 AI 高频词
-- **完整规范**：`.specify/templates/knowledge-base/requirements/anti-ai-v4.md`
+- **完整规范**：`resources/requirements/anti-ai-v4.md`
 
 ## 段落格式规范
 
@@ -44,7 +44,7 @@
 **补充上下文来源**（不依赖前文全文）：
 - `creative-plan.md`：章节大纲和情节走向
 - `tasks.md`：当前章节具体写作任务
-- `spec/tracking/*.json`：角色状态、关系、情节线、时间线
+- `tracking/*.json`：角色状态、关系、情节线、时间线
 
 ## /compact 使用建议
 
@@ -60,7 +60,7 @@
 ### 目录结构（分片模式）
 
 ```
-spec/tracking/
+tracking/
 ├── story-facts.json          # 全局事实库
 ├── tracking-log.md           # 全局更新日志
 ├── summary/                  # 全局摘要（跨卷查询入口）
@@ -108,7 +108,7 @@ spec/tracking/
 
 **迁移流程**：
 1. **检查模式**：分析当前 tracking 文件大小
-2. **备份数据**：创建时间戳备份（`spec/tracking-backup-YYYYMMDD/`）
+2. **备份数据**：创建时间戳备份（`tracking-backup-YYYYMMDD/`）
 3. **自动分片**：
    - 创建 `summary/` 和 `volumes/` 目录
    - 按卷拆分 tracking 数据（默认每卷 50 章）
@@ -149,7 +149,7 @@ spec/tracking/
 novelws init my-novel --with-mcp
 
 # 或在现有项目中配置
-# 编辑 .specify/config.json，添加：
+# 编辑 resources/config/config.json，添加：
 {
   "mcp": true
 }