npm - @oh-story/dsh - Versions diffs - 0.1.14 → 0.1.16 - Mend

@oh-story/dsh 0.1.14 → 0.1.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (533) hide show

package/lib/oh-story/skills/story-long-scan/references/genre-trends.md CHANGED Viewed

@@ -1,5 +1,5 @@
 # 网文题材趋势与流派参考
-题材选择、流派写作要点、扫榜技巧的速查手册。
+流派、书名示例作候选，趋势看本次榜单。
 ---
@@ -11,28 +11,28 @@
 2. 评估潜力（纯原创？有市场铺垫？）
 3. 匹配题材（放进熟悉题材看效果）
 4. 提炼核心卖点（能否转化为情绪缺口/期待感）
-5. 梳理故事雏形（框架/金手指/切入点）
+5. 检验故事雏形能否持续推进
 6. 动笔验证
 ### 金手指创新
-基础=满足条件→得到反馈。变体：多条件一反馈 / 阶段性反馈 / 概率性反馈 / 反馈可叠加
+金手指以“满足条件→得到反馈”为基础，可用多条件触发、阶段反馈、概率反馈或反馈叠加。
 ### 写长方法
-1. 从核心卖点找多角度，归纳不同矛盾套路，每套写1-2卷
-2. 叠加框架：多角度交织循环支撑几百万字
-3. 框架+小剧情循环：大目标→中目标→小目标→细纲
+1. 从核心卖点推演不同矛盾，每套可展开1-2卷
+2. 让各卷目标、代价与关系相互影响，持续推进主线
+3. 将大目标拆成中目标、小目标与细纲，检验每轮剧情的新变化
-### 跟风 = 换皮
+### 跟风与换皮
-照搬核心设定换熟悉题材。金手指类兼容所有题材；同题材跟风保留底层情绪另换角度。
+只换题材外壳属于换皮。跟风保留已验证的情绪期待，让金手指机制、人物选择或切入角度随题材变化。
 ---
 ## 题材选择
-85%熟悉+15%惊喜。选择数据充分+可构建完整世界观的赛道。
+用熟悉题材建立预期，以新元素制造惊喜；方向有样本，素材能撑主线。
 ---
@@ -42,13 +42,9 @@
 |------|------|------|
 | 题材圈 | 都市、玄幻、仙侠 | 大分类 |
 | 流派圈 | 极道流、凡人流、种田流 | 细分 |
-| 核心梗圈 | 具体卖点/金手指/情绪点 | 内容不能踏出此圈 |
+| 核心梗圈 | 具体卖点/金手指/情绪点 | 主线持续兑现核心期待，副线为它服务 |
-| 错误 | 后果 |
-|------|------|
-| 高武文写官场 | 踏破边界 |
-| 种田文写深度商战 | 串味 |
-| 悬疑文去掉悬念 | 核心卖点消失 |
+高武写官场、种田写商战时，检查副线是否仍服务升级或经营反馈；悬疑去掉核心悬念后，需重新明确追读理由。
 ---
@@ -64,10 +60,10 @@
 ### 各网站方法
-**起点**：三江→首订图→签约新书榜前15→拆精品到万订之间的书
-**番茄**：新书榜拉到底→在读30万以上为标准
+**起点**：结合三江、签约新书榜与付费榜选对标；首订图指作者提供的订阅数据截图，脚本不采首订。
+**番茄**：对照新书榜、阅读榜与书库新书，比较同题材、同书龄的在读差距。
-### 起点热门题材
+### 起点题材候选
 | 题材 | 要点 |
 |------|------|
@@ -75,7 +71,7 @@
 | 玄幻 | 极道流、加点横推等强反馈样本优先；传统玄幻若近期样本稀疏，标记为高风险 |
 | 仙侠 | 优先检查脑洞融合路线的近期样本；纯传统路线需额外验证受众 |
 | 历史 | 秦/唐/明/宋/三国；类同人写法 |
-| 诸天无限 | 不要写原创副本，用同人 |
+| 诸天无限 | 比较同人与原创副本样本，看世界规则能否持续兑现核心期待 |
 | 科幻 | 末世类（含脑洞/种田/游戏设定） |
 ---
@@ -84,16 +80,16 @@
 | 流派 | 核心要点 |
 |------|----------|
-| 极道流 | 金手指属性加点，横推一切；边界清楚、验证成本低，适合作为低复杂度候选 |
+| 极道流 | 金手指属性加点，横推一切；用样本检验反馈是否足够直接 |
 | 凡人流 | 小人物攀爬+精打细算；战力数据化+寿命驱动 |
 | 巫师流 | 知识体系+实验探索升级，门槛较高 |
