微信读书助手

解决的问题

微信读书里的书目、阅读进度、划线和想法通常分散在 App 中。若想在对话里批量查询“书架有多少本”“某章有哪些热门划线”“今年读了多久”，直接人工翻找成本高，且缺少稳定结构化答案。

工作方式

该技能通过 Agent API Gateway 调用微信读书接口。先按意图读取 search.md、shelf.md、readdata.md 等说明，再用 POST 请求，将 api_name 和 skill_version 平铺在 JSON body 顶层。典型流程包括：用 /store/search 将书名解析为 bookId；用 /shelf/sync 按 books、albums 及 mp 非空情况统计书架；用 bookmarklist、bestbookmarks、review 查看笔记、热门划线和点评；在字段足够时生成可跳转到书籍、章节或划线位置的深度链接。展示时按文档解释字段，Unix 时间戳转为 YYYY-MM-DD，阅读秒数转为小时/分钟。

适用边界

需要配置 WEREAD_API_KEY，且身份相关接口依赖绑定用户。若回包包含 upgrade_info，应先按提示升级再继续；字段含义以能力文档为准，不能只按字段名直译；部分想法或点评缺少 chapterUid、range 时，无法生成精确划线定位链接。