前言
四年前，我在 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 应运而生。
V2 核心变化
API Key 认证体系
获取方式：在设置页点击「扫码获取」按钮即可。如果你已经用微信读书网页版登录过，会自动获取 Key；如果没登录，会弹出二维码窗口，扫码完成登录后 Key 自动填入。
移动端：由于扫码需要 Electron 环境，移动端自己访问weread-skills页面，手动复制API KEY 粘贴即可。
热门划线同步 🔥
这是 V2 最令人兴奋的新功能。
微信读书每本书都有一个「热门划线」榜单——被最多读者标记的段落。现在你可以把它们同步到自己的笔记里了。
在合并式模板中，热门划线会和你的个人划线融合在一起：
在分离式（含热门划线）模板中，热门划线会独立展示为一个区块，按章节分组。
性能怎么保证？
每次同步访问几十上百本书，每本书又要查多个章节的热门划线。为此做了三层优化：
并发查询：每批 5 个章节并行请求，不阻塞
本地缓存：热门划线缓存到.weread-cache/ 目录，默认 7 天有效期
TTL 可控：在设置中可调整缓存天数
只要缓存没过期，第二次同步就是秒级完成。
书籍详情页
点击书架上的书籍封面或标题，会在新标签页打开一个完整的详情视图：
划线 Tab：按章节分组展示，每张卡片左侧有颜色边线（对应微信读书的划线颜色——黄/蓝/绿/红/紫），显示创建时间和位置，可以 deeplink 跳转到微信读书 App 或者一键复制原文
笔记 Tab：所有个人想法和注解，按时间倒序排列，显示引用原文
热门划线 Tab：社区热度最高的段落（需 API Key），按章节分组，显示划线人数
书评 Tab：你的个人书评 + 社区精选公开书评
右下角悬浮按钮可快速跳转本地 Markdown 文件。
升级
打开 Obsidian 插件市场搜索 Weread 即可安装或升级，打开设置 → 扫码获取 API Key 即可使用。
最后，Happy Reading, Happy Thinking
