第 4 章

同步后处理

2026-03-24更新 2026-09-11

微信读书同步完成后,插件会把同步结果、待办、书籍整理状态、历史批注、复习队列、主题和阅读数据分别整理出来。本章按“先确认结果,再整理内容,最后回顾数据”的顺序介绍同步后的使用方式。

授权、模板、位置标记和同步方式请先查看微信读书同步

首次使用建议先执行全部同步

如果是第一次使用“批注”“主题”或“复习”,建议先执行一次“全部同步”,建立完整的历史批注索引。之后日常使用“更新同步”即可;如果同步结果提示有遗漏或失败,先处理同步待办再继续整理。

第一步:查看同步结果与待办

同步结束后,先打开“同步结果与待办”,确认最近一次同步的状态和每个来源的处理结果。这里会分开呈现成功、失败、跳过,以及新增、更新、删除的数量;失败项目、未绑定书籍和需要诊断的项目也会单独列出。

微信读书同步结果与待办入口
从工作台进入同步结果与待办
微信读书同步结果与待办详情
最近更新、未绑定和失败项目会分开显示

建议先处理以下项目:

看到的项目下一步
未绑定书籍或公众号回到新来源确认或书籍管理,选择入库、绑定或忽略方式
同步失败打开失败详情和诊断信息,修正授权、模板、位置标记或数据问题后重试
有新增或更新继续查看书籍状态、批注和复习队列
全部或大量项目显示跳过先查看每项具体跳过原因。“无变化”属于正常结果;如果明确预期有新书却没有进入处理计划,再检查“跳过新书检查”、忽略设置和书籍绑定状态

第二步:查看书籍整理状态

在阅读工作台进入“书籍整理状态”,可以用搜索框按书名、ISBN 或 BookID 查找书籍;再用筛选项查看全部、未开始整理、待整理、整理中、已整理、有新增笔记或同步失败。页面会显示来源类型,但当前没有独立的按来源筛选控件。这个状态面向“同步内容是否已经整理”,和微信读书本身的阅读进度不是一回事。

整理状态适合表示的情况
未开始整理已经入库,但还没有开始处理这本书的同步内容
待整理有新增批注或同步内容,需要安排整理
整理中正在处理这本书的批注、想法或笔记
已整理当前一轮同步内容已经整理完成

同步后,页面会自动更新“有新增笔记”和“同步失败”等提示标签;“未开始整理”“待整理”“整理中”“已整理”这四个整理状态由用户按自己的工作流维护。整理完成后,可以在这里打开关联的读书笔记文档,检查位置标记后的同步区域,再把状态改成合适的值。

第三步:处理今日复习与复习队列

如果把重要的划线或想法加入复习,插件会在阅读中心提供“今日复习”和“复习队列”两个视图。今日复习只显示已经到期的内容,复习队列则包含全部仍在队列中的内容,并标出下次复习时间。

复习一条内容时,根据记忆情况选择对应结果:

选择作用
忘记记录本次复习结果,并按较短的下一间隔重新安排
模糊记录记忆不牢的结果,并按中间间隔重新安排
记住记录已经记住的结果,并按较长的下一间隔重新安排

按钮旁会预览三种结果对应的下一次间隔。复习卡片还可以打开原笔记;不想继续复习的内容可以选择“移出复习”,这只会移出队列,不会删除原笔记或历史批注。

第四步:整理历史批注

进入阅读资料库的“批注”页,可以集中浏览微信读书同步下来的划线和想法。可按内容、书名或章节搜索,也可以按批注类型、来源和书籍筛选,并按最新、最早或标题排序。每条批注都可以打开原笔记,或加入主题。

阅读资料库历史批注页面
在批注页搜索、筛选划线和想法,并打开原笔记或加入主题

首次使用或提示索引不完整时,先执行一次“全部同步”。普通书籍和公众号的历史批注都会在同步后建立索引;被设置为忽略的新来源不会参与后续同步。索引不完整时,页面应以提示为准,不要把当前结果当成全部历史内容。

第五步:用主题组织跨书阅读

“主题”页用于把不同书籍、不同来源中的批注聚合到一起。点击“添加主题”填写主题名称和说明,再从批注卡片或搜索结果中选择“加入”。一个批注可以放进多个主题,也可以在确认时选择移动到当前主题、保留原有主题归属。

阅读资料库主题页面
把批注加入主题后集中查看,并可复制为 Markdown

主题的日常整理方式:

  • 在主题列表中拖动每个主题左侧的六点手柄调整顺序,也可以使用 Alt+↑Alt+↓ 移动当前主题。
  • 删除主题只删除主题及其归属关系,不会删除原书籍、原笔记或批注;需要彻底清理时,仍要单独处理原内容。
  • 主题搜索以已经建立的历史批注索引为主要数据源,并补充阅读待办 Inbox 中尚未进入完整归档的新划线或想法。它不是整个思源知识库的全文搜索;历史索引覆盖不完整时,搜索结果也可能不完整。
  • 主题名称不能重复。新增归属时,遇到已经属于其他主题的批注,可以选择保留原主题并增加当前主题,或移动到当前主题。

主题内容可以打开原笔记,也可以复制成 Markdown,适合把一组跨书摘录整理成文章素材、复习清单或研究线索。

第六步:生成阅读周报与月报

阅读中心还提供“阅读周报 / 月报”。选择“周报”或“月报”后,插件会基于微信读书阅读统计和本地缓存,汇总这段时间的新增内容、待整理书籍、已整理书籍和阅读时长等信息,并可直接“复制 Markdown”。

这两种报告是本地统计报告,不是 AI 总结;如果统计缓存或同步数据不存在,报告会按当前可读取的数据展示,不应把空结果理解成没有阅读记录。

第七步:查看微信读书数据

“微信读书数据”是独立的数据统计页,不等同于本地阅读周报和月报。它会按周、月、年和总体等范围展示微信读书返回的阅读时长、阅读天数、读完书籍、偏好分类以及书籍排行等数据,更适合回顾一段时间内的阅读趋势。

微信读书阅读数据统计中心
按时间范围与图书维度查看微信读书统计

微信读书数据依赖最近一次成功获取的统计缓存;如果只更新了笔记而统计接口没有返回新数据,统计页和本地报告的更新时间可能不同。

下一步:MCP 与 AI 接入

完成同步整理后,如果希望让支持 MCP 的 AI 或 Agent 读取这些阅读数据,可以继续查看MCP 与 AI 接入。它只提供受限的只读业务数据,不会修改笔记或触发同步。

MCP 与 AI 接入
开启只读 MCP 服务,让外部 Agent 查询同步状态、批注、主题、复习队列和阅读数据。

常见问题

同步结果里有待处理项目

打开同步结果与待办,分别查看未绑定、失败和需要人工检查的项目。处理完成后,再执行一次更新同步确认结果。

批注页没有内容

批注索引来自微信读书同步。先确认 API Key 已验证,并执行一次“全部同步”;如果只完成了部分来源同步,页面会提示索引覆盖范围。

批注索引不完整

执行一次“全部同步”即可补全已经同步来源的历史批注。被忽略的新来源不会进入索引;如果仍有缺失,检查同步结果与待办中的失败项目。

复习内容为什么没有出现在今日复习?

只有已经加入复习队列且到达 nextReviewAt 的内容才会进入今日复习。尚未到期的内容可以在“复习队列”中查看;不需要继续复习的内容可以移出队列。

阅读数据没有更新

先确认本次同步已经成功完成,再执行一次更新同步。若仍然没有变化,打开同步结果与待办查看失败项目,并区分阅读数据缓存与本地周报/月报的更新时间。