WeRead 微信读书助手

要解决什么问题

你在对话里想查微信读书上的书、书架、笔记或阅读数据，但 App 里没有给 Agent 用的官方 SDK；手动复制书名、进度和划线既慢，也容易漏字段。WeRead 技能通过 Agent API Gateway 以统一 POST 接口调用微信读书能力，让模型在弄清 bookId、分页和字段含义后再回答，而不是凭字段名瞎猜。

技能如何工作

• 搜书与上下文：用户说书名时，先走 /store/search 解析 bookId，后续查目录、进度、笔记可沿用同一会话里的 ID。
• 书架与统计：/shelf/sync 等接口支撑「我的书架」；书架条目数需按 books.length + albums.length + (mp 非空 ? 1 : 0) 口径统计（专辑/有声书算在架内）。
• 笔记与社区内容：个人划线、想法、书签数量与内容、章节热门划线、公开书评、个性化推荐分别对应 notes、review、discover 等说明文档里的接口与工作流。
• 调用约定：Authorization: Bearer + 环境变量 WEREAD_API_KEY（wrk- 前缀）；每次 body 必须带 skill_version，业务参数与 api_name 平铺在同一层，禁止包进 params。
• 展示习惯：Unix 时间戳展示为 YYYY-MM-DD；阅读时长由秒转为「X小时Y分钟」；列表用编号便于选择；能构造深度链接时在结果里附上 App 跳转（书籍、章节、具备 chapterUid 与 range 的划线位置）。

适用边界与注意点

回包经字段裁剪，解释字段以各能力说明文件（如 readdata.md、shelf.md）为准。errcode 非 0 需用中文说明错误；若响应含 upgrade_info，须先按指引升级再重试用户请求。未配置 API Key 时应提示用户设置 WEREAD_API_KEY；Key 绑定用户 vid，需要身份的接口会自动注入，无需手传 vid。