---
name: webnovel-plan
description: Builds volume and chapter outlines from the total outline, inherits creative constraints, and prepares writing-ready chapter plans. Use when the user asks for outlining or runs /webnovel-plan.
allowed-tools: Read Write Edit Grep Bash Task
---

# Outline Planning

Purpose: refine 总纲 into volume + chapter outlines. Do not redesign the global story.
Setting policy: 先基于 init 产出的总纲+世界观补齐设定集基线；再在卷纲完成后，直接对现有设定集做增量补充。

## Project Root Guard
- Claude Code 的“工作区根目录”不一定等于“书项目根目录”。常见结构：工作区为 `D:\wk\xiaoshuo`，书项目为 `D:\wk\xiaoshuo\凡人资本论`。
- 必须先解析 `PROJECT_ROOT` 为真实书项目根（必须包含 `.webnovel/state.json`），后续所有读写路径都以该目录为准。

环境设置（bash 命令执行前）：
```bash
export WORKSPACE_ROOT="${CLAUDE_PROJECT_DIR:-$PWD}"

if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan" ]; then
  echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan" >&2
  exit 1
fi
export SKILL_ROOT="${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan"

if [ -z "${CLAUDE_PLUGIN_ROOT}" ] || [ ! -d "${CLAUDE_PLUGIN_ROOT}/scripts" ]; then
  echo "ERROR: 未设置 CLAUDE_PLUGIN_ROOT 或缺少目录: ${CLAUDE_PLUGIN_ROOT}/scripts" >&2
  exit 1
fi
export SCRIPTS_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"

export PROJECT_ROOT="$(python "${SCRIPTS_DIR}/webnovel.py" --project-root "${WORKSPACE_ROOT}" where)"
```

## References（按步骤导航）

- Step 3（必读，节拍表模板）：[大纲-卷节拍表.md](../../templates/output/大纲-卷节拍表.md)
- Step 4.5（必读，时间线模板）：[大纲-卷时间线.md](../../templates/output/大纲-卷时间线.md)
- Step 4（必读，题材配置）：[genre-profiles.md](../../references/genre-profiles.md)
- Step 4（必读，Strand 节奏）：[strand-weave-pattern.md](../../references/shared/strand-weave-pattern.md)
- Step 4（可选，爽点结构需要细化）：[cool-points-guide.md](../../references/shared/cool-points-guide.md)
- Step 5/6（可选，冲突强度分层）：[conflict-design.md](references/outlining/conflict-design.md)
- Step 5（可选，需要钩子/节奏细分）：[reading-power-taxonomy.md](../../references/reading-power-taxonomy.md)
- Step 6（可选，章节微结构细化）：[chapter-planning.md](references/outlining/chapter-planning.md)
- Step 4/5（可选，电竞/直播文/克苏鲁）：[genre-volume-pacing.md](references/outlining/genre-volume-pacing.md)
- 归档（不进主流程）：`references/outlining/outline-structure.md`、`references/outlining/plot-frameworks.md`

## Reference Loading Levels (strict, lazy)

Use progressive disclosure and load only what current step requires:
- L0: No references before scope/volume is confirmed.
- L1: Before each step, load only the “必读” items in **References（按步骤导航）**.
- L2: Load optional items only when the trigger condition applies.

## Workflow
1. Load project data.
2. Build setting baseline from 总纲 + 世界观 (in-place incremental).
3. Select volume and confirm scope.
4. Generate volume beat sheet (节拍表).
4.5. Generate volume timeline (时间线表).
5. Generate volume skeleton.
6. Generate chapter outlines in batches.
7. Enrich existing setting files from volume outline (in-place incremental).
8. Validate + save + update state.

## 1) Load project data
```bash
cat "$PROJECT_ROOT/.webnovel/state.json"
cat "$PROJECT_ROOT/大纲/总纲.md"
```

