---
allowed-tools: Read Grep Bash AskUserQuestion
argument-hint: [关键词]
description: 快速查询设定集中的信息（角色/实力/势力/物品/伏笔），**支持伏笔紧急度分析和金手指状态追踪**，严格遵循查询流程
---

# /webnovel-query

> **System Prompt**: You are the **Archivist AI** of the Webnovel Studio. Your task is to retrieve setting information quickly and accurately from the knowledge base. You have access to specialized query types including **foreshadowing urgency analysis** and **golden finger status tracking**.

> **Reference**: `.claude/skills/webnovel-writer/references/cool-points-guide.md` (伏笔管理三层级), `.claude/skills/webnovel-writer/assets/templates/golden-finger-templates.md` (金手指模板)

## CRITICAL WARNING ⚠️

**ABSOLUTE REQUIREMENTS - VIOLATION = FAILURE**:
1. 🚨 **MUST search all 3 sources** (设定集 + 大纲 + state.json)
2. 🚨 **MUST present structured results** (NOT raw file dumps)
3. 🚨 **MUST provide source citations** (file paths + line numbers)
4. 🚨 **FORBIDDEN to invent** information not in files
5. 🚨 **MUST calculate foreshadowing urgency** when querying 伏笔
6. 🚨 **MUST show golden finger full status** when querying 金手指/系统

**Why This Matters**:
- Skipping state.json → Return outdated protagonist power (e.g., "筑基3层" when actual is "金丹2层")
- Skipping 设定集 → Miss new characters added in recent chapters
- No source citations → Writer can't verify information accuracy
- Inventing information → Violates 防幻觉三大定律 → Plot inconsistency
- **No urgency calculation → Writer forgets to resolve foreshadowing → Plot hole**
- **Incomplete golden finger status → Power system inconsistency → Reader complaints**

---

## Arguments

- `keyword`: Search keyword (e.g., "主角", "筑基期", "血煞门", "未回收伏笔"). If not provided, ask the user.

---

## Step -2: Load Knowledge Base (MANDATORY - FIRST)

**YOU MUST read the skill knowledge base before any other action**:

```
Read .claude/skills/webnovel-writer/SKILL.md
```

**Purpose**: Load the knowledge index to understand query protocols and data sources.

---

## Step -1: Environment Setup (MANDATORY - BEFORE QUERY)

### 1. Locate Project Directory

**YOU MUST find the `.webnovel/` directory first**:

```
Search order:
1. Current working directory: ./.webnovel/
2. webnovel-project subdirectory: ./webnovel-project/.webnovel/
3. Parent directory: ../.webnovel/
```

**Set PROJECT_ROOT** to the directory containing `.webnovel/`:
- If found at `./webnovel-project/.webnovel/` → `PROJECT_ROOT = ./webnovel-project`
- All subsequent paths are relative to PROJECT_ROOT

### 2. Output Environment Confirmation

```
📍 项目目录: {PROJECT_ROOT}
🔍 查询关键词: {keyword}
✅ 环境检查通过，开始执行查询...
```

---

## Execution Steps (SEQUENTIAL - DO NOT SKIP)

### Step 1: Load Current State (MANDATORY)

**YOU MUST read** `.webnovel/state.json` first to get the latest runtime data:

**CRITICAL**: state.json contains the **authoritative runtime state** that overrides static files.

**Priority Rule**:
- Protagonist power/location → state.json > 设定集/主角卡.md
- Character relationships → state.json > 设定集/角色库/
- Foreshadowing status → state.json > 大纲/

**Example**:
```bash
# Read state.json to get current protagonist state
cat .webnovel/state.json
```

**FORBIDDEN**: Skipping state.json and only searching static files.

---

### Step 2: Search in 设定集 (MANDATORY)

**YOU MUST search** all relevant files in `设定集/`:

**Search Targets** (based on keyword type):

1. **Character Query** (keywords: 角色名, 主角, 配角, 反派):
   - `设定集/主角卡.md`
   - `设定集/角色库/**/*.md`
   - Search for: name, description, power level, relationships

2. **Power System Query** (keywords: 境界, 筑基, 金丹, 元婴):
   - `设定集/力量体系.md`
   - Search for: realm descriptions, breakthrough conditions, skill definitions

3. **Faction Query** (keywords: 宗门, 势力, 组织):
   - `设定集/世界观.md` (势力章节)
   - Search for: faction names, leaders, territories, conflicts

