WeRead KOReader Plugin 是一款专为 KOReader 用户设计的第三方插件,它打破了平台壁垒,让你能够在 Kindle、Kobo、ReMarkable 等搭载 KOReader 的电子墨水设备上,直接浏览、下载并阅读微信读书中的书籍和公众号文章。
该插件不仅实现了内容的离线化阅读,更关键的是解决了阅读时长同步与进度同步的痛点,让电子墨水屏用户也能享受微信读书的社交激励与统计功能。
核心功能亮点
📚 书籍阅读与管理
- 书架同步:直接浏览微信读书云端书架,支持搜索、排序(按时间、书名等)及筛选(已读/未读、已下载/未下载)。
- 高质量转换:将在线书籍下载并转换为标准的 EPUB 格式。自动处理章节解码、CSS 样式优化、图片资源打包,并生成目录(TOC)和嵌入封面,确保在 KOReader 中获得最佳的排版体验。
- 笔记同步:自动下载并嵌入书中的划线和想法(笔记)。阅读时可一键显示/隐藏,点击划线即可查看详细想法内容,实现双向知识管理。
- 智能缓存:章节目录独立缓存为
catalog.json,支持手动刷新;元数据、阅读状态分别存储,便于本地管理。
📰 公众号文章阅读
- 离线阅读:浏览已关注的公众号列表,下载文章为内嵌图片(Base64)的 HTML 文件。
- 舒适排版:KOReader 可自由调节 HTML 字体大小与行距,解决手机端阅读长文疲劳的问题。
- 本地缓存:文章列表本地缓存,避免重复请求,节省流量与电量。
⏱️ 阅读时长上报(核心特色)
- 自动同步:默认每 30 秒向微信读书服务器上报一次阅读时长,确保你的“阅读成就”不丢失。
- 灵活模式:
- 自动关联:打开某本书时自动上报该书时长,关闭即停。
- 手动设置:指定一本固定书籍作为上报对象(适合挂机刷时长或听书场景)。
- 触发策略:支持「仅在翻页活动时上报」或「KOReader 启动即上报」,满足不同用户的需求。
- 状态监控:菜单中实时查看上报次数、最近时间及错误信息,透明可控。
📊 阅读统计完整移植
- 多维度数据:完整复刻微信读书 APP 的统计能力,支持按周、月、年及总维度查看阅读时长、阅读天数及阅读排行。
- 激励闭环:让电子墨水屏用户也能参与好友排名、领取体验卡等活动。
安装与配置指南
⚠️ 版本要求
请务必使用较新版本的 KOReader。已知 2024.11 版本存在兼容性问题,建议升级至 2026.3 或最新版以确保插件正常加载。
1. 安装插件
将插件目录 weread.koplugin 复制到 KOReader 的 plugins 目录下:
koreader/plugins/weread.koplugin/
重启 KOReader,在 「工具」 菜单中即可看到 「微信读书」 选项。
2. 登录与认证
插件采用安全的微信扫码登录机制,无需手动配置 Cookie 或 Token。
前置步骤:获取 API Key
- 打开手机微信读书 App。
- 进入 「我」→「设置」→「微信读书 Skill」。
- 点击 「获取 API Key」,确认生成个人官方 API Key。
扫码登录:
- 在 KOReader 中打开 「工具」→「微信读书」→「微信扫码登录」。
- 使用手机微信扫描二维码并确认。
- 若手机端显示四位验证码,请在 KOReader 界面中输入以完成配对。
适用人群
- 电子墨水屏重度用户:希望在 Kindle/Kobo 等设备上利用微信读书庞大书库的人。
- 护眼阅读倡导者:偏好 E-Ink 屏幕长时间阅读公众号长文,避免手机蓝光干扰。
- 微信读书成就党:离不开阅读时长统计、好友排名及体验卡奖励,但不愿被手机通知打扰。
- 离线阅读需求者:需要在无网络环境下(如飞机、地铁)阅读云端书籍的用户。