teng-lin/weread-omni

解决的问题

weread-omni 提供了一个全面的非官方 SDK 和命令行界面（CLI），用于微信读书（微信读书），将平台的功能扩展到官方 Agent Skill 之外。官方 Skill 仅限于六种只读操作，而此项目支持超过 40 种读写操作，让用户能够自动化阅读工作流程、管理书库，并将微信读书数据集成到 AI 代理中。

运作方式

此项目基于微信读书 E-ink 屏幕设备所使用的 API 构建。它提供了三种与服务交互的主要方式：

1. CLI：一个命令行工具，可以输出 JSON，方便与其他脚本集成。
2. TypeScript SDK：一个完整类型的函数库，供开发者构建应用程序。
3. Agent Skill：一个预先配置的 Skill，允许 AI 代理（如 Codex 或 Claude Code）检查登录状态、执行读写操作，并处理分页。

用户通过扫描 QR code 并使用微信读书账号进行验证。此工具也维护一个本地内容库（使用 SQLite WAL）来缓存书籍信息、章节和公众号文章，以减少重复的网络请求。

适用对象

• 开发者：想要围绕微信读书数据构建应用程序或自动化。
• AI 代理用户：希望 AI 助手能与他们的书籍、笔记和划线互动。
• 高级用户：想要导出公众号文章、导入个人书籍（EPUB、PDF 等），或通过终端管理阅读列表。

亮点

• 扩展功能：支持添加、修改和删除划线和评论，这是官方 Skill 无法做到的。
• 内容导入：允许导入 EPUB、PDF、MOBI、TXT 和 AZW3 格式的个人文件。
• 公众号集成：能够阅读文章、订阅账号，并以 RSS、Atom 或 JSON 格式导出文章。
• AI 集成：直接访问「微信读书 AI」来询问特定书籍的问题。
• 本地缓存：内置本地书库，用于存储内容并避免重复下载。