WeRead KOReader Plugin

免责声明：本项目仅供个人学习和技术研究使用，不得用于商业用途。使用本项目所产生的一切后果（包括但不限于账号封禁、数据丢失等）由使用者自行承担，项目作者概不负责。请遵守微信读书的用户协议和相关法律法规。

在 KOReader 上阅读微信读书中的书籍、公众号文章的插件。支持同步进度同步，阅读时长同步和统计，查看书评、划线和想法。让Kindle、Kobo等封闭系统设备也能体验微信读书！

安装

⚠️ 建议使用 KOReader 2026.03 或更高版本。旧版本可能无法正常加载或使用插件，例如「工具」菜单中找不到「微信读书」。详见 #14。

1. 前往 GitHub Releases 下载最新的 weread.koplugin-vX.Y.Z.zip 安装包。
2. 解压安装包，得到 weread.koplugin 文件夹。
3. 将该文件夹复制到 KOReader 的 plugins 目录：

koreader/plugins/weread.koplugin/

4. 重启 KOReader，在菜单中找到：

工具 → 微信读书

后续更新插件可在 微信读书 → 设置 → 更新管理 菜单中在线更新。

登录与认证

插件只支持微信扫码登录，扫码前需要先为账号开通微信读书 Skill：

1. 手机打开微信读书 App。
2. 进入 我 → 设置 → 微信读书 Skill。
3. 点击 获取 API Key，确认已经生成个人官方 API Key。
4. 在 KOReader 打开 工具 → 微信读书 → 微信扫码登录。
5. 使用微信扫码并在手机端确认；若手机显示四位验证码，请在 KOReader 中输入。

功能

主菜单	书架	公众号

阅读时间上报	阅读统计	阅读进度同步

多选章节下载	章节预下载	下载全书

书籍详情	书评	划线和想法

搜索书籍	快捷菜单	设置

SimpleUI / Zen_UI 集成

插件提供统一的“微信读书书架”入口并支持集成到 SimpleUI和 ZenUI的快捷按钮中。(需要安装最新版 SimpleUI 和 ZenUI插件)。

• SimpleUI：进入 快捷操作 新建操作，类型选择 插件 → 微信读书，再把该操作加入底部栏即可。如需使用本项目图标，将 icons/weread-w-book.svg 或 icons/weread-ink.png 复制到 SimpleUI 的自定义图标目录koreader/setting/simpleui/sui_icons后，在快捷操作中选中它。
• Zen_UI 底栏：进入 控件 → 按钮 → ➕ → 插件 → 微信读书，点击后直接打开微信读书书架。注册时会把 weread-w-book.svg 同步到 KOReader 用户图标目录，供 ZenUI 自动匹配或手动选择；不会自动修改、添加或启用 Tab。
• Zen_UI 首页：进入 主页 → 小组件，启用“微信读书”组件。组件默认关闭，可由用户自行排序。

原生 KOReader 的 “工具 → 微信读书” 菜单保持不变。

SimpleUI	Zen_UI

菜单结构

