SubsTracker

在订阅制服务泛滥的今天，你是否经常忘记取消免费试用？是否搞不清每月到底在哪些服务上花了多少钱？

SubsTracker 是一款部署在 Cloudflare Workers 上的超轻量级订阅管理工具。它无需购买服务器，无需配置数据库，利用 Cloudflare 的全球边缘网络和 KV 存储，帮你轻松追踪各类订阅的到期时间、自动计算续费日期，并通过 Telegram、企业微信、邮件、Bark 等多渠道发送精准提醒。

更棒的是，该项目现在开启了 AI 托管迭代模式：main 分支由 AI 持续优化功能与修复 Bug，你只需提 Issue，AI 即刻响应，确保工具永远保持最新状态。

核心亮点

1. 全方位的财务追踪

• 多币种支持：记录 USD, CNY, EUR 等多种货币订阅，支持动态/固定汇率换算。
• 智能仪表盘：
  • 📈 支出分析：月度/年度支出统计、环比趋势、分类占比排行。
  • 💳 活跃概览：当前活跃订阅数、月均支出计算。
  • 📅 近期预警：最近 7 天支付记录、即将续费列表。
• 支付历史：完整记录每一笔扣费，支持编辑、删除（删除自动回退周期），精确显示计费周期。

2. 强大的多渠道提醒

不再错过任何续费通知！支持配置多种推送方式：

• 📱 即时通讯：Telegram Bot, 企业微信机器人。
• 📧 邮件服务：基于 Resend 的高送达率邮件。
• 🔗 通用推送：自定义 Webhook, NotifyX, iOS Bark。
• ⏰ 智能策略：自定义提前 N 天提醒，自动识别过期状态。

3. 贴心的农历支持

• 双历显示：完美支持 1900-2100 年农历转换。
• 场景化应用：列表页/编辑页可开关农历显示，通知消息中也可包含农历日期，更符合华人使用习惯。

4. 极致的用户体验

• 响应式设计：完美适配桌面端、平板和手机端。
• 深色模式：支持浅色、深色及跟随系统自动切换。
• 细节优化：长备注自动截断（悬停显示），日期选择实时预览农历，操作流畅丝滑。

5. AI 驱动的快速迭代

• Legacy 保护：稳定版代码保留在 legacy-v1 分支，随时可回滚。
• AI 主理：main 分支由 AI 托管，负责功能新增、体验优化和 Bug 修复。
• 社区共建：用户遇到任何问题直接提 Issue，AI 将第一时间分析并推送修复代码。

极速部署指南

SubsTracker 采用 Wrangler 本地部署模式，无需复杂配置，几分钟即可上线。

第一步：环境准备

1. 安装 Node.js: 前往 nodejs.org 下载并安装 LTS 版本。
2. 获取 Cloudflare API Token:
   • 登录 Cloudflare Dashboard → My Profile → API Tokens。
   • 点击 Create Token，推荐使用 Edit Cloudflare Workers 模板。
   • 确保权限包含：Workers Scripts: Edit 和 Workers KV Storage: Edit。
   • 复制生成的 Token（仅显示一次，请妥善保存）。

第二步：克隆与安装

git clone https://github.com/wangwangit/SubsTracker.git
cd SubsTracker
npm install

第三步：一键部署 (推荐)

使用 deploy:safe 脚本，它会自动检查/创建 KV 命名空间并回写配置。

Windows PowerShell:

$env:CLOUDFLARE_API_TOKEN="你的token"
npm run deploy:safe

Windows CMD:

set CLOUDFLARE_API_TOKEN=你的token
npm run deploy:safe

macOS / Linux:

export CLOUDFLARE_API_TOKEN="你的token"
npm run deploy:safe

💡 升级提示：后续更新只需 git pull 然后再次运行上述部署命令，脚本会自动复用原有的 KV 数据，数据零丢失。

第四步：初始化登录

• 访问部署成功后生成的 Worker 域名。
• 默认账号: admin
• 默认密码: password
• ⚠️ 重要: 首次登录后，请立即在系统设置中修改默认密码！

💡 高级玩法

• 批量续订：支持一次性续订多个周期，或自定义续订日期（甚至支持回溯补录）。
• 数据备份：

  # 备份配置
  npx wrangler kv key get --binding=SUBSCRIPTIONS_KV --remote config > backup-config.json
  # 备份订阅数据
  npx wrangler kv key get --binding=SUBSCRIPTIONS_KV --remote subscriptions > backup-subscriptions.json
  

• 自定义 Webhook：如果你使用 Gotify, ServerChan 等私有推送服务，可通过 Webhook 轻松集成。