Optional (only if they exist):
- `设定集/主角组.md`
- `设定集/女主卡.md`
- `设定集/反派设计.md`
- `设定集/世界观.md`
- `设定集/力量体系.md`
- `设定集/主角卡.md`
- `设定集/典故引用库.md`（若存在：本卷引用规划的输入源）
- `设定集/原创诗词口诀.md`（若存在：原创口诀优先于外部典故）
- `.webnovel/idea_bank.json` (inherit constraints)

If 总纲.md lacks volume ranges / core conflict / climax, ask the user to fill those before proceeding.

**创意约束文件完整性检查（Soft warning）**:
以下文件若缺失，后续 write 流程会降级处理（不阻断 plan）：
- `设定集/叙事声音.md`（缺失 → style-adapter 使用分题材默认，跨章风格一致性降低）
- `设定集/情感蓝图.md`（缺失 → emotion-checker 跳过蓝图对标）
- `设定集/开篇策略.md`（缺失 → Ch1-3 使用 Golden Opening Protocol 通用默认）
若缺失，在 plan 开始前提示用户：“建议先运行 /webnovel-init 补齐设定集”。

### Step 1.5 · Cross-volume awareness（Round 19 Phase E · upstream@3e36417 借鉴）

下卷规划前**必须**读已写章节真实数据，不能只看大纲：

1. 跑：
   ```bash
   python -X utf8 ${SCRIPTS_DIR}/webnovel.py --project-root "${PROJECT_ROOT}" \
     state get-recent-meta --last-n 10
   ```
   取最近 10 章 `hook_close / hook_type / unresolved_loops / overall_score / narrative_version`。

2. （Phase G 之后追加）跑：
   ```bash
   python -X utf8 ${SCRIPTS_DIR}/webnovel.py --project-root "${PROJECT_ROOT}" \
     state get-hook-trend --last-n 10
   ```
   取 4 类钩子分布。

3. 在新卷规划必须**显式回应**：
   - 至少 1 个上卷未解决伏笔在本卷开篇 3 章内被触及
   - 主角金手指曲线在新卷保持单调或带显式弱化事件
   - 上卷读者钩子若 overall_score < 70，新卷开篇加强同类钩子
   - 上卷 hook_type 若连续 5+ 章相同 → 新卷必须切换钩子类型

### 不做 Cross-volume 检查的章节

第 1 卷规划（无前卷数据）→ 跳过 Step 1.5，仅按既有 Step 1 大纲流程。

## 2) Build setting baseline from 总纲 + 世界观
目标：在不推翻现有内容的前提下，让设定集从“骨架模板”进入“可规划可写作”的基线状态。

输入来源：
- `大纲/总纲.md`
- `设定集/世界观.md`
- `设定集/力量体系.md`
- `设定集/主角卡.md`
- `设定集/反派设计.md`

执行规则（必须）：
- 只做增量补齐，不清空、不重写整文件。
- 优先补齐“可执行字段”：角色定位、势力关系、能力边界、代价规则、反派层级映射。
- 若总纲与现有设定冲突，先列冲突并阻断，等待用户裁决后再改。

基线补齐最小要求：
- `设定集/世界观.md`：世界规则边界、社会结构、关键地点用途。
- `设定集/力量体系.md`：境界链/能力限制/代价与冷却。
- `设定集/主角卡.md`：欲望、缺陷、初始资源与限制。
- `设定集/反派设计.md`：小/中/大反派层级与主角镜像关系。

## 2.5) 卷前调研（必做）

目标：在规划本卷章纲前，通过搜索获取专业知识和创作参考，确保大纲有真实细节支撑。

**搜索统一使用 Tavily 直连 API 脚本**（`${SCRIPTS_DIR}/tavily_search.py`），禁止使用 MCP 工具。

