Incremental.icu

incremental.icu 是一款专为运动爱好者打造的跨平台数据同步工具。它能够连接佳明（Garmin）与高驰（Coros）平台，通过调用官方提供的 API 同步数据，协助用户高效管理运动记录，特别适合同时使用多设备记录运动状态的用户。

创建这个工具的初衷，是为了解决佳明海内外版本数据不同步导致 Strava 和微信运动等数据国内平台只能二选一的问题。后来使用了高驰训练平台感觉不错，于是增加了高驰的平台支持。

---

✨ 主要功能

• 一键同步：设定两个平台，手动拉取最新 10 条数据，进行差量同步。
• 手动同步：在数据列表中找到对应的数据记录，手动推送到指定平台。
• 定时同步：设定定时任务，自动执行同步。

🌐 支持平台

平台	支持状态	交互格式
佳明 (Garmin) 国内版	✅ 已支持	.FIT
佳明 (Garmin) 国际版	✅ 已支持	.FIT
高驰 (Coros)	✅ 已支持	.FIT

🚀 线上版本

访问 incremental.icu 即可直接注册并开始管理您的运动数据。

---

🛠 开发者指南

如果您希望参与开发或自行部署本项目，请参考以下技术细节。

技术栈

• 前端框架: Next.js (App Router)
• 后端服务: FastAPI (Python) 提供接口
• UI 组件库: shadcn/ui & Alpine.js
• 数据库: Neon (Serverless Postgres)
• 邮件服务: Resend
• 图标库: Tabler Icons
• garth: 一个模拟佳明客户端的 python 包，目前版本 0.5.17 更高版本支持佳明国内版有问题。

部署与 CI/CD

1. 代码规范: 前端部署之前记得先跑一下 npm run lint。
2. 前端部署: 托管于 Vercel。
   • 注意: 后端接口地址需要配置在 /vercel.json 中。
3. 自动化工作流:
   • CI/CD: 前端通过 Vercel 自动部署，后端通过 GitHub Actions。
   • 定时任务: 使用 GitHub Actions 处理定时同步任务。

监控与分析

• 网站状态监测: Better Stack
• 网站流量分析: Google Analytics

参考资源与授权

• 登录逻辑参考: running_page (前端佳明高驰登录逻辑参考，但因为前端登录的有效性会掉，目前已经不采用前端登录的方式)
• 佳明高驰数据同步参考: garmin-sync-coros
• 身份验证: 支持 Google 和 GitHub 原生的 OAuth 单点登录。

📈 项目管理

本项目使用 GitHub Projects 进行进度管理与任务追踪。