WeReadMaster | RHZ 博客

type

Post

status

Published

date

Sep 5, 2026

slug

/2026/09/04/wereadmaster

summary

0. 先看这一张图

你可以把应用理解成四步：

同步：把微信读书数据或本地图书带入本地工作区。

阅读与整理：维护候选、进度、整理状态、划线和想法。

生成成果：主动生成书籍复盘、阅读指南、阅读路线、周期复盘或报告图片。

导出与备份：把已有成果带到 Markdown、Obsidian、Notion，或按预览边界发布到 IMA，再执行本地备份。

有新笔记或新进度时，回到前面的阶段刷新即可。导出不是同步，生成成果也不会在后台自动发生。

1. 第一次使用：完成最小闭环

1.1 选择运行环境

能力	Windows 桌面端	Android	Web Preview
查看已同步内容	支持	支持	查看已准备数据
微信读书同步	支持	支持	不支持
微信书架、候选书架	支持	支持	只读查看
本地书库与阅读器	完整能力	移动阅读优先	不支持本地命令
主动生成成果	支持	以当前入口和配置为准	不支持
文档导出	支持	按移动端能力	不支持桌面导出
SQLite 备份与恢复	支持	按移动端能力	不支持
应用更新	应用内更新或下载安装包	下载 APK 后按系统安装	不适用

Web Preview 只能查看已经准备好的阅读数据和成果，不能写入阅读状态、执行导出、调用 AI 或执行本地命令。

1.2 安装和配置凭据

从 GitHub Releases 下载 Windows x64 安装包或 Android 签名 APK。

打开 设置 > 账户与同步。

按微信读书官方页面获取并保存 API Key。

确认页面显示凭据状态正常。

不要把 API Key 放入笔记、诊断信息、截图或导出文档。

页面只显示凭据状态，不显示已保存的 Key 正文。删除凭据不会自动删除已经同步到本机的书架、笔记和统计缓存。

1.3 同步第一批数据

进入 书架，点击 同步书架。

需要划线和想法时，进入 笔记 执行笔记同步。

需要阅读趋势时，进入 统计 同步当前周期数据。

等待结果提示完成，再开始生成成果。

同步结果进入本地缓存。没有远端数据变化时，仍可继续查看已经同步的内容。

1.4 配置 AI（可选）

如果要生成书籍复盘、阅读指南、阅读路线、周期复盘、选书决策或使用 AI 阅读助手：

打开 设置 > AI 设置。

选择 Provider 预设，或配置自定义 Provider。

填写模型和 API Key。

先测试连通性，再测试结构化输出兼容性。

模型列表刷新失败时，可以按照服务商文档手动填写模型名称。

AI 只在你主动触发具体动作时处理对应上下文，不会在后台自动生成。

1.5 先完成一次最小成果

推荐选择一本已经有划线或想法的书：

在 书架 或 笔记 中打开书籍详情。

确认笔记数量和材料内容已经可见。

点击 本书阅读指南，确认下一步读法。

进入 书籍复盘，生成一次 快速复盘（抽样）。

在成果页查看结果，并尝试导出一份 Markdown。

2. 看懂数据来源和保存位置

应用中有三类容易混淆的数据来源：

数据类型	来源	典型内容	默认保存方式
微信读书数据	你的微信读书账号	书架、笔记、统计、发现结果	同步到本地数据库或缓存
本地图书数据	你导入的文件	EPUB、TXT、Markdown、进度、划线、想法	本地书库与浏览器/WebView 存储
AI 阅读成果	你主动生成或记录	书籍复盘、阅读指南、阅读路线、周期复盘、选书决策、助手对话	本地成果缓存和导出目录
IMA 发布内容	你主动选择 IMA 导出的快照	IMA 笔记，以及可选的知识库关联	写入 IMA 远端；不会自动回写本地

本地图书与微信书架是两个来源版本：

可以人工关联，用于识别“可能是同一本书”；

不会自动合并进度、划线、想法或 AI 缓存；

本地图书的阅读记录不会写回微信读书。

三个关键边界：

打开导出窗口不会自动同步、调用 AI 或生成缺失成果。

SQLite 备份不包含凭据、语义向量、索引任务记录和 WebView 阅读器记录。

Web Preview 不写入状态、不执行本地导出、不触发 AI。

3. 管理书架和阅读状态

3.1 微信书架

进入 书架 > 微信书架。

用类型、分类、书单和关键词筛选。

搜索书名、作者或分类。

打开详情查看阅读状态、笔记和成果入口。

根据需要标记阅读状态或整理状态。

支持的书架范围以当前应用页面为准，通常包括电子书、有声书和文章收藏等类型。

3.2 候选书架

候选书架只保存本机的候选关系，不写回微信读书。

推荐流程：

在 发现 中搜索书名、作者或主题词。

查看推荐、相似书或搜索结果。

将合适的书保存到候选书架。

在 候选书架 中确认、移除或搜索书源。

需要做下一本取舍时，点击 生成选书决策。

3.3 本地书库

本地书库用于导入自己拥有的 EPUB、TXT 和 Markdown 文件：

进入 书架 > 本地书库。

选择文件或粘贴路径。

导入后使用网格或列表视图浏览。

打开书籍进入本地阅读器。

如需识别同一本书，可关联微信读书版本，但不要把关联理解为自动合并。

3.4 三维阅读状态

一本书的状态拆成三个互不覆盖的维度：

因此：

标记“读完”不等于“已整理”；

标记“已整理”不会移除候选关系；

加入候选不会覆盖当前阅读进度；

修改一个维度不会清除另外两个维度。

推荐使用方式：

还没决定是否阅读：保留候选关系，生命周期设为想读。

正在阅读：生命周期设为在读；有内容需要处理时，再标记待整理。

已读完但还没整理：生命周期设为读完，整理进度仍为待整理。

成果已经确认并保存：整理进度改为已整理。

暂时不再继续：使用暂缓，不要把暂缓当作物理删除。

4. 使用本地阅读器

从本地书库打开书后，可以使用：

字号和行距调整；

阅读主题；

正文搜索；

工具侧栏。

Markdown 图书支持标题、引用、列表、分隔线和代码块等基础渲染。