ZiChuanLan/freebie-radar

项目介绍

资源雷达（Resource Radar）是一个自托管的多兴趣社区信息聚合与推送工作台。它从开发者论坛、游戏商店、软件限免站、GitHub、Reddit、Bluesky、Telegram 频道和自定义 RSS 中采集条目，经过规则初筛、可选的 AI 语义定级和频道化呈现，再按路由推送到 Telegram。

每条内容会被打上内容形态（freebie 白嫖、deal 好价、opensource 开源、info 资讯、noise 噪音）、21 个垂直领域之一，以及获取方式（free 直接白嫖、conditional 有条件、lottery 抽奖、trial 试用、promo 推广、paid 付费）。首页的「真福利精选」只展示 AI 确认为 freebie 的条目，付费好价、拼车、二手和新闻不会混进来。它适合想同时跟踪多个兴趣频道、又不想手动刷几十个来源的人。分类口径可参考数据源清单和获取方式说明。

快速使用

Docker Compose 是最快的方式，不需要预先安装 Node.js，也不强制准备 .env：

git clone https://github.com/ZiChuanLan/freebie-radar.git
cd freebie-radar
cp .env.example .env   # 可选：配置 ADMIN_TOKEN、Telegram、AI
ocker compose up -d --build

服务默认监听 http://127.0.0.1:8788。用健康检查确认启动成功：

curl http://127.0.0.1:8788/health

返回内容应包含 "ok":true。也可以先打开在线演示查看界面。

从源码运行需要 Node.js 22.5+ 和 pnpm 10：

pnpm install
cp .env.example .env
pnpm build
pnpm start

pnpm dev 启动 8788 端口的 API，pnpm dev:web 启动 5173 端口的 Vite 前端并代理到 API。数据库默认保存在 ./data/radar.db。

如果需要采集 LINUX DO 这类带 Cloudflare 防护的站点，在 .env 中设置 FLARESOLVERR_URL=http://flaresolverr:8191，并用 docker compose --profile cf up -d --build 同时启动 FlareSolverr。

配置与运维

大部分策略配置——AI 模型与提示词、屏蔽词、推送路由、静默时段、数据源启停、保留天数——都在网页管理区实时修改。.env 只需关注进程级变量：PORT、DATABASE_PATH、ADMIN_TOKEN、代理变量、Telegram Token 与 Chat ID、AI 接口参数、INGEST_TOKEN、GITHUB_TOKEN 和调度开关。

部署到公网前务必设置强 ADMIN_TOKEN，留空时管理区是开放的。配置 GITHUB_TOKEN 可以把 GitHub 采集限额从每小时 60 次提高到 5000 次。

内置 CLI 可用于维护：pnpm tsx src/server/cli.ts sources 查看数据源和最近运行状态，collect 立即采集，ai-review 批量补审未审条目，reclassify 零 Token 重跑规则分类。

使用约束

• 运行环境： 源码运行需要 Node.js 22.5+；Docker 方式使用内置的 node:24-alpine 镜像。SQLite 内嵌，不需要外部数据库。
• 登录态站点： 知乎、小红书、小黑盒需要持久化 Chrome Profile，通过 scripts/pw-collect.mjs 或仓库提供的油猴脚本完成。服务端不保存 Cookie 或账号凭据，登录态只留在本地 PROFILE_DIR。
• AI 审核： 可选，需要任意 OpenAI 兼容接口。不配置时仍可使用规则分类和专源免审。
• Telegram 推送： 需要 Bot Token 和 Chat ID，支持即时直推与定时攒批，可开启推送前 AI 防误推，并提供 AI 不可用时的兜底模式。
• 抓取边界： 项目要求遵守目标站点服务条款并控制抓取频率，只聚合公开页面信息，不存储或传播受版权保护的内容，不提供账号共享。
• 许可证： MIT。

HotRepo 点评

该项目在 2026-11-14 的新项目榜记录中，一小时内新增 25 Star，累计 127 Star、27 Fork。这只是单次短窗口快照，不足以判断趋势。技术上值得注意的是自托管版本的完整度：内置 63 个数据源，规则初筛与 AI 语义审核两段式过滤，屏蔽词命中的条目在送 AI 前就被跳过以节省额度，获取方式分为 6 级，Telegram 支持多条独立路由和发送前二次校验。README 对 Docker 路径和 CLI 的说明比较清楚，但登录态采集仍需本地运行 Playwright 脚本，AI 和 Telegram 功能依赖用户自备的凭据。对于想要一个可调校的个人福利/资讯流、而不是托管服务的人来说，源码和配置的深度是主要吸引力。