-| 种田流 | 经营餐馆/书店/渔场等；复杂度较低，可与多界穿梭结合，但仍需样本校验 |
-| 都市高武 | 高频：武馆+学校双线/死党对比/师姐诱惑/模拟考装逼；《武圣》前三章是黄金模板 |
+| 种田流 | 以餐馆/书店/渔场的经营反馈推进，可与多界穿梭结合 |
+| 都市高武 | 可观察武馆+学校双线、死党对比、师姐互动、模拟考装逼；以《武圣》前三章为拆文候选 |
 | 同人文 | 仅在用户明确目标 IP、平台允许且近期样本有效时使用；默认只抽“已知世界+新变量+名场面改写”结构 |
-| 盘点文 | 难度低，找对切入点 |
+| 盘点文 | 盘点对象与切入点要鲜明 |
 | 模拟文 | 模拟制造情绪缺口→得奖励→现实满足 |
 | 两界穿梭 | 标准模板：金手指+震惊历史人物+改变命运 |
-| 历史文 | 秦/唐/明/宋/三国主流；需危机感+从小到大+清晰主线；宋朝以后审核风险高 |
+| 历史文 | 秦/唐/明/宋/三国可作候选；用危机感、由小及大的目标与清晰主线组织剧情 |
 ---
@@ -101,27 +97,25 @@
 | 维度 | 要点 |
 |------|------|
-| 事业感情配比 | 五五开上限最高但要求极高；感情弱→8:2，感情行→2:8起步 |
-| 期待感 | 没有升级线必须持续维持期待感；悬疑反转少用；保持两万字规划连续性 |
-| 短视频化 | 每章有几个逗人一笑的点；搭建正反馈人际网循环玩梗；同一梗反复出现读者不厌倦 |
-| 同质化 | 微创新开头+中正内容=足够精品；缺的是流量不是内容 |
+| 事业感情配比 | 按作者擅长的事业线或感情线确定主次，检查另一条线是否促进人物选择 |
+| 期待感 | 没有升级线时靠人物目标持续维持期待感，反转服务当下选择 |
+| 短视频化 | 用人物关系与反应形成笑点；复用梗时让关系或结果有新变化 |
+| 同质化 | 分别检验开篇差异与中段持续兑现，不把数据低一概归因于流量 |
 ---
 ## 轻小说
-核心=卖有戏剧性的人设（尤其美少女人设）。
+核心是有戏剧性的人设（尤其美少女人设），以及令人羡慕的互动。
 - 事业线：美少女当前困境+她与别人的恩怨
 - 爱情线：有戏剧性的发展+人设搭配造成事件
-- 核心竞争力：人设设计+互动状态是否令人羡慕
 ---
 ## 喜剧/沙雕文
-套路：中计掉坑+弄巧成拙 / 降智反派 / 误解错位，可组合。
-底层原理：根据读者对角色好感度，让剧情对角色的忧惧因素产生攻击性。
+可组合中计掉坑、弄巧成拙、降智反派与误解错位。先让麻烦落到角色身上，再借意外变化制造笑点；读者对角色的好感会影响他们是心疼还是看笑话。
 ---
@@ -138,7 +132,9 @@
 ---
-## 爆款灵感素材库
+## 书名与卖点观察样本
+以下样本只用于观察命名和情绪入口；能否支撑长篇主线，仍须查本次长篇榜单与作品内容。
 ### 古言/宫闱宅斗
@@ -182,16 +178,6 @@
 ## 命名规律
-### 短篇公式
-`[极端事件] + [被逼/死亡] + [反击手段]`
-高频词：疯了/杀疯了/悔疯了(17次) | 我反手/我让他(4次) | 全家/所有人都(4次) | 清明节/愚人节/除夕夜(4次)
 ### 长篇公式
-高频词：快穿、系统、一见钟情、离婚后、反派、开局秒杀
-### 知乎风格
-平均7.9字。类型：事件型 / 反差型 / 互动型
+观察词：快穿、系统、一见钟情、离婚后、反派、开局秒杀

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

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

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

@@ -1,6 +1,6 @@
 # 番茄：采集与分析
-作者选了番茄才读本文。番茄列表页有字体反爬，须先用 `/browser-cdp` 启动 Chrome，再由脚本从详情页（内嵌 JSON `bookName`/`author`/`abstract`/`categoryV2` + `<title>` + og:meta）多策略解码书名、作者、题材、标签、简介。
+选择番茄时读取，先用 `/browser-cdp` 启动 Chrome。列表页有字体反爬，脚本从详情页内嵌 JSON 的 `bookName`/`author`/`abstract`/`categoryV2`，结合 `<title>` 和 og:meta 解析书名、作者、题材、标签与简介。
 ## 榜单与命令
