wq-scan

> 依赖 wq-rules，默认 quiet 模式。

扫榜分析与竞品拆解

触发关键词

扫榜、分析热榜、看看现在什么火、市场调研、竞品分析、拆解XX书、拆解这个链接、分析榜单趋势、看看番茄什么火、看看七猫什么火、热门题材分析、榜单数据分析

核心功能

1. 榜单抓取：从番茄/七猫等平台抓取公开榜单数据
2. 趋势分析：统计热门题材、套路模式、读者偏好
3. 竞品拆解：深度拆解标杆作品的结构、人设、钩子、节奏
4. 写作指南生成：基于趋势+拆解，生成可注入context pack的写作指令

与 wq-topic 的区别

• wq-scan：数据驱动，从真实榜单/作品中提取市场信息
• wq-topic：创意驱动，基于经验和知识生成选题方案
• 配合关系：scan 的输出（趋势报告）可作为 topic 的输入，提升选题的数据支撑

一、数据来源

来源优先级

用户明确指定 > 网页抓取 > 手动输入

支持的数据来源

平台范围

根据 .sumeru/project.json 的 targetPlatform 字段确定抓取目标：

二、榜单抓取规则

番茄小说榜单URL模式

# 番茄小说Web端榜单页面
https://fanqienovel.com/rank/{榜单类型}

七猫免费小说榜单URL模式

# 七猫Web端榜单页面
https://www.qimao.com/rank/{榜单类型}

抓取策略

1. 优先抓取web页面：使用 webfetch 抓取榜单页面HTML
2. 解析榜单数据：从HTML中提取书名、作者、题材、简介、排名等信息
3. 抓取限制：单次最多抓取榜单前50本，避免过度请求
4. 缓存机制：同一天对同一榜单的抓取结果缓存到 .sumeru/research/cache/

抓取失败处理

• 网页抓取失败 → 提示用户手动输入榜单数据
• 页面结构变化 → 记录错误，提示用户反馈

三、趋势分析规则

分析维度

趋势报告格式

# 扫榜趋势报告

## 扫描范围
- 平台：番茄小说
- 榜单：畅销榜Top50
- 扫描时间：2026-06-12
- 题材：玄幻

## 题材分布
| 题材 | 数量 | 占比 | 平均排名 |
|------|------|------|----------|
| 都市修仙 | 15 | 30% | 12 |
| 系统流 | 12 | 24% | 18 |
| ... | ... | ... | ... |

## 套路模式统计
| 套路类型 | 出现次数 | 代表作 |
|----------|----------|--------|
| 退婚开局 | 8 | 《XX》《YY》 |
| 赘婿逆袭 | 6 | 《ZZ》 |
| ... | ... | ... |

## 开篇模式Top5
1. 被欺负/羞辱开局（12本）
2. 穿越/重生开局（10本）
3. 系统觉醒开局（8本）
4. ... 

## 人设趋势
- 主角类型：[逆袭型/成长型/扮猪吃虎型]
- 金手指：[系统/重生记忆/特殊体质]
- 反派：[嚣张打脸型/阴险算计型]

## 读者偏好画像
- 书名关键词：[重生, 系统, 帝尊, 无敌]
- 简介高频词：[逆袭, 打脸, 爽文, 无敌]
- 标签分布：[玄幻, 都市, 系统, 重生]

四、竞品拆解规则

拆解深度

拆解维度

1. 结构拆解

2. 人设拆解

3. 爽点拆解

4. 开篇拆解（重点）

标杆拆解卡片格式

# 标杆拆解：《书名》

## 基本信息
- 平台：番茄小说
- 题材：玄幻·都市修仙
- 字数：15万（拆解前3万）
- 排名：畅销榜第X名
- 评分：X.X分

## 结构分析
### 章节节奏
| 章节 | 字数 | 核心事件 | 钩子类型 | 爽点 |
|------|------|----------|----------|------|
| 第1章 | 2100 | 主角被退婚 | 悬念：觉醒 | 无 |
| 第2章 | 2300 | 系统觉醒 | 反转：隐藏身份 | 初步爽 |
| ... | ... | ... | ... | ... |

