novelws 5.1.0 → 5.3.0

package/templates/commands/analyze.md

@@ -2,7 +2,7 @@
 description: 质量检查：对比概要与正文，检测一致性和AI味
 argument-hint: [章节号] [--range start-end]
 recommended-model: claude-sonnet-4-5-20250929
-allowed-tools: Read(//stories/**), Read(//tracking/**), Bash(ls:*)
+allowed-tools: Read(//stories/**), Read(//resources/anti-ai.md), Bash(ls:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
@@ -16,11 +16,23 @@ allowed-tools: Read(//stories/**), Read(//tracking/**), Bash(ls:*)
 - 章节号：分析单章
 - `--range start-end`：批量分析章节范围（如 `--range 1-20`）
 
+## 卷定位
+
+根据章节号和 `stories/<story>/creative-plan.md` 确定目标章节所属卷（如 `vol-001`）。
+
 ## 资源加载
 
-- 目标章节正文：`stories/<story>/content/chapter-XXX.md`
-- 对应概要：`stories/<story>/content/chapter-XXX-synopsis.md`
-- tracking 数据：`tracking/character-state.json`、`tracking/plot-tracker.json`
+- 目标章节正文：`stories/<story>/volumes/vol-XXX/content/chapter-YYY.md`
+- 对应概要：`stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`
+- 卷级 tracking：`stories/<story>/volumes/vol-XXX/tracking/character-state.json`、`stories/<story>/volumes/vol-XXX/tracking/plot-tracker.json`
+
+**DB 增强模式**：如果 `resources/config.json` 中 `database.enabled = true`，可用 DB 上下文替代 tracking 文件读取：
+
+```
+python scripts/db_context.py --chapter <全局章节号> --mode analyze
+```
+
+输出包含本章伏笔检查清单、角色状态基准、时间线连续性和一致性警告。输出还包含主角能力基准（技能习得时间线 + 道具持有状态），用于检测正文中是否使用了尚未习得的技能或不持有的道具。
 
 ## 检查项（5项）
 
@@ -58,11 +70,11 @@ allowed-tools: Read(//stories/**), Read(//tracking/**), Bash(ls:*)
 评分：✅ / ⚠️ / ❌
 
 ### 5. AI味检测
-检查常见AI写作痕迹：
-- AI高频词使用（然而、殊不知、缓缓、深邃等）
-- 句式重复度
+读取 `resources/anti-ai.md` 的禁用词表，对照正文检查：
+- AI高频词使用（对照禁用词汇清单逐项检查）
+- 句式重复度（连续相同结构、段落开头重复）
 - 空洞描写比例
-- 段落结构单一性
+- 段落结构单一性（是否全部 3-4 句等长段落）
 
 评分：✅ 自然 / ⚠️ 轻微AI味 / ❌ 明显AI味
 

package/templates/commands/expand.md

@@ -2,7 +2,7 @@
 description: 将章节概要扩写为 3000-5000 字正文
 argument-hint: [章节号] [--batch N]
 recommended-model: claude-opus-4-6
-allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracking/**), Write(//tracking/**), Read(//resources/style-reference.md), Read(//resources/anti-ai.md), Read(//resources/constitution.md), Bash(ls:*)
+allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//stories/**/tracking/**), Write(//stories/**/tracking/**), Read(//resources/style-reference.md), Read(//resources/anti-ai.md), Read(//resources/constitution.md), Bash(ls:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
@@ -25,45 +25,63 @@ allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracki
 - 章节号：从 $ARGUMENTS 提取
 - `--batch N`：批量扩写 N 章（最大 10），从指定章节号开始
 
+## 卷定位
+
+根据章节号和 `stories/<story>/creative-plan.md` 中每卷的章节范围，确定目标章节所属的卷目录（如 `vol-001`）。
+
+路径规则：
+- 概要：`stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`
+- 正文：`stories/<story>/volumes/vol-XXX/content/chapter-YYY.md`
+- Tracking：`stories/<story>/volumes/vol-XXX/tracking/`
+
 ## 资源加载（3 层结构，从文件系统重新加载）
 
 所有资源必须从文件系统读取，不复用对话中的缓存。总上下文控制在 3500 字以内。
 
+**DB 增强模式**：如果 `resources/config.json` 中 `database.enabled = true`，可用 DB 上下文替代第 3 层的 tracking 文件读取：
+
+```
+python scripts/db_context.py --chapter <全局章节号> --mode expand
+```
+
+输出包含本章伏笔、活跃角色状态、角色关系、前序衔接，直接替代手动读取 tracking JSON。输出还包含主角当前修为、可用技能和道具清单，确保扩写中主角能力使用不超出已有设定。第 1、2 层仍从文件系统加载。
+
 ### 第 1 层 — 全局视角
 
 1. **specification.md 摘要**：读取 `stories/<story>/specification.md`，提取 100 字核心摘要（类型 + 主角 + 核心冲突）
 2. **当前卷大纲**：读取 `stories/<story>/creative-plan.md`，只提取当前章节所属卷的段落
+3. **volume-summary.md**：读取 `stories/<story>/volumes/vol-XXX/volume-summary.md`（跨卷上下文，500-1000 字）
 
 ### 第 2 层 — 章节核心
 
-3. **当前章概要**：读取 `stories/<story>/content/chapter-XXX-synopsis.md`（200-500字）
-4. **前一章正文末尾**：读取前一章 `chapter-XXX.md` 的最后 500-800 字（衔接用）。如果前一章尚未扩写，读取前一章概要代替
+4. **当前章概要**：读取 `stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`（200-500字）
+5. **前一章正文末尾**：读取前一章 `chapter-YYY.md` 的最后 500-800 字（衔接用）。如果前一章在上一卷，从上一卷的 content/ 读取。如果前一章尚未扩写，读取前一章概要代替
 
 ### 第 3 层 — 细节支撑
 
-5. **本章出场角色状态**：从概要中提取出场角色列表，然后从 `tracking/character-state.json` 只提取这些角色的条目
-6. **本章活跃伏笔**：从 `tracking/plot-tracker.json` 提取 status=planted 或 status=hinted 且 keyChapters 包含当前章或相邻章（±3章）的伏笔
-7. **本章相关角色关系**：从 `tracking/relationships.json` 提取本章出场角色之间的关系条目（最多 5 条，超出则取最近更新的）
-8. **风格参考**：读取 `resources/style-reference.md`
-9. **反AI规范**：读取 `resources/anti-ai.md`
+6. **本章出场角色状态**：从概要中提取出场角色列表，然后从 `volumes/vol-XXX/tracking/character-state.json` 只提取这些角色的条目。如果角色在本卷 tracking 中不存在，从 volume-summary.md 的活跃角色状态中查找
+7. **本章活跃伏笔**：从 `volumes/vol-XXX/tracking/plot-tracker.json` 提取 status=planted 或 status=hinted 的伏笔。补充 volume-summary.md 中的活跃伏笔
+8. **本章相关角色关系**：从 `volumes/vol-XXX/tracking/relationships.json` 提取本章出场角色之间的关系条目（最多 5 条）。补充 volume-summary.md 中的关键关系
+9. **风格参考**：读取 `resources/style-reference.md`
+10. **反AI规范**：读取 `resources/anti-ai.md`
 
 **上下文预算**：
 
 | 层级 | 预估字数 |
 |------|---------|
-| 第 1 层 全局 | 200-400 字 |
+| 第 1 层 全局 | 700-1400 字（含 volume-summary） |
 | 第 2 层 章节 | 700-1300 字 |
 | 第 3 层 细节 | 800-1500 字 |
-| **总计** | **1700-3200 字** |
+| **总计** | **2200-4200 字** |
 
-每层加载完后检查上下文预算，超出则截断（如角色关系条目过多时只取最核心的 5 条）。
+每层加载完后检查上下文预算，超出则截断。volume-summary.md 超长时只保留活跃角色状态和活跃伏笔部分。
 
 ## 执行步骤
 
 ### 1. 前置检查
 
 - 确认目标章节的 synopsis.md 存在，否则提示先运行 /write
-- 确认目标章节的正文 chapter-XXX.md 不存在（避免覆盖），如已存在则询问是否覆盖
+- 确认目标章节的正文 chapter-YYY.md 不存在（避免覆盖），如已存在则询问是否覆盖
 
 ### 2. 加载上下文
 
@@ -75,29 +93,37 @@ allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracki
 
 - **忠实于概要**：核心事件、出场角色、情感走向必须与概要一致
 - **全局一致性**：正文必须与 specification.md 的类型定位和 creative-plan.md 的卷级设计保持一致
-- **角色关系驱动**：对话和互动必须体现 relationships.json 中的关系动态
+- **角色关系驱动**：对话和互动必须体现 tracking/relationships.json 中的关系动态
 - **文学表达**：专注于场景描写、对话、心理活动、动作细节
 - **风格一致**：遵循 style-reference.md 的风格设定
 - **反AI规范**：遵循 anti-ai.md 的写作规范
 - **衔接自然**：与前一章末尾自然衔接
 - **伏笔落地**：概要中标记的伏笔必须在正文中体现
 
-写入 `stories/<story>/content/chapter-XXX.md`。
+写入 `stories/<story>/volumes/vol-XXX/content/chapter-YYY.md`。
 
-### 4. 补充 tracking 细节
+### 4. 补充卷级 tracking 细节
 
 扩写完成后，检查正文中是否产生了概要中没有的新细节：
-- 对话中透露的新信息 → 更新 character-state 或 relationships
+- 对话中透露的新信息 → 更新 `volumes/vol-XXX/tracking/` 中的 character-state 或 relationships
 - 新的场景细节 → 如有重要设定变化，更新相关 tracking
 
-### 5. 批量模式
+### 5. DB 同步（可选）
+
+如果 `resources/config.json` 中 `database.enabled = true`，在 tracking 更新完成后运行：
+
+```
+python scripts/db_sync.py --vol <当前卷号>
+```
+
+### 6. 批量模式
 
 如果指定了 `--batch N`，重复步骤 2-4 共 N 次。每章完成后输出进度和字数。
 
-**批量模式资源隔离**：每章都必须重新从文件系统加载所有资源（前一章扩写可能更新了 tracking）。批量模式中每章视为独立的扩写任务，不复用前一章扩写过程中的中间状态。
+**批量模式资源隔离**：每章都必须重新从文件系统加载所有资源。批量模式中每章视为独立的扩写任务。如果批量过程中跨卷，需要切换到下一卷的 tracking 和 content 目录。
 
-### 6. 后续建议
+### 7. 后续建议
 
-单章完成：「第X章扩写完成（XXXX字）。继续 /expand [X+1] 或使用 /analyze X 检查质量。」
+单章完成：「第X章扩写完成（XXXX字，vol-XXX）。继续 /expand [X+1] 或使用 /analyze X 检查质量。」
 
 批量完成：「第X-Y章扩写完成（共Z章，平均XXXX字/章）。使用 /analyze --range X-Y 批量检查质量。」

package/templates/commands/plan.md

@@ -48,7 +48,8 @@ allowed-tools: Read(//stories/**/specification.md), Read(//stories/**/creative-p
 - 主线概要：
 
 ## 第一卷：[卷名]
-- 章节范围：第1-XX章
+- 卷目录：vol-001
+- 章节范围：第1-XX章（chapter-001 到 chapter-XXX）
 - 核心主题：
 - 核心冲突：
 - 转折点：
@@ -67,4 +68,4 @@ allowed-tools: Read(//stories/**/specification.md), Read(//stories/**/creative-p
 
 ### 4. 后续建议
 
-输出：「卷级大纲生成完成。下一步请使用 /write 1 开始逐章生成剧情概要。可用 /write --batch 20 批量生成。」
+输出：「卷级大纲生成完成。下一步请使用 /write 1 开始逐章生成剧情概要（系统会自动创建 volumes/vol-001/ 目录结构）。可用 /write --batch 20 批量生成。」

package/templates/commands/specify.md

@@ -1,7 +1,7 @@
 ---
 description: 定义故事规格，明确要创造什么样的作品
 argument-hint: [故事描述]
-allowed-tools: Read(//stories/**/specification.md), Write(//stories/**/specification.md), Read(//resources/constitution.md), Write(//resources/style-reference.md), Bash(ls:*), Bash(mkdir:*)
+allowed-tools: Read(//stories/**/specification.md), Write(//stories/**/specification.md), Read(//resources/constitution.md), Read(//resources/anti-ai.md), Write(//resources/style-reference.md), Bash(ls:*), Bash(mkdir:*)
 ---
 
 用户输入：$ARGUMENTS
@@ -70,7 +70,11 @@ allowed-tools: Read(//stories/**/specification.md), Write(//stories/**/specifica
 
 ### 4. 生成风格参考
 
-如果 `resources/style-reference.md` 仍是模板默认内容（含 `[第一人称/第三人称有限/第三人称全知]`），根据用户的风格偏好自动填充。
+如果 `resources/style-reference.md` 仍是模板默认内容（含 `[第一人称/第三人称有限/第三人称全知]`），根据用户的风格偏好自动填充：
+
+- 在「故事类型」字段填入步骤 2 中确定的类型
+- 参考模板中的 HTML 注释提示，为每个维度选择符合该类型的默认值（用户未明确指定时）
+- 读取 `resources/anti-ai.md` 的「类型特有禁用词」段落，将对应类型的禁用词追加到「风格禁忌」字段
 
 ### 5. 后续建议
 

package/templates/commands/write.md

@@ -1,43 +1,86 @@
 ---
-description: 逐章生成剧情概要（200-500字），同步更新 tracking
+description: 逐章生成剧情概要（200-500字），严格控制字数，同步更新 tracking
 argument-hint: [章节号] [--batch N]
 recommended-model: claude-opus-4-6
-allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracking/**), Write(//tracking/**), Bash(ls:*)
+allowed-tools: Read(//stories/**), Write(//stories/**), Bash(ls:*), Bash(mkdir:*), Bash(python:scripts/*)
 ---
 
 用户输入：$ARGUMENTS
 
 ## 目标
 
-为指定章节生成 200-500 字的纯剧情概要，同步生成 tracking 骨架数据。
+为指定章节生成 200-500 字的纯剧情概要（严格控制字数），同步生成 tracking 骨架数据。
 
 ## 参数解析
 
 - 章节号：从 $ARGUMENTS 提取，如 `1`、`42`
 - `--batch N`：批量生成 N 章概要（最大 20），从指定章节号开始
 
-## 资源加载（极简）
+## 卷定位
 
-1. **specification.md 摘要**：读取 `stories/<story>/specification.md`，提取100字核心摘要（类型+主角+核心冲突）
-2. **当前卷大纲**：读取 `stories/<story>/creative-plan.md`，只提取当前章节所属卷的段落
-3. **前序概要标题列表**：扫描 `stories/<story>/content/chapter-*-synopsis.md`，只读取每个文件的第一行标题
-4. **前一章概要全文**：读取前一章的 synopsis.md（200-500字）
+根据章节号和 `stories/<story>/creative-plan.md` 中每卷的章节范围，确定目标章节所属的卷目录（如 `vol-001`）。
+
+路径规则：
+- 概要：`stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`
+- Tracking：`stories/<story>/volumes/vol-XXX/tracking/`
+
+### 首次写入某卷时的初始化
+
+如果 `volumes/vol-XXX/` 目录不存在，自动创建：
+
+1. 创建 `volumes/vol-XXX/content/` 和 `volumes/vol-XXX/tracking/`
+2. 初始化 4 个空 tracking 文件（同 templates/tracking/ 的初始内容）
+3. 如果是第一卷（vol-001），生成初始 volume-summary.md（空状态，从 specification.md 提取基本信息）
+4. 如果不是第一卷，执行「卷切换」流程（见下方）
+
+### 卷切换流程
+
+当目标章节属于新卷时（上一卷已完成）：
+
+**路径 A — DB 模式**（`resources/config.json` 中 `database.enabled = true`）：
+
+运行 `python scripts/db_volume_switch.py --vol <新卷号>` 自动生成 volume-summary.md。输出还包含主角当前修炼进度、技能清单和道具状态，用于概要中主角能力描写的一致性。
+
+**路径 B — 文件模式**（默认）：
+
+1. 读取上一卷 `volumes/vol-NNN/tracking/` 的 4 个 JSON 文件
+2. 读取上一卷最后一章 synopsis 的章末钩子
+3. 读取 `creative-plan.md` 中下一卷的大纲段落
+4. 生成新卷的 `volume-summary.md`：
+   - 故事进度：已完成的章节范围
+   - 活跃角色状态：从 character-state.json 提取最近 2 卷出场过的角色
+   - 活跃伏笔：从 plot-tracker.json 提取 status=planted/hinted 的条目
+   - 关键关系：从 relationships.json 提取活跃角色间的关系
+   - 待续悬念：上一卷末章的章末钩子
+5. volume-summary.md 控制在 500-2000 字（严格控制字数）
+
+## 资源加载（卷级）
+
+1. **specification.md 摘要**：读取 `stories/<story>/specification.md`，提取 100 字核心摘要（类型 + 主角 + 核心冲突）
+2. **当前卷大纲**：读取 `stories/<story>/creative-plan.md`，只提取当前卷的段落
+3. **volume-summary.md**：读取 `stories/<story>/volumes/vol-XXX/volume-summary.md`（跨卷上下文）
+4. **本卷前序概要标题列表**：扫描 `stories/<story>/volumes/vol-XXX/content/chapter-*-synopsis.md`，只读取每个文件的第一行标题
+5. **前一章概要全文**：读取前一章的 synopsis.md（200-500 字）。如果前一章在上一卷，从上一卷的 content/ 读取
 
 **不加载**：resources 目录任何文件、tracking 文件（写入时直接追加）
 
 ## 执行步骤
 
-### 1. 确定故事目录和章节号
+### 1. 确定故事目录、章节号和所属卷
+
+从 $ARGUMENTS 和 `stories/` 目录确定当前故事，从 creative-plan.md 确定章节所属卷。
+
+### 2. 确保卷目录存在
 
-从 $ARGUMENTS 和 `stories/` 目录确定当前故事和目标章节。
+如果卷目录不存在，执行初始化或卷切换流程。
 
-### 2. 加载上下文
+### 3. 加载上下文
 
 按上述「资源加载」规则加载最小上下文。
 
-### 3. 生成概要
+### 4. 生成概要
 
-为当前章节生成 200-500 字纯剧情概要，包含：
+为当前章节生成 200-500 字纯剧情概要（严格控制字数），包含：
 
 - **本章标题**：简短的章节标题
 - **核心事件**：本章发生的主要事件（1-3个）
@@ -45,35 +88,45 @@ allowed-tools: Read(//stories/**), Write(//stories/**/content/**), Read(//tracki
 - **情感走向**：本章的情感基调和变化
 - **章末钩子**：本章结尾的悬念或引子
 
-写入 `stories/<story>/content/chapter-XXX-synopsis.md`（XXX 为三位数补零）。
+写入 `stories/<story>/volumes/vol-XXX/content/chapter-YYY-synopsis.md`（YYY 为三位数补零）。
 
-### 4. 更新 tracking 骨架
+### 5. 更新卷级 tracking
 
-根据概要内容，更新 4 个 tracking 文件：
+根据概要内容，更新 `stories/<story>/volumes/vol-XXX/tracking/` 下的 4 个文件：
 
-**tracking/character-state.json**：
+**character-state.json**：
 - 新出场角色：添加条目（role, status, location, state, lastAppearance）
 - 已有角色：更新 status、location、state、lastAppearance
 
-**tracking/relationships.json**：
+**relationships.json**：
 - 新关系：添加条目（from, to, type, note, lastUpdate）
 - 关系变化：更新 note 和 lastUpdate
 
-**tracking/plot-tracker.json**：
+**plot-tracker.json**：
 - 更新 currentChapter
 - 新情节线：添加到 plotlines（name, status, description, keyChapters）
 - 伏笔埋设：添加到 foreshadowing（id, content, plantedAt, status=planted）
 - 伏笔回收：更新 resolveAt 和 status=resolved
 
-**tracking/timeline.json**：
+**timeline.json**：
 - 添加本章事件到 events（chapter, time, event）
 
-### 5. 批量模式
+### 6. DB 同步（可选）
+
+如果 `resources/config.json` 中 `database.enabled = true`，在 tracking 更新完成后运行：
+
+```
+python scripts/db_sync.py --vol <当前卷号>
+```
+
+将本卷 tracking 数据同步到 PostgreSQL。
+
+### 7. 批量模式
 
-如果指定了 `--batch N`，重复步骤 2-4 共 N 次，每次递增章节号。每章完成后输出进度。
+如果指定了 `--batch N`，重复步骤 3-5 共 N 次。如果批量过程中跨卷，自动触发卷切换。
 
-### 6. 后续建议
+### 8. 后续建议
 
-单章完成：「第X章概要已生成。继续 /write [X+1] 或 /write --batch 20 批量生成。概要全部完成后使用 /expand 开始扩写。」
+单章完成：「第X章概要已生成（vol-XXX）。继续 /write [X+1] 或 /write --batch 20 批量生成。」
 
 批量完成：「第X-Y章概要已生成（共Z章）。继续 /write [Y+1] --batch 20 或开始 /expand [章节号] 扩写。」

package/templates/dot-claude/CLAUDE.md

@@ -35,17 +35,57 @@
 | resources/style-reference.md | 风格参考 | /expand |
 | resources/anti-ai.md | 反AI规范 | /expand |
 
-## Tracking 文件
+## 卷级结构
 
-| 文件 | 用途 |
+每个故事按卷分片存储：
+
+```
+stories/<story>/
+├── specification.md
+├── creative-plan.md
+└── volumes/
+    └── vol-XXX/
+        ├── volume-summary.md    # 跨卷状态快照
+        ├── tracking/            # 卷级 tracking
+        │   ├── character-state.json
+        │   ├── plot-tracker.json
+        │   ├── relationships.json
+        │   └── timeline.json
+        └── content/             # 卷级内容
+            ├── chapter-YYY-synopsis.md
+            └── chapter-YYY.md
+```
+
+- volume-summary.md 在卷切换时自动生成，是当前卷的入口条件
+- /write 完成后自动更新卷级 tracking 骨架
+- /expand 完成后补充卷级 tracking 细节
+
+## DB 增强（可选）
+
+项目支持 PostgreSQL 双轨并行模式：DB 可用时增强上下文精度，不可用时回退到纯文件系统流程。
+
+### 配置
+
+编辑 `resources/config.json` 中的 `database` 字段：
+- `enabled: true` 启用 DB 模式
+- 配置 host、port、dbname、user、password
+- schema 默认为 `novelws`
+
+### scripts/ 目录
+
+| 脚本 | 用途 |
 |------|------|
-| tracking/character-state.json | 角色状态（role, status, location, state, lastAppearance） |
-| tracking/relationships.json | 角色关系（from, to, type, note, lastUpdate） |
-| tracking/plot-tracker.json | 情节线和伏笔（plotlines, foreshadowing） |
-| tracking/timeline.json | 时间线（chapter, time, event） |
+| `phase_a_init_db.py` | 初始化数据库（建表 + 视图） |
+| `db_sync.py` | 文件系统 tracking → DB 同步（幂等） |
+| `db_context.py` | 从 DB 生成精确上下文（write/expand/analyze 模式） |
+| `db_volume_switch.py` | 从 DB 生成 volume-summary.md（卷切换） |
+
+### 双轨机制
 
-- /write 完成后自动更新 tracking 骨架
-- /expand 完成后补充 tracking 细节
+- /write、/expand、/analyze 命令会检测 `database.enabled`
+- DB 可用时：用 `db_context.py` 生成精确上下文，完成后用 `db_sync.py` 同步
+- DB 不可用或脚本执行失败时：自动回退到纯文件系统流程，不影响正常创作
+- 文件系统 tracking 始终是主数据源，DB 是增强层
 
 ## 会话级资源复用
 

package/templates/resources/anti-ai.md

@@ -1,16 +1,95 @@
 # 反AI写作规范
 
 ## 核心原则
-自然表达，像真人写的。
-
-## 必须做到
-- 句长混合：短句(30-40%)、中句(40-50%)、长句(10-20%)
-- 单句成段比例 30%-50%，每段 50-100 字
-- 用具体细节替代抽象描写
-- 对话符合角色身份，不千人一面
-
-## 必须避免
-- 「然而」「殊不知」「缓缓」「深邃」「不禁」等AI高频词
-- 连续使用相同句式结构
-- 空洞的心理描写和环境渲染
-- 每段都以角色名开头
+自然表达，像真人写的。以下规则按从微观到宏观三层组织。
+
+<!-- === /expand 加载区 开始 === -->
+
+## 第一层 — 词汇级
+
+### 禁用词汇（出现即替换）
+
+**情绪/动作类**：不禁、缓缓、深邃、淡淡、微微、轻轻、默默、静静、悄然、赫然、骤然、竟然、居然、蓦然、倏然、怔怔
+
+**转折/连接类**：然而、殊不知、与此同时、值得一提的是、不得不说、毋庸置疑、不言而喻
+
+**描写类**：如同XX一般、宛如、仿佛（同一段内超过1次）、映入眼帘、一抹（微笑/苦涩/无奈）、勾勒出、弥漫着、充斥着、笼罩着
+
+**心理类**：心中涌起、脑海中浮现、不由得想起、心头一紧、心中暗道
+
+### 替代策略
+- 不用副词修饰情绪动词，改用具体动作
+  - ❌ 她默默地流下了眼泪
+  - ✅ 她偏过头，用袖口蹭了一下眼角
+- 不用"如同/宛如"做比喻，改用直接隐喻或省略
+  - ❌ 疼痛如同潮水一般涌来
+  - ✅ 疼痛从断骨处一波一波地涌上来
+
+## 第二层 — 句段级
+
+### 句式变化
+- 禁止连续 3 个句子使用相同结构（如连续主谓宾、连续"他...他...他..."）
+- 禁止连续 2 个段落以相同方式开头（如都以角色名开头、都以环境描写开头）
+- 长句后跟短句形成节奏对比
+
+### 段落反模式
+- ❌ 每段恰好 3-4 句，长度均匀 — AI 的典型"整齐段落"
+- ✅ 段落长短交替：有 1 句成段的冲击段，有 5-7 句的铺陈段
+- ❌ 段末总是情感总结句（"他心中涌起一股XX"）
+- ✅ 段末留在动作或对话上，让读者自行感受
+
+## 第三层 — 叙述级
+
+### 场景展开反模式
+- ❌ 固定公式：环境描写 → 人物出场 → 对话 → 心理活动 → 结尾总结
+- ✅ 可以从对话切入、从动作切入、从一个细节切入
+- ❌ 每个场景都有完整的开场环境描写
+- ✅ 只在环境变化或环境与情绪相关时才描写环境
+
+### 对话反模式
+- ❌ 每句对话都有信息量，每句都推进剧情
+- ✅ 允许闲聊、打岔、答非所问、说到一半被打断
+- ❌ 对话后必跟心理描写解释角色真实想法
+- ✅ 让读者从对话本身和动作推断角色想法
+- ❌ 所有角色都说完整的句子，语法正确
+- ✅ 口语化：省略、重复、语气词、不完整句
+
+### 情绪表达反模式
+- ❌ 直接命名情绪（他感到愤怒/悲伤/喜悦）
+- ✅ 通过生理反应和无意识动作表现
+- ❌ 用大段内心独白解释角色心理
+- ✅ 内心活动碎片化，穿插在动作和对话之间
+
+### 正面示例 — 完整段落演示
+
+**场景展开（从细节切入）**：
+> 茶杯磕在桌沿上，发出一声脆响。李远的手指还保持着端杯的姿势，但杯子已经不在了。碎瓷片在地上转了两圈才停下来。
+> "你说什么？"他的声音很平，像是在问今天吃什么。
+
+**对话（含打断和答非所问）**：
+> "我觉得这件事——"
+> "你上次也这么觉得。"周婷把筷子往碗上一搁，"结果呢？"
+> 他张了张嘴，最后说："菜凉了。"
+
+<!-- === /expand 加载区 结束 === -->
+
+<!-- === /specify 参考区（类型特有禁用词，由 /specify 注入到 style-reference.md 的风格禁忌字段） === -->
+
+## 类型特有禁用词
+
+> 以下按故事类型分组。/specify 生成 style-reference.md 时，根据 specification.md 的故事类型，
+> 将对应类型的禁用词追加到 style-reference.md 的「风格禁忌」字段中。
+
+### 玄幻
+气势如虹、不可一世、实力深不可测、天赋异禀、气运之子、震惊四座、全场哗然、一股强大的气息、修为突破、丹田中的灵力
+
+### 都市
+商业帝国、权势滔天、豪门恩怨、身价百亿、谈笑风生、运筹帷幄、一个电话搞定、社会底层逆袭、人脉通天
+
+### 言情
+心如鹿撞、脸颊绯红、薄唇微启、眸光深邃、低沉磁性的嗓音、修长的手指、禁欲系、宠溺地笑了笑、霸道地将她揽入怀中
+
+### 悬疑
+细思极恐、不寒而栗、一个大胆的想法、真相浮出水面、拨开迷雾、抽丝剥茧、一切都说得通了、背后的真相
+
+<!-- === /specify 参考区 结束 === -->