读书笔记插件基础使用教程

✨ 4.0 版本更新

插件在4.0大版本更新后，同步支持了 全新的阅读总控台界面，实现了更加美观便捷的数据管理体验。

一、准备工作（配置数据库）

⚙️ 核心配置

在使用插件前，最重要的就是配置本地数据库，因为所有的 书籍信息 和 读书笔记文档都要跟随数据库而存在。

复制数据库块ID

🚨

注意是复制这个数据库所在块的ID，不是数据库ID。

将计划用于存储书籍信息的数据库块 ID，填入下面如图所示的位置。

填写数据库块 ID

💡

配置成功后会自动校验该数据库块ID是否可用。

📚 数据库字段

数据库，用于保存书籍的字段信息，包括如下表所示的内容。

✨

这些书籍元数据的字段不需要自己提前配置好，在书籍添加和同步的时候，会自动检测缺失并添加字段。

🚨 注意！！！

💡

使用自己已有的书籍数据库，若已经存在上述的某一个书籍元数据（即列名称一样），则必须将已有的列类型改成与插件一致，不然会导致添加书籍后识别错误，从而使已有数据库失效！！！

⚠️

若是隐藏列也不影响添加，因为隐藏列只是我们看不见了，数据库里还存在，所以隐藏的列也会添加进去。（同样的，若现有数据库有同名的隐藏列，需保持数据类型一致）这样我们就可以选择想要哪些书籍信息显示，而不会影响书籍的添加，以后想看了也可以显示出来查看。

二、插件核心功能

🚀 核心功能概览

插件致力于为您提供无缝的阅读管理体验，主要包含以下两大核心功能：

🟢

功能一：豆瓣图书搜索与添加

一键获取豆瓣书籍的元数据并添加入库，系统会根据您配置的模板，自动生成初始的读书笔记文档。

📝 说明：此功能为您搭建好完美的笔记框架，具体的读书笔记内容则需要您在阅读过程中自行记录完成。

🔵

功能二：微信读书笔记自动同步

深度整合账户，直接将您在微信读书上阅读时产生的划线与笔记内容自动同步至本地。

✨ 说明：彻底告别繁琐的手动复制与迁移，让系统自动为您沉淀所有的阅读灵感。

1. 豆瓣图书搜索与添加

🟢 豆瓣图书搜索与添加

在阅读总控台的头版书籍搜索框中，可以直接进行相应书籍的搜索，支持 ISBN、书名、作者名 等直接搜索。搜索完成后，可显示一个详细的书籍获取弹窗。确认后，将进行数据库字段的注入添加，并可选择生成读书笔记模板。

书名搜索示例

书籍元数据获取确认弹窗示例

💡

若使用

ISBN 号

搜索，则直接显示书籍元数据确认弹窗，因为一个 ISBN 固定对应一本书。

若是使用其他字符（如

书名、作者名

等）搜索，会在搜索框下面显示搜索结果，点击相应的书籍即可显示确认弹窗。

在书籍元数据详情弹窗中，有两个部分是需要自己提前进行配置的：

1. 读书笔记模板

2. 个人记录配置

📖 查看「读书笔记模板」设置教程 ➔

个人记录的配置需要提前在总控台中进行设置。如下图所示，每一项之间需要用逗号隔开（可以是英文或中文逗号）。

个人记录配置示例

✅

添加与生成

在确认好所有数据的原数据以及是否生成读书笔记文档之后，点击 添加书籍 即可在配置好的数据库中添加这本书的所有信息。

若勾选了生成读书笔记，则会在该数据库所在文档的子文档中，创建一个以书籍书名为名的文档作为读书笔记文档。这一步会自动获取书籍信息，并适配读书笔记模板进行内容生成。

封面会自动下载并保存在资源文件夹（笔记工作空间/data/assets）中的 covers 文件夹内，并以“书名_时间”的方式命名：

封面自动下载及命名规则示例

2. 微信读书笔记自动同步

🔵 微信读书笔记自动同步

⚙️ 必要的前置条件

为了确保微信读书笔记能够被正确地抓取并按照期望的格式生成文档，必须先完成以下两项前置配置：

1. 读书笔记模板

在同步微信读书笔记之前，最重要的一件事情就是配置相应的读书笔记模板。注意，微信读书有两种图书：书籍和公众号，需要分别设置模版。

