Olympianz/tokenspring

🌱 tokenSpring

Token 优惠榜 & LLM 发布榜 — 一个既能在本地打开、也能部署到 Web 的轻量榜单站点。

- 📊 双榜单：Token 优惠榜（最近优惠的套餐 / Token Plan）+ LLM 发布榜（最新发布的模型）
- 🔍 点击卡片查看详情，并可跳转来源链接
- 📡 内置 RSS 订阅（/rss.xml、/rss/token.xml、/rss/llm.xml，支持 ?lang=en）
- 🌐 中英双语切换，英文版走海外新闻源（TechNode / VentureBeat / CNBC / Chosun / Forkast 等）
- 🔐 权限：管理员可见「管理」按钮，普通用户只能看到「登录」
- 🔎 自动发现：内置 token 优惠搜索词库，一键/定时自动搜索最新降价与免费活动，去重后进待补全队列
- ⚙ 管理录入：输入已知信息 → 助手联网搜索补全后上架

快速开始（本地打开）

npm install
npm start          # 或 npm run dev（文件变更自动重启）

然后浏览器打开 。

要求 Node.js ≥ 18。

页面功能

| 功能 | 说明 |
| --- | --- |
| Token 优惠榜 | 按发布时间倒序展示最近优惠套餐，卡片显示折扣、现价/原价 |
| LLM 发布榜 | 按发布时间倒序展示最新模型发布 |
| 详情弹窗 | 点击卡片弹出完整描述、标签、来源、跳转链接 |
| RSS 订阅 | 右上角「RSS」菜单，或直接访问 /rss.xml（英文 /rss.xml?lang=en） |
| 中英切换 | 右上角「EN / 中文」按钮，切换后榜单走对应语言数据源 |
| 权限 | 管理员可见「⚙ 管理」；普通用户只能看到「🔑 登录」 |
| 管理录入 | 登录后右上角「管理」→ 只需填一个主题，AI 自动联网补全 |
| 深浅色主题 | 右上角 🌙 / ☀️ 切换，本地记忆 |

权限（管理员 / 普通用户）

