SyncOnelapToXoss

KO | EN

gitlite — search

#python #hacktoberfest #golang #android #rust #deep-learning #linux #windows #awesome #kubernetes #ios #mcp #openai #open-source

SyncOnelapToXoss

(★ 29)

迈金（OneLap)至行者(XOSS) /捷安特骑行APP/IGPSport/Strava 数据同步工具，支持OpenClaw（龙虾）中调用

SyncOnelapToXoss Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# OneLap到多平台数据同步工具

## 🎯 功能概述

从 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 反向增量同步

### 功能说明

将 iGPSport 中比 OneLap 新的骑行记录自动同步到 OneLap。

**适用场景**：当您的 iGPSport 记录比 OneLap 多时，使用此功能补录数据。

### 与传统方式对比

| 方式 | 处理180条记录 | 速度 |
|------|---------------|------|
| 传统全量同步 | 每次处理180条 | 约5分钟 |
| **新增增量同步** | 只处理3条新记录 | **约15秒** |

### 配置方法

在 `settings.ini` 中添加配置：

```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 为空也会自动全量同步。

### 使用方法

```bash
# 1. 开启反向同步（编辑 settings.ini）
# [igpsport_to_onelap]
# enable = true
# mode = auto

# 2. 运行程序
python3 SyncOnelapToXoss.py
```

程序会自动：
1. 执行原有逻辑（OneLap → 行者/捷安特/iGPSport/Garmin/Strava）
2. 执行新增逻辑（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 秒
==========================================
```

## 📖 使用指南

### 1. 快速开始 (Windows 用户)

如果您下载的是 Windows 打包版本 (`.zip`)：

1.  **解压文件**：将压缩包解压到一个文件夹中。
2.  **配置账号**：
    *   `settings.ini` 是实际运行配置，`settings.ini.example` 是示例模板。
    *   如果 `settings.ini` 被覆盖，可复制 `settings.ini.example` 后重命名为 `settings.ini`。
    *   用记事本打开，填入您的 OneLap、行者、捷安特、iGPSport 或 Garmin 账号密码。
    *   **注意**：`enable_sync = true` 表示启用该平台的同步。
3.  **运行程序**：
    *   双击 `SyncOnelapToXoss.exe`。
    *   程序会自动打开浏览器进行操作，**请勿关闭该浏览器窗口**，等待程序运行结束。

### 2. 开发者指南 (源码运行)

如果您是开发者或希望通过源码运行：

1.  **环境准备**：
    *   Python 3.7+
    *   Chrome 浏览器
2.  **安装依赖**：
    ```bash
    pip install -r requirements.txt
    ```
3.  **配置文件**：
    *   复制模板：`cp settings.ini.example settings.ini` (Windows 下手动复制重命名即可)
    *   编辑 `settings.ini` 填入账号信息。
4.  **运行脚本**：
    ```bash
    python SyncOnelapToXoss.py
    ```

## ⚙️ 业务场景与配置

本工具支持多种同步场景，请根据需求修改 `settings.ini`：

