@oh-story/dsh 0.1.0

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

@@ -0,0 +1,197 @@
+# 网文题材趋势与流派参考
+题材选择、流派写作要点、扫榜技巧的速查手册。
+
+---
+
+## 脑洞文创作
+
+### 从灵感到成书
+
+1. 得到点子（金手指雏形/画面/切入点）
+2. 评估潜力（纯原创？有市场铺垫？）
+3. 匹配题材（放进熟悉题材看效果）
+4. 提炼核心卖点（能否转化为情绪缺口/期待感）
+5. 梳理故事雏形（框架/金手指/切入点）
+6. 动笔验证
+
+### 金手指创新
+
+基础=满足条件→得到反馈。变体：多条件一反馈 / 阶段性反馈 / 概率性反馈 / 反馈可叠加
+
+### 写长方法
+
+1. 从核心卖点找多角度，归纳不同矛盾套路，每套写1-2卷
+2. 叠加框架：多角度交织循环支撑几百万字
+3. 框架+小剧情循环：大目标→中目标→小目标→细纲
+
+### 跟风 = 换皮
+
+照搬核心设定换熟悉题材。金手指类兼容所有题材；同题材跟风保留底层情绪另换角度。
+
+---
+
+## 题材选择
+
+85%熟悉+15%惊喜。选择数据充分+可构建完整世界观的赛道。
+
+---
+
+## 边界感三层圈
+
+| 圈层 | 示例 | 规则 |
+|------|------|------|
+| 题材圈 | 都市、玄幻、仙侠 | 大分类 |
+| 流派圈 | 极道流、凡人流、种田流 | 细分 |
+| 核心梗圈 | 具体卖点/金手指/情绪点 | 内容不能踏出此圈 |
+
+| 错误 | 后果 |
+|------|------|
+| 高武文写官场 | 踏破边界 |
+| 种田文写深度商战 | 串味 |
+| 悬疑文去掉悬念 | 核心卖点消失 |
+
+---
+
+## 扫榜
+
+### 三级分类
+
+| 级别 | 频率 | 要点 |
+|------|------|------|
+| 新题材 | 极少 | 只有出现跨榜单、跨作者重复样本时才标记为趋势；否则作为观察项 |
+| 新金手指 | 较少，翻新为主 | 适合作为低成本验证点，但必须换题材外壳和情绪触发方式 |
+| 新噱头 | 常见 | 高同质化风险；没有差异化机制时降低优先级 |
+
+### 各网站方法
+
+**起点**：三江→首订图→签约新书榜前15→拆精品到万订之间的书
+**番茄**：新书榜拉到底→在读30万以上为标准
+
+### 起点热门题材
+
+| 题材 | 要点 |
+|------|------|
+| 都市 | 重生/种田/娱乐；重生可与任何元素融合 |
+| 玄幻 | 极道流、加点横推等强反馈样本优先；传统玄幻若近期样本稀疏，标记为高风险 |
+| 仙侠 | 优先检查脑洞融合路线的近期样本；纯传统路线需额外验证受众 |
+| 历史 | 秦/唐/明/宋/三国；类同人写法 |
+| 诸天无限 | 不要写原创副本，用同人 |
+| 科幻 | 末世类（含脑洞/种田/游戏设定） |
+
+---
+
+## 流派写作要点
+
+| 流派 | 核心要点 |
+|------|----------|
+| 极道流 | 金手指属性加点，横推一切；边界清楚、验证成本低，适合作为低复杂度候选 |
+| 凡人流 | 小人物攀爬+精打细算；战力数据化+寿命驱动 |
+| 巫师流 | 知识体系+实验探索升级，门槛较高 |
+| 种田流 | 经营餐馆/书店/渔场等；复杂度较低，可与多界穿梭结合，但仍需样本校验 |
+| 都市高武 | 高频：武馆+学校双线/死党对比/师姐诱惑/模拟考装逼；《武圣》前三章是黄金模板 |
+| 同人文 | 仅在用户明确目标 IP、平台允许且近期样本有效时使用；默认只抽“已知世界+新变量+名场面改写”结构 |
+| 盘点文 | 难度低，找对切入点 |
+| 模拟文 | 模拟制造情绪缺口→得奖励→现实满足 |
+| 两界穿梭 | 标准模板：金手指+震惊历史人物+改变命运 |
+| 历史文 | 秦/唐/明/宋/三国主流；需危机感+从小到大+清晰主线；宋朝以后审核风险高 |
+
+---
+
+## 都市重生文
+
+| 维度 | 要点 |
+|------|------|
+| 事业感情配比 | 五五开上限最高但要求极高；感情弱→8:2，感情行→2:8起步 |
+| 期待感 | 没有升级线必须持续维持期待感；悬疑反转少用；保持两万字规划连续性 |
+| 短视频化 | 每章有几个逗人一笑的点；搭建正反馈人际网循环玩梗；同一梗反复出现读者不厌倦 |
+| 同质化 | 微创新开头+中正内容=足够精品；缺的是流量不是内容 |
+
+---
+
+## 轻小说
+
+核心=卖有戏剧性的人设（尤其美少女人设）。
+
+- 事业线：美少女当前困境+她与别人的恩怨
+- 爱情线：有戏剧性的发展+人设搭配造成事件
+- 核心竞争力：人设设计+互动状态是否令人羡慕
+
+---
+
+## 喜剧/沙雕文
+
+套路：中计掉坑+弄巧成拙 / 降智反派 / 误解错位，可组合。
+底层原理：根据读者对角色好感度，让剧情对角色的忧惧因素产生攻击性。
+
+---
+
+## 霸道总裁文（女频）
+
+| 维度 | 传统 | 现代 |
+|------|------|------|
+| 女主 | 傻白甜 | 独立职业女性 |
+| 相遇逻辑 | 善良行为偶遇 | 职业交集+独特价值 |
+| 男主便利 | 全方位照顾 | 情绪价值+锦上添花 |
+| 底层逻辑 | 嫁好男人不用干 | 我很强+征服了强者的心 |
+
+情敌反派避免传统"绿茶"模式。
+
+---
+
+## 爆款灵感素材库
+
+### 古言/宫闱宅斗
+
+| 标题 | 一句话卖点 |
+|------|-----------|
+| 重生后公府长媳要跑路，首辅大人疯魔了 | 前世替公府操碎心还被逼腾位，重生后决定卷走一切直接跑路 |
+| 权臣偏宠掌上娇，重生真千金杀疯了 | 真千金重生归来，先盯上将来权倾天下的养子 |
+| 惨死重生，捂不热的权臣我不要了 | 为妾五年被锁枯院，重生后捂不热的权臣不要了 |
+| 被逼替嫁我不慌，我送全家火葬场 | 被逼替嫁我不慌，我送全家火葬场 |
+
+### 现言/总裁豪门
+
+| 标题 | 一句话卖点 |
+|------|-----------|
+| 逼我给青梅打官司，离婚你哭什么 | 逼我给青梅打官司，离婚你哭什么 |
+| 真千金出狱后，全家悔哭求原谅 | 亲爹亲哥联手送进监狱为假千金顶罪 |
+
+### 世情复仇
+
+| 标题 | 一句话卖点 |
+|------|-----------|
+| 班主任断我舞台梦，十五年后我封杀她女儿 | 年会试镜在评委席亲手刷掉班主任的女儿 |
+| 伤害转移100次，我妈终于杀疯了 | 病床上挨满百次剧痛后，妈妈说该你们还了 |
+
+### 都市/年代重生
+
+| 标题 | 一句话卖点 |
+|------|-----------|
+| 高武：开局就氪命，你小子是个狠人！ | 开局被亲人陷害，拿寿命换武学 |
+| 重生八零，我选择成全教授妻子和妹夫 | 重生回龙凤胎惨死前夜，先拍离婚书 |
+
+### 玄幻/历史/末世
+
+| 标题 | 一句话卖点 |
+|------|-----------|
+| 剑仙：从杀敌爆经验开始无敌 | 靠杀敌爆经验从苟命少年杀成无敌剑仙 |
+| 全宗通魔，唯有小师弟正的发邪 | "那便恭请师尊赴死" |
+| 被妹妹推去喂丧尸后，我重生囤满物资 | 被推进丧尸群死过一次后，先在地下藏满十年物资 |
+
+---
+
+## 命名规律
+
+### 短篇公式
+
+`[极端事件] + [被逼/死亡] + [反击手段]`
+
+高频词：疯了/杀疯了/悔疯了(17次) | 我反手/我让他(4次) | 全家/所有人都(4次) | 清明节/愚人节/除夕夜(4次)
+
+### 长篇公式
+
+高频词：快穿、系统、一见钟情、离婚后、反派、开局秒杀
+
+### 知乎风格
+
+平均7.9字。类型：事件型 / 反差型 / 互动型

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

