freebie-radar README

项目的 README,来自 github.com/ZiChuanLan/freebie-radar。合并为一个 markdown 文件:README.md。

Resource Radar Logo

资源雷达 · Resource Radar

全网福利、黑五好价、拼车交易、开源项目与新闻资讯的多兴趣自托管聚合雷达站

六大内容形态分流 · 27 类分频道目录 · 统一屏蔽词省额度 · AI 语义定级 · 多路由精准推送

简体中文 · English

Node.js Docker Ready SQLite React MIT License


资源雷达(Resource Radar / repo: freebie-radar) 是一款轻量、开箱即用的多兴趣社区信息聚合与精准推送工作台。它从各大开发者社区、游戏平台、软件限免站、GitHub、Reddit、Bluesky、Telegram 频道及自定义 RSS 采集信息,并通过 「规则初筛与统一屏蔽 → AI 语义定级与分流 → 分频道目录呈现 → 多路由精准推送」 把每条内容送到它该去的位置:


在线演示:https://radar.zichuanlan.top


界面预览

工作台列表视图(多兴趣频道栏 + 跨源折叠 + 兑换码一键复制) 三列图文卡片视图(零额外请求封面图提取 + 响应式 2列/3列网格)
工作台列表视图 三列图文卡片视图
多路由精准推送(分形态/分类/获取方式/关键词定制即时或攒批路由) AI 语义引擎(27 类分流、自适应学习与零 Token 存量重整分类)
多路由精准推送 AI 语义引擎

核心特性

1. 多兴趣频道与「形态 × 领域 × 获取方式」正交分类

2. 三层高信噪比治理(统一屏蔽 · AI 定级 · 零 Token 重整)

3. 三种响应式视图与零请求封面图提取

4. 多路由精准 Telegram 推送

5. 极简部署与单密码鉴权分区


工作流架构

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)? 仓库已内置可选 cf profile,一条命令同时拉起 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 每日精选生成时间与条数

登录态站点采集(知乎 / 小红书 / 小黑盒)

这三个站点依赖浏览器登录态与前端签名,通过 scripts/pw-collect.mjs 使用持久化 Chrome Profile 运行,支持本机或带图形桌面的远程服务器:


常用 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/:


免责与许可

freebie-radar (ZiChuanLan/freebie-radar)

正在搜索数据库…

这是什么?一个自托管的雷达,从开发者社区、游戏平台、免费领取网站、GitHub、Reddit、Bluesky、Telegram 频道和 RSS 订阅源收集帖子。它用规则和 AI 进行筛选,把内容分到不同频道,并将有用的内容推送到 Telegram。
它是单个列表,还是网页应用?它是一个带管理后台的网页应用,而不是静态列表。它设有独立的频道,分别用于真正的免费领取、VPS 优惠、拼车购买、开源项目和新闻,每个频道都可以设置自己的 Telegram 推送路线。
我该如何运行它?使用 Docker:克隆仓库并运行 docker compose up -d --build。SQLite 数据库保存在 ./data/radar.db。更新方式相同:先执行 git pull,再运行同样的 compose 命令。若从源码运行,则需要 Node.js 22.5+ 和 pnpm 10。
我需要自己安装数据库或 Node.js 吗?不需要外部数据库,因为它使用内置的 node:sqlite。正常部署只需 Docker 即可。只有从源码安装时才需要 Node.js 22.5+ 和 pnpm 10。
有什么需要注意的坑吗?知乎、小红书和小黑盒等需要登录的网站,需要一个辅助脚本来运行持久化的 Chrome 配置文件。LINUX DO 等受 Cloudflare 保护的网站,则需要可选的 FlareSolverr 容器。
我能在便宜的海外 VPS 上运行它吗?可以。README 中说明,在海外服务器上可以将采集代理留空。它默认监听端口 8788,因此需要开放该端口,或者在前面加一个反向代理。
首页默认显示什么?默认打开的是「真正的免费」精选,只包括经 AI 验证、可以直接领取的免费内容。付费优惠、拼车、二手商品和新闻都不会出现在这个视图中。
如何接收 Telegram 提醒?将 PUSHCHANNEL 设置为 telegram,并填写 bot token 和 chat ID。之后可以添加多条推送路线,每条路线都可以设置自己的分类、关键词、价格上限,以及即时推送或批量推送模式。
它会从多少个来源拉取内容?项目说明中提到,它会按计划采集约 57 个来源,涵盖开发者社区、游戏平台、GitHub、Reddit、Bluesky、Telegram 和 RSS 订阅源。
大小
8.6 MB
星标
1.4K
更新
提交Nov 17
时长
6天
提交 · 90 天