@oh-story/dsh 0.1.9 → 0.1.11

package/lib/oh-story/skills/story-long-scan/SKILL.md

@@ -32,7 +32,7 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 ### Phase 1：确认平台和方向
 
-问用户：**「你想看哪个平台？（起点/番茄/晋江/其他）有没有关注的题材方向？」**
+问用户：**「你想看哪个平台？（起点/番茄/晋江/七猫/刺猬猫/其他）有没有关注的题材方向？」**
 
 关键判断：
 - 用户已有方向 → 针对该方向做深度扫榜
@@ -53,227 +53,75 @@ metadata: {"openclaw":{"source":"https://github.com/zenstory-ai/oh-story-claudec
 
 #### 脚本采集模式
 
-优先运行对应平台脚本直接采集结构化数据。起点使用移动端 SSR pageContext，默认不需要 Chrome/CDP；番茄等需要浏览器态的平台再使用 `/browser-cdp` 启动 Chrome。
-
-**采集流程**：
-1. 选择平台脚本；起点直接运行 `scripts/qidian-rank-scraper.js`，番茄/七猫/晋江等按需启动 browser-cdp
-2. 等待列表元素或 SSR 数据加载，逐条提取字段（排名、书名、作者、题材、字数、推荐/在读数等），判断翻页（起点通常单页50-100条，番茄按题材逐页cap≈20）
-3. 需要补充数据时（标签、简介、最新更新），进入详情页提取
-4. 按规范格式写入 Markdown 文件
-5. 多榜单/多题材时，逐组采集并保存
-
-**输出规范**：详见 [references/scan-output-format.md](references/scan-output-format.md)，包含各平台字段定义、输出模板。
-
-**起点采集目标**（优先运行 `node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录}`；默认 `--mode auto` 会先用 `https://m.qidian.com` 移动端 SSR，PC/CDP 只作回退）：
-
-| 榜单 | URL | 核心字段 |
-|------|-----|----------|
-| 新人签约新书榜 | qidian.com/rank/newsign/ | 作者·题材·签约·免费/VIP·字数·总推荐·标签·简介 |
-| 签约作者新书榜 | qidian.com/rank/signnewbook/ | 已签约作者新书，新风向信号 |
-| 公众作者新书榜 | qidian.com/rank/pubnewbook/ | 公众作者新书，发现潜力作者 |
-| 新人作者新书榜 | qidian.com/rank/newauthor/ | 新人作品，新人赛道风向 |
-| 三江推荐 | qidian.com/sanjiang/ | 编辑推荐，按周分组（注意：非 /rank/ 路径） |
-| 月票榜 | qidian.com/rank/yuepiao/ | 付费认可度最高指标 |
-| 畅销榜 | qidian.com/rank/hotsales/ | 真金白银投票 |
-| 阅读指数榜 | qidian.com/rank/readindex/ | 阅读量综合指标 |
-| 收藏榜 | qidian.com/rank/collect/ | 读者关注热度 |
-| 原创推荐榜 | qidian.com/rank/recom/ | |
-
-**番茄采集目标**：
-
-| 榜单 | URL格式 | 核心字段 |
-|------|---------|----------|
-| 男频阅读榜 | fanqienovel.com/rank/1_2_{cat_id} | 按题材逐页采集，在读数为核心指标 |
-| 女频阅读榜 | fanqienovel.com/rank/0_2_{cat_id} | 按题材逐页采集 |
-| 男频新书榜 | fanqienovel.com/rank/1_1_{cat_id} | 新风向信号 |
-| 女频新书榜 | fanqienovel.com/rank/0_1_{cat_id} | 新风向信号 |
-
-URL 参数：`/rank/{channel}_{type}_{cat_id}`，channel 0=女频/1=男频，type 1=新书榜/2=阅读榜。番茄列表页有字体反爬，须用 `scripts/fanqie-rank-scraper.js` 从详情页多策略解码书名/作者/题材/评分/标签/简介，配合 browser-cdp 使用：
-
-```bash
-node scripts/fanqie-rank-scraper.js --channel 1 --type 2 --outdir {输出目录}   # 男频阅读榜
-node scripts/fanqie-rank-scraper.js --channel all --top 15 --outdir {输出目录}   # 男女频，每题材前 15 本
-```
-
-> **番茄采集后必查文件头 `数据质量`**，异常排查步骤见 [references/scan-output-format.md](references/scan-output-format.md)。
-
-**七猫采集目标**：
-
-| 榜单 | URL | 核心字段 |
-|------|-----|----------|
-| 排行榜总入口 | qimao.com/paihang | 大热榜/新书榜/完结榜，热度为核心指标 |
-
-榜单类型：大热榜（日榜/月榜）、新书榜、完结榜、收藏榜、更新榜，支持男生榜/女生榜切换。
-
-大热榜用 `--period day|month|all` 显式选择日榜、月榜或两者（默认 `day`）；周期会进入文件头与文件名。非大热榜不区分周期，`--period` 不会重复采集。
-
-**晋江采集目标**（`scripts/jjwxc-rank-scraper.js`，默认列表 + 详情两步走）：
-
-| 榜单 | URL | 核心字段 |
-|------|-----|----------|
-| 收入金榜 | jjwxc.net/topten.php?orderstr=12&t=0 | 收藏数、营养液、积分、字数、状态（详情页 `onebook.php` 补采） |
-
-```bash
-node scripts/jjwxc-rank-scraper.js --type 12 --outdir {输出目录}        # 列表+详情（默认每频道前10，详情上限100）
-node scripts/jjwxc-rank-scraper.js --type 12 --top 15 --detail-limit 60  # 调整每频道本数/详情总量
-node scripts/jjwxc-rank-scraper.js --type 12 --list-only                 # 只采列表（快，无核心指标）
-```
-
-> **晋江硬性要求**：必须有详情页核心指标（收藏数/营养液/积分/字数），脚本默认已补采；采集要点见 [references/scan-output-format.md](references/scan-output-format.md)。
-
-**文件命名**：`{平台}{榜单名称}_{YYYYMMDD}.md`，例：`起点新人签约新书榜_20260425.md`
-
-#### 采集质量检查（「确定数据来源」完成后必须执行）
-
-每完成一个榜单的采集，立即执行以下检查。发现问题当场修复，不留给后续分析。详细规则见 [references/scan-output-format.md](references/scan-output-format.md)「数据清洗与字段约束」。
-
-**1. 数据完整性**
-
-| 检查项 | 标准 | 处理 |
-|--------|------|------|
-| 条目数量 | >= 15 条有效数据（小平台 >= 10） | 不足则在文件头注明 `[数据稀疏] 实际采集 N 条` |
-| 必填字段 | 排名、书名、作者（缺任一项视为无效） | 无效条目移除，条目数重新计算 |
-| 字段一致性 | 同一榜单内所有条目字段集必须一致 | 不一致条目标记 `[字段缺失: {字段名}]` |
-
-**2. 数据清洗**
-
-| 污染类型 | 处理 |
-|----------|------|
-| 平台模板文本（番茄「提供XXX完整版在线免费阅读」、七猫「上一页」等） | 删除模板文本，保留正文 |
-| 解析串行（同一条目出现两个不同作品的数据） | 标记 `[解析异常]`，删除并重新采集 |
-| 空字段（空白、`--`、`未知`） | 标记 `[待补]`，优先通过详情页补采 |
-
-**3. 简介截断**
-
-- 清洗后超过 100 字的简介，在最近的句号/问号/感叹号处截断，加 `...`
-- 平台模板文本不计入 100 字限制（先删除模板，再截断）
-
-**4. 文件头质量状态**
-
-每个采集文件头部必须包含：
-
-```
-- 数据质量：[OK / 存在问题]
-- 有效条目：{N} / {总数}
-- 问题摘要：{无 / 具体问题描述}
-```
+1. 只读所选平台那一份：[起点](references/platform-qidian.md) / [番茄](references/platform-fanqie.md) / [七猫](references/platform-qimao.md) / [晋江](references/platform-jjwxc.md) / [刺猬猫](references/platform-ciweimao.md)。里面有榜单网址、命令、字段、默认组合、故障排查和该平台的分析维度；需要浏览器态的平台先 `/browser-cdp` 启动 Chrome。
+2. 每次扫榜新建输出目录 `扫榜/{YYYYMMDD}/`（同日再扫加 `-2`），存本次榜单，不往旧目录追加（聚合会混进旧榜）；文件名 `{平台}{榜单}_{YYYYMMDD}.md`。脚本已做清洗和质量标注。
+3. 聚合：`node scripts/aggregate-rank.js {输出目录} --out {输出目录}/扫榜聚合.md`（小平台加 `--sparse 10`）。**主会话只读这份聚合**，不整份读原始榜单：题材分布、本数占比、热度与字数中位、标签热词、书名常见词、多榜重合、每题材前 3 本代表作。
+4. 看聚合的「采集情况」：标了问题（书名没解出来、没采到、只有书单）的榜单按平台参考排查重采；重采不了就在报告里说明结论不含它。同方向不到 15 本（小平台 10 本）标「少」，等同 `[数据稀疏]`。
+5. 要看原始条目（开篇卖点、新人设、新桥段）时按需抽样：`node scripts/aggregate-rank.js {输出目录} --sample {题材/标签/书名词} --n 5`，一次一个方向。
 
 #### 其他数据来源
 
-**用户提供操作指引：**
-- 用户提供已有的扫描结果文件路径 → 直接加载进入「数据分析」
-- 用户提供链接 → 用 WebFetch 抓取
-- 用户粘贴/截图 → 手动解析进入分析
+**用户提供：** 已有扫描结果文件 → 直接聚合；链接 → 用 WebFetch 抓取；粘贴/截图 → 整理成 `# {平台} · {榜单名}` 标题、每本一段 `### #{排名} {书名}` 加一行 `*作者 · 题材 · 连载中 · 120万字 · 3.5万收藏*`（热度写「数字+口径」；有标签再加 `**标签：** a、b`）存进输出目录，再同样聚合。
 
-**内置知识操作指引：**
-- 加载 `references/genre-trends.md`
-- 明确标注：「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的榜单。
+**内置知识：** 加载 `references/genre-trends.md`，明确标注「以下分析基于历史趋势数据；未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的榜单。
 
 ---
 
 ### Phase 3：数据分析
 
-根据用户选择的平台，结合已获取的数据做以下分析：
-
-#### 起点中文网分析维度
-
-| 维度 | 看什么 |
-|---|---|
-| 月票榜/推荐票榜 | 付费用户认可度高、持续追读强 |
-| 畅销榜 | 真金白银投票，最硬核的指标 |
-| 签约作者新书榜 | 已签约作者的新作风向 |
-| 公众作者新书榜 | 公众作者的新作，发现潜力股 |
-| 新人作者新书榜 | 新作者作品与新题材信号 |
-| 三江推荐 | 编辑精选推荐，按周分组，发现平台力推作品 |
-| 分类榜单 | 各垂直题材的竞争格局 |
-| 追读率 | 核心指标，决定推荐位分配 |
-
-#### 番茄小说分析维度
-
-| 维度 | 看什么 |
-|---|---|
-| 阅读榜 | 流量与读者规模，在读数为核心指标 |
-| 新书榜 | 新题材、新风向的早期信号 |
-| 题材分布 | 各品类在读数集中度 |
-| 在读数趋势 | 同题材不同作品的流量差距 |
-| 标签热词 | 简介开头【】内的标签组合，揭示题材细分卖点（如「种田+慢热+西幻」） |
-
-#### 七猫小说分析维度
-
-| 维度 | 看什么 |
-|---|---|
-| 大热榜 | 热度排名，反映流量集中度 |
-| 新书榜 | 新流量风口 |
-| 完结榜 | 长尾价值作品 |
-| 热度指标 | 七猫核心指标，反映读者活跃度 |
-
-#### 晋江文学城分析维度
+以聚合结果为主，按所选平台参考里的「分析维度」看，再提取通用维度：
 
-> **采集硬性要求**：若用了 `--list-only` 或文件头标 `[仅列表-无核心指标]`，则该数据不足以支撑以下分析维度，视为不合格。
-
-| 维度 | 看什么 |
-|---|---|
-| 金榜 | 综合热度最高 |
-| 季度榜 | 中期趋势 |
-| 红字/黑字 | 积分与负面评价 |
-| 收藏/营养液 | 女频市场的核心指标 |
-
-#### 通用分析维度
-
-对每个平台的榜单数据，提取：
-
-1. **题材分布**：当前榜上哪些题材最多
-2. **新题材信号**：最近新出现的题材类型
-3. **经典题材变化**：老牌题材的走势（上升/稳定/下降）
-4. **字数与更新**：上榜作品的字数区间和更新频率
-5. **书名模式**：上榜作品的命名规律
-6. **开头卖点**：简介/标签中反复出现的关键词
-7. **新元素对比**：与上期/同类榜单对比，标注新出现的人物设定、开篇切入点、桥段套路
+1. **题材分布**：题材表的本数、占比与热度中位
+2. **新题材信号**：新书榜列、多榜重合；`扫榜/` 下上一次的日期目录里有 `扫榜聚合.md` 就对比
+3. **经典题材变化**：老牌题材的走势（上升/稳定/下降），没有上期数据就只写现状
+4. **字数**：字数分布与各题材字数中位
+5. **书名模式**：书名常见词 + 代表作书名
+6. **开头卖点**：标签热词 + 代表作简介
+7. **新元素**：对候选方向抽样原始条目，标出新的人物设定、开篇切入点、桥段套路
 
 ---
 
 ### Phase 4：输出扫榜报告
 
-```
-# 长篇网文扫榜报告：{平台名称}
+报告写给作者：讲市场结论和能写的方向。脚本名、命令和采集状态码不进报告；某个榜没采到，就说一句「XX 榜这次没拿到（原因），结论不含它」。
 
-## 市场概况
+报告展示给作者，同时写进输出目录的 `选题决策.md`：文件不存在就先按 [references/topic-decision.md](references/topic-decision.md) 的模板写文件头，再把报告作为「扫榜结论」一节写入（已存在同名一节就整节替换）。作者只扫榜不选题，结论也已落盘。
+
+<!-- author-report -->
+```md
+## 扫榜结论：{平台名称}
+
+### 市场概况
 - 扫榜时间：{日期}
 - 核心发现：{一句话总结}
 
-## 题材热度排行
+### 题材热度排行
 | 排名 | 题材 | 榜上数量 | 趋势 | 代表作 |
 |------|------|----------|------|--------|
 | 1 | {题材} | {N本} | ↑/→/↓ | {书名} |
 
-## 新题材信号
+### 新题材信号
 - {新出现或正在上升的题材，附依据}
 
-## 经典题材动态
+### 经典题材动态
 - {老牌题材的现状，附依据}
 
-## 新元素提取
-### 新人物设定模式
-- {新模式描述 + 代表作}
-
-### 新开篇切入点
-- {新切入点描述 + 代表作}
+### 新元素提取
+- 新人物设定：{新模式描述 + 代表作}
+- 新开篇切入点：{新切入点描述 + 代表作}
+- 新桥段/套路：{新桥段描述 + 代表作}
 
-### 新桥段/套路
-- {新桥段描述 + 代表作}
-
-## 关键数据洞察
+### 关键数据洞察
 - 字数区间：上榜作品集中在 {X}-{Y} 万字
-- 更新频率：日均 {X} 字为主流
 - 书名特征：{命名模式总结}
 - 标签热词：{高频标签词}
 
-## 值得关注的方向
+### 值得关注的方向
 1. {方向 + 为什么值得关注 + 可行性评估}
 2. {方向 + 为什么值得关注 + 可行性评估}
 3. {方向 + 为什么值得关注 + 可行性评估}
 
-## 一句话
+### 一句话
 {犀利的总结}
 ```
 
@@ -283,12 +131,14 @@ node scripts/jjwxc-rank-scraper.js --type 12 --list-only                 # 只
 
 把扫榜结果变成能直接用的选题建议，产出 `选题决策.md`。完整方法（选题四步 + 可行性判断 + 输出模板）见 [references/topic-decision.md](references/topic-decision.md)。
 
+**从文件接上：** 先读 `{outdir}/选题决策.md` 的「扫榜结论」和 `扫榜聚合.md`，不靠对话记忆；两者都没有就回 Phase 2。
+
 **如信息不足，向用户补齐项目条件：**「目标平台、已有素材、擅长题材/写作约束、计划篇幅是什么？」
 
-按 `topic-decision.md` 的选题四步产出 2-3 个推荐选题（能爆的原因 → 市场验证 → 差异化定位 → 可行性+失败风险+验证动作），写入**本次扫榜输出目录** `{outdir}/选题决策.md`
+按 `topic-decision.md` 的选题四步产出 2-3 个推荐选题（能爆的原因 → 市场验证 → 差异化定位 → 可行性+失败风险+验证动作），写入**本次扫榜输出目录** `{outdir}/选题决策.md` 的「推荐选题」一节，保留「扫榜结论」。
 
 **硬规则：**
-- 可行性上限：背靠榜单标了 `[数据稀疏]` 或同方向样本 <15（小平台<10）⇒ 不许给"高"，强制降到"中" + 写明先验证；内置知识模式一律给"中"。
+- 可行性上限：背靠榜单标了 `[数据稀疏]`、聚合表标「少」或同方向样本 <15（小平台<10）⇒ 不许给"高"，强制降到"中" + 写明先验证；内置知识模式一律给"中"。
 - 不输出项目素材无法支撑的题材；不只看热度，必须给可行性和失败风险；不忽略平台调性差异（起点男频和晋江女频审美完全不同）。
 
 ---
@@ -326,13 +176,14 @@ node scripts/jjwxc-rank-scraper.js --type 12 --list-only                 # 只
 | [references/reader-profiling.md](references/reader-profiling.md) | 需要分析目标读者画像时 |
 | [references/genre-trends.md](references/genre-trends.md) | 查看题材趋势候选、切入约束和样本校验规则时 |
 | [references/publishing-guide.md](references/publishing-guide.md) | 平台适配+推荐机制校验+数据指标+简介设计 |
-| [references/scan-output-format.md](references/scan-output-format.md) | 脚本/CDP 采集字段定义+输出模板 |
+| 五份平台参考（链接见「脚本采集模式」第 1 步） | 「确定数据来源」：只读所选平台那份——榜单网址、命令、字段、故障排查、平台分析维度 |
+| [scripts/aggregate-rank.js](scripts/aggregate-rank.js) | 把输出目录里的原始榜单聚合成短表（`--out` 落盘，`--sample` 抽原始条目，`--json` 机读），主会话只读它 |
 | [scripts/cdp-utils.js](scripts/cdp-utils.js) | CDP 公共工具函数（ab/sleep/evalJSON/safeStr/scrollLoad/getArg），各采集脚本共用 |
-| [scripts/fanqie-rank-scraper.js](scripts/fanqie-rank-scraper.js) | 番茄榜单采集，分批请求防超时，带连通性自检+标题解析率质量标注，配合 browser-cdp 使用 |
-| [scripts/qidian-rank-scraper.js](scripts/qidian-rank-scraper.js) | 起点榜单采集（畅销/月票/新书等），默认移动端 SSR 提取，PC/CDP 回退 |
-| [scripts/qimao-rank-scraper.js](scripts/qimao-rank-scraper.js) | 七猫榜单采集（大热/新书/完结等），tab 切换（失败重试）+滚动加载，按 bookId 取书名回填作品页链接，带连通性自检+链接/热度命中率标注 |
-| [scripts/jjwxc-rank-scraper.js](scripts/jjwxc-rank-scraper.js) | 晋江榜单采集（收入金榜/月榜等），按频道分组 |
-| [scripts/ciweimao-rank-scraper.js](scripts/ciweimao-rank-scraper.js) | 刺猬猫榜单采集（点击/收藏/月票等），单页 9 榜提取，按 bookId 归一书名回填作品页链接，带连通性自检+空结果重试+链接命中率标注 |
+| [scripts/fanqie-rank-scraper.js](scripts/fanqie-rank-scraper.js) | 番茄榜单采集，用法见番茄参考 |
+| [scripts/qidian-rank-scraper.js](scripts/qidian-rank-scraper.js) | 起点榜单采集，用法见起点参考 |
+| [scripts/qimao-rank-scraper.js](scripts/qimao-rank-scraper.js) | 七猫榜单采集，用法见七猫参考 |
+| [scripts/jjwxc-rank-scraper.js](scripts/jjwxc-rank-scraper.js) | 晋江榜单采集，用法见晋江参考 |
+| [scripts/ciweimao-rank-scraper.js](scripts/ciweimao-rank-scraper.js) | 刺猬猫榜单采集，用法见刺猬猫参考 |
 
 ---
 

package/lib/oh-story/skills/story-long-scan/references/platform-ciweimao.md

@@ -0,0 +1,19 @@
+# 刺猬猫：采集与分析
+
+作者选了刺猬猫才读本文。需先用 `/browser-cdp` 启动 Chrome。rank-index 单页展示全部榜单，脚本按文本解析，按书名归一回填作品页链接，带连通性自检与空结果重试。
+
+## 榜单与命令
+
+`node scripts/ciweimao-rank-scraper.js --type {榜单} --outdir {输出目录}`：click 点击榜 / favor 收藏榜 / recommend 推荐榜 / subscribe 订阅榜 / monthly 月票榜 / tsukkomi 吐槽榜 / newbook 新书榜 / blade 刀片榜 / all 全部（默认）。
+
+## 字段
+
+排名、书名、作者（仅榜首条目带）、题材（其余条目带）、榜单值（聚合的热度口径；各榜含义不同，不跨榜比较）、作品页链接。刺猬猫是小平台：同方向不到 10 本才算稀疏，聚合时加 `--sparse 10`。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 月票/订阅榜 | 付费认可 |
+| 新书榜 | 二次元新梗与新设定 |
+| 吐槽/刀片榜 | 读者互动强度与争议点 |

package/lib/oh-story/skills/story-long-scan/references/platform-fanqie.md

@@ -0,0 +1,45 @@
+# 番茄：采集与分析
+
+作者选了番茄才读本文。番茄列表页有字体反爬，须先用 `/browser-cdp` 启动 Chrome，再由脚本从详情页（内嵌 JSON `bookName`/`author`/`abstract`/`categoryV2` + `<title>` + og:meta）多策略解码书名、作者、题材、标签、简介。
+
+## 榜单与命令
+
+URL `fanqienovel.com/rank/{channel}_{type}_{cat_id}`：channel 0=女频/1=男频，type 1=新书榜/2=阅读榜。
+
+```bash
+node scripts/fanqie-rank-scraper.js --channel 1 --type 2 --outdir {输出目录}     # 男频阅读榜（默认）
+node scripts/fanqie-rank-scraper.js --channel all --top 15 --outdir {输出目录}   # 男女频，每题材前 15 本
+```
+
+脚本逐题材采集（每题材上限约 20，`--top N` 可调），每 5 本一批请求详情页。默认组合：男频阅读榜全题材 + 女频阅读榜全题材；要看新风向再加新书榜（`--type 1`）或下面的书库「最热」。文件名 `番茄{频道}{榜单}_全题材_{YYYYMMDD}.md`。一份全题材就是七百来条，只读聚合结果，不整份读原始文件。
+
+题材 cat_id —— 男频 19 个：西方奇幻(1141) / 东方仙侠(1140) / 科幻末世(8) / 都市日常(261) / 都市修真(124) / 都市高武(1014) / 历史古代(273) / 战神赘婿(27) / 都市种田(263) / 传统玄幻(258) / 历史脑洞(272) / 悬疑脑洞(539) / 都市脑洞(262) / 玄幻脑洞(257) / 悬疑灵异(751) / 抗战谍战(504) / 游戏体育(746) / 动漫衍生(718) / 男频衍生(1016)；女频 18 个：古风世情(1139) / 科幻末世(8) / 游戏体育(746) / 女频衍生(1015) / 玄幻言情(248) / 种田(23) / 年代(79) / 现言脑洞(267) / 宫斗宅斗(246) / 悬疑脑洞(539) / 古言脑洞(253) / 快穿(24) / 青春甜宠(749) / 星光璀璨(745) / 女频悬疑(747) / 职场婚恋(750) / 豪门总裁(748) / 民国言情(1017)。
+
+### 书库「最热」
+
+URL `fanqienovel.com/library/{筛选}/page_{n}?sort=hottes`：筛选段 `audience1`=男生、`audience0`=女生（不写＝不分男女），`stat1`=连载中、`stat0`=已完结，`count0`=30 万字以下（`count1`-`count4` 依次 30-50 万、50-100 万、100-200 万、200 万以上），全不选时是 `all`。每页 18 本，按热度排。
+
+```bash
+node scripts/fanqie-rank-scraper.js --source library --channel all --outdir {输出目录}            # 男、女各一份：连载中、30 万字以下、前 3 页
+node scripts/fanqie-rank-scraper.js --source library --channel mix --pages 5 --outdir {输出目录}  # 不分男女
+```
+
+`--stat 1|0|any`、`--count 0-4|any` 改筛选。默认组合（连载中、30 万字以下）是**正在起量的新书**：阅读榜被老书占住时，看它才知道新书里什么题材在冒头，文件名与列表名带「新书」，聚合时算进「新书榜」列。列表页书名和数字都被字体反爬，脚本只按页面顺序取 bookId，书名、题材、在读、字数都由详情页解码。
+
+## 字段
+
+排名、书名、作者、题材（详情页 categoryV2）、状态、在读（核心指标，聚合的热度口径）、字数、标签（简介开头 `【种田+慢热+西幻】`，题材细分的真实信号）、最新更新、bookId、作品页链接、简介。详情页没有数字评分，不输出评分。解码失败的书名显示 `（标题待解析）`，bookId 与链接保留供回查。
+
+## 故障排查
+
+文件头 `数据质量` 标 `[标题解析异常]`（书名多为 `（标题待解析）`）：多为详情页结构变动或被登录/验证页拦截。在已登录的 Chrome 里手动打开任一 `https://fanqienovel.com/page/{bookId}`，确认页面正常、不是验证页；控制台报 `CDP 无响应` 就按 browser-cdp 重新启动 Chrome。确认正常后重采。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 阅读榜 | 流量与读者规模，在读数为核心指标 |
+| 新书榜 | 新题材、新风向的早期信号（聚合表的「新书榜」列） |
+| 题材分布 | 各品类在读数集中度（热度中位对照本数） |
+| 在读数差距 | 同题材头部与腰部的流量差 |
+| 标签热词 | 【】内标签组合揭示细分卖点 |

package/lib/oh-story/skills/story-long-scan/references/platform-jjwxc.md

@@ -0,0 +1,28 @@
+# 晋江：采集与分析
+
+作者选了晋江才读本文。需先用 `/browser-cdp` 启动 Chrome。脚本两步走：① 列表页 `topten.php` 取频道分组与书名/作者，从书名链接取 `novelid`（排除「X 向《书名》投了 Y」霸王票记录）；② 进 `onebook.php?novelid=` 详情页补采核心指标。晋江是 gb18030 编码，脚本已按此解码；详情指标公开，无需登录。
+
+## 榜单与命令
+
+URL `jjwxc.net/topten.php?orderstr={榜单ID}&t={频道ID}`（t=0 全站）。orderstr：收入金榜 12 / 月榜 7 / 季度榜 8 / 完结金榜 14 / 新手金榜 15 / 千字金榜 17。
+
+```bash
+node scripts/jjwxc-rank-scraper.js --type 12 --outdir {输出目录}        # 列表+详情（默认每频道前 10，详情上限 100）
+node scripts/jjwxc-rank-scraper.js --type 12 --top 15 --detail-limit 60  # 调整每频道本数/详情总量
+node scripts/jjwxc-rank-scraper.js --type 12 --list-only                 # 只采列表（快，无核心指标）
+```
+
+默认组合：收入金榜 + 月榜。
+
+## 字段与硬性要求
+
+频道（聚合时当题材）、排名、书名、作者、novelid、收藏数（核心，聚合的热度口径）、营养液、积分、字数、状态、作品页链接。必须有详情页核心指标（收藏、营养液或积分、字数）：用了 `--list-only` 或文件头标 `[仅列表-无核心指标]` 的数据撑不起下面的分析，视为不合格，要重采。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 金榜 | 综合热度最高 |
+| 季度榜 | 中期趋势 |
+| 红字/黑字 | 积分与负面评价 |
+| 收藏/营养液 | 女频市场的核心指标 |

package/lib/oh-story/skills/story-long-scan/references/platform-qidian.md

@@ -0,0 +1,35 @@
+# 起点：采集与分析
+
+作者选了起点才读本文。默认不需要 Chrome：脚本先读 `https://m.qidian.com` 移动端 SSR pageContext，移动端不可用时才回退 CDP/PC 页面，文件头 `抓取方式` 标 `mobile-ssr` 或 `cdp-pc`。
+
+## 榜单与命令
+
+`node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录}`（`--type all` 全采；`--mode mobile|cdp` 强制一种方式；`--detail yes` 进详情页补标签、简介、最新更新）
+
+| 榜单 | --type | URL | 看什么 |
+|------|--------|-----|--------|
+| 新人签约新书榜 | newsign | qidian.com/rank/newsign/ | 新人签约作品，新风向 |
+| 签约作者新书榜 | signnewbook | qidian.com/rank/signnewbook/ | 已签约作者新作风向 |
+| 公众作者新书榜 | pubnewbook | qidian.com/rank/pubnewbook/ | 发现潜力作者 |
+| 新人作者新书榜 | newauthor | qidian.com/rank/newauthor/ | 新人赛道 |
+| 三江推荐 | sanjiang | qidian.com/sanjiang/ | 编辑精选，按周分组（非 /rank/ 路径） |
+| 月票榜 | yuepiao | qidian.com/rank/yuepiao/ | 付费认可度最高 |
+| 畅销榜 | hotsales | qidian.com/rank/hotsales/ | 真金白银投票 |
+| 阅读指数榜 | readindex | qidian.com/rank/readindex/ | 阅读量综合 |
+| 收藏榜 | collect | qidian.com/rank/collect/ | 读者关注热度 |
+| 原创推荐榜 | recom | qidian.com/rank/recom/ | 平台推荐 |
+
+默认组合：新人签约新书榜 + 签约作者新书榜 + 月票榜 + 畅销榜。文件名 `起点{榜单}_{YYYYMMDD}.md`。
+
+## 字段
+
+排名、书名、作者、题材（主类·子类；聚合时主类作题材、子类进标签）、状态、签约、收费模式、字数、总推荐（聚合的热度口径）、标签/最新更新/简介（详情页）、作品页链接。额外必填：题材、字数、总推荐，缺的写 `[待补]`。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 月票榜/畅销榜 | 付费认可与持续追读，最硬的指标 |
+| 各新书榜 | 新作者、新题材的早期信号；和月票/畅销榜的题材占比对照 |
+| 三江推荐 | 平台力推方向 |
+| 追读率 | 决定推荐位分配（榜单上看不到，只能从月票/畅销间接推断） |

package/lib/oh-story/skills/story-long-scan/references/platform-qimao.md

@@ -0,0 +1,27 @@
+# 七猫：采集与分析
+
+作者选了七猫才读本文。需先用 `/browser-cdp` 启动 Chrome；页面无明显反爬，脚本滚动加载，男生榜/女生榜 tab 切换（失败重试）。
+
+## 榜单与命令
+
+入口 qimao.com/paihang：大热榜（日榜/月榜）、新书榜、完结榜、收藏榜、更新榜。
+
+```bash
+node scripts/qimao-rank-scraper.js --channel male --type hot --period day --outdir {输出目录}   # 男生大热榜日榜
+node scripts/qimao-rank-scraper.js --channel all --type all --outdir {输出目录}                 # 全部
+```
+
+大热榜用 `--period day|month|all` 选日榜、月榜或两者（默认 day），周期进文件头与文件名；其他榜不分周期。默认组合：男频大热榜日榜 + 女频大热榜日榜。
+
+## 字段
+
+排名、书名、作者、题材、分类标签（聚合时进标签）、状态、字数（万字）、热度（核心指标，聚合的热度口径）、最新更新、作品页链接、简介。文件头带 `数据质量`、`有效条目`、`问题摘要`、链接与热度命中数；热度缺失写 `[待补]`。
+
+## 分析维度
+
+| 维度 | 看什么 |
+|---|---|
+| 大热榜 | 热度排名，流量集中度 |
+| 新书榜 | 新流量风口 |
+| 完结榜 | 长尾价值作品 |
+| 热度 | 七猫核心指标，读者活跃度 |

package/lib/oh-story/skills/story-long-scan/references/topic-decision.md

@@ -49,6 +49,10 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 # 选题决策：{平台/方向}
 - 扫榜日期：{YYYYMMDD}     # 数据新鲜度；写作读取时若过期会提示复扫
 - 数据来源：{榜单文件名 / 内置知识}
+- 聚合表：扫榜聚合.md     # 同目录；内置知识模式写「无」
+
+## 扫榜结论：{平台名称}
+{Phase 4 报告正文，Phase 4 写入；Phase 5 只读不改}
 
 ## 推荐选题
 
@@ -73,6 +77,6 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 
 ## 交付
 
-1. 写到本次扫榜的输出目录（和榜单文件同一个目录）：`{outdir}/选题决策.md`。扫榜常在还没有小说项目的目录下跑，所以产物落在这里，不直接写进项目。
-2. 告知用户路径，并说明下一步：「开书时如果小说项目就建在这个目录里、或和这个目录同级（共用一个上级目录），`/story-long-write` 会自动找到并让你确认；隔得更远就把 `选题决策.md` 复制到小说项目根目录，或开书时把路径粘给它。想确认"能爆的原因"就先 `/story-long-analyze` 拆对标书，拆完会回填。」
+1. 写到本次扫榜的输出目录 `扫榜/{YYYYMMDD}/`（和榜单、`扫榜聚合.md` 同目录）：`{outdir}/选题决策.md`。Phase 4 先写文件头和「扫榜结论」，Phase 5 再写「推荐选题」；重跑时整节替换，不追加第二份。扫榜常在还没有小说项目的目录下跑，所以产物落在这里，不直接写进项目。
+2. 告知用户路径，并说明下一步：「开书时如果小说项目就建在扫榜时所在的文件夹里、或和它同级，`/story-long-write` 会自动找到并让你确认；隔得更远就把 `选题决策.md` 复制到小说项目根目录，或开书时把路径粘给它。想确认"能爆的原因"就先 `/story-long-analyze` 拆对标书，拆完会回填。」
 3. 后续衔接（本文件不执行，仅说明）：拆文在汇总报告产出后回填对应选题的"能爆的原因"；写作 Phase 1 读取 `选题决策.md` 作为开书起点。