```
卷前调研（至少5次search）：
1. 搜索本卷涉及的专业领域（2-3次）
   python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "机甲拆解 技术 废品回收" --max 5
   python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "遗迹暴走 失控机甲 设定参考" --max 5
2. 搜索同题材近6个月内爆款的节奏和创新点（1-2次）
   python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "科幻机甲 网文 2025 2026 热门 爆款 节奏" --max 5
3. 搜索本卷关键场景类型的写作技巧（1-2次）
   python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "机甲战斗场景 描写技巧" --max 5
4. 复杂专业领域用深度研究模式
   python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" research "太空探索遗迹考古的物理原理和技术细节" --model pro
5. 将调研结果保存到 调研笔记/ 对应主题文件
6. 在后续Step中引用调研笔记作为参考输入
```

Search 失败处理：同 webnovel-write 的失败协议——立即停止，检查 Tavily API key 配置。

## 3) Select volume
- Offer choices from 总纲.md (卷名 + 章节范围).
- Confirm any special requirement (tone, POV emphasis, romance, etc.).
If 总纲缺少卷名/章节范围/核心冲突/卷末高潮，先补问并更新总纲，再继续。

## 4) Generate volume beat sheet (节拍表)
目标：先把本卷“承诺→危机递增→中段反转→最低谷→大兑现+新钩子”钉死，避免卷中段漂移。

Load template:
```bash
cat "${SKILL_ROOT}/../../templates/output/大纲-卷节拍表.md"
```

执行前搜索（推荐）：
```bash
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "网文 {题材} 节奏 节拍 结构" --max 5
python -X utf8 "${SCRIPTS_DIR}/tavily_search.py" search "网文 {爽点类型} 写法 案例" --max 5
```

Must satisfy (hard requirements):
- **中段反转（必填）**：不得留空；若无，写 `无（理由：...）`
- **危机链**：至少 3 次递增（表格 1-3 行不得空）
- **卷末新钩子**：必须能落到“最后一章的章末未闭合问题”

Write output:
```bash
cat > "$PROJECT_ROOT/大纲/第${volume_id}卷-节拍表.md" << 'EOF'
{beat_sheet_content}
EOF
```

Completion criteria:
- `大纲/第{volume_id}卷-节拍表.md` 存在且非空
- Step 4/5 能直接引用 Catalyst / 中段反转 / 最低谷 / 大兑现 / 新钩子来锚定节奏

## 4.5) Generate volume timeline (时间线表)

目标：为本卷建立时间轴基准，确保章节间时间推进逻辑自洽，避免“第一章灾变第二章火拼”的时间跳跃问题。

Load template:
```bash
cat "${SKILL_ROOT}/../../templates/output/大纲-卷时间线.md"
```

Must satisfy (hard requirements):
- **时间基准（必填）**：明确本卷使用的时间体系（末世第X天/仙历年月/现代日期）
- **本卷时间跨度（必填）**：本卷覆盖的时间范围
- **关键倒计时事件**：若有时限性事件（物资耗尽/大比开始/截止日期），必须列出并标注 D-N

Write output:
```bash
cat > "$PROJECT_ROOT/大纲/第${volume_id}卷-时间线.md" << 'EOF'
{timeline_content}
EOF
```

Completion criteria:
- `大纲/第{volume_id}卷-时间线.md` 存在且非空
- 时间基准和本卷跨度已明确
- 若存在倒计时事件，已在表中列出

## 5) Generate volume skeleton
Load genre profile and apply standards:
```bash
cat "${SKILL_ROOT}/../../references/genre-profiles.md"
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"
```

Optional (only if爽点结构需要细化):
```bash
cat "${SKILL_ROOT}/../../references/shared/cool-points-guide.md"
```

Optional (only if需要补强卷级冲突链与强度分层):
```bash
cat "${SKILL_ROOT}/references/outlining/conflict-design.md"
```

Load beat sheet (must exist):
```bash
cat "$PROJECT_ROOT/大纲/第{volume_id}卷-节拍表.md"
```

