#微信读书 Pro 版配置教程

如果播放器无法加载，可以前往 B 站观看微信读书 Pro 版配置教程。

微信读书 Pro 版可以将书架、读过或做过笔记的书籍、划线、想法、阅读时长和阅读热力图同步到 Notion，并支持全量更新、数据修复和自动同步。

#开始前准备

开始配置前，请确认：

• 已安装并打开 NotionHub 浏览器插件。
• 浏览器中可以正常登录 Notion。
• 手机微信可以扫描微信读书登录二维码。
• 已有 GitHub 账号，或者可以使用 Google / Apple 账号登录 GitHub。

#1. 打开微信读书 Pro 版

1. 点击浏览器工具栏中的 NotionHub 插件图标。
2. 在同步服务列表中找到「微信读书」，点击进入。
3. 在微信读书配置页顶部选择「Pro 版」。

如果插件没有显示在工具栏中，可以先打开浏览器的扩展程序菜单，将 NotionHub 固定到工具栏后再操作。

#2. 登录并授权 Notion

第一次进入微信读书配置页时，插件会提示先登录 Notion。

1. 点击 Notion 登录入口，浏览器会打开 Notion 授权页面。
2. 选择要使用的 Notion 工作区，然后点击「下一步」。
3. 检查授权范围，选择「使用开发人员提供的模板」。
4. 点击「允许访问」，等待页面返回 NotionHub 插件。

完成后，配置页中的 Notion 账号会显示为已连接状态。

#3. 复制并连接微信读书模板

登录 Notion 后，需要复制 NotionHub 提供的微信读书模板。

1. 在配置页找到 Notion 模板区域，点击「去复制」。
2. 在确认弹窗中继续点击「去复制」，打开 Notion 模板页面。
3. 选择要保存模板的 Notion 工作区。
4. 选择「使用开发人员提供的模板」，然后点击「下一步」。
5. 点击「允许访问」，完成模板复制和授权。
6. 关闭授权页面并返回 NotionHub 插件。

请使用开发者提供的模板，不要改为自己的数据库或其他模板。其他模板的数据库名称和属性可能不一致，会导致同步失败。

#4. 使用微信扫码登录

模板连接完成后，继续绑定微信读书账号。

1. 在配置页找到「微信读书」账号区域，点击登录按钮。
2. 页面显示二维码后，使用手机微信扫描二维码。
3. 在手机上确认登录，等待浏览器显示登录成功。
4. 返回配置页，确认微信读书账号已经显示为已连接。

二维码具有时效性。如果二维码失效，请点击页面上的刷新按钮，获取新二维码后重新扫描。

#5. 连接 GitHub

NotionHub 使用 GitHub Actions 执行同步任务。第一次开始同步时，需要先完成 GitHub 授权。

1. 点击配置页底部的「开始同步」。
2. 出现 GitHub 授权提示后，点击「登录 GitHub」。
3. 已有 GitHub 账号时，直接登录并完成授权。
4. 没有 GitHub 账号时，可以选择使用 Google 或 Apple 账号登录 GitHub。
5. 页面显示「GitHub 授权成功」后，关闭授权页面并返回 NotionHub 插件。

返回配置页后，插件会自动完成 GitHub Runner 的连接和同步配置。首次初始化可能需要等待一小段时间。

#6. 开始第一次同步

确认 Notion、微信读书和 GitHub 都已经连接后：

1. 点击「开始同步微信读书」。
2. 等待插件成功创建 GitHub Actions 任务。
3. 点击运行记录，打开 GitHub Actions 页面。
4. 在任务详情中可以查看当前状态和正在执行的步骤。

微信读书任务会依次同步书籍、阅读时长、书单、公众号收藏等已启用内容。第一次同步的数据较多，通常会比后续增量同步耗时更长。任务进入 GitHub Actions 后，即使关闭插件页面，同步也会继续运行。

#7. 在 Notion 中查看同步结果

同步完成后，可以从配置页打开微信读书 Notion 模板，检查数据是否已经写入。

模板首页会展示阅读概览和阅读热力图。进入书籍数据库后，可以继续查看：

• 书架、读过和做过笔记的书籍。
• 单本书的作者、分类、阅读进度和阅读时长。
• 按章节整理的划线和想法。
• 最近阅读、年度统计和阅读热力图。

如果 GitHub Actions 已经成功，但 Notion 暂时还没有显示全部内容，可以等待一两分钟后刷新 Notion 页面。

#8. 激活 Pro 版

未激活用户可以先使用免费体验次数。需要继续同步或使用自动同步、通知等完整功能时，可以购买并输入 Pro 激活码。

1. 在微信读书 Pro 版配置页打开激活入口。
2. 按页面提示购买激活码。
3. 将收到的激活码粘贴到输入框中。
4. 点击「激活」。
5. 页面提示激活成功，并显示 Pro 状态后，即可继续同步。

激活码属于个人授权信息，请不要发布到截图、公开文档或聊天记录中。

#常见问题

#Notion 授权后仍然显示未连接

返回插件刷新页面后重试。如果仍然未连接，请重新进入 Notion 授权流程，并确认授权的是刚才复制模板所在的工作区。

#微信读书二维码无法使用

先确认二维码没有过期，再点击刷新二维码重新扫描。扫码后还需要在手机上完成确认。

#点击同步后没有立即看到数据

先打开运行记录，检查 GitHub Actions 是否仍在执行。第一次同步的数据量通常较大，请等待任务完成后再刷新 Notion。

#GitHub Actions 执行失败

打开失败的运行记录，展开带有错误标记的步骤查看原因。仍无法解决时，可以前往常见问题或联系支持。