@@ -11,9 +11,9 @@ 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`。一份全题材就是七百来条，只读聚合结果，不整份读原始文件。
+脚本逐题材采集，每题材默认最多 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)。
+题材由页面菜单发现，以下 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)。
 ### 书库「最热」
@@ -24,7 +24,7 @@ node scripts/fanqie-rank-scraper.js --source library --channel all --outdir {输
 node scripts/fanqie-rank-scraper.js --source library --channel mix --pages 5 --outdir {输出目录}  # 不分男女
 ```
-`--stat 1|0|any`、`--count 0-4|any` 改筛选。默认组合（连载中、30 万字以下）是**正在起量的新书**：阅读榜被老书占住时，看它才知道新书里什么题材在冒头，文件名与列表名带「新书」，聚合时算进「新书榜」列。列表页书名和数字都被字体反爬，脚本只按页面顺序取 bookId，书名、题材、在读、字数都由详情页解码。
+`--stat 1|0|any`、`--count 0-4|any` 改筛选。默认筛选的连载中、30 万字以下作品用于找**起量候选**；是否起量看同口径前后变化。仅默认筛选在列表名中加「新书」，按新书样本计；混有其他榜时聚合才显示「新书榜」列。脚本按列表顺序取 bookId，再由详情页解析书名、题材、在读与字数。
 ## 字段
@@ -39,7 +39,7 @@ node scripts/fanqie-rank-scraper.js --source library --channel mix --pages 5 --o
 | 维度 | 看什么 |
 |---|---|
 | 阅读榜 | 流量与读者规模，在读数为核心指标 |
-| 新书榜 | 新题材、新风向的早期信号（聚合表的「新书榜」列） |
+| 新书榜 | 观察新题材样本，与阅读榜对照；单次上榜不等于正在上升 |
 | 题材分布 | 各品类在读数集中度（热度中位对照本数） |
 | 在读数差距 | 同题材头部与腰部的流量差 |
 | 标签热词 | 【】内标签组合揭示细分卖点 |

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

@@ -1,28 +1,28 @@
 # 晋江：采集与分析
-作者选了晋江才读本文。需先用 `/browser-cdp` 启动 Chrome。脚本两步走：① 列表页 `topten.php` 取频道分组与书名/作者，从书名链接取 `novelid`（排除「X 向《书名》投了 Y」霸王票记录）；② 进 `onebook.php?novelid=` 详情页补采核心指标。晋江是 gb18030 编码，脚本已按此解码；详情指标公开，无需登录。
+选择晋江时读取，先用 `/browser-cdp` 启动 Chrome。脚本从 `topten.php` 取频道、书名、作者与链接中的 `novelid`，排除「X 向《书名》投了 Y」霸王票记录，再请求 `onebook.php?novelid=` 补详情；详情 HTML 按 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 --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` 或文件头标 `[仅列表-无核心指标]` 的数据撑不起下面的分析，视为不合格，要重采。
+频道（聚合时当题材）、排名、书名、作者、novelid、收藏数（核心，聚合的热度口径）、营养液、积分、字数、状态、作品页链接。指标分析须有收藏、营养液或积分、字数；`--list-only` 或 `[仅列表-无核心指标]` 只支持看书目，指标分析前要重采详情。
 ## 分析维度
 | 维度 | 看什么 |
 |---|---|
-| 金榜 | 综合热度最高 |
+| 金榜 | 观察上榜作品构成，不把名次还原为收入 |
 | 季度榜 | 中期趋势 |
-| 红字/黑字 | 积分与负面评价 |
+| 红字/黑字 | 当前脚本不采页面颜色，不能据此判断负面评价 |
 | 收藏/营养液 | 女频市场的核心指标 |

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

@@ -1,10 +1,10 @@
 # 起点：采集与分析
-作者选了起点才读本文。默认不需要 Chrome：脚本先读 `https://m.qidian.com` 移动端 SSR pageContext，移动端不可用时才回退 CDP/PC 页面，文件头 `抓取方式` 标 `mobile-ssr` 或 `cdp-pc`。
+选择起点时读取。脚本默认先读 `https://m.qidian.com` 页面的 SSR 内嵌数据，失败才回退 CDP/PC；文件头 `抓取方式` 标 `mobile-ssr` 或 `cdp-pc`。书库新书只走 Chrome，先说明并用 `/browser-cdp` 启动。
 ## 榜单与命令
-`node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录}`（`--type all` 全采；`--mode mobile|cdp` 强制一种方式；`--detail yes` 进详情页补标签、简介、最新更新）
+`node scripts/qidian-rank-scraper.js --type {榜单} --outdir {输出目录}`（`--type all` 全采；`--mode mobile|cdp` 强制方式；`--detail yes` 仅在 CDP 模式补详情）
 | 榜单 | --type | URL | 看什么 |
 |------|--------|-----|--------|