📘 查看「微信读书笔记模板」设置教程 ➔

2. 专属 API 密钥 (Key)

此外，还需要配置自己的微信读书 API key。具体的密钥申请地址为：https://weread.qq.com/r/weread-skills，同时也可以直接在手机微信读书 APP 的设置中进行申请。

浏览器申请微信读书 API key

微信读书 APP 申请 API key

✅

完成上述的配置之后，即可开始微信读书笔记的同步了。

🔄 同步模式与操作

微信读书笔记的同步总共支持三种模式，您可以根据实际需求选择最合适的同步方式：

⚡

第一：更新同步

检测上一次同步的记录信息，验证是否新增了读书笔记，只同步有变更的书籍笔记内容。

🔄

第二：全部同步

不管本地有没有同步过相应书籍的读书笔记，都进行全量的更新替换。

🤖

第三：自动同步

每一次打开思源笔记时，系统会自动进行一次更新同步，无需手动干预。

微信读书笔记同步位置示例

📑 具体的同步过程与新书确认

在进行同步时，若检测到有新数据不存在于数据库、本地记录或笔记文档中，则会弹窗显示相应的新数据确认界面。您需要自行确定是否同步某一本书，同时还需要确定该书的同步方式。

微信读书笔记同步过程中的一些书籍确认弹窗

在新书确认中，主要需要确认的是同步方式，分为以下三种：

🏷️

第一种：使用 ISBN 同步

会调用豆瓣图书来获取元数据（因为其信息比微信读书更丰富）。

注意：

不是所有微信读书中的书籍都有 ISBN。对于没有 ISBN 的书籍，需要您自行填入相应的 ISBN 号之后，才能选择此方式同步。

🆔

第二种：使用 book ID 同步

若不想匹配豆瓣读书的 ISBN，可直接使用微信读书每本书特有的 book ID 进行标记同步。此时会在数据库中导入微信读书

特有的相关信息

。

🚫

第三种：忽略同步

意思是

不同步这本书

，以后都不再检测这本书，直接略过。

💡

若您不想每次同步都弹出新书籍确认窗口，但也不想“忽略”某些书（计划以后再同步），可以在同步选项设置中勾选跳过新书确认。这样在后续同步中将不再弹窗，仅自动执行现有书籍的增量或全部同步。

确定好同步方式后，在新书籍的确认弹窗中，共有两个按钮可供点击：

确认选择

确认当下选择的新书籍同步模式进行同步，

并对现有书籍进行同步

。

继续同步

忽略所有新书籍

，仅对现有书籍进行同步。

⚠️ 所以，如果要同步新书籍，请务必点击**“确认选择”**，而不是“继续同步”。

⏳

确认好同步信息之后，就可以等待同步完成了。此时您可以查看相应的同步进度和同步日志。

三、插件附加功能

1. 微信读书同步结果与待办

📊 同步结果与待办

微信读书同步结果与待办入口

在这里面，您可以快速查看和管理以下三类状态信息：

📝

最近同步了哪些笔记

🔗

哪些书籍没有绑定到本地

⚠️

哪些书籍是有问题的

微信读书笔记同步结果与待办示例

2. 书架中心与数据展示

📚 书架中心与数据展示

总控台中一共有 3 个标签页：上述的所有基本操作都是在第一个总控台标签页中进行，另外两个标签页则专门用于数据展示。

📖 这里的“书架中心”可以展示三种类型的书架：

🗂️

1. 本地书架

同步或导入到数据库中的书籍汇总展示。对于有读书笔记文档的，可以直接点击跳转到相应的读书笔记文档中。

📝

2. 有笔记书籍

在微信读书中有读书笔记的书籍，都会在这里以书架的形式展示。若某本书的笔记同步到本地过，则可直接点击跳转。

📱

3. 微信读书书架

即你微信读书加入书架上的书籍。注意：这里的书籍不一定有笔记，也不一定同步过；对于同步过、笔记本里有记录并绑定的，也可以点击打开。

书架中心示例

📈 微信读书数据中心

微信读书数据中心是用来展示个人微信读书数据的。它可以精准统计 每年 每月 每周 的阅读情况，以及具体书籍类型的阅读情况等。

所有数据均在这里进行了美观直观的图表化可视化展示，帮助您更好地复盘阅读历程。

微信读书数据统计中心示例