爆款热点雷达
这是什么
一个选题决策工具：告诉你「什么内容已经火过」，以及「你该不该跟、怎么拍」。它不预测未来，只基于当前实时榜单做判断，帮你避开与头部账号正面竞争的炮灰位。
- 数据来源：抖音官方热搜榜、百度实时热搜榜、抖音 28 个视频级分榜（含作者 / 播放量 / 视频直链）。
- 核心价值：用「可蹭 / 观察 / 别碰 / 慎跟」四档结论，替你做选题取舍。
- 可靠性：所有数字来自接口实时返回；抓不到就如实说抓不到，绝不编造或拿旧数据冒充。
能力边界
做什么
- 抓取并解析抖音热搜、百度热搜、抖音 28 个视频分榜。
- 逐条给出四档判断与理由，以及可执行的拍摄方案。
不做什么
- 不登录、不写、不保存任何平台凭证。
- 不预测未来热度，不给「大概率会爆」的承诺。
- 不生成文案成品（那是另外的技能）。
- 不代发、不代运营、不刷量。
已知局限（如实告知）
- 抖音分榜为 JS 动态渲染，静态抓取可能返回 0 条；此时明说「本次未返回数据」，不用旧数据顶替。
- tophub 分榜节点可能随页面改版失效，boards 命令可查当前列表，doctor 可自检。
- 抖音返回的 label 是平台内部标记码，映射关系未经核实，不对外部讲。
- 分档为启发式规则（排名分位 + 风险词过滤），非官方口径、非审核结论。
怎么用
自然语言触发（任意一句即可，无需 Key、无需前置条件）：
- 用雷达 / 雷达看一下
- 现在什么内容火 / 今天什么话题热 / 有什么热点可以蹭
- 这个话题火不火 / 找爆款选题 / 抖音热搜 / 热点榜 / 选题参考
命令行：
python scripts/radar.py douyin # 抖音官方热搜榜
python scripts/radar.py baidu # 百度实时热搜榜
python scripts/radar.py all --top 10 # 双榜各取前 10
python scripts/radar.py douyin --board 美食榜 # 指定视频分榜
python scripts/radar.py boards # 列出 28 个分榜
python scripts/radar.py doctor # 数据端点自检
python scripts/radar.py douyin --json # 机器可读输出
参数：--top N 只看前 N 条；--board 榜名 指定分榜；--json 输出 JSON。
零第三方依赖，仅用 Python 标准库（urllib / json / re / ssl）。
判断逻辑
第一道 · 风险词过滤：命中涉政 / 伤亡 / 司法类关键词，直接判「慎跟」——此类话题易限流或被处置，不给蹭热建议。
第二道 · 排名分位（用分位而非绝对热度，因每日榜单整体热度会漂移）：
| 分位 | 判断 | 理由 |
|---|---|---|
| 前 5 | 别碰 | 大号已压上，现在进是炮灰 |
| 6–15 | 观察 | 看头部怎么拍，别硬跟 |
| 中段 | 可蹭 | 还能分到流量，动作要快且贴垂类 |
| 尾段 | 观察 | 还没起来，等下一波或换话题 |
「别碰」占比高是正常的——榜单前排本就是大号战场，雷达的价值恰恰在于劝你别冲炮灰位。
付费：深度选题方案（支付宝 AI 按量付费）
基础榜单本地免费、永久免费。仅在需要镜头级深度方案时按次付费：¥3.00 / 次，先出账单再扣款，账单金额以服务端下发为准。
付费内容范围：
- 可蹭话题的开口三秒逐字稿
- 拍摄方案（景别 / 机位 / 时长 / 道具）
- 对标账号拆解（谁在拍、拍成什么样、为什么能起）
- 发布节奏建议（什么时间发、发几条、怎么接第二条）
402 按量付费链路（HTTP 402 / 支付宝 AI 付）
本技能实现五项改造要素：
| 要素 | 实现 |
|---|---|
| 402 账单下发 | 服务端返回 HTTP 402，响应头 Payment-Needed = base64url({protocol, method})；注意 service_id 在 method 层，不在 protocol 层 |
| 携带凭证重试 | 客户端把支付凭证放入 Payment-Proof 头（base64，须 ≤ 64 字符，塞整份账单会被支付宝判 40004）原参数重发取货 |
| 验付调用 | 服务端调 alipay.aipay.agent.payment.verify 校验 payment_proof 真伪 |
| 履约确认 | 验付通过后调 alipay.aipay.agent.fulfillment.confirm 确认履约 |
| 订单持久化与幂等 | SQLite 落库，out_trade_no 为主键保证重试不重复计费；resource_id 标识付费资源 |
客户端用法（买家侧，零凭证）
python scripts/radar_client.py deep # 请求深度方案；402 时打印账单
python scripts/radar_client.py deep --json # 账单以 JSON 输出
python scripts/radar_client.py deep --proof <hex> # 带 Payment-Proof 凭证重发取货
三条路径均已实测：① 无凭证 → 402 + 账单；② 合法凭证 → 深度方案正文；③ 非法凭证 → {"error":"bad_payment_proof"}（证明网关真在验付）。
生产网关：https://triage-pay.app.workbuddy.host/api/v1/radar/deep-plan
（注：本技能走独立资源号 radar-deep-plan；若账单出现「本地 Agent 资产体检」即端点用错。）
扣款发生在买家侧：买家 Agent 需装支付宝 AI 付并授权；商家侧只出账、验付、履约，碰不到买家钱。
错误处理
| 情况 | 行为 |
|---|---|
| 网络超时 / 连不上 | 打印 [FAIL] 抓取失败：URLError: ...，不静默、不无限重试 |
| 接口返回空 | 明说「抓到 0 条——本次未返回数据」，如实转述，不编 |
| 百度词条数与热度数不齐 | 打 [warn] 说明数量，只取对齐部分，不硬凑 |
| 分榜节点失效 | 提示换分榜，并给出 boards 命令 |
| 编码异常 | utf-8 → gbk → latin-1 三级兜底，最后 errors=replace 不崩 |
纪律：任何一次抓取失败都要原样转述失败，不许用上次缓存或「我记得大概」填空。
常见问题
Q：为什么全是「别碰」？ A：你看的是前 5 名，本就是大号战场。要看「可蹭」请用 --top 51 看全榜中段。
Q：能预测明天什么火吗？ A：不能。雷达只回答「已经火过什么」，预测是玄学。
Q：为什么有的分榜抓不到？ A：分榜 JS 动态渲染，静态抓不到是常态；换分榜或跑 radar.py doctor 自检。
Q：判断准吗？ A：启发式经验规则，非平台官方数据；解决「别冲炮灰位」，不保证「稳赚」。
Q：会花我钱吗？ A：基础榜单本地免费、永久免费；仅深度方案按次付费，且先出账单再扣款。
文件结构
viral-radar/
├── SKILL.md # 本文档
└── scripts/
├── radar.py # 榜单抓取与判断引擎（零第三方依赖）
└── radar_client.py # 402 付费网关客户端（零凭证，仅标准库）
已知坑
- 别把「别碰」当没用——劝你别冲炮灰位，是雷达最值钱的输出。
--board抓不到不一定是脚本坏了；分榜 JS 渲染，静态抓不到是常态，doctor先自检。- 抖音
label别对外讲——平台内部标记码，映射关系未核实。 - 热度值不能跨平台比——抖音、百度口径不同，只能各自榜单内比。
Payment-Proof别塞整份账单——上限 64 字符，超了支付宝返回 40004。service_id在method层——从protocol层取会得到None。- 抓失败就照说失败——拿昨天数据冒充今天，是本技能最不能犯的错。