- 普通用户：看不到「⚙ 管理」按钮，只能看到「🔑 登录」；后台 /api/admin/* 接口也需要管理员权限（未登录返回 401）。
- 管理员：点击「🔑 登录」输入密码后，「管理」按钮出现（登录态 7 天有效，HttpOnly cookie）。
- 密码通过环境变量 ADMIN_PASSWORD 设置，默认 admin123，请务必在生产环境修改：

ADMIN_PASSWORD=你的强密码 ADMIN_SECRET=你的签名密钥 npm start

自动发现（token 优惠 + LLM 发布）

页面内置联网搜索管线，可自动抓取两类内容：

- 搜索词库：lib/search.js 的 QUERIES，分 token（降价/免费/折扣）与 llm（新模型/开源发布）两组，各含中英关键词。
- 搜索源：默认 Bing News RSS（无需 API key）；可设 SEARCH_PROVIDER=tavily + SEARCH_API_KEY=... 换 Tavily。
- 去重分流：按标题+URL 去重；按关键词类别自动标记 category: token | llm。
- 结果：新条目以 status: "draft"、徽标「自动发现」进待补全队列，供管理员/AI 补全后上架。

触发方式：

1. 手动：管理员登录后，在「管理」面板点 🔎 自动搜索优惠。
2. 本地定时：

AUTO_DISCOVER=true AUTO_DISCOVER_INTERVAL=6 npm start   # 每 6 小时一次
或 npm run start:auto

3. Vercel 定时（cron）：vercel.json 已配置每天 01:00 UTC 触发 /api/cron/discover（用 CRON_SECRET 保护）。⚠️ Vercel Hobby 套餐 cron 每天最多 1 次；且 serverless 写入不持久（见「部署到 Web」）。

其它可选环境变量：DISCOVER_MAX（单次最多新增，默认 20）、SEARCH_PROVIDER（bing/tavily）、SEARCH_API_KEY、CRON_SECRET。

中英切换与数据源

- 右上角「EN / 中文」按钮切换语言，选择本地记忆。
- 中文版读取 lang: "zh" 的条目（中文新闻源：新华社、财联社、新浪财经、36氪、网易、智东西等）。
- 英文版读取 lang: "en" 的条目（海外新闻源：TechNode、VentureBeat、CNBC TV18、The Chosun Ilbo、Forkast News、TipRanks 等）。
- RSS 同样按语言拆分：/rss.xml?lang=en、/rss/token.xml?lang=en、/rss/llm.xml?lang=en。

管理录入 + 联网补全（工作流）

页面不直接调用外部搜索 API（无需任何 key）。流程如下：

1. 管理人点击右上角 ⚙ 管理，在「主题 / Topic」一栏输入一个主题（例如「OpenAI 降价 50%」「Claude 新模型发布」），提交。
2. 该主题进入 data/items.json 的 待补全队列（status: "draft"、category: "unknown"、徽标「待补全」）。
3. 助手（AI）用 web_search 联网搜索该主题，自动补全 category / title / summary / description / url / source / tags / pricing 等全部字段，并把 status 改为 live。
4. 刷新页面即可看到该条上架对应语言榜单与 RSS。

补全/新增可用命令行助手脚本（无需手改 JSON）：

新增一条
node scripts/add-item.mjs --category llm --title "GPT-5.2 发布" --provider OpenAI \
--summary "OpenAI 十周年发布 GPT-5.2" --url https://... --source 澎湃 --tags gpt-5.2,openai

补全已有的待补全条目（按 id）
node scripts/add-item.mjs --id  --status live --summary "补全后的摘要" \
--description "详情" --tags a,b --discount "50% off"

数据模型

数据存放在 data/items.json，结构：

{
"id": "gpt-5-2",            // 唯一 slug
"lang": "zh",               // "zh" | "en"（决定显示在中文/英文榜）
"category": "llm",          // "token" | "llm"
"title": "OpenAI 十周年发布 GPT-5.2",
"provider": "OpenAI",
"summary": "一句话摘要",
"description": "详情（弹窗展示）",
"url": "https://...",        // 来源链接
"source": "澎湃新闻",
"tags": ["gpt-5.2", "openai"],
"pricing": {                 // 仅 token 类别使用
"original": "原价",
"now": "现价",
"discount": "↓ 超 50%"
},
"badge": "新",               // 可选角标
"status": "live",            // live=上架 / draft=待补全
"publishedAt": "2025-12-12T00:00:00.000Z"
}

部署到 Web

任何支持 Node 的托管平台均可，例如：

Vercel（serverless）

已内置 vercel.json 与 api/index.js，可直接导入部署：

1. 打开 ，导入本仓库（GitHub → Olympianz/tokenspring）。
2. Vercel 会自动识别配置，无需手动填写构建/启动命令。
3. 在环境变量里设置（可选但推荐）：
- ADMIN_PASSWORD —— 管理员密码（默认 admin123，务必修改）
- ADMIN_SECRET —— 登录签名密钥
- BASE_URL —— 你的域名，如 https://你的项目.vercel.app（RSS 绝对链接用）
- CRON_SECRET —— 定时自动发现的鉴权密钥（需与 vercel.json 里 cron 路径中的 key 一致）
4. 点击 Deploy。

vercel.json 已内置每天 01:00 UTC 的 cron 触发 /api/cron/discover（自动发现）。注意 Vercel Hobby 套餐 cron 每天最多 1 次。

⚠️ Vercel 是 serverless（文件系统只读、按请求拉起）：榜单浏览、RSS、点赞、热门排名均可正常使用；但点赞 / 录入 / 自动发现的数据写入只在本实例内存中生效，冷启动后会重置（初始数据仍来自打包进部署的 data/items.json）。需要持久化写入，请改用 Render/Railway（有持久磁盘），或给 Vercel 接入 KV（如 Upstash）并改造 lib/store.js。

Render / Railway（持久化）

- 构建命令：npm install
- 启动命令：npm start
- 环境变量：PORT、BASE_URL、ADMIN_PASSWORD、ADMIN_SECRET、SEARCH_PROVIDER / SEARCH_API_KEY、AUTO_DISCOVER / AUTO_DISCOVER_INTERVAL / DISCOVER_MAX

自定义域名 + 环境变量

BASE_URL=https://tokenspring.example.com PORT=3000 npm start

RSS 里的绝对链接由 BASE_URL 决定，默认 http://localhost:3000。上线前请设置 BASE_URL 为你的公网域名。

项目结构

.
├── server.js            # Express 服务（页面 + API + RSS），本地入口
├── api/index.js         # Vercel serverless 入口（导出 Express app）
├── vercel.json          # Vercel 部署配置
├── lib/
│   ├── store.js         # JSON 读写（内存缓存，兼容只读 FS）
│   ├── rss.js           # RSS 2.0 生成
│   └── search.js        # 联网搜索 + token 优惠自动发现
├── public/              # 前端（原生 HTML/CSS/JS，无构建步骤）
│   ├── index.html
│   ├── styles.css
│   ├── app.js
│   └── favicon.svg
├── data/items.json      # 榜单数据（JSON 存储）
└── scripts/add-item.mjs # 新增/补全命令行助手

说明

- 种子数据来自公开报道（中文源：新华社、财联社、新浪财经、36氪、网易、智东西等；英文源：TechNode、VentureBeat、CNBC TV18、The Chosun Ilbo、Forkast News、TipRanks 等），日期为近似值、价格为参考值，请以上游源站为准。
- 本项目为演示/自用工具，榜单内容仅供信息参考，不构成购买建议。