从 OneLap (顽鹿) 平台下载运动数据，同步到多个平台：
- ✅ 行者 (XOSS)
- ✅ 捷安特骑行 (Giant)
- ✅ iGPSport
- ✅ Garmin Connect 中国区
- ✅ Strava
当前版本已支持：
- OneLap 新版签名 API：使用 token + 签名分页获取活动，并通过 FIT 下载接口拉取运动文件。
- 正向增量同步：按下游平台最新记录作为同步基准，触达基准后停止翻页，避免重复处理历史数据。
- OneLap 下载状态记录：已完成下载会记录到
onelap_download_state.json，重复运行时可跳过已下载文件。 .part临时文件保护：下载中断时降低留下坏文件的概率。- iGPSport → OneLap 反向增量同步：支持按时间戳筛选增量记录，并通过 OneLap 上传接口补录。
- Garmin Connect 中国区同步：支持登录后批量导入 OneLap 下载的运动文件，并可作为增量同步基准。
- Strava OAuth 同步：支持首次授权、token 自动刷新、上传测试、重复上传保护和错误分类日志。
- Strava 坐标转换：上传前自动将 OneLap FIT 文件从 GCJ-02 火星坐标系转为 WGS84，消除轨迹偏移。
- 打包发布：GitHub Actions 支持 Windows / Linux 构建，推送
v*标签时可自动创建 GitHub Release。
将 iGPSport 中比 OneLap 新的骑行记录自动同步到 OneLap。
适用场景：当您的 iGPSport 记录比 OneLap 多时，使用此功能补录数据。
| 方式 | 处理180条记录 | 速度 |
|---|---|---|
| 传统全量同步 | 每次处理180条 | 约5分钟 |
| 新增增量同步 | 只处理3条新记录 | 约15秒 |
在 settings.ini 中添加配置：
[igpsport_to_onelap]
# 是否启用反向同步
enable = false # true=启用, false=禁用(默认)
# 同步模式
mode = auto # auto=增量(推荐), full=全量
# 比对策略
strategy = time_based # 基于时间戳比对| 配置项 | 可选值 | 默认值 | 说明 |
|---|---|---|---|
enable |
true/false |
false |
功能开关 |
mode |
auto/full |
auto |
同步模式 |
strategy |
time_based |
time_based |
比对策略 |
- auto（智能增量模式）：自动检测 iGPSport 中 OneLap 没有的新记录，只同步这些
- full（全量模式）：同步 iGPSport 中所有记录
建议：日常使用 auto 模式，即使 OneLap 为空也会自动全量同步。
# 1. 开启反向同步（编辑 settings.ini）
# [igpsport_to_onelap]
# enable = true
# mode = auto
# 2. 运行程序
python3 SyncOnelapToXoss.py程序会自动：
- 执行原有逻辑（OneLap → 行者/捷安特/iGPSport/Garmin/Strava）
- 执行新增逻辑（iGPSport → OneLap 增量同步）
程序启动
│
├── 步骤1-9: 原有逻辑（OneLap → 行者/捷安特/iGPSport/Garmin/Strava）
│
└── 步骤10: 新增逻辑（iGPSport → OneLap 增量同步）
│
├── 登录 iGPSport（API方式）
├── 获取所有记录（180条）
├── 登录 OneLap（浏览器方式）
├── 获取最新记录时间
├── 筛选增量记录（时间 > OneLap最新时间）
├── 下载增量文件
└── 批量上传到 OneLap
🚴 iGPSport → OneLap 增量同步
==========================================
📊 发现增量: 3 条新记录
├─ 2026-02-05 - 2.3km
├─ 2026-02-02 - 20.5km
└─ 2026-02-02 - 13.0km
⬇️ 下载完成: 231 KB
⬆️ 上传完成: 3/3
✅ 同步成功！耗时 15 秒
==========================================
如果您下载的是 Windows 打包版本 (.zip)：
- 解压文件：将压缩包解压到一个文件夹中。
- 配置账号：
settings.ini是实际运行配置，settings.ini.example是示例模板。- 如果
settings.ini被覆盖，可复制settings.ini.example后重命名为settings.ini。 - 用记事本打开，填入您的 OneLap、行者、捷安特、iGPSport 或 Garmin 账号密码。
- 注意：
enable_sync = true表示启用该平台的同步。
- 运行程序：
- 双击
SyncOnelapToXoss.exe。 - 程序会自动打开浏览器进行操作，请勿关闭该浏览器窗口，等待程序运行结束。
- 双击
如果您是开发者或希望通过源码运行：
- 环境准备：
- Python 3.7+
- Chrome 浏览器
- 安装依赖：
pip install -r requirements.txt
- 配置文件：
- 复制模板：
cp settings.ini.example settings.ini(Windows 下手动复制重命名即可) - 编辑
settings.ini填入账号信息。
- 复制模板：
- 运行脚本：
python SyncOnelapToXoss.py
本工具支持多种同步场景，请根据需求修改 settings.ini：
- 用途：将顽鹿(OneLap)的骑行记录同步到行者、捷安特、iGPSport、Garmin 或 Strava。
- 配置：
[onelap]: 填入账号密码（必须）。[xoss]: 填入账号密码（如不同步到行者，可不填）。[giant]: 填入账号密码并将enable_sync = true(如不同步到捷安特，可不填)。[igpsport]: 填入账号密码并将enable_sync = true(如不同步到 iGPSport，可不填)。[garmin]: 填入 Garmin Connect 中国区账号密码并将enable_sync = true(如不同步到 Garmin，可不填)。[strava]: 如需同步到 Strava，需配置client_id/client_secret并先完成一次授权。
- 用途：当 iGPSport 记录比 OneLap 全时，将缺失的记录补录回 OneLap。
- 配置：
[igpsport_to_onelap]: 设置enable = true。- 建议保持
mode = auto(智能增量模式)，只同步新数据。
编辑 settings.ini：
[onelap]
username = 13800138000 # OneLap账号（数据源）
password = your_password
[xoss]
username = 13800138000 # 行者账号
password = your_password
[giant]
username = 13800138000 # 捷安特账号
password = your_password
enable_sync = false # 是否启用捷安特同步
[igpsport]
username = 13800138000 # iGPSport账号
password = your_password
enable_sync = false # 是否启用iGPSport同步（主程序方向）
[garmin]
username = 13800138000 # Garmin Connect 中国区账号
password = your_password
enable_sync = false # 是否启用 Garmin 同步
max_upload_files = 0 # Garmin 每批最多上传文件数；0 表示使用全局批大小
[strava]
enable_sync = false # 是否启用 Strava 同步
client_id = # Strava Client ID
client_secret = # Strava Client Secret
access_token = # 首次授权后自动写入
refresh_token = # 首次授权后自动写入
expires_at = 0 # 首次授权后自动写入
redirect_port = 8765 # 本地回调端口
athlete_id = # 首次授权后自动写入
athlete_name = # 首次授权后自动写入
gcj02_to_wgs84 = true # 上传前自动转换 GCJ-02 → WGS84 坐标系
[sync]
storage_dir = ./downloads
supported_formats = .fit,.gpx,.tcx
max_file_size_mb = 50
max_files_per_batch = 5
[igpsport_to_onelap]
enable = false # 反向同步开关
mode = auto # 同步模式Strava 不使用账号密码直接登录同步，而是使用 OAuth 2.0。
首次接入步骤：
- 在 Strava Developers 创建应用
- 配置回调地址，例如：
http://127.0.0.1:8765/callback - 在
settings.ini的[strava]中填写client_id和client_secret - 运行以下命令完成首次授权：
python3 SyncOnelapToXoss.py --strava-auth授权完成后，程序会自动写入：
access_tokenrefresh_tokenexpires_atathlete_idathlete_name
测试 token 是否可用：
python3 SyncOnelapToXoss.py --strava-test测试单个 FIT 文件上传：
python3 SyncOnelapToXoss.py --strava-upload-test /path/to/file.fit主程序使用固定优先级链选择增量同步基准，不比较所有平台中的最大时间。
当前优先级：
- XOSS / 行者
- iGPSport
- Giant / 捷安特
- Garmin Connect 中国区
- Strava
示例：
- 如果 XOSS 和 Strava 都启用，优先使用 XOSS 作为增量基准
- 如果只启用 Strava，则使用 Strava 作为增量基准
- 如果 XOSS / iGPSport / Giant 都不可用，但 Garmin 启用且可读取最新记录，则使用 Garmin 作为增量基准
Strava 已增加基础去重保护：
- 本地重复文件会跳过
- 服务端 duplicate 活动会自动识别并吸收
- 主流程会输出 Strava 上传摘要（成功 / 跳过重复 / 失败）
settings.ini可能包含敏感信息，请勿提交到 Git- 建议仓库中保留模板版
settings.ini或settings.ini.example - 本地真实配置请使用私有文件保存（如
settings.local.ini） access_token/refresh_token/client_secret不应出现在公开仓库、截图或文档中
- Python 3.7+
- Chrome/Chromium 浏览器
- Linux/macOS/Windows
pip install -r requirements.txt仓库已支持通过 GitHub Actions 自动执行 Windows 打包：
- 触发方式：
- push 到
main - push 到
release-*分支 - push
v*标签 - 手动
workflow_dispatch
- push 到
- 运行环境：
windows-latest - 产物：Windows zip 包（作为 Actions artifact 上传）
工作流文件位置：
.github/workflows/build-release.yml
当前版本支持 Windows / Linux 构建，并可在推送
v*标签时自动创建 GitHub Release。
完整发布说明见 RELEASE_NOTES.md。README 仅保留主要功能和关键修复摘要。
- ✅ 新增 Strava 坐标自动修正功能：OneLap 的国内坐标系（GCJ-02）→ Strava 的国际标准坐标系（WGS84），解决轨迹偏移 50-500 米的问题。
- ✅ 默认自动启用，无需额外配置；不想用可在
settings.ini中关闭。 - ✅ 境外骑行自动跳过，不会误转；转换精度可达 1-2 米。
- ✅ 适配顽鹿新版登录页
u.onelap.cn/login，新旧页面选择器自动兼容。 - ✅ 登录成功判定优先读取 token，URL 与 userInfo 作为兜底，提升识别可靠性。
- ✅ OneLap 接口 Referer 统一指向
recordPage数据管理页，修复请求异常。 - ✅ 新增
[app] debug_mode调试开关，登录失败时保留浏览器并打印诊断信息。 - ✅ 新增 Docker 部署支持（含 noVNC），可在浏览器中观察运行过程、手动处理验证码。
- ✅
settings.ini不再纳入版本控制，改为从settings.ini.example复制填写，避免误提交账号密码。
- ✅ 新增 Garmin Connect 中国区平台支持，可将 OneLap 下载文件导入 Garmin。
- ✅ Garmin 支持作为正向增量同步基准，优先级位于 Giant 之后、Strava 之前。
- ✅ Garmin 支持按批上传，
max_upload_files可配置每批最多上传文件数。 - ✅ Garmin 上传按活动时间从旧到新执行，便于异常中断后继续增量同步。
- ✅ 配置模板和使用文档新增
[garmin]配置说明。
- ✅ 主同步链路切换到 OneLap 新版签名 API，使用 token + 签名分页获取活动。
- ✅ 正向同步按下游平台最新记录做增量比对，触达同步基准后停止翻页。
- ✅ 新增 OneLap 下载状态记录与
.part临时文件落盘，支持跳过已完成下载。 - ✅ 修复 OneLap FIT 下载参数兼容性问题，支持完整
fitUrl、解码 URL、路径和文件名候选回退。 - ✅ iGPSport → OneLap 反向上传改为调用 OneLap 上传接口，修复旧页面自动化上传未入库的问题。
- ✅ 反向上传按活动时间数量增量校验，减少误判。
- ✅ 主脚本和增量脚本统一从程序目录读取
settings.ini。 - ✅ 修复 Windows 下反向同步 FIT 文件名和控制台输出兼容性问题。
- ✅ 修复 iGPSport 为空时的同步处理逻辑。
- ✅ 优化 iGPSport 分批上传后的页面刷新与后续批次处理。
- ✅ PyInstaller 单文件打包后，
settings.ini和 Strava 状态文件改为从 exe 所在目录读取。 - ✅ 修复
--strava-auth等命令在打包版本中找不到配置文件的问题。
- ✅ 当 OneLap 正向没有新文件可上传时，不再提前终止整体流程。
- ✅ 保证 iGPSport → OneLap 反向增量同步仍可继续执行。
- ✅ 修复 Strava 授权回调处理中的
NameError。
- ✅ 完善 Strava 发布说明和用户文档。
- ✅ GitHub Release 使用
RELEASE_NOTES.md中的自定义发布说明。 - ✅ 完善自动发布流程。
- ✅ 新增 Strava 同步能力，支持 OAuth 2.0 授权。
- ✅ 支持 Strava token 自动刷新、重复上传保护、测试命令和单文件上传测试。
- ✅ Strava 可作为同步基准的兜底平台。
- ✅ GitHub Actions 支持 Windows / Linux 自动构建，并在 tag 发布时创建 Release。
- ✅ 优化 iGPSport 文件输入框与确认按钮定位，提升导入稳定性。
- ✅ 增强增量同步保护：未显式配置
onelap_full_sync=true时，避免误触发全量同步。 - ✅ 优化行者 (XOSS) 最新活动时间解析，修复基准判断失败问题。
- ✅ 修复 iGPSport 登录成功判断、页面访问、导入按钮定位和上传确认逻辑。
- ✅ 继续支持
.fit、.gpx、.tcx文件格式。 - ✅ 增强错误处理和请求重试机制。
- ✅ 优化使用说明和配置文档。
- ✅ 明确常用同步场景、账号选填规则和开关配置。
- ✅ 修复增量同步浏览器端口与 XOSS 跳过逻辑。
- ✅ 新增 iGPSport → OneLap 反向增量同步功能
- ✅ 智能增量检测，只同步新数据
- ✅ settings.ini 使用示例账号优化
- ✅ 文档合并优化：说明文档整合到 README.md
- ✅ 修复 iGPSport 批量上传问题（支持一次上传多个 .fit 文件）
- ✅ 增强容错性：OneLap/行者登录失败时不再直接退出，而是尝试继续后续流程
- ✅ 优化发布包命名
- ✅ 新增 iGPSport 平台支持
- ✅ 新增同步到捷安特骑行平台功能
- ✅ 初始版本，支持 OneLap → 行者/捷安特
- 首次使用建议测试：先开启预览模式确认增量数量
- 定期同步：建议每周运行一次，保持数据同步
- 账号安全：settings.ini 包含敏感信息，请勿分享
Enjoy your ride! 🚴♂️