### 节奏曲线
[用ASCII或文字描述节奏起伏]

## 人设分析
### 主角
- 类型：逆袭型
- 金手指：XX系统
- 性格：隐忍、果断
- 成长线：废物→天才

### 核心配角
| 角色 | 功能 | 与主角关系 |
|------|------|------------|
| 苏瑾 | 女主/支持者 | 从怀疑到信任 |
| 赵无极 | 反派/垫脚石 | 被打脸对象 |

## 爽点分析
### 爽点清单
| 章节 | 爽点类型 | 铺垫长度 | 强度 |
|------|----------|----------|------|
| 第3章 | 打脸 | 2章 | 中 |
| 第8章 | 逆袭 | 5章 | 高 |

### 爽点模式
- 铺垫方式：[被欺负→隐忍→爆发]
- 爆发节奏：[3章一个小爽点，10章一个大爽点]

## 开篇分析
### 前100字
[摘录原文前100字]
- 冲突启动：✅/❌
- 设定铺陈：有/无
- 吸引力评分：X/10

### 前3章结构
| 章节 | 切入方式 | 核心冲突 | 钩子 |
|------|----------|----------|------|
| 第1章 | 被退婚 | 身份vs尊严 | 觉醒暗示 |
| 第2章 | 系统觉醒 | 废物vs天才 | 隐藏身份 |
| 第3章 | 第一次打脸 | 实力vs偏见 | 更大敌人 |

## 可复用模式
### 开篇模式
- 模式名称：[退婚开局]
- 结构：[羞辱→觉醒→暗示→钩子]
- 适用场景：[玄幻/都市逆袭]

### 爽点模式
- 模式名称：[隐忍打脸]
- 结构：[被欺负→隐忍→实力展示→打脸]
- 铺垫建议：[2-3章铺垫，1章爆发]

### 钩子模式
- 模式名称：[身份悬念]
- 结构：[暗示主角有隐藏身份/能力]
- 使用频率：[每章结尾]

## 差异化亮点
- 本书的独特之处：[...]
- 与同类作品的区别：[...]
- 可借鉴的创新点：[...]

## 避坑提示
- 本书的不足之处：[...]
- 读者负面反馈：[...]
- 应避免的模式：[...]

五、写作指南生成规则

定位

写作指南是针对当前小说项目生成的持久化写作指令，只在当前项目创作时使用。

生成时机

• 新项目创作规划时（wq-topic 或 wq-worldbuilder 阶段）
• 用户手动触发：/wq-scan 生成指南

生成流程

1. 读取项目信息：从 .sumeru/project.json 读取题材、平台、风格
2. 读取扫榜数据：从 .sumeru/research/trends.md 读取趋势报告
3. 读取标杆拆解：从 .sumeru/research/benchmarks/ 读取相关题材的拆解
4. 匹配提炼：从趋势+拆解中提取与当前项目相关的模式
5. 生成指南：输出 .sumeru/research/writing-guide.md

写作指南格式

# 写作指南：{小说标题}

> 本指南基于{平台}{题材}扫榜数据生成，仅供当前项目使用。
> 生成时间：{日期}
> 数据来源：{榜单名称} Top{N}

## 一、开篇指导

### 推荐开篇模式
基于当前榜单{题材}热榜作品分析，推荐以下开篇模式：

| 模式 | 使用频率 | 代表作 | 适用性 |
|------|----------|--------|--------|
| {模式1} | {N}本/{M}% | 《XX》 | ⭐⭐⭐ |
| {模式2} | {N}本/{M}% | 《YY》 | ⭐⭐ |

### 开篇结构建议

第1章：{切入方式}，{核心冲突}，{钩子类型}
第2章：{推进方式}，{金手指展示}，{钩子类型}
第3章：{第一个爽点}，{冲突升级}，{钩子类型}

### 开篇禁忌
基于榜单数据分析，以下开篇模式应避免：
- ❌ {禁忌1}：{原因}
- ❌ {禁忌2}：{原因}

## 二、爽点设计指导