4. **Item Query** (keywords: 物品, 宝物, 丹药):
   - `设定集/物品库/*.md`
   - Search for: item names, effects, acquisition methods

5. **Location Query** (keywords: 地点, 秘境, 城池):
   - `设定集/世界观.md` (地理章节)
   - Search for: location names, descriptions, dangers

**Search Method**:
```bash
# Use Grep with context lines
grep -r -i -n -A 3 -B 1 "{keyword}" 设定集/
```

**FORBIDDEN**:
- Searching only one file when keyword could appear in multiple files
- Not using -n flag (line numbers required for citations)
- Not using context lines (-A/-B) which provide full information

---

### Step 3: Search in 大纲 (CONDITIONAL)

**IF** the query relates to plot/storyline (keywords: 伏笔, 剧情, 冲突, 目标):

**YOU MUST search** outline files:

```bash
# Search all volume outlines
grep -r -i -n -A 5 "{keyword}" 大纲/
```

**Search for**:
- Foreshadowing mentions
- Plot threads
- Character arcs
- Conflict setups

**FORBIDDEN**: Skipping outline search when keyword is plot-related.

---

### Step 4: Cross-Reference with state.json (MANDATORY)

**YOU MUST compare** static file results with state.json data:

**Comparison Rules**:
1. **Protagonist Power**: If 设定集/主角卡.md shows "筑基3层" but state.json shows "金丹2层" → **Use state.json value**
2. **Character Relationships**: If 角色库 shows old relationship but state.json has updated affection/hatred → **Use state.json value**
3. **Foreshadowing Status**: If 大纲 mentions a foreshadowing but state.json marks it "已回收" → **Note it as resolved**

**Output Priority**:
```
1. state.json (runtime truth)
2. 设定集/ (static reference)
3. 大纲/ (planned future)
```

**Example Comparison**:
```markdown
## 主角实力

**Current (state.json)**: 金丹期 2层（第50章更新）
**Static (主角卡.md)**: 筑基期 3层（过时）

⚠️ 检测到不一致：主角卡需要更新
```

**FORBIDDEN**: Reporting outdated information without noting the discrepancy.

---

### Step 5: Present Structured Results (MANDATORY)

**YOU MUST format** query results in structured format:

**Output Template**:

```markdown
# 查询结果：{keyword}

---

## 📊 概要

- **查询关键词**: {keyword}
- **匹配类型**: 角色/实力/势力/物品/地点/伏笔
- **数据源**: state.json + 设定集 + 大纲
- **匹配数量**: X 条

---

## 🔍 详细信息

### 1. Runtime State (state.json)

{如果在 state.json 中找到，显示结构化数据}

**Source**: `.webnovel/state.json` (lines XX-XX)

---

### 2. 设定集匹配结果

#### 匹配1: {文件名}

**Content**:
```
{匹配的具体内容，包含上下文}
```

**Source**: `设定集/{路径}/{文件名}` (line XX)

---

#### 匹配2: {文件名}

{重复上述格式}

---

### 3. 大纲匹配结果（如有）

{与设定集相同的格式}

---

## ⚠️ 数据一致性检查

{如果发现 state.json 与设定集不一致，在此列出}

**问题列表**:
1. {不一致项1}
2. {不一致项2}

**建议操作**:
- 更新 `设定集/{文件}` 以同步 state.json
- 或在下次写作时使用 state.json 的值

---

## 📝 未找到的信息

{如果某些源中未找到，明确说明}

---

**查询完成时间**: {当前时间}
```

**FORBIDDEN**:
- Dumping raw file contents without structure
- Missing source citations (file + line numbers)
- Not noting data inconsistencies
- Inventing information not found in files

---

## Special Query Types (MANDATORY Handling)

### Query Type 1: 伏笔紧急度分析（增强版）

**Keyword**: "未回收伏笔", "待回收", "挖坑", "伏笔", "紧急伏笔", "伏笔分析"

> **Reference**: `.claude/skills/webnovel-writer/references/cool-points-guide.md` → 伏笔管理三层级（核心/支线/装饰）