Extract for current genre:
- Strand 比例（Quest/Fire/Constellation）
- 爽点密度标准（每章最低/推荐）
- 钩子类型偏好

### Strand Weave 规划策略

**Strand 比例与 Weaving 规则详见规范源：**
```bash
cat "${SKILL_ROOT}/../../references/shared/strand-weave-pattern.md"
```
基于 genre profile 分配三线（Quest/Fire/Constellation）章节比例，遵循规范源中的切换阈值和交织模式。

For 电竞/直播文/克苏鲁, apply dedicated volume pacing template:
```bash
cat "${SKILL_ROOT}/references/outlining/genre-volume-pacing.md"
```

### 爽点密度规划策略
Based on genre profile, **adjusted by project pacing_preference** (from state.json):

若 `state.json` 包含 `pacing_preference`：
- **高频密集** (`coolpoint_frequency: "高频密集"`):
  - 常规章节: 2-3 个小爽点（强度 2-3）
  - 关键章节: 3-4 个爽点，至少 1 个中爽点（强度 4-5）
  - 每 3-5 章至少 1 个关键章节
  - 每卷 `climaxes_per_volume` 个高潮章节
- **适中** (`coolpoint_frequency: "适中"`, 默认):
  - 常规章节: 1-2 个小爽点（强度 2-3）
  - 关键章节: 2-3 个爽点，至少 1 个中爽点（强度 4-5）
  - 每 5-8 章至少 1 个关键章节
  - 每卷至少 1 个高潮章节（通常在卷末）
- **慢热积累** (`coolpoint_frequency: "慢热积累"`):
  - 常规章节: 0-1 个小爽点，允许纯铺垫章
  - 关键章节: 2-3 个爽点，至少 1 个中爽点（强度 4-5）
  - 每 8-12 章至少 1 个关键章节
  - 每卷 `climaxes_per_volume` 个高潮章节

若 `pacing_preference` 缺失，使用“适中”默认值。

### 约束触发规划策略
If idea_bank.json exists:
```bash
cat "$PROJECT_ROOT/.webnovel/idea_bank.json"
```

Calculate trigger frequency:
- **反套路规则**: 每 N 章触发 1 次
  - N = max(5, 总章数 / 10)
  - 例：50 章卷 → 每 5 章触发
  - 例：100 章卷 → 每 10 章触发
- **硬约束**: 贯穿全卷，在章节目标/爽点设计中体现
- **主角缺陷**: 每卷至少 2 次成为冲突来源
- **反派镜像**: 反派出场章节必须体现镜像对比

Use this template and fill from 总纲 + idea_bank:

```markdown
# 第 {volume_id} 卷：{卷名}

> 章节范围: 第 {start} - {end} 章
> 核心冲突: {conflict}
> 卷末高潮: {climax}

## 卷摘要
{2-3 段落概述}

## 关键人物与反派
- 主要登场角色：
- 反派层级：

## Strand Weave 规划
| 章节范围 | 主导 Strand | 内容概要 |
|---------|------------|---------|

## 爽点密度规划
| 章节 | 爽点类型 | 具体内容 | 强度 |
|------|---------|---------|------|

## 伏笔规划
| 章节 | 操作 | 伏笔内容 |
|------|------|---------|

## 引用规划（若 `设定集/典故引用库.md` 存在）
> 从引用库中选取本卷适合的引用，标注章节、载体、伏笔功能。全卷 10-15 处，单章上限 2 处。
| 章 | 引用内容 | 类型/编号 | 载体 | 伏笔 |
|----|---------|----------|------|------|

## 约束触发规划（如有）
- 反套路规则：每 N 章触发一次
- 硬约束：贯穿全卷
```

## 6) Generate chapter outlines (batched)
Batching rule:
- ≤20 章：1 批
- 21–40 章：2 批
- 41–60 章：3 批
- >60 章：4+ 批

