微信读书助手

要解决什么问题

如果你习惯用微信读书做长期阅读，数据和操作都锁在 App 里：想查「这本书读到哪」「某章热门划线」「本月读了多久」，往往要在客户端里点好几层。把同一套能力接到 Agent 对话里，需要的是稳定、可预期的 HTTP 接口，而不是让模型凭字段名瞎猜语义。

技能如何工作

本技能通过 Agent API Gateway 以统一 POST 入口调用微信读书相关接口，Authorization: Bearer 使用环境变量 WEREAD_API_KEY（wrk- 前缀）绑定用户身份，需要 vid 的接口会自动注入。

按用户意图，能力大致对应这些文档与工作流：

• 书城搜索（search.md）：用户说书名时，先 /store/search 解析 bookId，再在对话里记住，避免重复问
• 书籍与进度（book.md）：详情、章节目录、阅读进度
• 书架（shelf.md）：同步书架；统计条目数时需按 books.length + albums.length + (mp 非空 ? 1 : 0) 口径
• 阅读统计（readdata.md）：时长、天数、偏好与摘要；秒级时长展示为「X小时Y分钟」
• 笔记与划线（notes.md）：个人划线/想法/书签；章节热门划线与热度
• 书评与发现（review.md、discover.md）：公开点评、个性化推荐

每次请求 body 须平铺业务参数，并带 skill_version；回包若含 upgrade_info 应先按指引升级再继续。展示结果时以各说明文件的字段释义为准，时间戳转 YYYY-MM-DD，列表用编号便于选择，并在条件允许时拼接 App 深度链接（书籍、章节、range 解析后的划线位置）。

适用边界与注意点

• 未配置 WEREAD_API_KEY 时无法鉴权，需用户自行 export。
• 调用前应阅读对应 *.md 能力说明，禁止仅凭字段名解释回包；错误地把参数包进 params 会导致分页等参数未转发。
• 想法/点评不一定具备 chapterUid 与 range，无法定位划线的内容不应强行生成划线跳转链接。