资源雷达 · Resource Radar
全网福利、黑五好价、拼车交易、开源项目与新闻资讯的多兴趣自托管聚合雷达站
六大内容形态分流 · 27 类分频道目录 · 统一屏蔽词省额度 · AI 语义定级 · 多路由精准推送
资源雷达(Resource Radar / repo: freebie-radar) 是一款轻量、开箱即用的多兴趣社区信息聚合与精准推送工作台。它从各大开发者社区、游戏平台、软件限免站、GitHub、Reddit、Bluesky、Telegram 频道及自定义 RSS 采集信息,并通过 「规则初筛与统一屏蔽 → AI 语义定级与分流 → 分频道目录呈现 → 多路由精准推送」 把每条内容送到它该去的位置:
- 只想纯粹蹲羊毛?首页默认 「真福利精选」 严格锁定 AI 验真的
freebie(直接白嫖 + 实操可领的有条件福利),绝不被付费好价、拼车、二手或新闻污染。 - 想看 黑五 VPS 好价 / 合规拼车 / 开源项目 / 重大新闻与科技资讯?一键切换顶部兴趣频道即可浏览各自专属的下级分类、真实有效计数与图文卡片,并可分别配置互不干扰的 Telegram 专题推送路由。
界面预览
| 工作台列表视图(多兴趣频道栏 + 跨源折叠 + 兑换码一键复制) | 三列图文卡片视图(零额外请求封面图提取 + 响应式 2列/3列网格) |
|---|---|
![]() | ![]() |
| 多路由精准推送(分形态/分类/获取方式/关键词定制即时或攒批路由) | AI 语义引擎(27 类分流、自适应学习与零 Token 存量重整分类) |
|---|---|
![]() | ![]() |
核心特性
1. 多兴趣频道与「形态 × 领域 × 获取方式」正交分类
- 6 大内容形态(
kind):freebie(白嫖福利)、deal(特价好价·含黑五 VPS/拼车/二手出鸡)、opensource(开源项目)、news(重要新闻)、info(行业资讯·指南)、noise(纯求助/灌水噪音)。 - 27 个垂直领域(
category):覆盖ai(AI 额度)、vps(VPS/主机)、cloud(云服务)、domain(域名/建站)、opensource(开源软件)、software(软件授权)、dev(开发/工程)、design(设计/素材)、security(安全/网络)、hardware(硬件/数码)、media(影音会员)、game(游戏)、carpool(拼车/合租)、trade(二手/交易)、headline(时政要闻)、world(国际要闻)、finance(经济/商业)、stock(股票/市场)、tech(科技动态)、news(综合资讯)、goods(实物/优惠)、offline(实物福利)、invite(邀请码)、edu(教育/考试)、pan(网盘资源)、course(网课/教程)、other(其它)。 - 8 个兴趣频道与自适应下级分类:真福利、全部白嫖、实物福利、网盘/网课、好价、开源、重要新闻、行业资讯;
- 「真福利 / 全部白嫖」只展现福利类目(隐藏拼车/交易/新闻要闻,网盘/网课/实物福利各自独立成频道),统计数字实时排除
noise假数; - 「重要新闻 / 行业资讯」自动切换为资讯栏目视角(时政要闻、国际要闻、经济/商业、股票/市场、科技前沿、AI 前沿、开发工程、开源生态、安全/漏洞、硬件数码、综合资讯);
- 切换频道自动重置不兼容的形态、获取方式与价格上限,避免空屏串态。
- 「真福利 / 全部白嫖」只展现福利类目(隐藏拼车/交易/新闻要闻,网盘/网课/实物福利各自独立成频道),统计数字实时排除
- 6 级获取方式(
obtain):严格区分free(直接白嫖)、conditional(有条件)、lottery(抽奖)、trial(试用/Demo)、promo(推广/引流)、paid(需付费)。
2. 三层高信噪比治理(统一屏蔽 · AI 定级 · 零 Token 重整)
- 统一屏蔽词防火墙(省额度 + 隐网页 + 拦推送):在「订阅与屏蔽」配置关键词、正则或分源规则,不仅隐藏网页条目、拦截推送与日报,在采集入库送 AI 审核及历史补审前也会直接跳过,无需在两处重复配置。
- AI 语义审核引擎:支持任意 OpenAI 兼容接口,单次输出
keep、kind、category、obtain、quality(1–5 星)与中文理由;支持白嫖专源免审直通、追加补充规则、从收藏/关闭自动学习个人偏好。 - 零 Token 存量分类重整:内置「重整分类 (0 Token)」入口与 CLI,更新关键词规则后可一键将历史
other条目零成本归位到细分类目。
3. 三种响应式视图与零请求封面图提取
- 单行紧凑 / 2列卡片 / 3列卡片 一键切换并记住偏好。
- 14 路采集器(Epic / Steam / GamerPower / CheapShark / GOG / RSS
<media:content>&<img>/ Telegram / LINUX DO / V2EX / B站 / 微博 / CCTV / Bluesky / 本地回环)零额外请求提取封面图,纯文本条目自动收起封面区避免网格空洞。
4. 多路由精准 Telegram 推送
- 全局策略 + 多专题路由:支持一键新增或可视化编辑独立路由(例如:「🎁 真福利直推」「🖥 黑五/VPS 即时提醒」「📦 开源项目攒批汇总」「📰 新闻资讯早报」),每条路由可单独设定形态、分类、获取方式、关键词、最高价、最低分、即时/攒批模式与自定义前缀头。
- 推送时机与兜底:支持「推送前先过 AI(防误推)」与「极速抢码先推后审(后台补审后自动补推)」;提供
strict/rule_fallback/ignore_ai三种 AI 兜底模式。 - 防误推二次校验与诊断预览:攒批发送前二次回查 DB 状态与最新屏蔽词;支持查看拦截原因分布与路由命中预览;内置夜间静默时段与多语言/时效闸门。
5. 极简部署与单密码鉴权分区
- 零外部数据库:基于
node:24-alpine原生运行 TypeScript,内置node:sqlite(WAL 模式 + 内存上限调优,自动增量迁移至 Schema v30),日常运行内存 < 100MB。 - 111 个内置数据源(默认精选启用 62 个):覆盖 LINUX DO、NodeSeek(含福利/资讯/拼车交易板块)、V2EX、NGA(优惠/拼车/二手)、B站、微博、CCTV 新闻、OpenRouter
:free模型、GitHub、Epic、Steam、GamerPower、CheapShark、ITAD、SharewareOnSale、TickCoupon、Reddit、Bluesky、Telegram 频道与中文主机圈促销博客,并支持自定义 RSS 与本地回环/油猴脚本抓取知乎/小红书/小黑盒。 - 公开/管理隔离:配置
ADMIN_TOKEN后,资源流与每日精选保持公开浏览,管理配置与写入接口全部自动鉴权保护。 - 可选的公开多用户模式:设
SITE_MODE=public+ LINUX DO OAuth 后,公共内容仍只读共享,但「不想看 / 收藏 / 已读 / 屏蔽词 / 关注词」按登录用户隔离;未登录访客的偏好只存本机浏览器;登录用户可绑自己的 Telegram Bot 收个人推送,也能订阅公开 RSS 或个人专属 RSS。管理权限始终只认ADMIN_TOKEN,OAuth 登录不会提权。详见 docs/accounts.md。
工作流架构
flowchart LR
S["111 个内置源 + 自定义 RSS + 回环/油猴"] --> E["规则初筛与特征抽取(14 路封面图 / 兑换码 / 价格 / 双语去重指纹)"]
E --> F{"统一屏蔽与噪音初筛(block_rules + NOISE_TITLE)"}
F -->|命中屏蔽/硬噪音| D["跳过 AI 省额度并隔离"]
F -->|通过| M{"AI 审核分流"}
M -->|白嫖专源免审| A1["直标 freebie · 进精选"]
M -->|AI 语义定级| Q["输出 keep · kind · category · obtain · quality"]
Q -->|freebie / deal / opensource / info| P["Web 多频道工作台(紧凑 / 2列 / 3列)"]
Q -->|命中多路由规则| R["Telegram 多专题路由(即时直推 / 定时攒批 / 每日精选)"]快速开始(开箱即用)
方式一:Docker Compose(推荐,1 分钟跑起来)
不需要预先安装 Node.js 或手动建表,甚至不复制 .env 也可以直接启动:
git clone https://github.com/ZiChuanLan/freebie-radar.git
cd freebie-radar
# 可选:复制并编辑环境变量(设置 ADMIN_TOKEN 管理密码、Telegram 推送、AI 等)
cp .env.example .env
# 启动服务(默认监听 http://127.0.0.1:8788)
docker compose up -d --build需要采集带 Cloudflare 护盾的站点(如 LINUX DO)? 仓库已内置可选
cfprofile,一条命令同时拉起 FlareSolverr:# 在 .env 中设置 FLARESOLVERR_URL=http://flaresolverr:8191 docker compose --profile cf up -d --build
验证健康状态与日志:
curl http://127.0.0.1:8788/health
# {"ok":true,"version":"0.1.0",...}
docker compose logs -f --tail 50数据库保存在 ./data/radar.db,升级只需 git pull && docker compose up -d --build,自动完成数据库迁移,数据零丢失。
方式二:源码运行(Node.js ≥ 22.5 + pnpm 10)
git clone https://github.com/ZiChuanLan/freebie-radar.git
cd freebie-radar
pnpm install
cp .env.example .env # 按需填写 ADMIN_TOKEN / 代理 / Telegram 等
pnpm build # 构建前端产物到 dist/web
pnpm start # 自动建表迁移 + 初始化 111 个数据源 + 启动 :8788开发模式(前后端热更新):
pnpm dev # 后端 API :8788
pnpm dev:web # 前端 Vite :5173(自动代理 /api 到 8788)环境变量说明(.env)
所有策略配置(AI 模型/提示词/初筛开关、多路由推送/静默时段、屏蔽词、数据源启停与周期、数据保留天数)均在网页管理区实时热修改,.env 仅需关注进程级环境变量:
| 变量名 | 默认值 | 说明 |
|---|---|---|
PORT / HOST | 8788 / 0.0.0.0 | HTTP 监听端口与地址 |
DATABASE_PATH | ./data/radar.db | SQLite 路径(Docker 内固定 /data/radar.db) |
ADMIN_TOKEN | 留空(开放) | 管理区密码;部署到公网强烈建议设置强密码 |
FLARESOLVERR_URL | 留空 | FlareSolverr 地址,如 http://flaresolverr:8191 |
HTTP_PROXY / HTTPS_PROXY | 留空 | 采集出口代理(海外服务器可留空) |
PUSH_CHANNEL | none | 设为 telegram 启用推送 |
TELEGRAM_BOT_TOKEN | 留空 | Telegram Bot Token(@BotFather 获取) |
TELEGRAM_CHAT_ID | 留空 | 接收推送的个人/群组 Chat ID |
TELEGRAM_PROXY | 留空 | 仅用于 Telegram 推送的代理 |
AI_BASE_URL / AI_API_KEY / AI_MODEL | 留空 | 首次启动默认 AI 参数,之后推荐在网页「AI 引擎」修改 |
INGEST_TOKEN | 留空(禁止写入) | 给 scripts/pw-collect.mjs 或油猴脚本回传数据的 Bearer Token |
GITHUB_TOKEN | 留空 | 可选,将 GitHub 采集限额从 60/h 提升到 5000/h |
ENABLE_SCHEDULER | true | 是否开启内置采集、攒批、每日精选与清理调度 |
DAILY_CRON / DAILY_TOP_N | 30 8 * * * / 12 | 每日精选生成时间与条数 |
SITE_MODE | auto | 一键切换部署形态,见下方说明 |
GUEST_HIDDEN_CATEGORIES | pan,course | 公开站对未登录访客隐藏的分类;自部署模式自动失效 |
公开站 vs 自部署:只改一个变量
SITE_MODE 决定整个站点的形态,其余配置会自动跟随:
SITE_MODE=selfhost(自部署自用) | SITE_MODE=public(公开演示站) | |
|---|---|---|
| 登录按钮 | 不显示,无需配 OAuth | 显示,需配 LINUX DO / GitHub OAuth |
| 收藏/已读/屏蔽词 | 全局共享,存在本地 | 按登录用户隔离 |
| 网盘/网课分类 | 全部可见 | 未登录访客不可见 |
| 个人 RSS / Telegram Bot | 不需要 | 支持每个用户绑定自己的 |
auto(默认)会看有没有配 OAuth:配了就按 public 跑,没配就按 selfhost 跑。
所以自部署只要不填 OAuth 凭据,什么都不用改;想跑公开站就填 OAuth 并设 SITE_MODE=public。不需要分别设置登录开关和分类可见性——GUEST_HIDDEN_CATEGORIES 只在 public 模式下生效,selfhost 下自动忽略。
公开站若想连网盘/网课分类也公开(自行承担版权合规责任),设 GUEST_HIDDEN_CATEGORIES=(空值)即可。
登录态站点采集(知乎 / 小红书 / 小黑盒)
这三个站点依赖浏览器登录态与前端签名,通过 scripts/pw-collect.mjs 使用持久化 Chrome Profile 运行,支持本机或带图形桌面的远程服务器:
- 本机回环登录服务(推荐):运行
node scripts/pw-collect.mjs serve,在网页「数据源运维」点「扫码登录」打开登录窗口扫码,登完自动抓取公开帖并回传雷达。也支持直接复制页面提供的 Tampermonkey 油猴脚本,无需本地安装 Node/Playwright。 - 服务器定时脚本:
PROFILE_DIR=/data/profile SERVER_URL=http://127.0.0.1:8788 HEADLESS=1 INGEST_TOKEN=your_token node scripts/pw-collect.mjs - 隐私边界:服务端不保存任何 Cookie 或账号凭据,登录态仅留存在本地
PROFILE_DIR。
常用 CLI 工具
pnpm tsx src/server/cli.ts sources # 查看全部 111 个数据源与最近运行状态
pnpm tsx src/server/cli.ts collect [sourceId] # 立即采集(不传则跑全部启用源)
pnpm tsx src/server/cli.ts enable <id...> # 启用指定源
pnpm tsx src/server/cli.ts disable <id...> # 禁用指定源
pnpm tsx src/server/cli.ts config <id> <json> # 更新指定源配置
pnpm tsx src/server/cli.ts reclassify # 重跑规则分类、评分与双语去重键
pnpm tsx src/server/cli.ts ai-review [limit] # 批量补审未审条目
pnpm tsx src/server/cli.ts daily [--dry-run] # 生成或预览每日精选
pnpm tsx src/server/cli.ts digests # 查看历史每日精选日期
pnpm tsx src/server/cli.ts stats # 查看分类统计
pnpm tsx src/server/cli.ts diagnose # 推送筛选与命中体检
pnpm tsx src/server/cli.ts obtain # 按获取方式重算统计目录结构与延伸文档
src/
├── server/
│ ├── collectors/ # 采集器与调度(SEEDS / dispatchFresh / 封面图提取)
│ ├── enrich/ # 归一化、双语去重、27 类规则、形态分流(kind)、获取方式(obtain)、AI 队列与屏蔽词
│ ├── push.ts # 多路由分流、Telegram 即时/攒批二次校验、静默时段、预览诊断
│ ├── digest.ts # 每日精选生成与格式化
│ ├── retention.ts # 数据保留策略与自动清理
│ ├── ai-admin.ts # AI 管理、历史补审与零 Token 存量重分类
│ └── routes.ts # Hono REST API 与单密码鉴权分区
└── web/ # React 19 + Vite + Tailwind v4 工作台(紧凑 / 2列 / 3列视图 + 多路由编辑器)延伸文档见 docs/:
docs/data-sources.md— 数据源清单与可达性说明docs/obtain.md— 获取方式(free/conditional/lottery/trial/promo/paid)分级体系docs/ai.md— AI 语义审核口径与误判治理docs/push.md— 推送分级分流、去重与静默时段CHANGELOG.md— 版本变更记录
免责与许可
- 本项目仅对公开网页与接口信息进行聚合、筛选与去重,不存储或传播受版权保护的内容,不提供账号共享;请遵守各目标站点的服务条款并控制合理抓取频率。
- 基于 MIT License 开源。如果这个项目帮到了你,欢迎点个 ⭐ Star 支持!
- 致谢 LinuxDo 以及所有反馈问题、补充源适配与参与改进的开发者。