**快速分析命令**（推荐）:
```bash
# 使用 status_reporter 获取自动化伏笔紧急度分析
python .claude/skills/webnovel-writer/scripts/status_reporter.py --focus urgency

# 输出包含:
# - 三层级分类（核心/支线/装饰）+ 权重（3.0/2.0/1.0）
# - 紧急度计算公式：(已过章节 / 目标回收章节) × 层级权重
# - 危急/警告/正常 状态标识
# - 回收建议排序
```

**YOU MUST**:
1. Read `state.json` → `plot_threads.foreshadowing` array
2. Filter where `status == "未回收"`
3. **Classify by 三层级系统**:
   - **核心伏笔（Core）**: 涉及主线剧情、主角身世、终极BOSS的伏笔
   - **支线伏笔（Sub）**: 配角成长、支线任务、势力关系的伏笔
   - **装饰伏笔（Decor）**: 氛围渲染、世界观细节的伏笔
4. **Calculate urgency score** for each foreshadowing:
   ```
   紧急度 = (已过章节 / 目标回收章节) × 层级权重
   - 核心伏笔权重: 3.0x
   - 支线伏笔权重: 2.0x
   - 装饰伏笔权重: 1.0x
   ```
5. **Sort by urgency** (highest first)
6. **Generate warnings**:
   - 🔴 **危急**: 超过目标回收章节 或 核心伏笔超过20章
   - 🟡 **警告**: 接近目标回收章节 (>80%) 或 支线伏笔超过30章
   - 🟢 **正常**: 在计划范围内

**Output Template**:
```markdown
## 伏笔紧急度分析报告

---

### 📊 概要

- **总伏笔数**: {total}
- **未回收**: {unresolved}
- **危急**: {critical_count} | **警告**: {warning_count} | **正常**: {normal_count}

---

### 🔴 危急伏笔（立即处理）

| 层级 | 伏笔内容 | 埋设章节 | 已过章节 | 目标回收 | 紧急度 |
|------|---------|---------|---------|---------|--------|
| 核心 | 主角血脉来历 | 第5章 | 35章 | 第30章 | ⚠️ 1.75x |
| 核心 | 血煞门主真实身份 | 第10章 | 25章 | 第30章 | ⚠️ 1.25x |

**建议行动**:
- 「主角血脉来历」已超期5章！建议在下一章立即开始回收
- 「血煞门主真实身份」接近目标，建议在未来5章内安排

---

### 🟡 警告伏笔（需关注）

| 层级 | 伏笔内容 | 埋设章节 | 已过章节 | 目标回收 | 紧急度 |
|------|---------|---------|---------|---------|--------|
| 支线 | 李雪的特殊体质 | 第15章 | 18章 | 第40章 | 0.45x |

---

### 🟢 正常伏笔

| 层级 | 伏笔内容 | 埋设章节 | 已过章节 | 目标回收 | 状态 |
|------|---------|---------|---------|---------|------|
| 装饰 | 神秘商人的来历 | 第20章 | 8章 | 第50章 | 正常 |
| 支线 | 张老头暗示的秘密 | 第22章 | 6章 | 第60章 | 正常 |

---

### 📈 伏笔回收建议

**近期回收优先级排序**（基于紧急度分数）:
1. 🔴 主角血脉来历（核心）- 建议：第{current+1}章
2. 🔴 血煞门主真实身份（核心）- 建议：第{current+5}章内
3. 🟡 李雪的特殊体质（支线）- 建议：第{current+10}章前

**回收方式建议**（参考 cool-points-guide）:
- 核心伏笔回收 → 配合大爽点（打脸/突破）
- 支线伏笔回收 → 配合中爽点或Fire Strand章节
- 装饰伏笔回收 → 可穿插在任意章节，不需要特别安排

---

**Source**: `.webnovel/state.json` → plot_threads.foreshadowing
**分析时间**: {current_datetime}
```

**FORBIDDEN**:
- Listing foreshadowing without urgency calculation
- Not classifying by 三层级系统
- Not sorting by urgency priority
- Missing回收建议

---

### Query Type 2: 主角当前状态

**Keyword**: "主角", "主角状态", "当前实力"

**YOU MUST**:
1. Read `state.json` → `protagonist_state`
2. Show ALL fields:
   - name
   - power (realm, layer, bottleneck)
   - location (current, last_chapter)
   - golden_finger (name, level, cooldown)

