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

# 快速开始

这篇文档适合第一次使用 NotionHub 的用户。你可以先按这里完成一次完整同步，再去看具体服务的详细教程。

## 使用前准备

开始前请确认：

- 已安装 Chrome、Edge 或 Firefox 浏览器。
- 已登录自己的 Notion 账号。
- 已安装 NotionHub 浏览器插件。
- 已准备好要同步的平台账号，例如微信读书、豆瓣、小宇宙、Keep 等。

如果还没有安装插件，请先看 [安装插件](https://www.notionhub.app/docs/install.md)。

如果你还不熟悉 Notion 授权和模板复制方式，可以先看 [Notion 模板与授权](https://www.notionhub.app/docs/notion-template.md)。

## 第一步：打开插件

点击浏览器工具栏中的 NotionHub 图标，进入服务列表。

如果没有看到插件图标，可以在浏览器扩展管理页面中把 NotionHub 固定到工具栏。

## 第二步：选择同步服务

在服务列表中选择你想同步的平台，例如「微信读书」「豆瓣」「小宇宙播客」。

每个服务都需要单独完成配置。一个服务配置完成后，不会影响其它服务。

## 第三步：激活或免费体验

如果你已经购买激活码，在插件中输入激活码并点击激活。

如果服务支持免费体验，也可以先完成一次免费同步。免费体验次数用完后，插件会提示「免费体验次数已用完，请购买激活码」，点击「购买激活码」即可打开激活窗口。

购买说明见 [获取激活码](https://www.notionhub.app/docs/get-activation-code.md)。

## 第四步：复制 Notion 模板

点击插件中的「复制 Notion 模板」按钮，Notion 会打开授权页面。

新用户推荐选择「使用开发人员提供的模板」。Notion 会把官方模板复制到你的工作区，并授权给 NotionHub。

老用户如果想继续使用已有模板，可以在 Notion 授权页选择自己的模板页面。选择自己的模板时，如果插件要求提交模板链接，请打开对应 Notion 页面，复制页面链接后提交。

## 第五步：登录第三方平台

不同服务的登录方式不同：

- 微信读书：使用微信扫码登录。
- 小宇宙：跳转到小宇宙官方账号页完成登录；短信和安全验证都在官网处理。
- 豆瓣：输入豆瓣用户名。
- Flomo、B 站、多邻国等：通过网页登录状态或 Cookie 授权。
- Toggl：填写 Toggl API Token。
- 不背单词：填写用户 ID。

登录完成后，插件会保存同步所需的凭证。凭证过期时，插件会提示你重新登录。

更完整的登录方式说明见 [第三方平台登录方式](https://www.notionhub.app/docs/service-login.md)。

## 第六步：开始同步

点击「开始同步」后，任务会在服务器或你的 GitHub Action 中运行。关闭浏览器、电脑或插件窗口，不会影响已经触发的同步。

同一个服务同一时间只保留一个同步任务。如果你重复点击运行，新的任务会自动取消旧任务，避免重复写入数据。

## 第七步：查看结果

同步完成后，打开 Notion 模板查看数据。

首次同步可能需要几分钟，数据量大或包含图片、音频、视频上传时会更久。后续同步通常会更快。

## 下一步

- 想调整同步范围、热力图或通知：查看 [同步设置](https://www.notionhub.app/docs/sync-settings.md)。
- 想了解图片、音频和视频上传：查看 [图片、音频和视频上传](https://www.notionhub.app/docs/media-upload.md)。
- 想看任务是否成功：查看 [运行状态与排错](https://www.notionhub.app/docs/sync-status.md)。
- 插件提示绑定 GitHub：查看 [GitHub Action 同步](https://www.notionhub.app/docs/github-action.md)。
- 需要单个平台教程：从左侧「使用指南」中选择对应服务。