WeRead KOReader Plugin

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

1. 打开手机微信读书 App。
2. 进入 「我」→「设置」→「微信读书 Skill」。
3. 点击 「获取 API Key」，确认生成个人官方 API Key。

扫码登录：

1. 在 KOReader 中打开 「工具」→「微信读书」→「微信扫码登录」。
2. 使用手机微信扫描二维码并确认。
3. 若手机端显示四位验证码，请在 KOReader 界面中输入以完成配对。

适用人群

• 电子墨水屏重度用户：希望在 Kindle/Kobo 等设备上利用微信读书庞大书库的人。
• 护眼阅读倡导者：偏好 E-Ink 屏幕长时间阅读公众号长文，避免手机蓝光干扰。
• 微信读书成就党：离不开阅读时长统计、好友排名及体验卡奖励，但不愿被手机通知打扰。
• 离线阅读需求者：需要在无网络环境下（如飞机、地铁）阅读云端书籍的用户。