运行状态与排错
点击「开始同步」后，插件会显示当前任务状态。大多数问题可以先根据状态和提示文案判断。
常见状态
| 状态 | 含义 | 建议 |
|---|---|---|
| 正在同步 | 任务已经开始运行 | 等待任务完成，不要重复点击 |
| 同步成功 | 本次任务正常结束 | 打开 Notion 模板查看数据 |
| 同步失败 | 任务运行中出现阻塞错误 | 查看错误提示并按本文排查 |
| 已取消 | 新任务取消了旧任务，或运行超时 | 如果不是你主动重试，请联系支持 |
| 免费体验次数已用完 | 当前服务的免费同步次数已经用完 | 购买激活码后重新运行 |
同步成功但 Notion 没有数据
可能原因：
- 第一次同步数据较多，Notion 页面还没有刷新。
- 第三方平台本身没有可同步的新数据。
- 模板没有完整授权给 NotionHub。
- 你打开的不是刚才授权的模板页面。
- 某些子模块在同步设置中没有开启。
建议先刷新 Notion 页面，再打开插件查看最近一次运行时间。如果超过 5 分钟仍没有数据，请检查模板授权。
一直显示正在同步
如果 GitHub Action 已经成功结束，但插件仍显示正在同步，通常是运行状态缓存没有及时刷新。
可以尝试：
- 关闭插件弹窗后重新打开。
- 刷新浏览器页面。
- 等待 1 分钟后再查看。
如果多次刷新后仍不更新，请联系技术支持，并提供服务名和 GitHub Action 链接。
提示登录过期
这说明第三方平台的 Cookie、Token 或授权已经失效。
处理方式：
- 微信读书：重新扫码登录。
- 小宇宙：重新手机号验证码登录。
- Flomo、B 站、多邻国：重新打开对应网页完成登录，再回插件更新登录状态。
- Toggl：检查 API Token 是否被重置。
- Spotify、Strava、Trakt、YouTube 等 OAuth 服务：重新授权。
重新登录后，再点击「开始同步」。
提示模板不存在或无访问权限
常见原因是 Notion 模板被删除、移动后权限丢失，或授权时选错页面。
请参考 模板页面不存在或无访问权限。
提示 404
如果 Notion 授权回调或模板页面打开后提示 404，请参考 修复 404 问题。
提示免费体验次数已用完
免费体验次数用完后，需要购买激活码继续使用。
购买说明见 获取激活码。
任务被取消
常见情况：
- 你重复点击了「开始同步」，新任务取消了旧任务。
- GitHub Action 达到最长运行时间限制。
- GitHub 仓库或 Action 权限发生变化。
如果是重复点击导致的取消，可以忽略旧任务，只看最新任务结果。
如果任务经常因为超时被取消，通常说明当前服务数据量较大，或者开启了较多媒体上传。可以先关闭大文件上传，再重新运行。
媒体上传失败
图片、音频、视频上传失败不一定代表主数据同步失败。
常见原因：
- Notion 免费版单个文件大小限制。
- 第三方平台限制下载。
- GitHub Action 网络较慢。
- 上传过程中临时超时。
如果 Notion 中已有文字数据，可以先正常使用，之后再重新运行补充媒体。
更多说明见 图片、音频和视频上传。
联系支持时需要提供什么
为了更快定位问题，请尽量提供：
- 同步服务名称。
- 插件里看到的错误文案。
- 最近一次运行时间。
- 如果绑定了 GitHub，提供 GitHub Action 链接。
- 不要发送 Cookie、Token、验证码、Notion access token 或完整激活码。
联系方式见 技术支持。