第三方平台登录方式

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

常见登录类型

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

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

生成日记 汇总已同步到 Notion 的数据,没有额外的第三方账号登录步骤;各数据来源仍需在对应服务中完成配置。

登录状态会过期吗

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

过期后常见表现:

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

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

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

通常不会。

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

OAuth 服务如何重新授权

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

如果授权过期:

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

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

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

Spotify、B 站、Flomo、多邻国、小红书等服务通常依赖浏览器中的网页登录状态。Spotify 当前使用网页连接方式,具体步骤见 Spotify 使用指南。

如果插件提示登录失效:

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

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

安全注意事项

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

登录失败怎么办

可以按顺序检查:

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

如果仍然失败,请联系 技术支持。