freebie-radar README

The project's README from github.com/ZiChuanLan/freebie-radar. As one markdown file: 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)

Searching Database…

What is this?A self-hosted radar that collects posts from dev communities, game platforms, free-giveaway sites, GitHub, Reddit, Bluesky, Telegram channels and RSS feeds. It filters them with rules and AI, sorts them into channels, and pushes the useful ones to Telegram.
Is it a single list or a web app?It is a web app with an admin area, not a static list. It has separate channels for real freebies, VPS deals, carpool buys, open-source projects and news, and each channel can have its own Telegram push route.
How do I get it running?Use Docker: clone the repo and run docker compose up -d --build. The SQLite database is stored at ./data/radar.db. Updates work the same way: git pull, then the same compose command. Running from source needs Node.js 22.5+ and pnpm 10.
Do I need to install a database or Node.js myself?No external database is needed because it uses built-in node:sqlite. Docker alone is enough for the normal setup. Node.js 22.5+ and pnpm 10 are only needed for the source install.
Are there any gotchas?Logged-in sites like Zhihu, Xiaohongshu and Xiaoheihe need a helper script that runs a persistent Chrome profile. Sites behind Cloudflare, such as LINUX DO, need the optional FlareSolverr container.
Can I run it on a cheap overseas VPS?Yes. The README says the collection proxy can be left empty on overseas servers. It listens on port 8788 by default, so you need to open that port or put a reverse proxy in front.
What does the home page show by default?It opens on 'Real Freebies' picks, which only include AI-verified freebies you can claim directly. Paid deals, carpools, secondhand items and news are kept out of that view.
How do I get Telegram alerts?Set PUSHCHANNEL to telegram and fill in the bot token and chat ID. You can then add several push routes, each with its own category, keywords, price cap and instant or batched mode.
How many sources does it pull from?The project description mentions about 57 sources collected on a schedule, covering dev communities, game platforms, GitHub, Reddit, Bluesky, Telegram and RSS feeds.
Creator
ZiChuanLan
Size
8.6 MB
Stars
1.4K
Updated
CommitNov 17
Age
6d
Commits · 90 Days