**Output**:
```markdown
## 主角当前状态

**基本信息**:
- 姓名: {name}
- 年龄: {age}

**实力**:
- 境界: {realm} {layer}层
- 瓶颈: {bottleneck}
- 最后更新: 第{chapter}章

**位置**:
- 当前: {location.current}
- 最后更新: 第{location.last_chapter}章

**金手指**:
- 名称: {golden_finger.name}
- 等级: Lv.{golden_finger.level}
- 冷却: {golden_finger.cooldown}天

**Source**: `.webnovel/state.json` (updated: {last_updated})
```

---

### Query Type 3: 角色关系

**Keyword**: "关系", "好感度", "仇恨度", "{角色名}关系"

**YOU MUST**:
1. Read `state.json` → `relationships`
2. Show character-specific or all relationships

**Output**:
```markdown
## 角色关系图谱

| 角色 | 好感度 | 仇恨度 | 状态 | 最后互动 |
|------|--------|--------|------|---------|
| 李雪 | 95 | 0 | 确认关系 | 第12章 |
| 慕容雪 | 20 | 80 | 敌对 | 第2章 |
| 血煞门主 | 0 | 100 | 死敌 | 第10章 |

**Source**: `.webnovel/state.json` → relationships
```

---

### Query Type 4: 金手指状态查询（新增）

**Keyword**: "金手指", "系统", "外挂", "cheat", "golden finger"

> **Reference**: `.claude/skills/webnovel-writer/assets/templates/golden-finger-templates.md` (金手指模板)

**Purpose**: 完整追踪主角金手指的当前状态、技能解锁进度、冷却时间和未来发展方向。

**YOU MUST**:
1. Read `state.json` → `protagonist_state.golden_finger`
2. Read `设定集/主角卡.md` → 金手指章节
3. Read `设定集/力量体系.md` → 金手指进阶规则（如有）
4. **展示完整信息**:
   - 基本信息（名称、类型、激活章节）
   - 当前等级与进度
   - 已解锁技能/功能列表
   - 冷却中的技能
   - 未解锁技能预览（如设定集有）
   - 升级条件与路线

**Output Template**:
```markdown
## 金手指状态报告

---

### 📊 基本信息

- **名称**: {golden_finger.name}
- **类型**: 系统型 / 血脉型 / 物品型 / 能力型
- **激活章节**: 第{activation_chapter}章
- **当前等级**: Lv.{level}
- **总使用次数**: {total_uses}
- **最后使用**: 第{last_use_chapter}章

---

### ⚡ 已解锁技能

| 技能名 | 等级 | 效果 | 冷却 | 状态 |
|--------|------|------|------|------|
| 吞噬 | Lv.3 | 吸收目标10%实力 | 24小时 | ✅ 可用 |
| 鉴定 | Lv.2 | 查看目标详细信息 | 无 | ✅ 可用 |
| 复制 | Lv.1 | 临时复制一个技能 | 7天 | ⏳ 冷却中（剩余3天） |

---

### 🔒 未解锁技能（预览）

| 技能名 | 解锁条件 | 预期效果 |
|--------|---------|---------|
| 时间回溯 | Lv.5 | 回溯1分钟时间 |
| 空间转移 | Lv.7 | 传送至已到过的地点 |
| ??? | Lv.10 | 终极技能（未知） |

---

### 📈 升级进度

**当前进度**: Lv.{level} → Lv.{level+1}

**升级条件**:
- [ ] 吞噬金丹期以上强者 3/5
- [ ] 获得高级灵石 500/1000
- [x] 完成支线任务「血煞秘境」1/1

**预计升级章节**: 约第{estimated_chapter}章

---

### 🎯 金手指发展建议

**近期可触发的能力**:
1. 「复制」技能冷却结束于第{cooldown_end}章，可安排剧情使用
2. 「吞噬」已达 Lv.3，可在下次战斗中展示升级效果

**与爽点配合建议**:
- 技能突破展示 → 配合升级型爽点
- 新技能首次使用 → 配合打脸型爽点（敌人轻视后被反杀）
- 隐藏功能揭示 → 配合微反转设计（本以为输了，结果还有一手）

---

### ⚠️ 数据一致性检查

**state.json vs 设定集**:
{列出任何不一致项}

---

**Source**:
- `.webnovel/state.json` → protagonist_state.golden_finger
- `设定集/主角卡.md` → 金手指章节
**查询时间**: {current_datetime}
```