Optional (only if需要钩子/节奏细分):
```bash
cat "${SKILL_ROOT}/../../references/reading-power-taxonomy.md"
```

Optional (only if需要章节微结构/标题策略细化):
```bash
cat "${SKILL_ROOT}/references/outlining/chapter-planning.md"
```

### Chapter generation strategy
For each chapter, determine:

**1. Strand assignment** (follow volume skeleton distribution)
- Quest: 主线任务推进、目标达成、能力提升
- Fire: 人物关系、情感冲突、团队动态
- Constellation: 世界揭示、伏笔埋设、谜团推进

**2. 爽点设计** (based on Strand and position)
- Quest Strand → 成就爽点（打脸、逆袭、突破）
- Fire Strand → 情感爽点（认可、保护、告白）
- Constellation Strand → 认知爽点（真相、预言、身份）

**3. 钩子设计** (based on next chapter's Strand)
- 悬念钩子：提出问题、制造危机
- 承诺钩子：预告奖励、暗示转折
- 情感钩子：关系变化、角色危机

**4. 反派层级** (based on volume skeleton)
- 无：日常章节、修炼章节、关系章节
- 小：小冲突、小反派、局部对抗
- 中：中反派出场、重要冲突、阶段性对抗
- 大：大反派出场、核心冲突、卷级高潮

**5. 关键实体** (new or important)
- 新角色：姓名 + 一句话定位
- 新地点：名称 + 一句话描述
- 新物品：名称 + 功能
- 新势力：名称 + 立场

**6. 约束检查** (if idea_bank exists)
- 是否触发反套路规则？
- 是否体现硬约束？
- 是否展现主角缺陷？
- 是否体现反派镜像？

Chapter format (include 反派层级 for context-agent):

```markdown
### 第 {N} 章：{标题}
- 目标: {20字以内}
- 阻力: {20字以内}
- 代价: {20字以内}
- 时间锚点: {末世第X天 时段/仙历X年X月X日/具体日期+时段}
- 章内时间跨度: {如 3小时/半天/1天}
- 与上章时间差: {如 紧接/6小时/1天/跨夜}
- 倒计时状态: {事件A D-3 -> D-2 / 无}
- 爽点: {类型} - {30字以内} | 预估爽值: 压抑{N}×反转{N}/逻辑{N}→≈{score}
- Strand: {Quest|Fire|Constellation}
- 反派层级: {无/小/中/大}
- 视角/主角: {主角A/主角B/女主/群像}
- 关键实体: {新增或重要出场}
- 本章变化: {30字以内，优先可量化变化}
- 章末未闭合问题: {30字以内}
- 钩子: {类型} - {30字以内} | 强度: {strong/medium/weak}
- 读者情绪: {压抑|紧张|释放|燃|温暖|震撼|好奇|焦虑}
- 氛围/情绪色调: {一句话描述本章的感官底色}
- 场景预案: {2-3个关键场景一句话，如"废品站深夜改装+红光映脸"}
- 对话种子: {1-2句关键对话方向，如"配角A问'你叫什么名字'"}
- 视觉锚点: {最有画面感的1-2个镜头}
- 引用锚点: {若引用库存在且本章在引用规划中：编号+"原文"（载体，伏笔说明）/ 无引用库或本章不引用则省略此字段}
```

**时间字段说明**：
- **时间锚点**：本章发生的具体时间点，必须与时间线表一致
- **章内时间跨度**：本章内容覆盖的时间长度
- **与上章时间差**：与上一章结束时间的间隔
  - 紧接：无时间间隔，直接承接
  - 跨夜：过夜但不超过 12 小时
  - 具体时长：如 6小时、1天、3天
- **倒计时状态**：若存在倒计时事件，标注推进情况（D-N → D-(N-1)）

**字段说明**：
- **章末未闭合问题**：本章结尾必须保留的“未闭合决策/问题”，用于驱动读者点下一章。
  - 规则：必须与 **钩子** 的类型/强度一致；不得出现“钩子很强但问题很虚”的错配。
- **钩子**：本章应设置的章末钩子（规划用）
  - 例：悬念钩 - 神秘人身份即将揭晓
  - 意思是：本章结尾要设置这个悬念钩子
  - 下章 context-agent 会读取 chapter_meta[N].hook（实际实现的钩子），生成“接住上章”指导
  - 钩子类型参考：悬念钩 | 危机钩 | 承诺钩 | 情绪钩 | 选择钩 | 渴望钩

Save after each batch:
```bash
cat >> "$PROJECT_ROOT/大纲/第${volume_id}卷-详细大纲.md" << 'EOF'
{batch_content}
EOF
```

## 7) Enrich existing setting files from volume outline
目标：卷纲写完后，把本卷新增事实写回“现有设定集文件”，确保后续写作可直接读取。

输入来源：
- `大纲/第{volume_id}卷-节拍表.md`
- `大纲/第{volume_id}卷-详细大纲.md`
- 现有设定集文件（世界观/力量体系/主角卡/主角组/女主卡/反派设计）

写回策略（必须）：
- 仅增量补充相关段落，不覆盖整文件。
- 新增角色：写入对应角色卡或角色组条目（含首次出场章、关系、红线）。
- 新增势力/地点/规则：写入世界观或力量体系对应章节。
- 新增反派层级信息：写入反派设计并保持小/中/大层级一致。
- 典故引用回写（若 `典故引用库.md` 存在）：将卷骨架“引用规划”段的条目增量写入引用库的“第N卷引用规划总表”。若章纲中有“引用锚点”引用了引用库中未登记的新引用，追加到对应分类。同时将承载伏笔的引用条目登记到 `伏笔追踪.md` 的“典故伏笔”分类。

冲突处理（硬规则）：
- 若卷纲新增信息与总纲或已确认设定冲突，标记 `BLOCKER` 并停止 state 更新。
- 只有冲突裁决完成后，才允许继续更新设定并进入保存步骤。

## 8) Validate + save
### Validation checks (must pass all)

**1. 爽点密度检查**
- 每章 ≥1 小爽点（强度 2-3）
- 每 5-8 章至少 1 个关键章节（强度 4-5）
- 每卷至少 1 个高潮章节（强度 6-7）

**2. Strand 比例检查**
Count chapters by Strand and compare with genre profile:
- Quest: 应占 55-65%
- Fire: 应占 20-30%
- Constellation: 应占 10-20%

If deviation > 15%, adjust chapter assignments.

**3. 总纲一致性检查**
- 卷核心冲突是否贯穿章节？
- 卷末高潮是否在最后 3-5 章体现？
- 关键人物是否按计划登场？

**4. 约束触发频率检查** (if idea_bank exists)
- 反套路规则触发次数 ≥ 总章数 / N（N = max(5, 总章数/10)）
- 硬约束在至少 50% 章节中体现
- 主角缺陷至少 2 次成为冲突来源
- 反派镜像在反派出场章节中体现

**5. 完整性检查**
Every chapter must have:
- 目标（20 字以内）
- 阻力（20 字以内）
- 代价（20 字以内）
- 时间锚点（必填）
- 章内时间跨度（必填）
- 与上章时间差（必填）
- 倒计时状态（若有倒计时事件则必填）
- 爽点（类型 + 30 字描述）
- Strand（Quest/Fire/Constellation）
- 反派层级（无/小/中/大）
- 视角/主角
- 关键实体（至少 1 个）
- 本章变化（30 字以内）
- 章末未闭合问题（30 字以内）
- 钩子（类型 + 30 字描述 + 强度）
- 读者情绪
- 氛围/情绪色调
- 场景预案（至少 1 个）

**6. 时间线一致性检查（新增）**
- 时间线表文件存在：`大纲/第{volume_id}卷-时间线.md`
- 所有章节时间锚点已填写
- 时间单调递增（不得回跳，除非明确标注为闪回）
- 倒计时推进正确（D-5 → D-4 → D-3，不得跳跃）
- 大跨度时间跳跃（>3天）必须有过渡章说明或明确标注

**7. 读者情绪连续性检查（新增）**
- 连续 3 章以上相同“读者情绪”值 = 预警（读者疲劳风险）
- 高压章节（压抑/紧张/焦虑）后 2 章内必须出现释放/温暖/燃
- 卷末 3 章必须有至少 1 个“燃”或“震撼”
- 卷首章必须是“好奇”或“震撼”（抓住新读者）

**8. 钩子强度与丰满度检查（新增）**
- 钩子强度交替规则：“1强2缓”交替（不要每章都 strong，会疲劳）
- 卷末 3 章连续 strong 钩子
- 卷首章 strong 钩子
- 每章场景预案至少 1 个
- 关键章节（高潮/转折）必须有视觉锚点
- 每 5 章至少有 1 个对话种子

**9. 爽值预估检查（新增）**
- 关键章节（爽点强度 4-5）预估爽值应 > 50
- 高潮章节（爽点强度 6-7）预估爽值应 > 70
- 爽值 = 压抑强度(0-10) × 反转速度(0-10) / max(1, 11-逻辑完整度(0-10))

**10. 设定补全检查**
- 本卷涉及的新角色/势力/规则已回写到现有设定集文件
- 所有新增条目可回溯到本卷章纲章节
- `BLOCKER` 数量为 0；若 >0，必须先裁决，不得进入 state 更新

Update state (include chapters range):
```bash
python "${SCRIPTS_DIR}/webnovel.py" --project-root "$PROJECT_ROOT" update-state -- \
  --volume-planned {volume_id} \
  --chapters-range "{start}-{end}"
```

Final check:
- 节拍表文件已写入：`大纲/第{volume_id}卷-节拍表.md`
- 时间线表文件已写入：`大纲/第{volume_id}卷-时间线.md`
- 章纲文件已写入：`大纲/第{volume_id}卷-详细大纲.md`
- 设定集已完成基线补齐与本卷增量补充（原文件内可见）
- 每章包含：目标/阻力/代价/时间锚点/章内时间跨度/与上章时间差/爽点/Strand/反派层级/视角/关键实体/本章变化/章末未闭合问题/钩子
- 时间线单调递增，倒计时推进正确
- 与总纲冲突/高潮一致，约束触发频率合理（如有 idea_bank）

### Hard fail conditions (must stop)
- 节拍表文件不存在或为空
- 节拍表中段反转缺失（未按“必填/无（理由）”规则填写）
- **时间线表文件不存在或为空**
- 章纲文件不存在或为空
- 任一章节缺少：目标/阻力/代价/时间锚点/章内时间跨度/与上章时间差/爽点/Strand/反派层级/视角/关键实体/本章变化/章末未闭合问题/钩子
- **任一章节时间字段（时间锚点/章内时间跨度/与上章时间差）缺失**
- **时间回跳且未标注为闪回**
- **倒计时算术冲突（如 D-5 直接跳到 D-2）**
- **重大事件发生时间与前章间隔不足且无合理解释（如末世第1天建帮派）**
- 与总纲核心冲突或卷末高潮明显冲突
- 设定集基线未补齐，或本卷增量未回写到现有设定集
- 存在 `BLOCKER` 未裁决
- 约束触发频率不足（当 idea_bank 启用时）

### Rollback / recovery
If any hard fail triggers:
1. Stop and list the failing items.
2. Re-generate only the failed batch (do not overwrite the whole file).
3. If the last batch is invalid, remove that batch and rewrite it.
4. Only update state after Final check passes.

Next steps:
- 继续规划下一卷 → /webnovel-plan
- 开始写作 → /webnovel-write