@@ -17,19 +17,29 @@
 | 畅销榜 | hotsales | qidian.com/rank/hotsales/ | 真金白银投票 |
 | 阅读指数榜 | readindex | qidian.com/rank/readindex/ | 阅读量综合 |
 | 收藏榜 | collect | qidian.com/rank/collect/ | 读者关注热度 |
-| 原创推荐榜 | recom | qidian.com/rank/recom/ | 平台推荐 |
+| 原创推荐榜 | recom | qidian.com/rank/recom/ | 读者推荐票表现 |
-默认组合：新人签约新书榜 + 签约作者新书榜 + 月票榜 + 畅销榜。文件名 `起点{榜单}_{YYYYMMDD}.md`。
+默认组合：新人签约新书榜 + 签约作者新书榜 + 月票榜 + 畅销榜。文件名 `起点{榜单}_{YYYYMMDD}.md`。移动端两个签约榜均取 `/rank/sign/`，`collect` 取书友榜；以文件头「移动端实际榜单」为准。
+### 书库新书
+要看「新书」「最近冒头」「什么在起量」时再加，默认组合不采。qidian.com/all/action0-size1-update1/ 筛选男生、连载、30 万字以下、三日内更新的作品，按人气排，每页 20 本，可补充已下新书榜但仍在更新的书。
+```bash
+node scripts/qidian-rank-scraper.js --type library --pages 3 --outdir {输出目录}   # 默认 3 页，最多 10，不进 --type all
+```
+所有页合写 `起点男频书库人气新书_{YYYYMMDD}.md`，名次连续，表示人气排名。字数由字体解码，签约/收费由移动端详情补，缺值写 `[待补]`；「新书总推荐」不进聚合热度。该筛选会拉低字数中位。跟作者说「起点最近三天还在更新的 30 万字以内新书，按人气取前 3 页，要开浏览器」。
 ## 字段
-排名、书名、作者、题材（主类·子类；聚合时主类作题材、子类进标签）、状态、签约、收费模式、字数、总推荐（聚合的热度口径）、标签/最新更新/简介（详情页）、作品页链接。额外必填：题材、字数、总推荐，缺的写 `[待补]`。
+排名、书名、作者、题材（主类·子类）、状态、签约、收费模式、字数、总推荐、标签/最新更新/简介、作品页链接；题材、字数、总推荐缺失写 `[待补]`。聚合按主类分题材、子类作标签，热度以表头口径为准；同源的两个签约榜不作独立交叉验证。
 ## 分析维度
 | 维度 | 看什么 |
 |---|---|
-| 月票榜/畅销榜 | 付费认可与持续追读，最硬的指标 |
+| 月票榜/畅销榜 | 观察付费榜表现，不等同于订阅或追读原数 |
 | 各新书榜 | 新作者、新题材的早期信号；和月票/畅销榜的题材占比对照 |
 | 三江推荐 | 平台力推方向 |
-| 追读率 | 决定推荐位分配（榜单上看不到，只能从月票/畅销间接推断） |
+| 追读率 | 当前榜单不提供，不能由月票/畅销排名换算 |

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

@@ -1,6 +1,6 @@
 # 七猫：采集与分析
-作者选了七猫才读本文。需先用 `/browser-cdp` 启动 Chrome；页面无明显反爬，脚本滚动加载，男生榜/女生榜 tab 切换（失败重试）。
+选择七猫时读取。排行榜先用 `/browser-cdp` 启动 Chrome，脚本切换男生/女生榜并滚动加载；书库新书直接请求网页，不用 Chrome。
 ## 榜单与命令
