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

# 即刻同步到 Notion

NotionHub 可以把自己在即刻发布的动态整理到 Notion，保存文字、原文链接、话题和可获取的图片视频，用于回顾个人记录。

## 可以同步什么

| 内容      | 在 Notion 中查看              |
| ------- | ------------------------- |
| 本人原创动态  | 正文、作者、创建时间和原文链接           |
| 本人转发动态  | 自己的转发内容，以及可获取的原动态内容、作者与链接 |
| 话题与分享链接 | 话题信息、分享链接和可获取的链接标题        |
| 互动数量    | 动态的点赞数、评论数和转发数            |
| 图片与视频   | 可用媒体、上传成功的附件，以及模板中对应的资源记录 |

**当前仅同步本人动态，不采集点赞列表、收藏列表、评论区正文、私信或他人的完整动态列表。**「点赞数」「评论数」是本人动态的统计信息，不代表导入了点赞行为或评论内容。

## 使用前准备

- 安装最新版 [NotionHub 浏览器插件](https://www.notionhub.app/docs/install.md)，并登录 NotionHub。
- 在安装插件的同一个浏览器中，能正常登录 [即刻网页版](https://web.okjike.com/)。
- 准备自己的 Notion 工作区，使用插件提供的即刻模板。
- 按插件提示连接 GitHub，参见 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 确认服务有可用体验次数或已激活，具体范围以插件显示为准，参见 [免费体验与激活](https://www.notionhub.app/docs/free-trial.md)。

即刻入口位于插件服务列表。若找不到，先核对安装版本并更新插件。

## 第一步：复制并授权 Notion 模板

1. 在服务列表选择「即刻」。
2. 在「Notion 模板」卡片点击「去复制」。
3. 在 Notion 授权页选择开发者提供的模板，确认工作区并允许访问。
4. 返回插件，等待显示「已配置」，再点击「打开模板」检查。

已有即刻模板可以继续授权使用。如果提示提交模板链接，提交自己工作区里的模板页面链接。

请保留动态数据库中的标题、Post ID、正文、原文链接和日期等字段。Post ID 用于去重；标签、资源和日期关系需要相应数据库。可以调整视图和排序，更多说明见 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第二步：连接即刻账号

1. 在「即刻账号」卡片点击「去登录」。
2. 允许插件请求的即刻网站及相关服务访问权限。
3. 如果打开即刻官网，先完成网页登录，再刷新页面，确认能够查看自己的动态。
4. 返回插件，再次点击「去登录」，让插件读取并保存当前账号连接。
5. 核对显示的账号，确认卡片显示「已登录」。

已在网页中登录时，插件可能直接完成连接。只在手机 App 中登录不能替代网页登录；无需手动复制登录凭据。

需要更换账号或重新登录时，点击「重新登录」，在官网完成登录后返回插件再次点击「去登录」。完成网页登录和返回插件保存连接是两个步骤。

## 第三步：检查同步设置

首次使用可以保留默认设置。当前范围固定为本人动态，不需要选择额外模块，也没有点赞或收藏列表的同步开关。

可在「同步设置」中查看通知等可用选项。图片和视频随动态处理，当前即刻页面没有单独的「上传视频等大文件」开关。

默认每天自动同步一次，也可以手动运行。自动同步需要有效的账号连接、完整的 GitHub 配置和可用的服务权益，具体安排以插件显示为准。

## 第四步：开始同步并查看结果

完成模板与账号连接后，点击「开始同步」。如果提示连接 GitHub，点击「连接 GitHub」并按引导完成授权。

通过插件运行记录或对应的 GitHub Action 查看结果。任务未结束时，避免重复启动。完成后打开 Notion 模板，检查：

- **动态库**：本人原创与转发动态，收录类型为「本人发布」。
- **动态正文**：文字、可获取的转发上下文、分享链接和媒体。
- **关联信息**：模板保留相应数据库时的标签、资源及日期关系。
- **附件与同步状态**：是否有媒体保存失败，导致标记「部分完成」。

同步按 Post ID 识别同一条动态，后续读取到已有记录时更新属性，不会重新创建一页。已有页面的正文内容不会在每次同步时自动重建；在即刻修改了旧动态，也不能据此保证 Notion 页面正文立即完全一致。

## 历史数据与媒体限制

普通同步在连续遇到已同步动态后会提前结束。需要检查较早记录时，可以在权益允许的情况下点击「全量同步」。全量同步会继续向前读取，但仍受单次分页上限、即刻当前可见范围及访问限制影响，不保证一次导入全部历史。

图片和视频会尝试保存为 Notion 文件。上传失败时，新建页面会保留可获取的外部媒体链接，并可能标记「部分完成」；这通常意味着文字已经写入，但附件尚未完整保存。外部媒体链接可能失效，Notion 工作区也有文件限制，参见 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。

普通同步和「全量同步」不会因为源动态删除或不可见而自动删除已有 Notion 页面。在 Notion 中修改动态也不会回写即刻。

## 常见问题

### 官网已经登录，为什么插件仍显示待登录？

确认使用同一个浏览器，并已允许插件访问即刻网站。刷新已登录的即刻网页，再回插件点击「去登录」。只完成官网登录而没有返回插件再次连接，账号可能尚未保存。

### 为什么只有自己的动态，没有点赞、收藏和评论？

这是当前同步范围。系统只读取当前账号的本人动态，并核对作者身份；全量同步也不会增加点赞、收藏、评论或他人的动态来源。

### 为什么旧动态或修改后的正文没有补全？

先检查最近运行是否成功以及体验条数限制。普通同步只检查近期范围；权益允许时，可以用全量同步检查更早的动态，但仍无法突破平台可见范围和单次读取上限。已有页面的属性更新与正文重建不同，全量同步不保证覆盖重写已有正文。

### 登录失效、安全验证或频率限制该怎么处理？

登录失效时，按「重新登录」流程完成官网操作，并回插件再次连接。安全验证在即刻官网完成；访问频率受限时，稍后再试，避免反复启动任务。

模板提示未就绪时，检查授权和动态数据库字段是否完整。仍有问题时，查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md) 或联系 [技术支持](https://www.notionhub.app/docs/support.md)。