搜索联盟库

盯单品

盯住一条商品，按 itemid 每次 1 次请求 回查到手价， 不占扫描额度。入口只有 itemid：好单库搜索不认京东数字 SKU（实测返回 0 条）， 所以请到「搜索」或「榜单」里点「盯住」，而不是粘商品链接。

到价推送

只在盯着的商品触及目标价时推送，不做全站广播——广播一晚上几十条， 第二天就会把通知关掉。三道闸：静默时段、同价位冷却、每 10 分钟上限。

官方类目名很泛：实测「婴儿推车」会回「婴儿车挂钩」、 「智能手表」会回「LED 电子手表」。所以扩词必须同步扩排除词——词池用的是 全局排除词，在「全局参数」里统一加，加一次对所有品类和词池都生效。

比排除词更要紧的是别选"一类货"的词。 「体育用品」「户外装备」这种词，好单库是按标题匹配的，谁标题里堆了这两个字就回来—— 京喜自营那批 1~5 元百货每条标题都塞了十几个类目词，于是词池被它们刷屏。 换成具体商品名（中性笔、空气炸锅、台灯、洗发水）召回才准。

访问与安全

两层：白名单里的 IP 免密直通；其他 IP 要过登录页（密码换签名 cookie， 7 天有效，同 IP 失败 5 次锁 30 分钟）。改密码会让所有已登录的浏览器立刻失效—— 这是设计，不是 bug。访客密码留空 = 访客免密：谁都能打开榜单和搜索， 但照样改不了任何东西。

SSH 兜底（万一被自己的配置锁在门外）： python -m radar passwd --clear-allow 或 python -m radar passwd 新密码。

配置备份与恢复

config.json 装着品类、词池、阈值、apikey、访问密码，是整套系统 唯一一份不可再生的状态——写坏了没有第二个地方能找回来。每次保存配置前系统会自动 留一份（只留最近 10 份，用途是"刚才那次改动之前长什么样"）；手动打的是 「我认这个版本」的快照：单独存放，不参与自动清理，留最近 50 份。

顶栏的「备份 / 恢复」也能直接打开同一个面板， 不用先翻到这一页。

数据源

好单库京东搜索接口。10 万次/天、2000 次/分钟，免登录，不占浏览器额度。

默认页数

没给品类单独设页数时用这个值。每个词一页 30 条。

额度与常驻节奏

接口标称 10 万次/天，这里默认只给 4 万（40%），剩下的留给转链、手动扫和 纯净度检测。额度是硬闸：用完了不是变慢，是直接扫不出东西，所以宁可留余量。

定时任务

控制台开着时按上面的节奏自动跑（全量 / 回查热点 / 回查盯盘）。 和命令行 python -m radar run 二选一：两个同时开就是双倍消耗， 而且谁都以为自己独占额度。额度硬闸仍然有效，所以最坏情况是提前停工，不是爆额度。

默认阈值（所有品类的起点）

品类里单独设过的项会覆盖这里；没设的继续用这个值。

全局排除词

对所有品类生效。品类里的排除词是在这层之上追加，不是替换。

降价告警

每轮全量扫收尾都会回头查一次库：这件商品是不是比过去 12 小时都便宜，是就在这里记一条。 这一步不花额度——数据本来就在库里，只是以前扫完就丢掉了。 榜单回答"现在便宜吗"，这张表回答"刚刚跌出新低"，后者才需要马上动手。 比对的是同款同标价的那一档：一个标题下常挂着 30 / 65 / 108 元几个规格， 跨规格比价只会报出一堆假的"降 50%"；券在批次间来回横跳（这次有券、下次没券） 也不计。只有真比这半天更便宜才算，所以宁可少报，不报没人信的。 没上榜的商品同样会记（跌幅够大就是线索），这类行的「分数」是空的。 每行带店铺——自营和第三方在发票、售后上不是一回事，跌得再狠也要看清是谁家的货。 要发出去就在行尾转链：转过的变「复制短链」，同一条只转一次（缓存），不重复花额度。

谁进来过

这张表只回答三个问题：什么时候、从哪个 IP、打开了什么接口、结果如何。 不记请求体——里面有密码，记下来等于把密码抄进数据库。轮询用的 /api/rev 和静态资源不记，否则一天几千条心跳会把真正的访问挤出去。