@@ -0,0 +1,114 @@
+# 网文平台运营与书名简介指南
+
+## 目录
+
+1. [平台选择与定位](#平台选择与定位)
+2. [推荐机制](#推荐机制)
+3. [数据指标解读](#数据指标解读)
+4. [简介写法](#简介写法)
+
+---
+
+## 平台选择与定位
+
+### 主流平台对比
+
+| 平台 | 特点 | 适配条件 |
+|------|------|----------|
+| 起点 | 主站标杆，订阅制，推荐机制完善 | 男频长线、追读驱动、能持续展开主线与爽点循环 |
+| 番茄 | 免费阅读，流量大，强完读/强标签导向 | 吸量书名、快节奏、强情绪或强脑洞，需用当前榜单校验 AI 同质化风险 |
+| 七猫 | 下沉市场，强情绪流 | 强感情线、甜虐推拉、情绪密度高；合同/收益规则必须以最新官方口径为准 |
+| 晋江 | 女频/纯爱/言情主阵地 | 主体性、文案安全感、人物细节和收藏/营养液等指标可支撑时优先 |
+
+### 选择原则
+
+- 先匹配题材与平台读者，再比较流量；不把平台规模直接等同于项目成功率
+- 合同、保底、分成、全勤等收益相关判断必须以平台最新官方规则或编辑确认信息为准，本文件只提供适配维度
+- 可同时保留主站/渠道候选，但每个平台都要列出：目标读者、题材样本、核心指标、失败风险
+- 平台选择至少检查三个方向：写法节奏、题材噱头、样本匹配度
+
+### 女频平台收稿倾向
+
+| 平台 | 收稿倾向 |
+|------|----------|
+| 七猫 | 强情绪流，甜虐交替极限推拉；爹系男主VS大美人、追妻火葬场、60-90年代甜宠+对照组、多男主修罗场 |
+| 起点女频 | 候选前必须复核近期榜单与推荐位样本；若目标题材样本稀疏，标记为高流量风险 |
+
+---
+
+## 推荐机制
+
+### 起点推荐流程
+
+```
+出库 -> 试水期(7天) -> 培育期(21-42天) -> 三江推荐/上架
+```
+
+**试水期**：同期新书在同一流量池，七天总流量恒定。
+
+**培育期**：四个等级：放量包++ > 放量包+ > 放量包 > 扶持包（安慰奖）。每1-2天一个流量包，共21个。下一个流量包大小取决于上一个的成绩（追读+留存）。噱头强但留存差 -> 恶性循环。
+
+**关键数据**：
+- 出库时300假追可无缝衔接试水
+- 冲三江至少500假追
+- 1000假追以下全是扶贫包，2000以上有放量+
+
+### 起点新书榜规则
+
+上榜条件（三选一即下榜）：满20万字 / 签约满30天 / 断更超3天
+
+**多待榜单技巧**：内投通过后和编辑商量，先发到3万字左右再完成签约流程，可多待4-5天。
+
+### 番茄推荐机制
+
+- 推荐节点、测试字数、流量包规则变化频繁；执行前必须用官方后台、编辑口径或最新作者公告复核
+- 分析番茄样本时记录：验证期字数、在读数、完读率/追更、书名标签、简介钩子
+- 若当前 scan 发现 AI 同质化样本密集，输出同质化风险和差异化检查，不直接沿用历史给量数字
+- 观察数据时按项目实际字数节点和平台最新规则设置复盘点，不使用固定字数作为硬规则
+
+### 书名简介的重要性
+
+起点新推荐机制下，书名和简介是第一道筛选：
+- 书名点明题材可保下限
+- 书名简介吸量 >> 追读 >> 读完率/书架比
+- 文艺书名在新机制下会被拉长培育期
+
+---
+
+## 数据指标解读
+
+### 番茄核心数据
+
+**追更人数** = 阅读最近 7 日更新章节的有效读者数。该指标只能和同题材、同字数段、同推荐阶段样本横向比较。
+
+| 指标 | 用法 |
+|------|------|
+| 追更人数 | 判断近期读者留存和更新期待，必须标注统计周期 |
+| 在读数 | 判断流量规模，需结合书龄和推荐阶段 |
+| 完读/读完率 | 判断章节承接是否掉点；若无法获取，报告中标记为缺失 |
+| 书架/收藏 | 判断吸量后是否留下，需和书名/简介一起分析 |
+
+历史追更区间只能作为样本注释；不输出固定首秀量预测，除非有当前平台同阶段数据支撑。
+
+### 起点核心数据
+
+- **收订比**：收藏与首订的比例，反映转化效率
+- **24小时追读**：VIP读者的实时追读，上推荐看这个数据
+- **首订数据参考**：上架首订不到100属中游水平
+
+### 通用数据逻辑
+
+- 读完率高 = 内容质量好，追更高 = 期待感足
+- 书架比好但完读差 = 中间内容出了问题
+- 收益与追更/在读等指标相关，但具体收益受平台规则、合同和推荐阶段影响，必须另行核实
+- 数据不好时优先检查：开头吸量、章节留存、期待感断档
+
+---
+
+## 简介写法
+
+核心结构：主角处境 -> 金手指能干嘛 -> 第一个爽点预览。不要写成设定说明书，要写成广告。好处要说具体。
+
+**常见错误**：东扯一句西塞一句没有核心主题 | 创意名字但实际是普通积分类系统 | "且看主角如何如何"空话套话 | 自称用"俺"等过于出戏
+
+**简介结构提取**：参考三江推荐（qidian.com/sanjiang/）或畅销榜同类型爆款简介结构，只提取功能位：问题、利益点、爽点预告、安全感、悬念。禁止复刻具体剧情和表达。

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

@@ -0,0 +1,105 @@
+# 读者画像系统
+
+## 9 维画像
+
+| 维度 | 包含什么 | 示例 |
+|------|----------|------|
+| 平台 | 起点/番茄/晋江/知乎/七猫 | 起点=付费硬核，番茄=免费下沉 |
+| 标签 | 题材标签决定读者预期 | 看到「系统文」期待升级节奏 |
+| 阅读量 | 低阅读量 vs 高阅读量读者，耐受度不同 | 高阅读量读者能识别套路模式，低阅读量读者对套路更敏感 |
+| 性别 | 男频女频审美差异巨大 | 男频重爽，女频重情感 |
+| 年龄 | 16-25 vs 25-35，代入角色不同 | 05后大学生 vs 90后打工人 |
+| 地域 | 一线城市 vs 下沉市场 | 北上广深 vs 三四线城市 |
+| 学历 | 影响对文笔和逻辑的要求 | 大学生 vs 初中辍学 |
+| 阶层 | 底层/中产/富人 | 决定什么样的逆袭有共鸣 |
+| 社会角色 | 学生/宝妈/打工者/自由职业 | 决定什么样的日常有代入感 |
+
+画像组合示例：「起点+古代官场+夺嫡+文抄+高阅读量+女+05后+二线城市+大学生+中产」-> 节奏快、权谋爽、感情线甜但不傻白甜、文化梗要新
+
+---
+
+## 画像关联元素法（70/20/10）
+
+构建读者共鸣的三层比例：
+
+- **70% 怀旧元素**：读者有过类似经历的场景
+- **20% 当前生活**：读者正在面对的压力
+- **10% 热点话题**：当下流行的梗和话题
+
+### 70% 怀旧元素来源
+
+| 来源 | 内容 | 适用题材 |
+|------|------|----------|
+| 共同代际记忆 | 90后的网吧/MP3/非主流 | 都市重生、年代文 |
+| 流行文化 | 经典影视剧、游戏、音乐 | 同人、穿越 |
+| 校园生活 | 高考、宿舍、社团 | 校园文 |
+| 童年回忆 | 村里/小区里的事 | 乡村、都市日常 |
+
+### 20% 当前生活来源
+
+| 来源 | 内容 | 适用题材 |
+|------|------|----------|
+| 工作压力 | 996、内卷、副业 | 都市、职场 |
+| 感情状态 | 相亲、催婚、丁克 | 言情、世情 |
+| 经济压力 | 房贷、消费降级 | 都市、种田 |
+| 社交焦虑 | 社恐、独居、社交恐惧 | 治愈、日常 |
+
+### 10% 热点话题来源
+
+| 来源 | 内容 | 适用题材 |
+|------|------|----------|
+| 社会热点 | 新闻事件、社会议题 | 都市、现实 |
+| 网络热梗 | 梗、表情包、流行语 | 轻松向 |
+| 影视联动 | 热门影视带动题材 | 蹭热度 |
+
+---
+
+## 平台读者画像速查
+
+### 起点男频读者
+
+- 核心需求：爽感、升级、碾压
+- 容忍度：开头慢可以，但不能超过5章
+- 爽点偏好：实力碾压 > 智谋取胜 > 运气好
+- 雷区：绿帽、憋屈、女主太强压过男主
+- 黄金标准：三章一爽点，十章一大高潮
+
+### 番茄读者
+
+- 核心需求：快节奏、强爽感、不费脑
+- 容忍度：3章不爽就走
+- 爽点偏好：打脸 > 装逼 > 获得机缘
+- 雷区：慢热、虐主、需要思考的剧情
+- 黄金标准：每章都有爽点，3000字内必须爆
+
+### 晋江女频读者
+
+- 核心需求：情感细腻、人设好、有共鸣
+- 容忍度：开头可以慢，但人设必须立住
+- 爽点偏好：虐完后的甜 > 反转打脸 > 身份翻盘
+- 雷区：女主傻白甜、男主渣且不追妻、三观不正
+- 黄金标准：人物有弧光，情感有层次
+
+### 知乎盐言读者
+
+- 核心需求：情绪冲击、反转、代入感
+- 容忍度：前500字决定生死
+- 爽点偏好：反转震撼 > 虐后治愈 > 现实共鸣
+- 雷区：说教、道德绑架、结局强行HE
+- 黄金标准：情绪拉扯 + 一个炸裂反转
+
+### 七猫读者
+
+- 核心需求：快节奏、强剧情、不拖沓
+- 容忍度：3章定生死
+- 爽点偏好：逆袭 > 打脸 > 获得认可
+- 雷区：文艺腔、节奏慢、不爽
+- 黄金标准：开篇即冲突，绝不平淡
+
+### 刺猬猫读者
+
+- 核心需求：二次元、轻小说、有趣
+- 容忍度：开头必须有趣
+- 爽点偏好：有趣 > 有梗 > 有梗但意想不到
+- 雷区：太严肃、太现实、没有二次元元素
+- 黄金标准：有梗有笑点，偶尔有深度

package/lib/oh-story/skills/story-long-scan/references/scan-output-format.md

@@ -0,0 +1,207 @@
+# 扫榜数据采集格式规范
+定义起点/番茄/七猫/晋江的采集字段、输出模板和清洗规则。
+
+---
+
+## 起点
+
+### 起点采集说明
+
+榜单清单与 URL 见 SKILL.md「起点采集目标」表。
+
+优先使用 `scripts/qidian-rank-scraper.js` 的默认 `--mode auto`。脚本先读取 `https://m.qidian.com` 移动端 SSR pageContext JSON，规避 PC 站风控页；移动端不可用时才回退到 CDP/PC 页面。输出头部会标注 `抓取方式：mobile-ssr` 或 `cdp-pc`。
+
+
+### 字段
+
+排名 | 书名 | 作者 | 题材 | 状态 | 签约 | 收费模式 | 字数(万字) | 总推荐 | 标签(详情页) | 最新更新(详情页) | 作品页链接 | 简介(详情页，截断100字)
+
+### 输出模板
+
+```markdown
+# qidian · {榜单名称}
+- 来源：{榜单URL}
+- 抓取时间：{ISO 8601}
+- 条目数：{N}
+
+---
+
+## #{排名} {书名}
+*{作者} · {题材} · {状态} · {签约} · {免费/VIP} · {字数}万字 · {推荐数}总推荐*
+**标签：** {标签}
+**最新更新：** {YYYY-MM-DD HH:MM:SS} · {章节标题}
+
+[作品页]({URL})
+
+**简介**
+{简介原文}
+```
+
+### 采集要点
+
+榜单页含：排名/书名/作者/题材/字数/推荐/签约/免费VIP。详情页需：标签/最新更新/简介。三江按周分组。
+
+---
+
+## 番茄小说
+
+榜单 URL 格式与参数说明见 SKILL.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)
+
+### 字段
+
+排名 | 书名(需详情页解码) | 作者(需详情页解码) | 题材(详情页 categoryV2) | 状态 | 在读(核心指标) | 字数 | 标签(简介内【】) | 最新更新 | bookId | 作品页链接 | 简介(截断100字)
+
+> 番茄 SSR 详情页**没有数字评分**，故不输出评分。题材取详情页 `categoryV2`（转义 JSON 的首个 `Name`，如「西方奇幻」）；标签取简介开头的 `【tag+tag+...】`（如「种田、慢热、西幻」），是题材细分的真实信号。
+
+### 输出模板
+
+```markdown
+# 番茄 · {频道}{榜单名} · 全 {N} 题材
+- 频道参数：channel={0女频/1男频}，type={1新书榜/2阅读榜}
+- 抓取时间：{ISO 8601}
+- 标题解析：成功 {X} / 共 {Y}
+- 数据质量：[OK / 标题解析异常 / 无数据]
+- 每题材上限 ≈ {N}（cap≈20）
+
+---
+
+## {题材名称} — {N} 本
+
+### #{排名} {书名}
+*{作者} · {题材} · {状态} · {在读数} 在读 · {字数}字*
+**标签：** {标签1、标签2}
+**最新更新：** {章节}
+**bookId：** {bookId}
+
+[作品页]({URL})
+
+**简介**
+{简介原文}
+```
+
+> 标题/作者/题材/标签/简介均为可选字段：详情页拿到才输出。书名解码失败时书名显示 `（标题待解析）`，但 bookId 与作品页链接始终保留，便于人工回查。
+
+### 采集要点
+
+字体反爬：列表页 innerText 被自定义字体混淆，`scripts/fanqie-rank-scraper.js` 改从详情页 HTML（内嵌 JSON `bookName`/`author`/`abstract`/`categoryV2` + `<title>` + og:meta）多策略解码明文，规避字体反爬。流程：访问品类页 → 提取品类链接 → 逐品类取 `__INITIAL_STATE__` 列表 → 分批（每 5 本）请求详情页解码。单页上限约 20 本需滚动加载；`--top N` 可调每题材上限。
+
+**故障排查（书名全是 `bookId:xxx` / `（标题待解析）`）**：
+- 看文件头 `数据质量`：标 `[标题解析异常]` 说明详情页解码失败率高。
+- 多为详情页结构变动或被登录/验证页拦截。在已登录的 Chrome 里手动打开任一 `https://fanqienovel.com/page/{bookId}` 确认页面正常、非验证页。
+- 控制台若报 `CDP 无响应`，说明 Chrome/CDP 没起来或端口不对，按 browser-cdp skill 重新启动。确认正常后重采。
+
+---
+
+## 七猫
+
+### 榜单
+
+入口：qimao.com/paihang，男生榜/女生榜tab切换。类型：大热榜(日/月) / 新书榜 / 完结榜 / 收藏榜 / 更新榜
+
+### 字段
+
+排名 | 书名 | 作者 | 题材 | 分类标签 | 状态 | 字数(万字) | 热度(核心指标) | 最新更新 | 作品页链接 | 简介(截断100字)
+
+### 输出模板
+
+```markdown
+# 七猫 · {男/女}频 · {榜单名称}
+- 来源：qimao.com/paihang
+- 抓取时间：{ISO 8601}
+- 条目数：{N}
+
+---
+
+### #{排名} {书名}
+*{作者} · {题材} · {分类标签} · {状态} · {字数}万字 · {热度}万热度*
+**最新更新：** {时间} · {章节}
+
+[作品页]({URL})
+
+**简介**
+{简介原文}
+```
+
+### 采集要点
+
+无明显反爬需滚动加载。男生榜/女生榜tab切换，大热榜有日/月切换。
+
+---
+
+## 晋江
+
+### 榜单URL
+
+`jjwxc.net/topten.php?orderstr={榜单ID}&t={频道ID}`（t=0全站，各频道ID从页面获取）
+
+| 榜单 | orderstr |
+|------|----------|
+| 收入金榜 | 12 |
+| 月榜 | 7 |
+| 季度榜 | 8 |
+| 完结金榜 | 14 |
+| 新手金榜 | 15 |
+| 千字金榜 | 17 |
+
+### 字段
+
+频道 | 排名 | 书名 | 作者 | novelid | 收藏数(核心) | 营养液 | 积分 | 字数 | 状态 | 作品页链接
+
+### 输出模板
+
+```markdown
+# 晋江 · {榜单名}
+- 来源：{topten URL}
+- 抓取时间：{ISO 8601}
+- 频道数：{N} / 总条目数：{M}
+- 详情采集：{命中收藏数} / {计划数}（每频道前 {top}，上限 {limit}）
+- 数据质量：[OK / 详情解析异常·登录态缺失 / 仅列表-无核心指标]
+
+---
+
+## {频道名} — {N} 本
+
+### #{排名} {书名}
+*{作者} · 收藏 {X} · 营养液 {Y} · 积分 {Z} · 字数 {W}字 · {状态}*
+[作品页](https://www.jjwxc.net/onebook.php?novelid={id})
+```
+
+### 采集要点
+
+两步：① 列表页 `topten.php` 取频道分组 + 书名/作者，从书名 anchor 取 `novelid`（排除"X向《书名》投了Y"霸王票记录）；② 进 `onebook.php?novelid=` 详情页补采核心指标。
+- **编码**：晋江是 gb18030，详情页必须 `fetch+arrayBuffer+TextDecoder('gb18030')` 解码（同步 XHR 的 responseText 按 UTF-8 解码会乱码）。
+- **字段来源**：详情页 `itemprop` 微数据——`collectedCount`(收藏)/`nutritionCount`(营养液)/`scoreCount`(积分)/`wordCount`(字数)/`updataStatus`(状态)。这些是公开指标，**无需登录**。
+- **控量**：列表全量保留，仅每频道前 `--top` 本（受 `--detail-limit` 总量约束）补详情，避免对全站数百本逐一请求。
+
+---
+
+## 数据清洗
+
+通用：移除平台模板文本→简介超100字在句号处截断加`...`→空值标`[待补]`
+
+| 平台 | 额外必填 |
+|------|----------|
+| 起点 | 题材、字数、总推荐 |
+| 番茄 | 在读数 |
+| 七猫 | 热度 |
+| 晋江 | 收藏数、营养液(或积分)、字数 |
+
+最低采集量：主流平台15条，小平台10条。低于底线标`[数据稀疏]`。
+
+---
+
+## 批量采集
+
+| 平台 | 默认组合 |
+|------|----------|
+| 起点 | 新人签约新书榜+签约作者新书榜前20+月票榜前20+畅销榜前20 |
+| 番茄 | 男频阅读榜全题材+女频阅读榜全题材 |
+| 七猫 | 男频大热榜日榜+女频大热榜日榜 |
+| 晋江 | 收入金榜+月榜 |
+| 全平台 | 起点+番茄+七猫默认组合 |