SubsTracker 是一个基于命令行接口（CLI）的工具，用于通过 REST API 自动化管理订阅服务。它提供了一套简洁的脚本集合，允许用户通过终端直接执行登录、订阅增删改查、配置更新、通知设置以及仪表板数据查询等操作。所有命令均输出结构化的 JSON 数据，便于集成到自动化流程或脚本中。该工具采用 TypeScript 编写，具备完善的类型定义和错误处理机制，确保操作的可靠性和可维护性。
使用 SubsTracker 无需复杂的前端界面或图形化配置，只需在本地创建 `.env` 文件并填入必要的认证信息（如 API URL、用户名和密码），即可开始管理你的各类订阅服务。系统支持环境变量自动加载，优先顺序为当前目录、用户主目录下的配置文件，最后是系统环境变量，极大简化了部署流程。此外，脚本内置会话管理和重试逻辑，当检测到身份验证失效时会自动重新登录并重试请求，减少因会话过期导致的失败。
无论是个人用户希望追踪每月支出，还是开发者需要将其嵌入自动化工作流，SubsTracker 都能以轻量级的方式满足需求。其设计注重实用性与可扩展性，所有核心功能均通过统一的 CLI 入口调用，并遵循一致的参数规范，使得学习成本低且易于上手。
核心功能特点
- 通过 CLI 脚本统一管理订阅服务的生命周期，包括创建、更新、删除和续费
- 自动处理身份验证与会话管理，支持环境变量配置，无需手动干预
- 支持丰富的订阅属性设置，如计费周期、提醒规则、分类标签和自定义类型
- 提供支付记录管理与编辑功能，便于调整历史付款信息
- 内置仪表板查询命令，可获取月度/年度消费统计与即将到期的订阅列表
- 灵活的配置系统支持多种通知方式（如 Telegram、Bark、Webhook、邮件等）
适用场景
SubsTracker 特别适合那些希望通过代码或脚本自动化管理多个在线订阅服务的用户。例如，自由职业者或小型企业主可以使用它定期生成订阅支出报告，帮助控制预算；技术爱好者则可将它与自己的脚本结合，实现到期前自动发送提醒或触发其他操作。由于其输出为标准 JSON，也方便与其他工具链集成，比如配合 cron 定时任务进行每日检查，或将数据导入 Excel 或数据库做进一步分析。
对于习惯使用终端工作的开发者而言，SubsTracker 提供了一种高效替代网页端操作的方式。无论是批量添加新订阅、修改价格变动，还是快速查看即将续费的账单，都可以通过一行命令完成，显著提升效率。同时，其清晰的错误提示和自动重试机制降低了运维复杂度，即使非专业运维人员也能轻松掌握。
此外，该工具对多币种、农历日期、自定义提醒策略的支持，使其不仅适用于国内常见的订阅场景（如视频流媒体、软件会员、云服务），也能适应国际化的使用需求。无论是 Netflix、Spotify 还是国内的各种 SaaS 产品，SubsTracker 都能灵活适配，成为个人财务管理的得力助手。