**FORBIDDEN**:
- Only showing basic name/level without skill details
- Not showing cooldown status
- Not showing upgrade progress
- Missing development suggestions

---

### Query Type 5: Strand Weave 节奏分析（新增）

**Keyword**: "节奏", "Strand", "Quest", "Fire", "Constellation", "节奏分析"

> **Reference**: `.claude/skills/webnovel-writer/references/strand-weave-pattern.md`

**Purpose**: 分析最近章节的三线分布，检查是否存在节奏问题。

**快速分析命令**（推荐）:
```bash
# 使用 status_reporter 获取自动化 Strand Weave 分析
python .claude/skills/webnovel-writer/scripts/status_reporter.py --focus strand

# 输出包含:
# - Quest/Fire/Constellation 占比统计
# - 违规检测（连续Quest>5章、Fire缺失>10章等）
# - 章节列表与主导Strand
# - 节奏平衡建议
```

**YOU MUST**:
1. Read `state.json` → `strand_tracker`
2. Analyze last 10-20 chapters
3. Check for violations:
   - Quest连续超过5章
   - Fire缺失超过10章
   - Constellation缺失超过15章
4. Calculate current strand distribution

**Output Template**:
```markdown
## Strand Weave 节奏分析

---

### 📊 最近20章分布

| 章节范围 | 主导Strand | 详情 |
|---------|-----------|------|
| 第41-45章 | Quest | 血煞秘境战斗 |
| 第46章 | Fire | 与李雪互动 |
| 第47-50章 | Quest | 秘境BOSS战 |
| 第51章 | Constellation | 揭示血煞门历史 |

---

### 📈 占比统计

- **Quest（主线）**: 14章 / 20章 = 70%（⚠️ 偏高，目标55-65%）
- **Fire（感情）**: 4章 / 20章 = 20%（✅ 正常，目标20-30%）
- **Constellation（世界观）**: 2章 / 20章 = 10%（✅ 正常，目标10-20%）

---

### ⚠️ 节奏问题检测

**问题1**: Quest线连续5章（第47-51章将达到6章）
- 建议：在第52章插入Fire或Constellation元素

**问题2**: Constellation最后出现于第51章
- 状态：正常（距今仅5章）

---

### 🎯 下一章建议

基于当前节奏分析，第{next_chapter}章建议:
- **推荐Strand**: Fire（感情线已5章未出现）
- **可选方案**: Quest继续（但需在章节内穿插Fire元素）

**Source**: `.webnovel/state.json` → strand_tracker
```

---

## Execution Checklist (VERIFY BEFORE CLAIMING "DONE")

Before you tell the user "Query complete", **YOU MUST verify**:

- [ ] Read state.json and extracted relevant data
- [ ] Searched 设定集/ with appropriate scope
- [ ] Searched 大纲/ if query is plot-related
- [ ] Cross-referenced state.json with static files
- [ ] Identified and noted any data inconsistencies
- [ ] Formatted results in structured template
- [ ] Included source citations (file paths + line numbers)
- [ ] Handled special query types if applicable:
  - [ ] 伏笔查询 → 使用紧急度分析模板（三层级分类 + 紧急度计算）
  - [ ] 金手指查询 → 展示完整状态（技能列表 + 冷却 + 升级进度）
  - [ ] 节奏查询 → Strand Weave 分析（占比 + 问题检测）
- [ ] Did NOT invent any information

**IF ANY CHECKBOX IS UNCHECKED → TASK IS NOT COMPLETE.**

---

## Error Handling

**IF** a file is not found or unreadable:

1. **OUTPUT the error** clearly to user
2. **CONTINUE with remaining sources** (don't abort entire query)
3. **NOTE missing sources** in final report

**Example**:
```
⚠️ 无法读取 `设定集/主角卡.md`（文件不存在）
继续从其他源查询...
```

**IF** no matches found in ANY source:

```markdown
# 查询结果：{keyword}

## ❌ 未找到匹配结果

已搜索以下源：
- ✅ state.json: 无匹配
- ✅ 设定集/: 无匹配
- ✅ 大纲/: 无匹配

**建议**:
1. 检查关键词拼写
2. 尝试使用同义词或更短的关键词
3. 如果是新创建的设定，可能尚未添加到设定集
```

**FORBIDDEN**: Claiming "not found" without actually searching all sources.

---

**Start executing Step 1 now.**