### 推荐爽点模式
| 爽点类型 | 铺垫长度 | 爆发强度 | 使用频率 |
|----------|----------|----------|----------|
| {类型1} | {N}章 | 高 | 每{M}章 |
| {类型2} | {N}章 | 中 | 每{M}章 |

### 爽点节奏建议
- 小爽点：每{N}章一个，铺垫{M}章
- 大爽点：每{N}章一个，铺垫{M}章
- 高潮段：每{N}章一个小高潮，{M}章一个大高潮

### 爽点创新方向
基于榜单作品分析，以下方向可尝试差异化：
- {创新方向1}
- {创新方向2}

## 三、人设指导

### 主角人设推荐
基于榜单热作分析，当前题材主流主角类型：

| 类型 | 占比 | 特征 | 代表作 |
|------|------|------|--------|
| {类型1} | {N}% | {特征} | 《XX》 |
| {类型2} | {N}% | {特征} | 《YY》 |

### 金手指推荐
| 金手指类型 | 占比 | 特点 | 适用性 |
|------------|------|------|--------|
| {类型1} | {N}% | {特点} | ⭐⭐⭐ |
| {类型2} | {N}% | {特点} | ⭐⭐ |

### 反派设计建议
- 反派层次：{建议}
- 智商水平：{建议}
- 压迫感来源：{建议}

## 四、节奏控制指导

### 章节字数建议
- 当前平台：{平台}
- 推荐字数：{N}-{M}字/章
- 榜单平均：{X}字/章

### 对话占比建议
- 当前平台：{平台}
- 推荐占比：{N}%-{M}%
- 榜单平均：{X}%

### 节奏曲线建议

章节：1 2 3 4 5 6 7 8 9 10
节奏：↑ → ↑↑ → ↑↑↑ → ↑ ↑↑↑↑
铺垫 小爽 铺垫 大爽 铺垫 高潮

## 五、钩子设计指导

### 推荐钩子类型
| 钩子类型 | 使用场景 | 示例 |
|----------|----------|------|
| {类型1} | {场景} | {示例} |
| {类型2} | {场景} | {示例} |

### 钩子频率建议
- 每章结尾：必须有钩子
- 每{N}章：一个大钩子（卷级悬念）

## 六、避坑清单

基于榜单作品的读者反馈和差评分析，以下模式应避免：

### 烂大街套路
- ❌ {套路1}：{原因}
- ❌ {套路2}：{原因}

### 读者反感模式
- ❌ {模式1}：{原因}
- ❌ {模式2}：{原因}

### 常见失误
- ❌ {失误1}：{原因}
- ❌ {失误2}：{原因}

## 七、注入Context Pack指令

以下内容可直接复制到 `shared-write.md` 的「写作指南」section：

```markdown
## 写作指南（基于{平台}{题材}扫榜数据）

### 开篇要求
- {要求1}
- {要求2}

### 爽点要求
- {要求1}
- {要求2}

### 人设要求
- {要求1}
- {要求2}

### 节奏要求
- {要求1}
- {要求2}

### 避坑要求
- {要求1}
- {要求2}

---

## 六、仿写指南生成规则

### 定位
仿写指南是基于标杆作品拆解，提取**结构/风格/套路模式**的写作指令，用于指导原创内容创作。

**核心原则**：学骨架不学血肉，学模式不学内容。

### 生成时机
- 用户手动触发：`/wq-scan 拆解 《书名》 --imitation`
- 拆解完成后自动生成（当指定 `--imitation` 参数时）

### 生成流程
1. **读取拆解结果**：从 `.sumeru/research/benchmarks/{书名}.md` 读取标杆拆解
2. **提取结构模式**：开篇结构、章节节奏、钩子设计
3. **提取风格特征**：句式、对话、情绪表达、用词习惯
4. **提取套路模式**：金手指、人设、冲突、打脸模式
5. **生成仿写指令**：输出 `.sumeru/research/imitation-guide-{书名}.md`

### 仿写指南格式

```markdown
# 仿写指南：基于《{书名}》

