Explorar o código

docs: 系统性整理与修复 .claude 资料 (6个冲突修复)

- CF-01: 统一版本标注为 v5.1
- CF-02: Data Agent LLM调用描述统一为"无需外部LLM"
- CF-03: 爽点密度标准统一(小爽点/组合爽点/里程碑爽点)
- CF-04: Strand定义统一(Constellation=世界观线, 占比55-65/20-30/10-20)
- CF-05: 修正脚本路径(添加data_modules前缀)
- CF-06: schema定义统一(tier枚举, aliases表约束)

删除冗余文件:
- webnovel-write/references/cool-points-guide.md
- webnovel-write/references/strand-weave-pattern.md

激活未引用资料:
- init: creativity/*, worldbuilding/*
- plan: outlining/*
- write: genres/* (可选加载)
- review: pacing-control.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
lingfengQAQ hai 5 meses
pai
achega
a182dfefbb

+ 3 - 3
.claude/agents/high-point-checker.md

@@ -36,9 +36,9 @@ Scan for the **6 standard execution modes** (执行模式):
 ### Step 3: Density Check
 
 **Required Baseline**:
-- **Every chapter**: ≥ 1 cool-point (任何单一模式)
-- **Every 5 chapters**: ≥ 1 combo cool-point (2种以上模式叠加)
-- **Every 10 chapters**: ≥ 1 milestone victory (改变主角地位的阶段性胜利)
+- **Every chapter**: ≥ 1 小爽点(单一模式)
+- **Every 5 chapters**: ≥ 1 组合爽点(2种模式叠加)
+- **Every 10-15 chapters**: ≥ 1 里程碑爽点(改变主角地位)
 
 **Output**:
 ```

+ 8 - 8
.claude/agents/pacing-checker.md

@@ -50,9 +50,9 @@ python -m scripts.status_reporter --focus strand --project-root "${PROJECT_ROOT}
 
 | Strand | Indicators | Examples |
 |--------|-----------|----------|
-| **Quest** (任务线) | 战斗/任务/探索/升级/打怪 | 参加宗门大比、探索秘境、击败反派 |
-| **Fire** (感线) | 情感关系/暧昧/友情/羁绊 | 与李雪的感情发展、师徒情深、兄弟义气 |
-| **Constellation** (人际线) | 势力关系/阵营/社交/揭示世界观 | 新势力登场、修仙界格局展示、宗门政治 |
+| **Quest** (线) | 战斗/任务/探索/升级/打怪 | 参加宗门大比、探索秘境、击败反派 |
+| **Fire** (感线) | 情感关系/暧昧/友情/羁绊 | 与李雪的感情发展、师徒情深、兄弟义气 |
+| **Constellation** (世界观线) | 势力关系/阵营/社交网络/揭示世界观 | 新势力登场、修仙界格局展示、宗门政治 |
 
 **Classification Rules**:
 - A chapter can have **undertones** of multiple strands, but only **one dominant**
@@ -112,9 +112,9 @@ Last Constellation: 38 | Current: 46 | Gap: 8 chapters
 
 | Strand | 理想占比 | 最大缺席 | 超限影响 |
 |--------|---------|---------|---------|
-| Quest (任务线) | 60% (6-7章) | 3 章 | 罕见,主线推进需要 |
-| Fire (情感线) | 20% (2-3章) | 10 章 | 人物关系停滞 |
-| Constellation (人际线) | 20% (1-2章) | 15 章 | 世界观单薄 |
+| Quest (主线) | 55-65% | 5 章连续 | 战斗疲劳,缺少情感深度 |
+| Fire (感情线) | 20-30% | 10 章 | 人物关系停滞 |
+| Constellation (世界观线) | 10-20% | 15 章 | 世界观单薄 |
 
 ### Step 5: Historical Trend Analysis
 
@@ -156,7 +156,7 @@ Chapters {N} - {M}
 | {M} | Quest | - | Medium |
 
 ## Strand Balance 检查
-### Quest Strand (任务线)
+### Quest Strand (线)
 - Last appearance: Chapter {X}
 - Consecutive chapters: {count}
 - **Status**: {✓ Normal / ⚠️ Warning / ✗ Overload}
@@ -166,7 +166,7 @@ Chapters {N} - {M}
 - Gap since last: {count} chapters
 - **Status**: {✓ Normal / ⚠️ Warning / ✗ Drought}
 
-### Constellation Strand (人际线)
+### Constellation Strand (世界观线)
 - Last appearance: Chapter {Z}
 - Gap since last: {count} chapters
 - **Status**: {✓ Normal / ⚠️ Warning}

+ 2 - 3
.claude/references/entity-management-spec.md

@@ -42,7 +42,7 @@ CREATE TABLE entities (
     id TEXT PRIMARY KEY,
     type TEXT NOT NULL,  -- 角色/地点/物品/势力/招式
     canonical_name TEXT NOT NULL,
-    tier TEXT DEFAULT '装饰',  -- 核心/支线/装饰
+    tier TEXT DEFAULT '装饰',  -- 核心/重要/次要/装饰
     desc TEXT,
     current_json TEXT,  -- JSON 格式的当前状态
     first_appearance INTEGER,
@@ -54,11 +54,10 @@ CREATE TABLE entities (
 
 -- 别名表 (一对多)
 CREATE TABLE aliases (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
     alias TEXT NOT NULL,
     entity_id TEXT NOT NULL,
     entity_type TEXT NOT NULL,
-    UNIQUE(alias, entity_id)
+    PRIMARY KEY (alias, entity_id, entity_type)
 );
 
 -- 状态变化表

+ 9 - 1
.claude/settings.local.json

@@ -18,7 +18,15 @@
       "Bash(git remote add:*)",
       "Bash(git push:*)",
       "WebFetch(domain:linux.do)",
-      "Bash(cd:*)"
+      "Bash(cd:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(tree:*)",
+      "Bash(dir:*)",
+      "Bash(git checkout -b feature/integrate-refined-docs-v3)",
+      "Bash(收获型\" → 无结果(旧术语已清除)\n✓ grep \"场景创作时.*标注.*压扬比例\" → 无结果(标注要求已删除)\n✓ 密度基准改为基于模式叠加和里程碑胜利\n✓ AI执行指令从4条改为3条(三处同步)\n\nFiles changed:\n- .claude/agents/high-point-checker.md \\(密度基准\\)\n- .claude/skills/webnovel-write/references/cool-points-guide.md \\(示例+边界案例+AI指令\\)\n- .claude/skills/webnovel-plan/references/cool-points-guide.md \\(示例+边界案例+AI指令\\)\n- .claude/skills/webnovel-review/references/cool-points-guide.md \\(示例+边界案例+AI指令\\)\nEOF\n\\)\")",
+      "Bash(git checkout master)",
+      "Bash(git merge:*)",
+      "Bash(head:*)"
     ]
   }
 }

+ 14 - 0
.claude/skills/webnovel-init/SKILL.md

@@ -105,6 +105,16 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/creativity/selling-po
 cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/character-design.md"
 ```
 
+**按需加载世界构建参考**(Standard+ 模式推荐):
+```bash
+# 势力体系设计
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/faction-systems.md"
+# 设定一致性指南
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/setting-consistency.md"
+# 世界规则设计
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/world-rules.md"
+```
+
 **使用 AskUserQuestion 收集**:
 - 金手指类型(系统面板/签到/鉴定/吞噬)
 - 系统名称/代号
@@ -119,6 +129,10 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/charact
 ```bash
 cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/creativity/inspiration-collection.md"
 cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/worldbuilding/power-systems.md"
+# 创意组合方法
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/creativity/creative-combination.md"
+# 市场定位分析
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-init/references/creativity/market-positioning.md"
 ```
 
 收集:

+ 15 - 2
.claude/skills/webnovel-plan/SKILL.md

@@ -32,8 +32,9 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/cool-points-guide.md"
 ```
 
 关键规则:
-- 每章 ≥1 个爽点
-- 每 5 章 ≥1 个大爽点 (⭐⭐⭐)
+- 每章 ≥1 个小爽点(单一模式)
+- 每 5 章 ≥1 个组合爽点(2种模式叠加)
+- 每 10-15 章 ≥1 个里程碑爽点(改变主角地位)
 - 避免连续 3 章同类型
 
 ## Step 2: 加载节奏规范(必须执行)
@@ -83,6 +84,18 @@ cat 大纲/总纲.md
 
 ## Step 7: 生成详细大纲
 
+**按需加载大纲设计参考**(推荐):
+```bash
+# 章节规划指南
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/outlining/chapter-planning.md"
+# 冲突设计指南
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/outlining/conflict-design.md"
+# 大纲结构指南
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/outlining/outline-structure.md"
+# 情节框架参考
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-plan/references/outlining/plot-frameworks.md"
+```
+
 **大纲结构**:
 
 ```markdown

+ 9 - 9
.claude/skills/webnovel-plan/references/cool-points-guide.md

@@ -93,16 +93,16 @@ purpose: 爽点设计参考,规划大纲时和写作时按需加载
 
 | 周期 | 要求 |
 |------|------|
-| 每章 | ≥1 个小爽点 |
-| 每 3-5 章 | ≥1 个中爽点 |
-| 每 10-15 章 | ≥1 个大爽点 |
+| 每章 | ≥1 个小爽点(单一模式) |
+| 每 5 章 | ≥1 个组合爽点(2种模式叠加) |
+| 每 10-15 章 | ≥1 个里程碑爽点(改变主角地位) |
 
 ### 爽点强度分级
 | 级别 | 说明 | 频率 |
 |------|------|------|
-| 小爽 | 日常打脸,规模不大 | 每章1-2个 |
-| 中爽 | 重要转折,影响剧情 | 每3-5章1个 |
-| 大爽 | 阶段性高潮,期待已久的爆发 | 每10-15章1个 |
+| 小爽 | 单一模式,日常打脸,规模不大 | 每章1-2个 |
+| 组合爽点 | 2种以上模式叠加,重要转折 | 每5章1个 |
+| 里程碑爽点 | 改变主角地位的阶段性胜利 | 每10-15章1个 |
 
 ---
 
@@ -228,9 +228,9 @@ purpose: 爽点设计参考,规划大纲时和写作时按需加载
 
 | 层级 | 回收周期 | 示例 |
 |------|----------|------|
-| 核心 | 20-50章 | 主角身世/终极敌人 |
-| 支线 | 10-30章 | 配角动机/神秘物品 |
-| 装饰 | 5-15章 | 场景细节/小习惯 |
+| 核心 | 50-300章 | 主角身世/终极敌人/金手指来历 |
+| 支线 | 30-100章 | 配角动机/神秘物品/师门秘密 |
+| 装饰 | 10-30章 | 场景细节/小习惯/路人提及 |
 
 </instructions>
 

+ 3 - 3
.claude/skills/webnovel-plan/references/strand-weave-pattern.md

@@ -13,9 +13,9 @@ purpose: 章节规划时检查三线平衡,避免节奏单调
 
 | 线条 | 占比 | 定义 | 典型剧情 |
 |------|------|------|----------|
-| **Quest(主线)** | 60% | 核心任务、升级、战斗、夺宝 | 宗门大比、秘境、突破境界、复仇打脸 |
-| **Fire(感情线)** | 25% | 情感关系发展(爱情/友情/师徒) | 相识暧昧、英雄救美、确认关系 |
-| **Constellation(世界观)** | 15% | 扩展设定、展示新势力/地点 | 揭示隐藏势力、介绍新大陆、主角身世 |
+| **Quest(主线)** | 55-65% | 核心任务、升级、战斗、夺宝 | 宗门大比、秘境、突破境界、复仇打脸 |
+| **Fire(感情线)** | 20-30% | 情感关系发展(爱情/友情/师徒) | 相识暧昧、英雄救美、确认关系 |
+| **Constellation(世界观线)** | 10-20% | 扩展设定、展示新势力/地点、势力关系、社交网络 | 揭示隐藏势力、介绍新大陆、主角身世 |
 
 ## 交织规则(低自由度 - 必须执行)
 

+ 2 - 2
.claude/skills/webnovel-query/references/system-data-flow.md

@@ -67,7 +67,7 @@ Context Agent (读) ←→ index.db + state.json ←→ Data Agent (写)
 | `backup_manager.py` | 章节号 | 自动 Git 备份 |
 | `status_reporter.py` | 无 | 生成健康报告/伏笔紧急度 |
 | `archive_manager.py` | 无 | 归档不活跃数据 |
-| `migrate_state_to_sqlite.py` | 项目路径 | 迁移旧 state.json 到 SQLite (v5.1 新增) |
+| `data_modules/migrate_state_to_sqlite.py` | 项目路径 | 迁移旧 state.json 到 SQLite (v5.1 新增) |
 
 ### data_modules 模块
 
@@ -212,7 +212,7 @@ v5.0 不再要求 XML 标签,由 Data Agent 智能提取:
    - 置信度 0.5-0.8: 采用但记录 warning
    - 置信度 < 0.5: 标记待人工确认
 4. **状态变化识别**: 境界突破/位置移动/关系变化
-5. **写入存储**: entities_v3 + alias_index + index.db
+5. **写入存储**: 直接写入 index.db(实体/别名/关系/状态变化)
 
 ## 伏笔字段规范
 

+ 2 - 2
.claude/skills/webnovel-resume/references/workflow-resume.md

@@ -1,7 +1,7 @@
 ---
 name: workflow-resume
 purpose: 任务恢复时加载,指导中断恢复流程
-version: "5.0"
+version: "5.1"
 ---
 
 <context>
@@ -10,7 +10,7 @@ version: "5.0"
 
 <instructions>
 
-## Step 中断难度分级 (v5.0)
+## Step 中断难度分级 (v5.1)
 
 | Step | 名称 | 影响 | 难度 | 默认策略 |
 |------|------|------|------|----------|

+ 6 - 0
.claude/skills/webnovel-review/SKILL.md

@@ -49,6 +49,12 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-review/references/strand-weave-patter
 cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-review/references/common-mistakes.md"
 ```
 
+**可选加载节奏控制参考**:
+```bash
+# 如需深入分析节奏控制,可加载此文件
+cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-review/references/pacing-control.md"
+```
+
 ## Step 5: 加载项目状态
 
 ```bash

+ 9 - 9
.claude/skills/webnovel-review/references/cool-points-guide.md

@@ -93,16 +93,16 @@ purpose: 爽点设计参考,规划大纲时和写作时按需加载
 
 | 周期 | 要求 |
 |------|------|
-| 每章 | ≥1 个小爽点 |
-| 每 3-5 章 | ≥1 个中爽点 |
-| 每 10-15 章 | ≥1 个大爽点 |
+| 每章 | ≥1 个小爽点(单一模式) |
+| 每 5 章 | ≥1 个组合爽点(2种模式叠加) |
+| 每 10-15 章 | ≥1 个里程碑爽点(改变主角地位) |
 
 ### 爽点强度分级
 | 级别 | 说明 | 频率 |
 |------|------|------|
-| 小爽 | 日常打脸,规模不大 | 每章1-2个 |
-| 中爽 | 重要转折,影响剧情 | 每3-5章1个 |
-| 大爽 | 阶段性高潮,期待已久的爆发 | 每10-15章1个 |
+| 小爽 | 单一模式,日常打脸,规模不大 | 每章1-2个 |
+| 组合爽点 | 2种以上模式叠加,重要转折 | 每5章1个 |
+| 里程碑爽点 | 改变主角地位的阶段性胜利 | 每10-15章1个 |
 
 ---
 
@@ -228,9 +228,9 @@ purpose: 爽点设计参考,规划大纲时和写作时按需加载
 
 | 层级 | 回收周期 | 示例 |
 |------|----------|------|
-| 核心 | 20-50章 | 主角身世/终极敌人 |
-| 支线 | 10-30章 | 配角动机/神秘物品 |
-| 装饰 | 5-15章 | 场景细节/小习惯 |
+| 核心 | 50-300章 | 主角身世/终极敌人/金手指来历 |
+| 支线 | 30-100章 | 配角动机/神秘物品/师门秘密 |
+| 装饰 | 10-30章 | 场景细节/小习惯/路人提及 |
 
 </instructions>
 

+ 7 - 5
.claude/skills/webnovel-review/references/core-constraints.md

@@ -1,6 +1,7 @@
 ---
 name: core-constraints
 purpose: 每次章节写作前加载,确保三大定律执行
+version: "5.1"
 ---
 
 <context>
@@ -17,17 +18,18 @@ purpose: 每次章节写作前加载,确保三大定律执行
 | **设定即物理** | 实力/招式/物品 ≤ state.json | 写作前查询确认 |
 | **发明需识别** | 新实体由 Data Agent 自动提取 | 章节完成后处理 |
 
-## 新实体处理流程(v5.0
+## 新实体处理流程(v5.1
 
-v5.0 不再要求在正文中写 XML 标签:
+v5.1 不再要求在正文中写 XML 标签:
 1. **写作时**: 直接写纯正文,新角色/地点/物品正常描写
-2. **完成后**: Data Agent 自动识别新实体并写入 state.json
+2. **完成后**: Data Agent 自动识别新实体并写入 index.db
 3. **不确定实体**: Data Agent 标记为 uncertain,由人工确认
 
 ## 爽点密度要求
 
-- 每章 ≥1 个爽点
-- 每 5 章 ≥1 个大爽点
+- 每章 ≥1 个小爽点(单一模式)
+- 每 5 章 ≥1 个组合爽点(2种模式叠加)
+- 每 10-15 章 ≥1 个里程碑爽点(改变主角地位)
 - 避免连续 3 章同类型
 
 ## Strand 平衡警告

+ 3 - 3
.claude/skills/webnovel-review/references/strand-weave-pattern.md

@@ -13,9 +13,9 @@ purpose: 章节规划时检查三线平衡,避免节奏单调
 
 | 线条 | 占比 | 定义 | 典型剧情 |
 |------|------|------|----------|
-| **Quest(主线)** | 60% | 核心任务、升级、战斗、夺宝 | 宗门大比、秘境、突破境界、复仇打脸 |
-| **Fire(感情线)** | 25% | 情感关系发展(爱情/友情/师徒) | 相识暧昧、英雄救美、确认关系 |
-| **Constellation(世界观)** | 15% | 扩展设定、展示新势力/地点 | 揭示隐藏势力、介绍新大陆、主角身世 |
+| **Quest(主线)** | 55-65% | 核心任务、升级、战斗、夺宝 | 宗门大比、秘境、突破境界、复仇打脸 |
+| **Fire(感情线)** | 20-30% | 情感关系发展(爱情/友情/师徒) | 相识暧昧、英雄救美、确认关系 |
+| **Constellation(世界观线)** | 10-20% | 扩展设定、展示新势力/地点、势力关系、社交网络 | 揭示隐藏势力、介绍新大陆、主角身世 |
 
 ## 交织规则(低自由度 - 必须执行)
 

+ 11 - 4
.claude/skills/webnovel-write/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: webnovel-write
-description: Writes webnovel chapters (3000-5000 words) using v5.0 dual-agent architecture. Context Agent gathers context, writer produces pure text (no XML tags), review agents report issues, polish fixes problems, Data Agent extracts entities with AI.
+description: Writes webnovel chapters (3000-5000 words) using v5.1 dual-agent architecture. Context Agent gathers context, writer produces pure text (no XML tags), review agents report issues, polish fixes problems, Data Agent extracts entities with AI.
 allowed-tools: Read Write Edit Grep Bash Task
 ---
 
@@ -11,7 +11,7 @@ allowed-tools: Read Write Edit Grep Bash Task
 ⚠️ **强制要求**: 开始写作前,**必须复制以下清单**到回复中并逐项勾选。跳过任何步骤视为工作流不完整。
 
 ```
-章节创作进度 (v5.0):
+章节创作进度 (v5.1):
 - [ ] Step 1: Context Agent 搜集上下文
 - [ ] Step 2: 生成章节内容 (纯正文,3000-5000字)
 - [ ] Step 3: 审查 (5个Agent并行,输出汇总表格)
@@ -88,6 +88,13 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/core-constraints.md"
 | 复杂场景 | 新地点/大场面描写 | `cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/scene-description.md"` |
 | 欲念描写 | 大纲含暧昧/亲密/情欲场景 | `cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/desire-description.md"` |
 
+**可选加载题材风格参考**(用户指定时加载):
+```bash
+# 如需特定题材的写作风格参考,可按需加载 genres 目录下的对应文件
+# 示例: cat "${CLAUDE_PLUGIN_ROOT}/genres/修仙/修仙-writing-style.md"
+# 可用题材: 修仙、系统流、都市异能、狗血言情、知乎短篇、古言、现实题材、规则怪谈等
+```
+
 **输出格式**:
 - Markdown 文件: `正文/第{NNNN}章.md`
 - 章节末尾追加摘要(见模板)
@@ -270,8 +277,8 @@ cat "${CLAUDE_PLUGIN_ROOT}/skills/webnovel-write/references/writing/typesetting.
 
 **Agent 自动完成**:
 
-1. **AI 实体提取**
-   - 调用 LLM 从正文中语义提取实体
+1. **AI 实体提取**(Agent 内置,无需外部 LLM)
+   - 从正文中语义提取实体
    - 匹配已有实体库,识别新实体
    - 识别状态变化(境界/位置/关系)
 

+ 0 - 312
.claude/skills/webnovel-write/references/cool-points-guide.md

@@ -1,312 +0,0 @@
----
-name: cool-points-guide
-purpose: 爽点设计参考,规划大纲时和写作时按需加载
----
-
-<context>
-此文件用于爽点(cool-points)设计。Claude 已知基本叙事技巧,这里只补充网文特定的爽点工程方法论。
-</context>
-
-<instructions>
-
-## 一、六种爽点执行模式
-
-### 1. 装逼打脸
-```
-对方轻视 → 主角展示实力 → 对方震惊/后悔
-```
-**适用**:都市、玄幻、职场
-
-### 2. 扮猪吃虎
-```
-表面弱小 → 关键时刻爆发 → 众人惊艳
-```
-**适用**:重生、隐藏身份、低调流
-
-### 3. 越级反杀
-```
-实力差距明显 → 主角逆袭 → 敌人不可置信
-```
-**适用**:玄幻、武侠、竞技
-
-### 4. 打脸权威
-```
-权威质疑 → 主角用实力证明 → 权威认可/尴尬
-```
-**适用**:职场、学院、技术流
-
-### 5. 反派翻车
-```
-反派得意 → 计划破产 → 反派狼狈
-```
-**适用**:所有题材
-
-### 6. 甜蜜超预期
-```
-平淡日常 → 意外惊喜 → 情感升温
-```
-**适用**:言情、甜宠
-
----
-
-## 二、爽点三段式结构 (30/40/30公式)
-
-### 铺垫阶段 (Setup, 30%篇幅)
-- **建立预期**:读者应该期待什么
-- **制造反差**:当前状态 vs 即将展现的状态
-- **信息差设置**:读者知道什么?角色知道什么?
-
-### 兑现阶段 (Delivery, 40%篇幅)
-- **触发时机**:什么事件触发爽点
-- **展现方式**:用对话/动作/结果展现
-- **情绪高峰**:爽点的最高潮瞬间
-
-### 微反转阶段 (Twist, 30%篇幅)
-- **假结束**:读者以为爽点结束了
-- **还有一手**:其实还有更厉害的
-- **余韵**:微反转后的状态与暗示
-
----
-
-## 三、压扬比例控制
-
-### 压扬比例标准
-| 题材类型 | 压扬比例 | 说明 |
-|---------|---------|------|
-| 传统爽文 | 压3扬7 | 轻度压迫,快速释放 |
-| 硬核正剧 | 压5扬5 | 平衡叙事 |
-| 虐恋/黑深残 | 压7扬3 | 长期压抑,爆发更爽 |
-
-### 压扬节奏控制
-```
-慢铺垫(压) → 快爆发(扬) → 停顿 → 再加速
-```
-
-### 句式节奏
-- **短句**:快节奏,动作密集
-- **长句**:慢节奏,细节描写
-- **交替**:制造节奏变化
-
----
-
-## 四、爽点密度标准
-
-| 周期 | 要求 |
-|------|------|
-| 每章 | ≥1 个小爽点 |
-| 每 3-5 章 | ≥1 个中爽点 |
-| 每 10-15 章 | ≥1 个大爽点 |
-
-### 爽点强度分级
-| 级别 | 说明 | 频率 |
-|------|------|------|
-| 小爽 | 日常打脸,规模不大 | 每章1-2个 |
-| 中爽 | 重要转折,影响剧情 | 每3-5章1个 |
-| 大爽 | 阶段性高潮,期待已久的爆发 | 每10-15章1个 |
-
----
-
-## 五、信息差设计
-
-### 信息差层级
-| 层级 | 说明 |
-|------|------|
-| 读者已知 | 读者通过前文已经知道的信息 |
-| 角色已知 | 场景中的角色知道的信息 |
-| 信息差核心 | 读者知道但角色不知道的关键信息 |
-| 反转信息 | 微反转时揭示的新信息 |
-
-### 信息差运用
-```
-读者知道主角是隐藏大佬 + 角色不知道 = 期待感
-角色嘲讽主角 + 读者知道主角实力 = 爽感积累
-主角展示实力 + 角色震惊 = 爽感释放
-```
-
----
-
-## 六、打脸四步法(核心套路)
-
-**Step 1 铺垫**: 提前1-2章建立信息差(读者知道主角底牌,反派不知道)
-
-**Step 2 挑衅**: 至少3次嘲讽 + 对照组(反派被追捧 vs 主角被贬低)
-
-**Step 3 拉扯**: 2-3轮交锋,主角示弱 → 反派得意 → 期待拉满
-
-**Step 4 爆发**: 物理碾压 + 精神打击 + 围观群众反应 + 实质收获
-
----
-
-## 七、微反转类型
-
-### 还有更强
-展示了一手,其实还有更厉害的
-```
-"你以为这就是我的全力?"
-```
-
-### 意外收获
-本来只想完成目标,结果还有意外好处
-```
-打败对手 → 获得宝物 → 宝物比预期更珍贵
-```
-
-### 对方更惨
-对方以为只是小失败,其实是大翻车
-```
-输了比赛 → 赌注曝光 → 身败名裂
-```
-
-### 情感升温
-本以为只是甜,其实更甜
-```
-以为只是普通礼物 → 发现是精心准备 → 感动落泪
-```
-
-### 真相揭示
-表面是A,其实是B,而且B更厉害
-```
-以为是普通玉佩 → 其实是上古神器 → 还认主了
-```
-
----
-
-## 八、爽点升级路径
-
-### 维度1: 规模升级
-```
-打脸小流氓 → 打脸世家少爷 → 打脸宗门长老 → 覆灭一个帝国
-```
-
-### 维度2: 方式升级
-```
-暴力碾压 → 智谋碾压 → 规则掌控 → 因果抹杀
-```
-
-### 维度3: 受众升级
-```
-让邻居震惊 → 让全城震惊 → 让全国震惊 → 让诸天神魔战栗
-```
-
----
-
-## 九、题材适配
-
-### 都市爽文
-- 注重装逼打脸
-- 用财力/人脉/身份反转
-- 社会地位碾压
-
-### 玄幻升级
-- 注重战力反转
-- 用实力碾压/等级差距打破
-- 越级战斗
-
-### 悬疑本格
-- 注重真相反转
-- 用证据/推理打脸
-- 智商碾压
-
-### 甜宠言情
-- 注重情感惊喜
-- 用意外浪漫/深情告白
-- 甜度超标
-
----
-
-## 十、AI执行指令
-
-创作时必须遵守:
-
-1. **设计反转时**: 明确**信息差核心**(谁知道什么,谁不知道什么)
-2. **审核爽感时**: 爽感不足检查**铺垫篇幅(30%)**是否太少导致势能不足
-3. **节奏检查时**: 确保符合 30/40/30 公式分配
-
----
-
-## 十一、伏笔三层级
-
-| 层级 | 回收周期 | 示例 |
-|------|----------|------|
-| 核心 | 20-50章 | 主角身世/终极敌人 |
-| 支线 | 10-30章 | 配角动机/神秘物品 |
-| 装饰 | 5-15章 | 场景细节/小习惯 |
-
-</instructions>
-
-<examples>
-
-<example>
-<input>设计一个打脸爽点:主角在宗门大比被嘲笑</input>
-<output>
-**铺垫**(第45章): 主角已筑基但隐藏修为,王少以为主角只有练气七层
-**挑衅**: 王少当众嘲讽"废物也来参加?",长老们追捧王少
-**拉扯**: 第1轮主角用三成力被轻视,第2轮继续示弱,王少大笑"不过如此"
-**爆发**: 主角爆发筑基威压,一拳击飞王少,全场震惊"十八岁筑基天才!"
-**收获**: 晋升内门 + 5000灵石 + 女主好感度+20
-
-**压扬比例**: 压3扬7(铺垫2章+挑衅拉扯30% / 爆发+收获70%)
-</output>
-</example>
-
-<example>
-<input>设计越级反杀爽点:主角突破境界</input>
-<output>
-**困境**: 被追杀至悬崖,走投无路
-**机缘**: 发现隐藏洞府,获得天材地宝
-**突破**: 服用后突破至筑基期
-**展示**: 回头一掌拍飞追兵,"你们...还追吗?"
-
-**30/40/30分配**:
-- 30%: 被追杀过程,生死危机(压)
-- 40%: 发现洞府、突破过程(扬)
-- 30%: 反杀追兵、展示威风(爆)
-</output>
-</example>
-
-<example>
-<input>节奏脉冲示例</input>
-<output>
-【慢铺垫】
-"你?"王浩嗤笑一声,上下打量着萧炎,眼中满是不屑,"就凭你一个废物,也配站在这里?"
-
-【快爆发】
-萧炎动了。
-一步。
-王浩的笑容僵住。
-两步。
-他的瞳孔骤缩。
-三步。
-"砰!"
-
-【停顿】
-全场寂静。
-没有人说话。
-甚至没有人敢呼吸。
-
-【再加速】
-"还有谁?"萧炎淡淡开口,目光扫过全场。
-</output>
-</example>
-
-<example type="edge_case">
-<input>连续3章都是打脸,如何调整?</input>
-<output>
-❌ 继续打脸 → 审美疲劳
-✅ 第4章改为越级反杀或打脸权威
-✅ 或穿插 Fire Strand(感情线)调节节奏
-</output>
-</example>
-
-</examples>
-
-<errors>
-❌ 无铺垫的突然反转 → ✅ 提前1-2章埋信息差
-❌ 一招秒杀 → ✅ 至少2-3轮拉扯
-❌ 降智反派 → ✅ 基于已知信息的合理轻视
-❌ 打完无收获 → ✅ 必须有战利品/认可/资格
-❌ 缺少围观群众 → ✅ 侧面烘托震惊效果
-❌ 铺垫篇幅不足(<30%) → ✅ 势能不足,爽感打折
-❌ 压扬比例失衡 → ✅ 根据题材调整比例
-❌ 未标注信息差 → ✅ 明确读者和角色的认知差异
-</errors>

+ 6 - 4
.claude/skills/webnovel-write/references/core-constraints.md

@@ -1,6 +1,7 @@
 ---
 name: core-constraints
 purpose: 每次章节写作前加载,确保三大定律执行
+version: "5.1"
 ---
 
 <context>
@@ -19,16 +20,17 @@ purpose: 每次章节写作前加载,确保三大定律执行
 
 ## 新实体处理流程
 
-v5.0 不再要求在正文中写 XML 标签。新实体由 Data Agent 在章节完成后自动提取:
+v5.1 不再要求在正文中写 XML 标签。新实体由 Data Agent 在章节完成后自动提取:
 
 1. **写作时**: 直接写纯正文,新角色/地点/物品正常描写
-2. **完成后**: Data Agent 自动识别新实体并写入 state.json
+2. **完成后**: Data Agent 自动识别新实体并写入 index.db
 3. **不确定实体**: Data Agent 标记为 uncertain,由人工确认
 
 ## 爽点密度要求
 
-- 每章 ≥1 个爽点
-- 每 5 章 ≥1 个大爽点
+- 每章 ≥1 个小爽点(单一模式)
+- 每 5 章 ≥1 个组合爽点(2种模式叠加)
+- 每 10-15 章 ≥1 个里程碑爽点(改变主角地位)
 - 避免连续 3 章同类型
 
 ## Strand 平衡警告

+ 3 - 3
.claude/skills/webnovel-write/references/polish-guide.md

@@ -1,11 +1,11 @@
 ---
 name: polish-guide
 purpose: 章节生成后的润色阶段加载,基于审查报告修复问题 + 去除AI痕迹
-version: 5.0
+version: "5.1"
 ---
 
 <context>
-此文件用于内容润色,v5.0 新增基于审查报告的问题修复。
+此文件用于内容润色,v5.1 支持基于审查报告的问题修复。
 
 润色步骤现在接收两个输入:
 1. 章节正文
@@ -14,7 +14,7 @@ version: 5.0
 
 <instructions>
 
-## v5.0 新增:基于审查报告修复
+## v5.1:基于审查报告修复
 
 ### 输入格式
 

+ 0 - 106
.claude/skills/webnovel-write/references/strand-weave-pattern.md

@@ -1,106 +0,0 @@
----
-name: strand-weave-pattern
-purpose: 章节规划时检查三线平衡,避免节奏单调
----
-
-<context>
-此文件用于情节线平衡控制。Claude 已知多线叙事技巧,这里只补充网文特定的三线交织机制和 state.json 中的追踪器结构。
-</context>
-
-<instructions>
-
-## 三条线定义与占比
-
-| 线条 | 占比 | 定义 | 典型剧情 |
-|------|------|------|----------|
-| **Quest(主线)** | 60% | 核心任务、升级、战斗、夺宝 | 宗门大比、秘境、突破境界、复仇打脸 |
-| **Fire(感情线)** | 25% | 情感关系发展(爱情/友情/师徒) | 相识暧昧、英雄救美、确认关系 |
-| **Constellation(世界观)** | 15% | 扩展设定、展示新势力/地点 | 揭示隐藏势力、介绍新大陆、主角身世 |
-
-## 交织规则(低自由度 - 必须执行)
-
-| 规则 | 警告条件 | 建议操作 |
-|------|----------|----------|
-| Quest 不连续超过 5 章 | chapters_since_switch >= 5 | 切换到 Fire 或 Constellation |
-| Fire 不超过 10 章不出现 | current - last_fire > 10 | 安排感情戏(小甜蜜/吃醋) |
-| Constellation 不超过 15 章不出现 | current - last_constellation > 15 | 展示新设定/势力/伏笔 |
-
-## state.json 中的 strand_tracker 结构
-
-```json
-{
-  "strand_tracker": {
-    "last_quest_chapter": 45,
-    "last_fire_chapter": 43,
-    "last_constellation_chapter": 40,
-    "current_dominant": "quest",
-    "chapters_since_switch": 3,
-    "history": [{"chapter": 46, "strand": "quest"}, ...]
-  }
-}
-```
-
-## 前 30 章织网模板
-
-```
-第 1-5 章:   Quest ×5(开局快速推进主线)
-第 6 章:     Fire(首次与女主相遇)
-第 7-10 章:  Quest ×4(宗门大比)
-第 11 章:    Fire(英雄救美)
-第 12-14 章: Quest ×3(秘境夺宝)
-第 15 章:    Constellation(揭示"圣地"存在)
-第 16-19 章: Quest ×4(击败强敌)
-第 20 章:    Fire(确认关系)
-第 21-24 章: Quest ×4(突破境界)
-第 25 章:    Constellation(发现主角身世线索)
-第 26-30 章: Quest ×5(卷末高潮)
-```
-
-</instructions>
-
-<examples>
-
-<example>
-<input>当前第 46 章,last_quest=45, last_fire=43, last_constellation=40, current_dominant="quest", chapters_since_switch=3</input>
-<output>
-**警告判断**:
-- Quest 连续 3 章 < 5 章 → 暂无警告
-- 距离 Fire 3 章 < 10 章 → 暂无警告
-- 距离 Constellation 6 章 < 15 章 → 暂无警告
-
-**本章建议**: 可继续 Quest,但建议下 1-2 章内安排 Fire 调节节奏
-</output>
-</example>
-
-<example>
-<input>当前第 55 章,last_fire=42,连续 13 章无感情线</input>
-<output>
-⚠️ **警告**: 距离上次感情线 > 10 章!
-
-**建议**: 本章安排 Fire 线
-- 选项 A: 女主出场,小甜蜜互动
-- 选项 B: 英雄救美场景
-- 选项 C: 吃醋/误会小剧情
-</output>
-</example>
-
-<example type="edge_case">
-<input>开局前 10 章需要快速建立主线,感情线可以少一点吗?</input>
-<output>
-✅ 可以。前 10 章占比可调整为:
-- Quest: 70-80%
-- Fire: 10-15%
-- Constellation: 5-10%
-
-但第 6-8 章必须安排至少 1 次 Fire(首次相遇/印象建立)
-</output>
-</example>
-
-</examples>
-
-<errors>
-❌ 连续 10 章纯 Quest → ✅ 最多 5 章后切换
-❌ 感情线超过 10 章不出现 → ✅ 每 5-10 章安排一次
-❌ 世界观线超过 15 章不出现 → ✅ 每 10-15 章展示新设定
-❌ 切换 Strand 后忘记更新 strand_tracker → ✅ 每章结束后自动更新
-</errors>