teng-lin/weread-omni

解决的问题

weread-omni 提供了比官方 Agent Skill 更广泛的 WeChat Reading（微信读书）交互能力。官方技能仅限于六项只读操作，而本项目支持超过 40 项读写操作，使用户能够管理书架、编辑笔记、导入个人书籍，并以编程方式与平台的 AI 功能进行交互。

工作原理

该项目作为非官方 SDK 和 CLI 工具运行。它使用基于二维码的登录系统进行用户认证。认证后，提供三种主要交互接口：

• 命令行界面（CLI）：用于执行特定阅读和写入任务的工具，可将结果以 JSON 格式输出。
• TypeScript SDK：用于将 WeChat Reading 功能集成到其他应用程序的完全类型化库。
• Agent Skill：预定义的技能集，允许 AI 代理（如 Codex 或 Claude Code）检查登录状态、调用 CLI，并处理写入操作的分页和确认。

此外，还包含一个基于 SQLite WAL 的本地内容库，用于缓存书籍信息、章节和公众号文章，以减少重复的网络请求。

适用人群

• 希望基于 WeChat Reading 数据构建应用的 开发者。
• 希望自动化阅读习惯、导出公众号内容或通过命令行管理图书馆的 高级用户。
• 希望赋予 AI 助手读取和管理 WeChat Reading 账户能力的 AI 代理用户。

主要亮点

• 功能全面：支持 40 多项操作，包括添加/编辑/删除书签和评论，这些在官方技能中不可用。
• 内容导入：支持导入个人书籍，格式包括 EPUB、PDF、MOBI、TXT 和 AZW3。
• 公众号集成：可阅读、订阅并导出 WeChat 公众号的资讯流。
• AI 集成：可直接访问 WeChat Reading AI 的「问书」和推荐功能。
• 本地缓存：内置本地图书馆，用于存储内容并减少 API 调用。