第三方平台登录方式

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

常见登录类型

类型	常见服务	说明
扫码登录	微信读书	使用微信扫码确认登录
手机验证码	小宇宙	输入手机号，获取验证码登录
OAuth 授权	Spotify、Strava、Trakt、YouTube	跳转到官方授权页面，同意后返回插件
网页 Cookie	B 站、Flomo、多邻国、小红书等	先登录平台官网，再由插件读取浏览器登录状态
API Token	Toggl	在平台官网复制 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。如果刷新失败，才会要求你重新授权。

Cookie 登录服务如何更新状态

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 日志是否明确提示登录失效。

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