#X 同步到 Notion

NotionHub 可以把当前 X（Twitter）账号的本人帖子、喜欢和书签保存到 Notion。同一帖子出现在多个来源时，会合并记录对应的收录类型。

同步由你在插件中点击「开始同步」发起，需要浏览器保持运行。当前版本不提供浏览器关闭后的自动定时同步，也不保证读取到 X 未向当前账号返回的全部历史内容或回复。

#使用前准备

1. 安装最新版 NotionHub 浏览器插件并登录 Notion。
2. 打开服务列表中的「X」，点击「复制 Notion 模板」，完成 NotionHub X 的授权。
3. 按插件提示完成 GitHub 连接与同步仓库配置，用于查看本次同步的运行结果。
4. 点击「登录 X 账号」，允许插件访问 X 网站，然后在 X 官网完成登录。已经登录时，插件会识别当前账号。

X 站点访问权限在连接或同步时按需申请。你不需要复制 Cookie、输入 X 密码到 NotionHub，或购买 X API。

#开始同步

点击「开始同步」后，插件依次读取本人帖子、喜欢和书签，再分批提交到 Notion。同步时无需切换到 X 标签页。

首次同步会按本次读取上限获取内容；之后会利用上次成功写入 Notion 的记录检查新增内容。没有新增内容时正常结束。页面会区分读取进度、正在写入 Notion、完成、部分完成和失败，并显示新建与更新数量。

读取过程中可点击同步按钮上的停止图标取消。停止读取不会删除已经写入 Notion 的页面。

#模板内容

请保留模板中的 Post ID、原文链接和作者关系字段。同一账号重复同步相同 Post ID 时会去重；帖子在喜欢和书签中同时出现，不会因此创建两份页面。

#账号与内容保护

• 插件使用当前浏览器的 X 登录状态读取你主动选择同步的内容；连接所需凭据通过加密连接提交并加密保存，不要求你手动复制凭据。
• 不读取私信、通知或关注列表，不代你发帖、点赞或修改书签。
• 内容提交后会短期加密保存以完成写入，成功或取消后清除临时正文。
• 遇到登录失效、访问被拒绝、限流或接口变化时停止同步，不绕过验证码或访问限制。

#常见问题

#提示重新登录

先在 X 官网确认当前账号能够正常访问，再回到插件点击「重新检测」。如果刚授予站点权限，也可以重新检测后再同步。

#提示限流或暂时不可用

本次读取已停止，请稍后重试。不要连续点击同步；临时限制不代表 Notion 模板损坏。

#为什么内容没有全部出现

结果取决于 X 对当前账号提供的内容、本次读取上限和接口可用性。已删除或无权访问的帖子、部分历史内容与回复可能无法返回。遇到接口变化时会安全停止，不能把部分读取当成完整历史备份。

#提示模板未就绪

检查「帖子」和「作者」数据库是否保留在已授权模板中，按插件提示重新授权或复制模板，然后再试。X 使用独立的 Notion 连接。

#为什么显示部分完成

查看结果中的失败数量并检查模板和账号状态。已经成功写入的页面会保留；媒体源失效或可选资源不可用时，正文可能已经写入。