> 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.

# 第三方平台登录方式

NotionHub 需要读取第三方平台数据，所以每个服务都要完成一次对应平台授权。不同平台的登录方式不同。

## 常见登录类型

| 类型        | 常见服务                                                                                                                                                                    | 说明                                          |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
| 扫码登录      | 微信读书                                                                                                                                                                    | 使用微信扫码确认登录                                  |
| 官方网页登录    | 小宇宙、[微博](https://www.notionhub.app/docs/weibo.md)、[即刻](https://www.notionhub.app/docs/jike.md)                                                                          | 在平台官网完成登录和安全验证；即刻登录并刷新网页后，还需返回插件点击「去登录」保存连接 |
| 网页账号连接    | [苹果播客](https://www.notionhub.app/docs/applepodcast.md)、[Apple Music](https://www.notionhub.app/docs/applemusic.md)                                                      | 登录官网后加载资料库或播放内容，让插件识别账号                     |
| OAuth 授权  | [Strava](https://www.notionhub.app/docs/strava.md)、[Trakt](https://www.notionhub.app/docs/trakt.md)、[YouTube](https://www.notionhub.app/docs/youtube.md)、长毛象            | 跳转到官方授权页面，同意后返回插件；长毛象先输入自己的实例地址             |
| 网页 Cookie | [Spotify](https://www.notionhub.app/docs/spotify.md)、[滴答清单](https://www.notionhub.app/docs/dida.md)、B 站、Flomo、多邻国、[小红书](https://www.notionhub.app/docs/xiaohongshu.md)等 | 先登录平台官网，再由插件读取浏览器登录状态；小红书需先确认所用版本提供受支持的服务入口 |
| API Token | Toggl                                                                                                                                                                   | 在平台官网复制 API Token 后填入插件                     |
| 用户 ID     | 豆瓣、不背单词等                                                                                                                                                                | 填写公开用户名或用户 ID                               |
| 账号密码      | Keep、[Forest](https://www.notionhub.app/docs/forest.md) 等                                                                                                               | 在插件中输入平台账号完成登录；Forest 还需确认服务器地区与同步支持范围      |

插件页面会按服务展示当前需要的登录方式。你不需要自己判断接口或参数。

[生成日记](https://www.notionhub.app/docs/daily.md) 汇总已同步到 Notion 的数据，没有额外的第三方账号登录步骤；各数据来源仍需在对应服务中完成配置。

## 登录状态会过期吗

会。第三方平台可能会让 Cookie、Token 或授权过期。

过期后常见表现：

- 插件提示需要重新登录。
- GitHub Action 日志提示登录状态失效。
- 同步失败但 Notion 模板本身没有问题。
- 最近数据突然不更新。

这时重新打开插件，进入对应服务，按提示重新登录即可。

## 重新登录会影响已有数据吗

通常不会。

重新登录只是更新访问第三方平台的凭证。已经同步到 Notion 的数据仍然保留，后续同步会继续更新原来的 Notion 数据库。

## OAuth 服务如何重新授权

Strava、Trakt、YouTube、长毛象等服务使用 OAuth 授权。

如果授权过期：

1. 打开插件中的对应服务。
2. 点击重新授权或重新登录。
3. 在官方授权页面确认。
4. 回到插件后重新点击「开始同步」。

NotionHub 会优先使用刷新 Token。如果刷新失败，才会要求你重新授权。

长毛象实例通常发放长期 access token，不一定提供 refresh token。实例明确撤销或拒绝 token 时，插件会提示在同一实例重新授权；临时限流和服务器错误不会把连接误判为永久失效。

## Cookie 登录服务如何更新状态

Spotify、B 站、Flomo、多邻国、小红书等服务通常依赖浏览器中的网页登录状态。Spotify 当前使用网页连接方式，具体步骤见 [Spotify 使用指南](https://www.notionhub.app/docs/spotify.md)。

如果插件提示登录失效：

1. 打开对应平台官网。
2. 确认自己已经登录。
3. 回到插件，重新点击登录或更新登录状态。
4. 再触发同步。

如果平台网页也要求重新登录，请先在官网完成登录。

## 安全注意事项

- 不要把 Cookie、Token、验证码、Notion access token 发到公开群或 issue。
- 技术支持只需要服务名、错误截图、运行时间和 GitHub Action 链接。
- 如果怀疑 API Token 泄露，请到对应平台官网重置，再回插件更新。
- 不建议手动修改 GitHub Secret，插件保存配置时会自动更新。

## 登录失败怎么办

可以按顺序检查：

1. 平台官网是否能正常登录。
2. 插件是否是最新版本。
3. 浏览器是否阻止了弹窗或第三方页面。
4. 官方登录页是否完成了验证码或安全验证。
5. GitHub Action 日志是否明确提示登录失效。

如果仍然失败，请联系 [技术支持](https://www.notionhub.app/docs/support.md)。