Cómo usar
- Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
- Consulta las herramientas, credenciales y entornos necesarios en el documento original.
- Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/mousesport9526/oh-story-claudecode --skill story-short-scanAntes de empezar
- La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
- Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.
story-short-scan:短篇网文扫榜
基于真实榜单样本分析短篇市场,给作者可写的情绪方向、题材候选和验证办法。
核心哲学
原则 1:短篇市场是情绪市场
扫榜从题材和简介中提取目标情绪、触发场景与情绪爆发点,说明这些内容如何吸引读者。仅凭题材名无法判断具体情绪体验。
原则 2:短篇的生命力在传播
榜单提供完读、分享、收藏或点赞数据时,按各自口径比较。排名和互动量只说明样本受到的关注,不能据此断定故事质量或情绪拉扯效果。
原则 3:短篇风口来得快去得快
报告写明样本日期、覆盖范围、结论可信度和复扫日期。题材信号可能在数周内失效,过期后只作候选参考。
扫榜流程
Phase 1:确认平台和方向
用户已给出平台或方向时直接采用,只问缺项:「想看哪个平台、哪类短篇?点众可直接采集,黑岩需要先登录作者后台;知乎盐言、番茄和七猫短篇请提供榜单截图、文字或链接。」
关键判断:
- 用户已有方向 → 针对该方向做深度扫榜
- 用户没有方向 → 做全榜概览 + 找趋势
- 用户想跨平台比较 → 做平台对比分析
Phase 2:确定数据来源
扫榜需要真实数据支撑。 根据当前环境选择数据来源:
| 优先级 | 模式 | 说明 | 何时用 |
|---|---|---|---|
| 1 | 脚本采集 | 点众、黑岩:直接抓取平台页面,产出结构化文件 | 有 Chrome 环境时(优先) |
| 2 | 作者提供 | 没有脚本的平台,或作者已有榜单 | 知乎盐言/番茄短篇/七猫短篇等 |
| 3 | 内置知识 | 用历史资料提出待验证的选题 | 无法联网、作者也没有数据时 |
- 只读所选平台那一份:点众 / 黑岩 / 没有脚本的平台。里面有网址、命令、字段、故障排查、平台分析维度,以及作者提供的榜单怎么整理成文件。
- 每次扫榜新建输出目录
扫榜/{YYYYMMDD}/(同日再扫加-2)存本次榜单,不往旧目录追加;文件名{平台}{类型}_{YYYYMMDD}.md,某平台失败就跳过。对比读上个日期目录的扫榜聚合.md。 - 有榜单文件时运行聚合:
node scripts/aggregate-rank.js {输出目录} --out {输出目录}/扫榜聚合.md --sparse 10 --scale short。主会话只读这份聚合,需要原始简介与人设信息时再抽样:node scripts/aggregate-rank.js {输出目录} --sample {题材/标签/书名词} --n 5。仅用内置知识时跳过聚合。
内置知识: 加载 references/real-market-data.md(跨平台写作差异对照),明确标注「以下分析基于历史趋势数据;未完成实时榜单校验前只能作为候选假设。」并列出需要复扫的平台页面。
Phase 3:数据分析
有真实样本时,以聚合结果和平台参考的「分析维度」为准,提取下列信息。趋势需对比同口径的多期样本;仅用内置知识时只给待验证候选,不填写当前数量、占比或涨跌。
- 情绪类型分布:从题材和标签归并虐恋、反转、悬疑、治愈、打脸等类型,按样本数量比较
- 题材热点:具体什么设定/场景反复出现
- 篇幅分布:字数分布与各题材字数中位
- 开头模式:抽样内容含正文开头时分析首句;只有简介时只判断简介的写法
- 结尾类型:HE(好结局)/BE(坏结局)/开放式 的比例(抽样可见时)
- 标题模式:书名常见词 + 代表作标题
- 人设模型:反复出现的主角类型
Phase 4:输出扫榜报告
报告讲市场结论和能写的方向。脚本名、命令和 SKIP 等采集状态不进报告;未采到的平台用一句话说明原因。模板中缺数据的项直接省略;单期样本不填涨跌,历史资料不填当前热度排行。
报告展示给作者,同时写进输出目录的 短篇扫榜结论.md:文件不存在就先按 references/topic-match.md 的模板写文件头,再把报告作为「扫榜结论」一节写入(已存在就整节替换)。
<!-- author-report -->
## 扫榜结论:{平台名称}
### 市场概况
- 扫榜时间:{日期}
- 核心发现:{一句话总结}
- 可信度:{样本多少篇、来自哪几个榜};建议 {日期} 前后再扫一次
### 情绪热度排行
| 排名 | 情绪类型 | 榜上数量 | 趋势 | 代表作 |
|------|----------|----------|------|--------|
| 1 | {类型} | {N篇} | ↑/→/↓ | {标题} |
### 题材热点
| 题材 | 热度 | 竞争程度 | 门槛 | 代表作 |
|------|------|----------|------|--------|
| {题材} | 高/中/低 | 激烈/一般/蓝海 | 高/中/低 | {标题} |
### 关键数据洞察
- 篇幅区间:热门短篇集中在 {X}-{Y} 字
- 开头模式:{高频开头模式}
- 结尾偏好:{HE/BE/开放式的比例}
- 标题特征:{命名规律}
- 人设热词:{高频主角类型}
### 风口预警
- 🔥 正在爆发:{题材} — {依据}
- ⚡ 即将起风:{题材} — {依据}
- ⚠️ 即将饱和:{题材} — {依据}
### 值得写的方向
1. {方向 + 情绪拉扯方式 + 可行性}
2. {方向 + 情绪拉扯方式 + 可行性}
3. {方向 + 情绪拉扯方式 + 可行性}
### 一句话
{犀利总结}Phase 5:选题匹配
先读 短篇扫榜结论.md 的「扫榜结论」及同目录 扫榜聚合.md;内置知识模式没有聚合表,只读历史候选。结合项目素材与作者能力,按 references/topic-match.md 写进同一文件的「选题匹配」一节:
- 低复杂度候选:反转类、打脸类(结构清晰、验证成本低)
- 高复杂度候选:悬疑类、虐恋类(技术壁垒高,需要伏笔、反转和情绪控制证据)
- 优先候选:样本信号明确,且项目素材与作者能力能够支撑的方向
关键判断:
- 先说明选题提供的情绪体验,再说明题材创新如何支持它
- 开头 3 句话是留存高风险区,必须建立冲突、身份差或情绪钩子
- 反转是短篇常见传播引擎;若不使用反转,必须用强共鸣、强话题或强余韵补足传播风险
平台特性速查
下表用于定位历史写法,当前题材分布与篇幅以本次样本为准;收费规则查平台说明。
| 平台 | 历史样本特点 | 可比较的类型与写法 |
|---|---|---|
| 知乎盐言故事 | 情感与认知变化,表达较克制 | 虐恋、反转、悬疑、现实 |
| 七猫短篇 | 重生纠错、关系冲突,短章推进 | 总裁、现实、宅斗、年代、悬疑 |
| 黑岩短篇 | 强刺激、虐恋与快节奏对抗 | 虐恋、复仇、身份反转 |
| 点众短篇 | 事件集中,情绪兑现直接 | 家庭复仇、假千金、弹幕流 |
流程衔接
流水线: 短篇 位置: 扫榜(第 1/3 步)
| 时机 | 跳转到 | 命令 |
|---|---|---|
| 找到方向 | story-short-analyze | /story-short-analyze |
| 直接开写 | story-short-write | /story-short-write |
| 更适合长篇 | story-long-scan | /story-long-scan |
参考资料
按需加载以下文件:
| 文件 | 何时加载 |
|---|---|
| 三份平台参考(链接见 Phase 2 第 1 步) | 「确定数据来源」:只读所选平台那份 |
| references/topic-match.md | Phase 4/5:短篇扫榜结论.md 模板、可行性上限与交付 |
| scripts/aggregate-rank.js | 把输出目录里的原始榜单聚合成短表(--out 落盘,--sample 抽原始条目),主会话只读它 |
| references/real-market-data.md | 核心参考:跨平台写作差异对照表、各平台简介公式速查、题材爆款公式速查表、各平台写作特征 |
| scripts/cdp-utils.js | CDP 公共工具函数(ab/sleep/evalJSON/safeStr/scrollLoad/getArg),各采集脚本共用 |
| scripts/dz-browse-scraper.js | 点众短篇采集(男频/女频),用法见点众参考 |
| scripts/heiyan-booklist-scraper.js | 黑岩书库列表采集(需登录),用法见黑岩参考 |





