Obsidian 微信读书插件 2.0 发布

前言

四年前，我在 GitHub 上发布了 Obsidian 微信读书插件的第一个版本。初衷很简单——我希望微信读书里的划线和笔记，能自动同步到 Obsidian 这个我信赖的「第二大脑」里，而不是被锁在 App 中吃灰。

四年过去，这个小小的插件收获了2100+ Star、132 个 Fork、累计几十万次下载。感谢每一位用户的支持和反馈。

今天，2.0 版本正式发布。这不是一次小修小补，而是从认证机制到底层架构的全面重塑。

为什么要有 2.0？

微信读书的 Cookie 有效期不稳定，有时候能用一个月，有时候一周就掉了。虽然我陆续加了被动刷新、CookieCloud 同步等方案，但这些都是「打补丁」——只要认证方式基于 Cookie，这个痛点就始终存在。

转机出现在今年。微信读书开放了Agent API，支持通过 API Key（Bearer Token）进行认证。API Key 长期有效，这意味着插件可以彻底告别 Cookie 有效期的困扰，而且用户可以在手机、平板电脑等移动端独立使用插件。

同时，Agent API 还提供了一批全新的接口：热门划线、书架同步、公开书评、更丰富的阅读统计数据，V1 的 Cookie API 无法支持这些功能。

于是，2.0 应运而生。

获取方式：在设置页点击「扫码获取」按钮即可。如果你已经用微信读书网页版登录过，会自动获取 Key；如果没登录，会弹出二维码窗口，扫码完成登录后 Key 自动填入。

移动端：由于扫码需要 Electron 环境，移动端自己访问weread-skills页面，手动复制API KEY 粘贴即可。

这是 V2 最令人兴奋的新功能。

微信读书每本书都有一个「热门划线」榜单——被最多读者标记的段落。现在你可以把它们同步到自己的笔记里了。

在合并式模板中，热门划线会和你的个人划线融合在一起：

在分离式（含热门划线）模板中，热门划线会独立展示为一个区块，按章节分组。

性能怎么保证？

每次同步访问几十上百本书，每本书又要查多个章节的热门划线。为此做了三层优化：

并发查询：每批 5 个章节并行请求，不阻塞

本地缓存：热门划线缓存到 .weread-cache/ 目录，默认 7 天有效期

TTL 可控：在设置中可调整缓存天数

只要缓存没过期，第二次同步就是秒级完成。

点击书架上的书籍封面或标题，会在新标签页打开一个完整的详情视图：

划线 Tab：按章节分组展示，每张卡片左侧有颜色边线（对应微信读书的划线颜色——黄/蓝/绿/红/紫），显示创建时间和位置，可以 deeplink 跳转到微信读书 App 或者一键复制原文

笔记 Tab：所有个人想法和注解，按时间倒序排列，显示引用原文

热门划线 Tab：社区热度最高的段落（需 API Key），按章节分组，显示划线人数

书评 Tab：你的个人书评 + 社区精选公开书评

右下角悬浮按钮可快速跳转本地 Markdown 文件。

Happy Reading, Happy Thinking.📚💭