> 本指南提取自《{书名}》的结构/风格/套路模式，用于指导原创内容创作。
> 生成时间：{日期}
> 拆解范围：{全书/前3万字}

## ⚠️ 原创保障声明

仿写时必须确保：
- [ ] 人物名称、外貌、背景**完全原创**
- [ ] 地名、组织名、功法名**完全原创**
- [ ] 具体情节、对话、场景**完全原创**
- [ ] 核心设定有差异化（不能照搬金手指）
- [ ] 只学模式，不学具体内容

---

## 一、结构模式

### 开篇结构
| 章节 | 切入方式 | 核心冲突 | 钩子类型 |
|------|----------|----------|----------|
| 第1章 | {模式} | {模式} | {模式} |
| 第2章 | {模式} | {模式} | {模式} |
| 第3章 | {模式} | {模式} | {模式} |

### 章节节奏
- 小爽点间隔：{N}章
- 大爽点间隔：{N}章
- 高潮位置：{章节范围}
- 节奏曲线：{快-慢-快/匀速推进/...}

### 钩子模式
| 钩子类型 | 使用场景 | 频率 | 示例结构 |
|----------|----------|------|----------|
| {类型1} | {场景} | 每{N}章 | {结构描述} |
| {类型2} | {场景} | 每{N}章 | {结构描述} |

### 信息密度
- 每章核心事件数：{N}个
- 场景切换频率：{每N章}
- 时间推进节奏：{描述}

---

## 二、风格特征

### 句式特征
| 维度 | 特征值 | 说明 |
|------|--------|------|
| 句子平均长度 | {N}字 | {短句为主/长句为主/长短交替} |
| 破碎句使用 | {高/中/低} | {频率描述} |
| 口语化程度 | {高/中/低} | {特征描述} |
| 主谓宾完整度 | {高/中/低} | {特征描述} |

### 对话风格
| 维度 | 特征值 | 说明 |
|------|--------|------|
| 对话占比 | {N}% | {偏高/偏低/适中} |
| 对话标记词 | {说/道/问道/混合} | {偏好描述} |
| 打断/停顿 | {高/中/低} | {频率描述} |
| 跑题/重复 | {高/中/低} | {频率描述} |
| 潜台词深度 | {高/中/低} | {特征描述} |

### 情绪表达
| 维度 | 特征值 | 说明 |
|------|--------|------|
| 直白vs暗示 | {比例} | {直白交代多/动作暗示多/平衡} |
| 内心独白占比 | {N}% | {偏高/偏低/适中} |
| 环境烘托 | {高/中/低} | {频率描述} |
| 情绪节拍 | {线性/跳跃/渐进} | {转换方式描述} |

### 用词特征
| 维度 | 特征值 |
|------|--------|
| 高频词汇 | {词汇1}、{词汇2}、{词汇3}... |
| 口头禅/语气词 | {词1}、{词2}... |
| 比喻风格 | {具象/抽象/少用} |
| 形容词偏好 | {特征描述} |
| 动词偏好 | {特征描述} |

---

## 三、套路模式

### 金手指模式
| 维度 | 模式 |
|------|------|
| 类型 | {系统/重生记忆/特殊体质/...} |
| 展示节奏 | {第N章展示/渐进展示/...} |
| 升级曲线 | {描述} |
| 限制设计 | {描述} |
| 爽点来源 | {描述} |

### 人设模板
| 维度 | 模式 |
|------|------|
| 主角类型 | {逆袭型/成长型/扮猪吃虎/...} |
| 核心性格 | {特征1}、{特征2}、{特征3} |
| 成长弧线 | {起点}→{终点} |
| 行为模式 | {描述} |
| 语言风格 | {描述} |

### 配角模式
| 角色类型 | 功能定位 | 与主角关系 | 设计要点 |
|----------|----------|------------|----------|
| 女主 | {功能} | {关系} | {要点} |
| 反派 | {功能} | {关系} | {要点} |
| 配角 | {功能} | {关系} | {要点} |

### 冲突模式
| 维度 | 模式 |
|------|------|
| 冲突来源 | {打脸/夺宝/争位/...} |
| 铺垫方式 | {描述} |
| 爆发节奏 | {描述} |
| 解决方式 | {描述} |

