顽鹿运动记录同步到Strava助手
项目背景 (Background)
顽鹿运动（Onelap）此前支持将运动数据自动同步至 Strava，但该功能于 2026 年 3 月 19 日关闭。本项目旨在恢复这一功能，通过 API 自动将顽鹿的骑行数据同步到 Strava。
当调用此 Skill 时，Agent 应作为同步专家，引导用户获取并使用 OnelapSyncStrava 工具完成从 Onelap (Magene) 到 Strava 的活动同步。
1. 获取程序 (Get Program)
在使用工具之前，必须确保拥有对应操作系统的二进制程序。
方法 A：从 GitHub 下载（推荐）
- 稳定版：前往 GitHub Releases 下载最新版本的压缩包，解压出对应平台的二进制文件（如
OnelapSyncStrava-windows-amd64.exe）。 - 开发版：从 GitHub Actions 的 Build Binaries 工作流中下载最新的 Artifacts。
方法 B：从源码编译
如果本地已安装 Go 环境：
- Windows: 运行
go build -o OnelapSyncStrava.exe main.go或make build。 - Linux/macOS: 运行
go build -o OnelapSyncStrava main.go并确保文件具有执行权限 (chmod +x OnelapSyncStrava)。
2. 核心流程 (Core Workflow)
第一步：环境检查
- 确认当前目录下存在
OnelapSyncStrava程序。 - 运行
OnelapSyncStrava status(Windows 使用.\OnelapSyncStrava.exe status) 查看当前同步统计和配置完整性。
第二步：基础配置 (获取 API 凭证)
- 获取 Strava API 凭证 (初次使用必做)：
- 在浏览器中登录 Strava 并访问：Strava API Settings。
- 创建一个新的 API 应用（若已有则跳过此步），填写必要信息。
- 关键点：
Authorization Callback Domain字段必须填写为localhost。 - 创建成功后，在页面中找到
Client ID及其对应的Client Secret。
- 设置并确保
config.json包含正确的参数：onelap_account: Onelap 登录邮箱/手机。onelap_password: Onelap 密码。strava_client_id: 上一步获取的 Client ID。strava_client_secret: 上一步获取的 Client Secret。
- 运行
OnelapSyncStrava check进行连通性测试。
第三步：Strava 授权 (OAuth)
为什么需要授权？
-
应用识别：
client_id和client_secret是你的 Strava API 应用凭证，用于向 Strava 标识本程序。 -
权限获取：由于 Strava 的安全机制，需要用户亲自授权给该应用上传数据的权限。
-
自动同步：授权成功后获取的
access_token和refresh_token会自动保存，后续即可实现全自动同步，无需再次手动操作。 -
如果
check提示missing refresh_token，运行OnelapSyncStrava auth。
第四步：执行同步
- 运行
OnelapSyncStrava sync开始抓取并拉取活动。 - 同步完成后，告知用户新增的活动数量。
3. 故障排除
- 授权失败：检查 Strava Client ID/Secret 是否正确，或尝试重新运行
auth。 - 登录失败：检查 Onelap 账号密码及网络连接。
- 无新活动：确认 Onelap 中是否有今日或近期尚未同步的记录。