@@ -13,15 +13,27 @@ node scripts/qimao-rank-scraper.js --channel all --type all --outdir {输出目
 大热榜用 `--period day|month|all` 选日榜、月榜或两者（默认 day），周期进文件头与文件名；其他榜不分周期。默认组合：男频大热榜日榜 + 女频大热榜日榜。
+### 书库新书
+作者说「新书」「最近冒头」「什么在起量」时再加，不进默认组合。书库筛选页 qimao.com/shuku/a-a-a-1-1-a-0-click-{页码}/：全部频道、30 万字以下、3 天内更新、连载中，按点击量排，每页 15 本。
+```bash
+node scripts/qimao-rank-scraper.js --source library --pages 3 --outdir {输出目录}   # 前 3 页（默认 3，最多 10）
+```
+所有页合写 `七猫全站书库点击新书_{YYYYMMDD}.md`，名次连续，表示点击排名。该筛选会拉低字数中位，长篇篇幅另看排行榜。页面不提供热度数字，无热度属正常；仅采书库时分析题材、字数和标签。跟作者说「七猫最近三天还在更新的 30 万字以内新书，按点击取前 3 页」。
 ## 字段
-排名、书名、作者、题材、分类标签（聚合时进标签）、状态、字数（万字）、热度（核心指标，聚合的热度口径）、最新更新、作品页链接、简介。文件头带 `数据质量`、`有效条目`、`问题摘要`、链接与热度命中数；热度缺失写 `[待补]`。
+书库从分类页补主类，补不到时退用子类；聚合出现细分类时先核对分类来源。
+排名、书名、作者、题材、分类标签（聚合时进标签）、状态、字数（万字）、热度（核心指标，聚合的热度口径；书库新书没有）、最新更新、作品页链接、简介。文件头带 `数据质量`、`有效条目`、`问题摘要`、链接与热度命中数；热度缺失写 `[待补]`。
 ## 分析维度
 | 维度 | 看什么 |
 |---|---|
 | 大热榜 | 热度排名，流量集中度 |
-| 新书榜 | 新流量风口 |
+| 新书榜 | 流量风口候选，与大热榜及可比上期对照 |
 | 完结榜 | 长尾价值作品 |
-| 热度 | 七猫核心指标，读者活跃度 |
+| 热度 | 平台公开指标，按同周期比较，不换算为读者人数 |

package/lib/oh-story/skills/story-long-scan/references/publishing-guide.md CHANGED Viewed

@@ -17,7 +17,7 @@
 |------|------|----------|
 | 起点 | 主站标杆，订阅制，推荐机制完善 | 男频长线、追读驱动、能持续展开主线与爽点循环 |
 | 番茄 | 免费阅读，流量大，强完读/强标签导向 | 吸量书名、快节奏、强情绪或强脑洞，需用当前榜单校验 AI 同质化风险 |
-| 七猫 | 下沉市场，强情绪流 | 强感情线、甜虐推拉、情绪密度高；合同/收益规则必须以最新官方口径为准 |
+| 七猫 | 免费阅读，强情绪流 | 强感情线、甜虐推拉、情绪密度高 |
 | 晋江 | 女频/纯爱/言情主阵地 | 主体性、文案安全感、人物细节和收藏/营养液等指标可支撑时优先 |
 ### 选择原则
@@ -41,37 +41,24 @@
 ### 起点推荐流程
 ```
-出库 -> 试水期(7天) -> 培育期(21-42天) -> 三江推荐/上架
+出库 -> 试水期 -> 培育期 -> 三江推荐/上架
 ```
-**试水期**：同期新书在同一流量池，七天总流量恒定。
-**培育期**：四个等级：放量包++ > 放量包+ > 放量包 > 扶持包（安慰奖）。每1-2天一个流量包，共21个。下一个流量包大小取决于上一个的成绩（追读+留存）。噱头强但留存差 -> 恶性循环。
-**关键数据**：
-- 出库时300假追可无缝衔接试水
-- 冲三江至少500假追
-- 1000假追以下全是扶贫包，2000以上有放量+
+这条路径用于辨认新书阶段，具体安排与时长按本书后台记录。比较试水期、培育期的作品时，分别看曝光、追读和留存；作者圈所说的“假追”及流量包档位须带具体来源和口径，不能由公开榜单还原。
 ### 起点新书榜规则
-上榜条件（三选一即下榜）：满20万字 / 签约满30天 / 断更超3天
-**多待榜单技巧**：内投通过后和编辑商量，先发到3万字左右再完成签约流程，可多待4-5天。
+区分新书榜与书库筛选：脚本书库的“30 万字以下、三日内更新”是本次筛选条件，不代表新书榜上下榜规则。内投、签约时点及榜单资格按具体投稿与榜单说明判断，扫榜文件不含这些后台信息。
 ### 番茄推荐机制
-- 推荐节点、测试字数、流量包规则变化频繁；执行前必须用官方后台、编辑口径或最新作者公告复核
-- 分析番茄样本时记录：验证期字数、在读数、完读率/追更、书名标签、简介钩子
-- 若当前 scan 发现 AI 同质化样本密集，输出同质化风险和差异化检查，不直接沿用历史给量数字
-- 观察数据时按项目实际字数节点和平台最新规则设置复盘点，不使用固定字数作为硬规则
+- 按本书后台、编辑口径或最新作者公告确定推荐阶段与复盘点
+- 样本记录验证期字数、在读数、书名标签与简介钩子；完读率/追更由作者补充
+- 同类 AI 同质化样本密集时检查差异化，不沿用历史给量数字
 ### 书名简介的重要性
-起点新推荐机制下，书名和简介是第一道筛选：
-- 书名点明题材可保下限
-- 书名简介吸量 >> 追读 >> 读完率/书架比
-- 文艺书名在新机制下会被拉长培育期
+书名与简介先建立题材预期，正文再兑现爽点和钩子。比较同题材样本的点击理由与后续留存，不凭书名风格推断推荐时长。
 ---
@@ -79,7 +66,7 @@
 ### 番茄核心数据
-**追更人数** = 阅读最近 7 日更新章节的有效读者数。该指标只能和同题材、同字数段、同推荐阶段样本横向比较。
+追更人数按作者后台给出的定义与周期记录，只与同题材、同字数段、同推荐阶段样本比较；扫榜脚本不采集该指标。
 | 指标 | 用法 |
 |------|------|
@@ -92,14 +79,14 @@
 ### 起点核心数据
-- **收订比**：收藏与首订的比例，反映转化效率
-- **24小时追读**：VIP读者的实时追读，上推荐看这个数据
-- **首订数据参考**：上架首订不到100属中游水平
+- **收订比**：观察收藏与首订之间的转化，引用时注明谁除谁及统计时点
+- **24小时追读**：由作者提供后台数值与口径，不从月票或畅销排名推算
+- **首订**：与同题材、同曝光阶段样本比较，不以固定本数划分市场水平
 ### 通用数据逻辑
-- 读完率高 = 内容质量好，追更高 = 期待感足
-- 书架比好但完读差 = 中间内容出了问题
+- 读完率看承接，追更看更新期待，书架比看吸量后的留存；结合曝光与推荐阶段解释
+- 书架比好但完读差时，优先检查中段节奏与章节承接，不直接认定原因
 - 收益与追更/在读等指标相关，但具体收益受平台规则、合同和推荐阶段影响，必须另行核实
 - 数据不好时优先检查：开头吸量、章节留存、期待感断档
@@ -107,8 +94,8 @@
 ## 简介写法
-核心结构：主角处境 -> 金手指能干嘛 -> 第一个爽点预览。不要写成设定说明书，要写成广告。好处要说具体。
+简介先交代主角处境、核心冲突或特殊能力带来的变化，再预告第一处回报，让读者看清会得到什么乐趣。
-**常见错误**：东扯一句西塞一句没有核心主题 | 创意名字但实际是普通积分类系统 | "且看主角如何如何"空话套话 | 自称用"俺"等过于出戏
+**常见错误**：卖点分散、只换系统名称却没有新机制、用"且看主角如何如何"代替具体好处，或自称与人物声线不符。
 **简介结构提取**：参考三江推荐（qidian.com/sanjiang/）或畅销榜同类型爆款简介结构，只提取功能位：问题、利益点、爽点预告、安全感、悬念。禁止复刻具体剧情和表达。

package/lib/oh-story/skills/story-long-scan/references/reader-profiling.md CHANGED Viewed

@@ -1,32 +1,30 @@
-# 读者画像系统
+# 读者画像参考
 ## 9 维画像
+画像假设用目标频道样本与读者反馈核对。
 | 维度 | 包含什么 | 示例 |
 |------|----------|------|
 | 平台 | 起点/番茄/晋江/知乎/七猫 | 起点=付费硬核，番茄=免费下沉 |
 | 标签 | 题材标签决定读者预期 | 看到「系统文」期待升级节奏 |
-| 阅读量 | 低阅读量 vs 高阅读量读者，耐受度不同 | 高阅读量读者能识别套路模式，低阅读量读者对套路更敏感 |
-| 性别 | 男频女频审美差异巨大 | 男频重爽，女频重情感 |
+| 阅读量 | 指读者读过多少同类作品 | 观察熟悉套路与初读者各自需要多少解释 |
+| 性别 | 结合频道与题材观察偏好 | 男频、女频先作渠道区分，再核对具体样本 |
 | 年龄 | 16-25 vs 25-35，代入角色不同 | 05后大学生 vs 90后打工人 |
 | 地域 | 一线城市 vs 下沉市场 | 北上广深 vs 三四线城市 |
-| 学历 | 影响对文笔和逻辑的要求 | 大学生 vs 初中辍学 |
-| 阶层 | 底层/中产/富人 | 决定什么样的逆袭有共鸣 |
+| 学历 | 关注知识背景和术语理解 | 判断专业信息需要交代到哪一步 |
+| 阶层 | 可用资源与现实压力 | 债务、职业上升或家庭资产如何影响逆袭期待 |
 | 社会角色 | 学生/宝妈/打工者/自由职业 | 决定什么样的日常有代入感 |
-画像组合示例：「起点+古代官场+夺嫡+文抄+高阅读量+女+05后+二线城市+大学生+中产」-> 节奏快、权谋爽、感情线甜但不傻白甜、文化梗要新
+例：「起点+古代官场+夺嫡+文抄+高阅读量」可先试节奏快、权谋爽、文化梗有变化的写法，再以同题材开篇与反馈核对。
 ---
-## 画像关联元素法（70/20/10）
-构建读者共鸣的三层比例：
+## 画像关联元素法
-- **70% 怀旧元素**：读者有过类似经历的场景
-- **20% 当前生活**：读者正在面对的压力
-- **10% 热点话题**：当下流行的梗和话题
+从怀旧经历、当前压力和热点话题中选择共鸣素材，比例随目标题材与读者反馈调整。
-### 70% 怀旧元素来源
+### 怀旧元素来源
 | 来源 | 内容 | 适用题材 |
 |------|------|----------|
@@ -35,7 +33,7 @@
 | 校园生活 | 高考、宿舍、社团 | 校园文 |
 | 童年回忆 | 村里/小区里的事 | 乡村、都市日常 |
-### 20% 当前生活来源
+### 当前生活来源
 | 来源 | 内容 | 适用题材 |
 |------|------|----------|
@@ -44,7 +42,7 @@
 | 经济压力 | 房贷、消费降级 | 都市、种田 |
 | 社交焦虑 | 社恐、独居、社交恐惧 | 治愈、日常 |
-### 10% 热点话题来源
+### 热点话题来源
 | 来源 | 内容 | 适用题材 |
 |------|------|----------|
@@ -59,47 +57,36 @@
 ### 起点男频读者
 - 核心需求：爽感、升级、碾压
-- 容忍度：开头慢可以，但不能超过5章
-- 爽点偏好：实力碾压 > 智谋取胜 > 运气好
-- 雷区：绿帽、憋屈、女主太强压过男主
-- 黄金标准：三章一爽点，十章一大高潮
+- 容忍度：观察慢热样本如何尽早交代目标与回报
+- 爽点偏好：实力碾压、智谋取胜、机缘兑现，按细分题材比较
+- 雷区：绿帽、长期憋屈、主角被动且缺少反击或成长
+- 观察重点：升级承诺如何分段兑现，大高潮前如何蓄力
 ### 番茄读者
-- 核心需求：快节奏、强爽感、不费脑
-- 容忍度：3章不爽就走
-- 爽点偏好：打脸 > 装逼 > 获得机缘
-- 雷区：慢热、虐主、需要思考的剧情
-- 黄金标准：每章都有爽点，3000字内必须爆
+- 核心需求：快节奏、强爽感、目标与因果清楚
+- 容忍度：观察开篇多久兑现第一个爽点
+- 爽点偏好：打脸、装逼、获得机缘，观察各自在样本中的作用
+- 雷区：目标迟迟不明、长期虐主、解释压过剧情
+- 观察重点：开篇冲突与爽点承接，不按固定字数凑高潮
 ### 晋江女频读者
 - 核心需求：情感细腻、人设好、有共鸣
 - 容忍度：开头可以慢，但人设必须立住
-- 爽点偏好：虐完后的甜 > 反转打脸 > 身份翻盘
+- 爽点偏好：虐后的甜、反转打脸、身份翻盘，结合人设与关系线选择
 - 雷区：女主傻白甜、男主渣且不追妻、三观不正
-- 黄金标准：人物有弧光，情感有层次
-### 知乎盐言读者
-- 核心需求：情绪冲击、反转、代入感
-- 容忍度：前500字决定生死
-- 爽点偏好：反转震撼 > 虐后治愈 > 现实共鸣
-- 雷区：说教、道德绑架、结局强行HE
-- 黄金标准：情绪拉扯 + 一个炸裂反转
 ### 七猫读者
 - 核心需求：快节奏、强剧情、不拖沓
-- 容忍度：3章定生死
-- 爽点偏好：逆袭 > 打脸 > 获得认可
+- 容忍度：观察前几章如何建立主线与追读理由
+- 爽点偏好：逆袭、打脸、获得认可，观察对应的主角选择与后果
 - 雷区：文艺腔、节奏慢、不爽
-- 黄金标准：开篇即冲突，绝不平淡
 ### 刺猬猫读者
 - 核心需求：二次元、轻小说、有趣
 - 容忍度：开头必须有趣
-- 爽点偏好：有趣 > 有梗 > 有梗但意想不到
+- 爽点偏好：角色互动、熟悉梗与意外变化共同形成笑点
 - 雷区：太严肃、太现实、没有二次元元素
-- 黄金标准：有梗有笑点，偶尔有深度

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

@@ -1,7 +1,6 @@
 # 选题决策：从扫榜数据到"写什么能爆"
-把扫榜结果变成能直接用的选题建议：**推荐写什么、为什么能爆、行不行、怎么验证**。
-Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿："能爆的原因"先当假设，拆文（story-long-analyze）后回填验证，写作（story-long-write）开书时直接用。
+Phase 5 根据扫榜结果产出 `选题决策.md`：**推荐写什么、为什么可能爆、作者能否驾驭、如何验证**。"能爆的原因"先记为假设，交给 story-long-analyze 拆文验证，再供 story-long-write 开书使用。
 ---
@@ -20,8 +19,8 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 每个推荐选题都走完这四步，缺一不可：
-1. **能爆的原因（先当假设）**：从榜上**重复出现的样本**（排除单本个例）+ 新元素提取，推出"这个方向能爆，依靠 X 结构/梗/人设吃这波读者"。单本上榜只是个例（扫榜原则 1：多本重复才算信号）。这里只写假设，标 `待拆文验证`；要坐实得靠拆文回填。
-2. **市场验证**：榜上同方向有几本 + 趋势（↑/→/↓）+ 反例（同方向有没有扑街/烂尾的）。样本越多、趋势越稳，越可信。
+1. **能爆的原因（先当假设）**：从榜上重复样本与新元素推测，哪种结构、梗或人设吸引了目标读者；标 `待拆文验证`，由拆文回填依据。
+2. **市场验证**：记录同方向本数、可比上期的趋势和有来源的扑街/烂尾反例。榜单不提供失败样本；没核实反例就写未核实，无可比上期就写现状。
 3. **差异化定位**：作者优势 × 市场缺口 = "你的版本和榜上现有的不同在哪"。没有差异化 = 同质化挤不进去。
 4. **可行性 + 风险 + 验证动作**：给出可行性高/中/低（下节规则）、最可能的失败点、开写前怎么低成本验证（通常："先写黄金三章测追读，不行就换"）。
@@ -29,17 +28,17 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 ## 可行性判断
-分三档；样本不够时不许给"高"，别让几条数据撑出假信心：
+按当前证据分三档。同方向样本按本平台去重作品计，细分梗不直接继承主类本数，也不把抽样命中条数当去重本数：
 | 可行性 | 含义 | 条件 |
 |--------|------|------|
-| 高 | 可放心写 | 同方向榜上样本够（≥15，小平台≥10）+ 趋势↑或→ + 作者素材能撑 + 有差异化空间 |
-| 中 | 可写但先验证 | 样本够但趋势↓ / 或差异化不清 / 或作者素材半撑 |
+| 高 | 当前证据较充分 | 同方向样本够（≥15，小平台≥10）+ 可比数据支持↑或→ + 作者素材能撑 + 有差异化空间 |
+| 中 | 可写但先验证 | 样本不足、趋势↓、差异化不清，或素材只能支撑部分情节 |
 | 低 | 不建议 | 同方向已饱和（扑街反例多）/ 或作者素材撑不住 / 或平台调性不符 |
-**硬规则**：某方向背靠的榜单若标了 `[数据稀疏]`（有效条目 < 15，小平台 < 10，即扫榜采集质量检查标的稀疏阈值），该方向**不许给"高"**，强制降到"中" + 写明"样本不足，先扫够样本或试水再定"。
+**硬规则**：榜单标 `[数据稀疏]`、聚合样本标「少」，或同方向不足 15 本（小平台不足 10 本）时，**最高给"中"**，写明先补样本或试水；素材撑不住、平台不符等低可行性条件仍按"低"处理。
-**内置知识模式**：无榜单、纯凭知识库趋势时，**所有方向一律给"中"**，理由写"基于通用认知，无榜单验证，开写前必须先扫榜或小成本试水"。不许给"高"。
+**内置知识模式**：无实时榜单时最高给"中"，说明方向尚待扫榜或小成本试水验证；已有条件不适配时给"低"。
 ---
@@ -77,6 +76,6 @@ Phase 5 用本文方法产出 `选题决策.md`——市场角度的选题初稿
 ## 交付
-1. 写到本次扫榜的输出目录 `扫榜/{YYYYMMDD}/`（和榜单、`扫榜聚合.md` 同目录）：`{outdir}/选题决策.md`。Phase 4 先写文件头和「扫榜结论」，Phase 5 再写「推荐选题」；重跑时整节替换，不追加第二份。扫榜常在还没有小说项目的目录下跑，所以产物落在这里，不直接写进项目。
+1. 写入本次输出目录 `扫榜/{YYYYMMDD}/` 的 `{outdir}/选题决策.md`，与榜单、`扫榜聚合.md` 同目录。Phase 4 写文件头和「扫榜结论」，Phase 5 写「推荐选题」；重跑只替换对应整节。
 2. 告知用户路径，并说明下一步：「开书时如果小说项目就建在扫榜时所在的文件夹里、或和它同级，`/story-long-write` 会自动找到并让你确认；隔得更远就把 `选题决策.md` 复制到小说项目根目录，或开书时把路径粘给它。想确认"能爆的原因"就先 `/story-long-analyze` 拆对标书，拆完会回填。」
-3. 后续衔接（本文件不执行，仅说明）：拆文在汇总报告产出后回填对应选题的"能爆的原因"；写作 Phase 1 读取 `选题决策.md` 作为开书起点。
+3. 拆文报告产出后只回填题材匹配且仍标 `待拆文验证` 的选题；写作 Phase 1 在作者尚未给方向时读取 `选题决策.md` 作为开书候选。