第三方平台登录方式

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

常见登录类型

类型常见服务说明
扫码登录微信读书使用微信扫码确认登录
手机验证码小宇宙输入手机号,获取验证码登录
OAuth 授权Spotify、Strava、Trakt、YouTube跳转到官方授权页面,同意后返回插件
网页 CookieB 站、Flomo、多邻国、小红书等先登录平台官网,再由插件读取浏览器登录状态
API TokenToggl在平台官网复制 API Token 后填入插件
用户 ID豆瓣、不背单词等填写公开用户名或用户 ID
账号密码Keep、Forest 等在插件中输入平台账号完成登录

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

登录状态会过期吗

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

过期后常见表现:

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

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

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

通常不会。

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

OAuth 服务如何重新授权

Spotify、Strava、Trakt、YouTube 等服务使用 OAuth 授权。

如果授权过期:

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

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

B 站、Flomo、多邻国、小红书等服务通常依赖浏览器中的网页登录状态。

如果插件提示登录失效:

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

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

安全注意事项

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

登录失败怎么办

可以按顺序检查:

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

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