### 场景 A：OneLap 数据同步到其他平台 (默认)
*   **用途**：将顽鹿(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` 并先完成一次授权。

### 场景 B：iGPSport 数据反向同步到 OneLap (新功能)
*   **用途**：当 iGPSport 记录比 OneLap 全时，将缺失的记录补录回 OneLap。
*   **配置**：
    *   `[igpsport_to_onelap]`: 设置 `enable = true`。
    *   建议保持 `mode = auto` (智能增量模式)，只同步新数据。

## ⚙️ 详细配置说明

编辑 `settings.ini`：

```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 使用说明

### 1. 首次接入需要先授权
Strava 不使用账号密码直接登录同步，而是使用 OAuth 2.0。

首次接入步骤：
1. 在 Strava Developers 创建应用
2. 配置回调地址，例如：`http://127.0.0.1:8765/callback`
3. 在 `settings.ini` 的 `[strava]` 中填写 `client_id` 和 `client_secret`
4. 运行以下命令完成首次授权：

```bash
python3 SyncOnelapToXoss.py --strava-auth
```

授权完成后，程序会自动写入：
- `access_token`
- `refresh_token`
- `expires_at`
- `athlete_id`
- `athlete_name`

### 2. Strava 测试命令

测试 token 是否可用：

```bash
python3 SyncOnelapToXoss.py --strava-test
```

测试单个 FIT 文件上传：

```bash
python3 SyncOnelapToXoss.py --strava-upload-test /path/to/file.fit
```

### 3. Strava 参与增量同步基准

主程序使用**固定优先级链**选择增量同步基准，不比较所有平台中的最大时间。

当前优先级：
1. XOSS / 行者
2. iGPSport
3. Giant / 捷安特
4. Garmin Connect 中国区
5. Strava

示例：
- 如果 XOSS 和 Strava 都启用，优先使用 XOSS 作为增量基准
- 如果只启用 Strava，则使用 Strava 作为增量基准
- 如果 XOSS / iGPSport / Giant 都不可用，但 Garmin 启用且可读取最新记录，则使用 Garmin 作为增量基准

### 4. Strava 去重说明

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

## 📦 安装依赖

```bash
pip install -r requirements.txt
```

## 🤖 GitHub Actions 自动打包

仓库已支持通过 GitHub Actions 自动执行 **Windows 打包**：

- 触发方式：
  - push 到 `main`
  - push 到 `release-*` 分支
  - push `v*` 标签
  - 手动 `workflow_dispatch`
- 运行环境：`windows-latest`
- 产物：Windows zip 包（作为 Actions artifact 上传）

工作流文件位置：

```text
.github/workflows/build-release.yml
```

> 当前版本支持 Windows / Linux 构建，并可在推送 `v*` 标签时自动创建 GitHub Release。

## 📝 版本历史

完整发布说明见 [`RELEASE_NOTES.md`](./RELEASE_NOTES.md)。README 仅保留主要功能和关键修复摘要。

### v1.2.15 (2026-07-07)
- ✅ 新增 Strava 坐标自动修正功能：OneLap 的国内坐标系（GCJ-02）→ Strava 的国际标准坐标系（WGS84），解决轨迹偏移 50-500 米的问题。
- ✅ 默认自动启用，无需额外配置；不想用可在 `settings.ini` 中关闭。
- ✅ 境外骑行自动跳过，不会误转；转换精度可达 1-2 米。

### v1.2.14 (2026-06-29)
- ✅ 适配顽鹿新版登录页 `u.onelap.cn/login`，新旧页面选择器自动兼容。
- ✅ 登录成功判定优先读取 token，URL 与 userInfo 作为兜底，提升识别可靠性。
- ✅ OneLap 接口 Referer 统一指向 `recordPage` 数据管理页，修复请求异常。
- ✅ 新增 `[app] debug_mode` 调试开关，登录失败时保留浏览器并打印诊断信息。
- ✅ 新增 Docker 部署支持（含 noVNC），可在浏览器中观察运行过程、手动处理验证码。
- ✅ `settings.ini` 不再纳入版本控制，改为从 `settings.ini.example` 复制填写，避免误提交账号密码。

### v1.2.13 (2026-06-03)
- ✅ 新增 Garmin Connect 中国区平台支持，可将 OneLap 下载文件导入 Garmin。
- ✅ Garmin 支持作为正向增量同步基准，优先级位于 Giant 之后、Strava 之前。
- ✅ Garmin 支持按批上传，`max_upload_files` 可配置每批最多上传文件数。
- ✅ Garmin 上传按活动时间从旧到新执行，便于异常中断后继续增量同步。
- ✅ 配置模板和使用文档新增 `[garmin]` 配置说明。

### v1.2.12 (2026-04-25)
- ✅ 主同步链路切换到 OneLap 新版签名 API，使用 token + 签名分页获取活动。
- ✅ 正向同步按下游平台最新记录做增量比对，触达同步基准后停止翻页。
- ✅ 新增 OneLap 下载状态记录与 `.part` 临时文件落盘，支持跳过已完成下载。
- ✅ 修复 OneLap FIT 下载参数兼容性问题，支持完整 `fitUrl`、解码 URL、路径和文件名候选回退。
- ✅ iGPSport → OneLap 反向上传改为调用 OneLap 上传接口，修复旧页面自动化上传未入库的问题。
- ✅ 反向上传按活动时间数量增量校验，减少误判。
- ✅ 主脚本和增量脚本统一从程序目录读取 `settings.ini`。
- ✅ 修复 Windows 下反向同步 FIT 文件名和控制台输出兼容性问题。

### v1.2.11 (2026-04-12)
- ✅ 修复 iGPSport 为空时的同步处理逻辑。
- ✅ 优化 iGPSport 分批上传后的页面刷新与后续批次处理。

### v1.2.10 (2026-04-12)
- ✅ PyInstaller 单文件打包后，`settings.ini` 和 Strava 状态文件改为从 exe 所在目录读取。
- ✅ 修复 `--strava-auth` 等命令在打包版本中找不到配置文件的问题。

### v1.2.9 (2026-04-12)
- ✅ 当 OneLap 正向没有新文件可上传时，不再提前终止整体流程。
- ✅ 保证 iGPSport → OneLap 反向增量同步仍可继续执行。

### v1.2.8 (2026-04-01)
- ✅ 修复 Strava 授权回调处理中的 `NameError`。

### v1.2.7 (2026-04-01)
- ✅ 完善 Strava 发布说明和用户文档。
- ✅ GitHub Release 使用 `RELEASE_NOTES.md` 中的自定义发布说明。
- ✅ 完善自动发布流程。

### v1.2.6 (2026-04-01)
- ✅ 新增 Strava 同步能力，支持 OAuth 2.0 授权。
- ✅ 支持 Strava token 自动刷新、重复上传保护、测试命令和单文件上传测试。
- ✅ Strava 可作为同步基准的兜底平台。
- ✅ GitHub Actions 支持 Windows / Linux 自动构建，并在 tag 发布时创建 Release。
- ✅ 优化 iGPSport 文件输入框与确认按钮定位，提升导入稳定性。

### v1.2.5 (2026-03-28)
- ✅ 增强增量同步保护：未显式配置 `onelap_full_sync=true` 时，避免误触发全量同步。
- ✅ 优化行者 (XOSS) 最新活动时间解析，修复基准判断失败问题。
- ✅ 修复 iGPSport 登录成功判断、页面访问、导入按钮定位和上传确认逻辑。
- ✅ 继续支持 `.fit`、`.gpx`、`.tcx` 文件格式。
- ✅ 增强错误处理和请求重试机制。

### v1.2.4 (2026-02-28)
- ✅ 优化使用说明和配置文档。
- ✅ 明确常用同步场景、账号选填规则和开关配置。
- ✅ 修复增量同步浏览器端口与 XOSS 跳过逻辑。

### v1.2.3 (2026-02-08)
- ✅ 新增 iGPSport → OneLap 反向增量同步功能
- ✅ 智能增量检测，只同步新数据
- ✅ settings.ini 使用示例账号优化
- ✅ 文档合并优化：说明文档整合到 README.md

### v1.2.1
- ✅ 修复 iGPSport 批量上传问题（支持一次上传多个 .fit 文件）
- ✅ 增强容错性：OneLap/行者登录失败时不再直接退出，而是尝试继续后续流程
- ✅ 优化发布包命名

### v1.2.0
- ✅ 新增 iGPSport 平台支持

### v1.1.0
- ✅ 新增同步到捷安特骑行平台功能

### v1.0.0
- ✅ 初始版本，支持 OneLap → 行者/捷安特

## 🙏 注意事项

1. **首次使用建议测试**：先开启预览模式确认增量数量
2. **定期同步**：建议每周运行一次，保持数据同步
3. **账号安全**：settings.ini 包含敏感信息，请勿分享

---

**Enjoy your ride! 🚴‍♂️**

SyncOnelapToXoss

SyncOnelapToXoss Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

SyncOnelapToXoss

SyncOnelapToXoss Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README