公众号 10w+ 热门文章推荐

简介

面向「公众号 10w+ 阅读爆文」场景的交付型 Skill：按分类与时间窗口拉取榜单，对话内给出完整 Markdown 榜单，并生成 可导出 PDF 的 HTML；支持按赛道订阅推送（产品侧若已开通）。

能做什么？

• 总榜 / 分赛道榜单：标准 23 分类 + 总排名；默认 TOP50 候选，首轮对话可 preview 10 条。
• 数据诚实：强依赖脚本 stdout，禁止 Agent 编造文章或阅读数。
• HTML + PDF：榜单页遵循微信绿视觉规范，单页 PDF 导出（html2pdf.js）。
• 规律复盘：在榜单后输出基于真实条目的「爆款规律分析」，并询问是否订阅赛道。

适合谁用？

• 公众号编辑 / 运营 —— 追热点、看标题与账号分布
• 内容负责人 —— 要「可分享、可打印」的榜单页
• 增长 / 商务 —— 按赛道盯 10w+ 供给

运行依赖：Python 3；数据脚本以仓库内 scripts/fetch_hot_articles.py 声明为准（标准库为主）。

功能特性

核心功能

• 榜单拉取：scripts/fetch_hot_articles.py → 写 temp_articles.json → 对话原样输出。
• 时间口径：每日 18:30 同步前一日数据；Agent 必须按当前钟点计算查询区间（详见参考文档）。
• HTML 生成：scripts/generate_hot_html.py，--display_count 必须与当前对话展示条数一致。
• 订阅引导：规律分析后询问是否订阅；同一轮不执行订阅，待用户下一条再分支。

特色亮点

• 脚本输出即正文：表格 + 详情 + 统计区均不可删改重排。
• 18:30 分水岭：早于 18:30 与晚于 18:30，「最新可用日期」不同，需配合固定致歉话术。
• 禁止凑数：少于 10 条如实展示；无数据按参考文档提示改查总榜或其它分类。

使用场景

当用户出现下列诉求时，应加载并严格按参考文档执行：

典型对话节奏

1. 识别意图 → 2. 跑脚本原样展示 → 3. 爆款规律分析 → 4. 订阅询问 → 5. 立即生成 HTML（不等订阅答复）→ 6. 用户若回订阅再走订阅分支。

重要数据说明

• 更新节奏：榜单库 每日 18:30 对齐前一日；对外推送话术可用 19:30。
• 时间不一致：凡用户说的「今天 / 昨天」与真实可查区间不一致，必须使用 references/time-and-date-rules.md 中的原文致歉话术。

核心执行规则（必须遵守）

1. 必须先跑脚本：任何榜单正文均来自 fetch_hot_articles.py 的 stdout，不得手写替代。
2. stdout 原样展示：含「数据说明、概览表、详情、统计」整块粘贴。
3. 固定六步顺序：不得跳过「规律分析 → 订阅询问 → HTML」；细则见 references/agent-workflow.md。
4. HTML 条数一致：对话展示 N 条，则 generate_hot_html.py --display_count N。
5. 细节下钻：日期区间、参数表、输出模板、API 字段等一律以 references 为单一事实来源（见下节资源索引）。

项目架构

目录（参考）

wechat-10w-hot/
├── SKILL.md                              # 本入口（精简版）
├── scripts/
│   ├── fetch_hot_articles.py             # 拉取 + 对话 Markdown 输出 + temp JSON
│   └── generate_hot_html.py             # 读 temp JSON → HTML
└── references/
    ├── agent-workflow.md                 # 六步流程、订阅、自检
    ├── time-and-date-rules.md            # 18:30 与区间、固定话术
    ├── script-parameters-and-output.md   # CLI、输出格式、四维分析
    ├── html-pdf-visual-spec.md           # 视觉、PDF、HTML 参数
    ├── usage-examples.md                 # 场景化命令示例
    ├── api-spec.md                       # 接口字段说明
    └── category-mapping.md               # 分类映射

数据流（概念）

用户请求 → 意图 + 日期区间 → fetch_hot_articles.py → stdout（对话）+ temp_articles.json
                                              ↓
                     generate_hot_html.py（display_count 对齐）→ HTML（可 PDF）

资源索引（何时读哪份）

常见问答

Q1：能否不跑脚本直接给 10 篇例文？ A：不能。无脚本输出即视为未执行本 Skill。

Q2：用户只要 HTML、不要长文？ A：仍必须先完整展示脚本 stdout（规范要求），再生成 HTML。

Q3：temp_articles.json 有 50 条但对话只聊了 10 条，HTML 几条？ A：10 条；--display_count 10。

Q4：接口 URL 以哪里为准？ A：以 references/api-spec.md 与 fetch_hot_articles.py 内常量为准，二者若有差异以脚本为准并应同步修正文档。