> For AI agents: the complete documentation index is available at https://www.notionhub.app/llms.txt, the full documentation bundle is available at https://www.notionhub.app/llms-full.txt.

# Strava 同步到 Notion

NotionHub 可以将 Strava 中的运动活动整理到 Notion，查看跑步、骑行、行走、游泳等活动的时间、距离和运动类型。活动提供相应数据时，还可以保存分段、心率和路线信息。

## 可以同步什么

| 内容      | 在 Notion 中查看                              |
| ------- | ----------------------------------------- |
| 运动活动    | 活动标题、Strava 链接、开始时间、运动时长、距离、运动类型和可计算的平均配速 |
| 活动详情    | 平台提供的平均心率、最大心率和热量等信息                      |
| 运动分段    | 可获取的公制分段、距离、时长、配速、心率，以及与活动的关联             |
| 路线与心率文件 | 在数据可用且允许上传媒体时，保存路线文件、路线封面和心率数据文件          |

没有 GPS、心率或分段数据的活动不会凭空补出这些内容。当前同步面向自己的活动，不包含好友动态、俱乐部数据、睡眠或体重记录。

运动时长使用 Strava 返回的移动时间，结束时间由开始时间加上该时长计算，因此可能与包含休息、暂停的实际结束时刻不同。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 准备能够正常登录的 Strava 账号，确认要同步的活动已经上传到该账号。
- 使用插件提供的 Strava Notion 模板，并允许 NotionHub 访问。
- 按提示连接 GitHub，用于执行同步，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 确认有可用的体验次数或已激活服务，具体以插件显示为准，参见 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

Strava 使用官方授权连接，无需自行创建开发者应用，也无需手动复制 Cookie 或长期访问凭证。

## 第一步：复制并授权 Notion 模板

1. 打开插件，在服务列表中选择「Strava」。
2. 在「Notion 模板」卡片点击「去复制」。
3. 在 Notion 授权页面确认工作区，使用开发者提供的模板并允许访问。
4. 返回插件，等待模板显示已配置。如果提示提交链接，提交自己工作区中复制后的模板页面链接。

请保留运动、运动类型及日期相关数据库。要同步分段，还需保留运动分段库及其与运动库的关系。模板中存在其它健康数据视图，并不表示 Strava 会为这些视图提供数据。更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：授权 Strava 账号

1. 在 Strava 账号卡片点击「去授权」。
2. 在打开的 Strava 官方页面登录目标账号。
3. 阅读并同意活动读取授权。
4. 等待授权页面返回插件，确认账号卡片显示账号信息和「已登录」。

授权应在安装 NotionHub 的同一浏览器中完成，插件会自动接收授权结果。正常流程无需从地址栏手动提取授权码。

当前连接请求的是普通活动读取权限，**不包含读取「仅自己可见」活动所需的全部活动权限**。因此，Strava App 中能看到的私密活动，不一定能同步到 Notion。全量同步也不会扩大授权范围。

## 第三步：检查同步设置

打开「同步设置」，按需调整热力图颜色等选项。Strava 当前没有面向用户的跑步、骑行等分类勾选项，也没有任意起止日期筛选；同步会读取权限范围内可用的运动活动。

路线和心率文件是否生成，还取决于活动本身的数据和媒体上传是否允许。如果界面提供媒体上传选项，按需要配置；只有基本运动记录时，先核对基础字段是否完整。相关说明见 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。

## 第四步：开始同步并查看结果

模板与账号授权就绪后，点击「开始同步」。如提示连接 GitHub 或配置服务权益，按提示完成后继续。

在插件运行记录或对应的 GitHub Action 中查看进度。任务结束后打开 Notion 模板，检查活动数量、来源链接、运动类型和分段关系。同步仍在运行时，避免重复启动。自动同步的条件与状态见 [同步设置](https://www.notionhub.app/docs/sync-settings.md)。

首次运行没有历史同步位置时，会扫描当前可读取的活动列表。后续普通同步会从已保存的最新活动时间向前回看一段范围，读取新活动并更新范围内的已有活动；如果没有可用的同步位置，也可能重新扫描列表。免费体验仍受活动条数限制。

修改了更早的活动、补传了旧活动，或怀疑有遗漏时，可在权益允许的情况下点击「全量同步」，再确认「开始全量同步」。全量会取消历史时间分界，重新检查权限内的活动，并按活动来源链接更新已有页面、补充缺失页面和分段。本次任务结束后恢复普通同步。

请保留活动的 Strava 来源链接，避免影响后续识别。当前同步方向是 Strava 到 Notion，修改 Notion 中的活动不会回写 Strava；在 Strava 中删除活动，也不会自动删除已有 Notion 页面。

## 常见问题

### 已经登录 Strava，为什么还需要授权？

网页登录与允许 NotionHub 读取活动是两个步骤。请从插件的账号卡片打开授权页并完成同意，确认回到插件后显示正确账号。授权取消、失效或撤销后，需要点击「重新登录」重新授权。

### 为什么有些活动没有同步？

依次检查账号、授权范围、活动是否已上传，以及运行是否成功。仅自己可见的活动不在当前普通活动读取授权范围内；体验条数限制也可能导致只导入部分记录。较早的补传或修改记录可以尝试全量同步，但全量不能绕过活动隐私权限。

### 为什么没有心率、分段或路线？

活动必须实际记录并允许读取这些数据。手动录入、室内运动或没有连接心率设备的活动，可能只有基本信息。分段来自 Strava 提供的公制分段，并非每项运动都有；心率和路线文件还受媒体上传条件限制。

### 路线文件与运动设备的原始文件相同吗？

不同。路线文件根据 Strava 提供的路线点生成，点位时间按运动时长分配，用于查看路线。它不是原始运动文件的完整备份，不能据此还原逐秒速度、暂停或设备传感器细节。

### 活动时长或日期为什么与预期不同？

先区分移动时间与包含暂停的总耗时，再检查 Notion 的时区显示。跨日运动的日期关联使用活动的结束时间；当前结束时间根据移动时长计算，可能与设备记录的实际结束时刻不同。

### 运行失败或提示请求过于频繁怎么办？

先在运行记录中确认错误原因。平台限制请求时，避免连续重复启动，待限制解除后再试；如果提示授权失效，则重新授权。不要把缺少心率或路线直接判断成整次同步失败，应同时检查基础活动是否写入。

仍有问题时，查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。