### 打脸模式
| 维度 | 模式 |
|------|------|
| 铺垫结构 | {被欺负→隐忍→爆发/...} |
| 铺垫长度 | {N}章 |
| 爽点强度 | {描述} |
| 反派设计 | {智商/层次/压迫感} |
| 打脸方式 | {实力碾压/智商碾压/身份反转/...} |

---

## 四、仿写执行指令

> 以下指令可直接注入 `shared-write.md` 的「仿写指令」section。

### 结构指令
```markdown
## 仿写结构指令（基于《{书名}》）

### 开篇要求
- 第1章：{模仿的开篇模式}
- 第2章：{模仿的推进模式}
- 第3章：{模仿的第一个爽点}

### 节奏要求
- 小爽点间隔：{N}章
- 大爽点间隔：{N}章
- 章节字数：{N}-{M}字

### 钩子要求
- 每章结尾：{模仿的钩子类型}
- 大钩子频率：{每N章}

风格指令

## 仿写风格指令（基于《{书名}》）

### 句式要求
- 句子长度：{模仿的特征}
- 破碎句：{模仿的频率}
- 口语化：{模仿的程度}

### 对话要求
- 对话占比：{N}%
- 标记词：{模仿的偏好}
- 打断/停顿：{模仿的频率}

### 情绪要求
- 表达方式：{直白/暗示/平衡}
- 内心独白：{模仿的占比}
- 环境烘托：{模仿的频率}

套路指令

## 仿写套路指令（基于《{书名}》）

### 金手指（用原创设定，模仿模式）
- 类型：{模仿的类型}
- 展示节奏：{模仿的节奏}
- 升级曲线：{模仿的曲线}

### 人设（用原创人物，模仿模板）
- 主角类型：{模仿的类型}
- 核心性格：{模仿的特征}
- 成长弧线：{模仿的弧线}

### 冲突（用原创情节，模仿模式）
- 冲突来源：{模仿的来源}
- 铺垫方式：{模仿的方式}
- 爆发节奏：{模仿的节奏}

### 打脸（用原创场景，模仿模式）
- 铺垫结构：{模仿的结构}
- 铺垫长度：{N}章
- 打脸方式：{模仿的方式}

五、差异化建议

基于《{书名}》的模式，以下方向可做差异化：

设定差异化

• {差异化方向1}
• {差异化方向2}

人设差异化

• {差异化方向1}
• {差异化方向2}

情节差异化

• {差异化方向1}
• {差异化方向2}

风格差异化

• {差异化方向1}
• {差异化方向2}

六、避坑提示

基于《{书名}》的拆解，以下问题应避免：

原作不足

• ❌ {不足1}：{改进方向}
• ❌ {不足2}：{改进方向}

模式风险

• ❌ {风险1}：{规避方式}
• ❌ {风险2}：{规避方式}

读者反感

• ❌ {反感点1}：{规避方式}
• ❌ {反感点2}：{规避方式}

---

## 七、子Agent调用规则

### 子Agent分工

| 任务 | 执行者 | 说明 |
|------|--------|------|
| 榜单抓取 | 父Agent | webfetch调用 |
| 单书拆解 | 子Agent并行 | 每个子Agent负责1本书 |
| 趋势分析 | 父Agent | 汇总所有拆解结果 |
| 写作指南生成 | 父Agent | 基于趋势+拆解生成 |

### 子Agent拆解模板

父Agent启动拆解子Agent时，传入以下指令：

角色：网文分析师，专攻{题材}题材

任务：深度拆解《{书名}》

拆解范围：{全书/前3万字}

拆解维度：
1. 结构分析：章节字数、段落数、对话占比、节奏曲线
2. 人设分析：主角类型、金手指、配角功能、反派设计
3. 爽点分析：爽点类型、频率、强度、创新点
4. 开篇分析：前100字、前1000字、前3章结构
5. 钩子分析：每章结尾钩子类型、频率

输出格式：按标杆拆解卡片格式输出

重点：
- 提取可复用的模式
- 识别差异化亮点
- 标注避坑提示

---

## 七、按模式输出

| 模式 | 输出内容 |
|------|----------|
| `short/light` | 单书拆解卡片，无趋势报告 |
| `medium/standard` | 1-3本书拆解 + 简要趋势报告 |
| `long/full` | 5-10本书拆解 + 完整趋势报告 + 写作指南 |

---

## 八、独立调用自举

1. **定位项目**：从当前目录查找 `.sumeru/project.json`
2. **读取配置**：获取 `targetPlatform`、`style`、`genre` 等信息
3. **确定榜单范围**：根据 `targetPlatform` 确定抓取目标
4. **检查缓存**：检查 `.sumeru/research/cache/` 是否有今日缓存
5. **执行抓取**：按优先级获取榜单数据
6. **生成报告**：按用户指定模式输出

---

## 九、数据持久化

### 用户可见输出
- `.sumeru/research/trends.md`：趋势报告
- `.sumeru/research/benchmarks/{书名}.md`：标杆拆解卡片
- `.sumeru/research/writing-guide.md`：写作指南
- `.sumeru/research/imitation-guide-{书名}.md`：仿写指南（指定 `--imitation` 时生成）

### 中间数据
- `.sumeru/research/cache/`：榜单抓取缓存
- `.sumeru/research/raw/`：原始抓取数据
- `.sumeru/research/analysis.json`：结构化分析数据

---

## 十、与其他Skill配合

| 方向 | Skill | 关系 |
|------|-------|------|
| **前置** | 无 | 可独立调用 |
| **后续** | `wq-topic` | 读取趋势报告，提升选题数据支撑 |
| **后续** | `wq-outline` | 读取标杆拆解，参考结构设计 |
| **后续** | `wq-write` | 注入写作指南/仿写指南到context pack |
| **后续** | `wq-review` | 参考避坑清单作为审查标准 |

### 集成点说明

#### wq-topic 集成
选题阶段可读取 `.sumeru/research/trends.md`：
- 替代"基于模型知识推断"的市场分析
- 提供真实的榜单数据支撑
- 输出时标注"数据来源：{平台}榜单{日期}"

#### wq-write 集成
写作阶段，父Agent将写作指南/仿写指南注入context pack：

**写作指南注入**：
1. 读取 `.sumeru/research/writing-guide.md`
2. 提取「七、注入Context Pack指令」section
3. 写入 `shared-write.md` 的「写作指南」section

**仿写指南注入**：
1. 读取 `.sumeru/research/imitation-guide-{书名}.md`
2. 提取「四、仿写执行指令」section
3. 写入 `shared-write.md` 的「仿写指令」section
4. 子Agent写作时按仿写指令的结构/风格/套路模式创作原创内容

#### wq-review 集成
审查阶段可读取 `.sumeru/research/writing-guide.md` 的避坑清单：
- 作为审查标准的补充
- 检查正文是否落入烂大街套路
- 检查正文是否触发读者反感模式

---

## 十一、调用示例

```bash
# 交互式扫榜
/wq-scan

# 指定平台+题材
/wq-scan 番茄 玄幻

# 拆解指定书籍
/wq-scan 拆解 《书名》

# 拆解指定链接
/wq-scan 拆解 https://fanqienovel.com/page/xxx

# 拆解+生成仿写指南
/wq-scan 拆解 《书名》 --imitation

# 生成写作指南
/wq-scan 生成指南

# 更新指南（新增拆解后）
/wq-scan 更新指南

十二、注意事项

数据准确性

• 网页抓取的数据可能存在延迟，需标注抓取时间
• 榜单排名是动态变化的，趋势分析基于抓取时刻的快照
• 拆解分析基于文本内容，可能存在主观判断

合规约束

• 拆解仅用于学习分析，不鼓励抄袭
• 引用原文时控制在合理范围内
• 写作指南强调"学习模式"而非"套用内容"

资源控制

• 单次抓取最多50本榜单数据
• 单次拆解最多10本书
• 缓存数据24小时后过期