The project's README from github.com/ZiChuanLan/freebie-radar. As one markdown file: README.md.
全网福利、黑五好价、拼车交易、开源项目与新闻资讯的多兴趣自托管聚合雷达站
六大内容形态分流 · 27 类分频道目录 · 统一屏蔽词省额度 · AI 语义定级 · 多路由精准推送
资源雷达(Resource Radar / repo: freebie-radar) 是一款轻量、开箱即用的多兴趣社区信息聚合与精准推送工作台。它从各大开发者社区、游戏平台、软件限免站、GitHub、Reddit、Bluesky、Telegram 频道及自定义 RSS 采集信息,并通过 「规则初筛与统一屏蔽 → AI 语义定级与分流 → 分频道目录呈现 → 多路由精准推送」 把每条内容送到它该去的位置:
freebie(直接白嫖 + 实操可领的有条件福利),绝不被付费好价、拼车、二手或新闻污染。| 工作台列表视图(多兴趣频道栏 + 跨源折叠 + 兑换码一键复制) | 三列图文卡片视图(零额外请求封面图提取 + 响应式 2列/3列网格) |
|---|---|
![]() |
![]() |
| 多路由精准推送(分形态/分类/获取方式/关键词定制即时或攒批路由) | AI 语义引擎(27 类分流、自适应学习与零 Token 存量重整分类) |
|---|---|
![]() |
![]() |
kind):freebie(白嫖福利)、deal(特价好价·含黑五 VPS/拼车/二手出鸡)、opensource(开源项目)、news(重要新闻)、info(行业资讯·指南)、noise(纯求助/灌水噪音)。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(其它)。noise 假数;obtain):严格区分 free(直接白嫖)、conditional(有条件)、lottery(抽奖)、trial(试用/Demo)、promo(推广/引流)、paid(需付费)。keep、kind、category、obtain、quality(1–5 星)与中文理由;支持白嫖专源免审直通、追加补充规则、从收藏/关闭自动学习个人偏好。other 条目零成本归位到细分类目。<media:content> & <img> / Telegram / LINUX DO / V2EX / B站 / 微博 / CCTV / Bluesky / 本地回环)零额外请求提取封面图,纯文本条目自动收起封面区避免网格空洞。strict / rule_fallback / ignore_ai 三种 AI 兜底模式。node:24-alpine 原生运行 TypeScript,内置 node:sqlite(WAL 模式 + 内存上限调优,自动增量迁移至 Schema v30),日常运行内存 < 100MB。: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 多专题路由(即时直推 / 定时攒批 / 每日精选)"]
不需要预先安装 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,自动完成数据库迁移,数据零丢失。
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 运行,支持本机或带图形桌面的远程服务器:
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
PROFILE_DIR。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 — 版本变更记录