weread

读你的微信读书数据：书架与阅读进度、划线/想法、书籍信息与目录、搜索、阅读统计，并可把笔记导出成 Markdown；只读网页接口，登录态取一次。

以 Pi package（技能形态）发布。技能本体在 skills/weread/。

• 平台：全平台
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

pi install git:gitea.vhkd.top/pi-hub/weread.git@v0.1.0

装完 pi-skill list 能看到 weread，pi-skill weread check 会告诉还缺什么。

先准备什么

• node（运行环境），用到内置 fetch 与 AbortSignal.timeout
• sqlite3（命令），只在本机 Chrome 读登录态（login --from-chrome，macOS）时用到
• security（命令），macOS 读浏览器 cookie 的钥匙串口令时用到（login --from-chrome）

常用命令

命令	说明
login	获取/刷新登录态：受控浏览器扫码、日常 Chrome、或手工 cookie
status	实时验证登录态与账号；--notify 掉登录时推手机
shelf	书架与阅读进度（进度/时长/最近在读）
notes	笔记本总览，或某本书的划线 + 想法
book	某本书的信息 + 目录 + 我的进度
search	搜微信读书书城（书名/作者）
stats	阅读统计：读完/在读数、总时长、读得最多的书
export	把划线/想法导出成 Markdown（默认预览，--yes 写入；--all 批量，可续跑）

用法与对外契约见技能内的 SKILL.md 与 REFERENCE.md。