微信读书
├── 微信扫码登录 / 已经登录 · 账号名
├── 立即同步进度       （阅读微信读书缓存书籍时显示）
├── 书籍详情           （阅读微信读书缓存书籍时显示）
├── 显示划线和想法     （阅读书籍时显示，开关）
├── 划线和想法管理     （本地书与微信下载书共用；不修改 EPUB/KOReader 笔记）
│   ├── 匹配微信读书书目 / 已关联微信书籍：书名（下载书自动关联）
│   ├── 继续匹配（显示完成章节和划线条数）
│   ├── 选择章节匹配
│   └── 清理划线和想法（再次匹配时下载最新数据）
├── 书架               书籍 / 公众号 Tab；书架内搜索、离线缓存、手动更新
├── weread收藏夹        已下载书籍（不包含单章）的本地入口
├── 搜索               搜索微信读书
├── 阅读时间上报        后台上报阅读时长
│   ├── 启用阅读时间上报
│   ├── 仅在阅读时上报
│   ├── 选择目标书籍
│   │   ├── 自动关联微信读书书籍
│   │   └── 手动设置上报书籍
│   └── 上报状态
├── 阅读统计            阅读时长/天数/排行/偏好可视化（页内 周/月/年/总 tab 切换，可翻阅历史周期）
├── 设置
│   ├── 书架视图
│   │   ├── 列表模式（默认；适合连续滚动）
│   │   └── 封面模式（按屏幕自适应行列；仅加载当前页封面）
│   ├── 分页书架（仅列表模式；默认开启，关闭后使用连续滚动）
│   ├── 缓存管理
│   │   ├── 扫描并关联本地书籍
│   │   ├── 缓存清理
│   │   └── 缓存目录
│   ├── 进度管理
│   │   ├── 打开时拉取进度（默认关闭）
│   │   └── 关闭时上传进度（默认关闭）
│   ├── 下载设置
│   │   ├── 书籍图片（默认开启）
│   │   ├── 公众号文章图片（默认关闭）
│   │   ├── 隐藏脚注文本（默认关闭；开启需同时启用 KOReader 脚注弹框；仅影响新下载书籍）
│   │   └── 章节预下载
│   │       ├── 自动预下载下一章（默认关闭，开启时会确认网络卡顿风险）
│   │       ├── 预下载划线和想法（默认关闭，总开关关闭时不可操作）
│   │       └── 显示预下载提示（默认开启，总开关关闭时不可操作）
│   ├── 划线设置
│   │   ├── 划线边缘防误触（默认开启）
│   │   ├── 边缘区域：20%（可调 10%–40%）
│   │   └── 想法弹窗设置
│   │       ├── 位置：居中（可切换为 底部）
│   │       ├── 高度：62%（可调 20%–90%）
│   │       ├── 宽度：80%（仅居中时可用，40%–100%）
│   │       ├── 字体大小（相对文档字号，默认 -2；可切换为绝对字号）
│   │       ├── 字体对比度：默认（可调 -3–+9，最大为纯黑）
│   │       └── 点击左右区域翻页（默认关闭，底部与居中弹窗均生效）
│   │   └── 想法弹窗宽度：80%（仅居中时可用，40%–100%）
│   ├── 账号管理
│   │   ├── 账号状态
│   │   ├── 立即续期 Cookie
│   │   └── 清除账号数据
│   └── 关于
│       ├── 版本 x.y.z
│       ├── 作者：finlater
│       ├── 检查更新
│       ├── 每天自动检查一次（默认关闭）
│       └── 更新时优先使用代理（默认开启；代理失败会自动回退 GitHub）

贡献

欢迎提交 issue 和 PR。提交前请阅读 CONTRIBUTING.md。

XPointer 外部标注层仍是实验性功能，测试步骤和限制见 原型说明。

许可证

本项目代码采用 GNU Affero General Public License v3.0，SPDX 标识为 AGPL-3.0-only，与 KOReader 使用的许可证保持一致。

修改、整合或再分发本项目时，必须遵守 AGPL-3.0，保留版权和许可证声明，并按许可证要求将本项目代码或其衍生作品开源。

fonts/NotoEmoji-Regular.ttf 是第三方字体，采用 SIL Open Font License 1.1，不适用本项目的 AGPL-3.0。

Copyright © 2026 finlater and contributors.

项目推荐

插件	简介
kindlebtcontroller.koplugin	蓝牙手柄/遥控器控制 Kindle —— 翻页、调节亮度、章节跳转等 20+ 操作，按键完全可自定义。
one.koplugin	在 KOReader 上离线阅读「ONE · 一个」每日更新：一图、一文、一问答。

划线和想法同步

下载只保存正文，不再选择“含划线和想法”的版本。阅读时点击“显示划线和想法”： 微信下载书自动绑定原书，本地导入书先选择微信书目，再逐章下载、匹配并保存。 同一本微信书的单章、选章合集和全书共用注释数据库及下载断点；只有 XPointer 定位缓存与具体文件关联。暂停、关书、断网后可继续已保存的章节和批次。

仅处理当前文件实际包含的章节。启用本书同步后，自动预下载会先保存下一章正文， 再准备该章共享注释；打开该章后自动生成定位缓存。可在下载设置全局关闭注释预准备， “隐藏划线”只改变显示。快捷动作“微信读书·显示/隐藏划线和想法”沿用原绑定； 新覆盖层采用较淡的短虚线。

“继续匹配”复用缓存；需要重新获取数据时，先清理划线和想法，再重新匹配。 旧版内嵌划线书籍在迁移完成前保留旧显示，不强制重新下载。