微信读书助手

背景：微信读书数据的自动化管理难题

微信读书作为主流阅读应用，积累了丰富的个人阅读数据，包括笔记、划线、阅读时长和偏好。然而，官方客户端未提供开放API，用户难以自动化提取或分析这些数据，导致手动整理耗时、易错且无法实现个性化统计。例如，想导出全年阅读摘要或批量查看书籍笔记，只能依赖App内有限功能，无法跨平台整合。

技能核心能力与工作流程

本技能通过Agent API Gateway调用微信读书的私有接口，实现数据的程序化访问。核心能力覆盖阅读全链路：

• 书籍搜索与信息获取：调用/store/search搜索书籍，返回bookId等关键信息，再通过/book/detail获取章节目录和阅读进度。
• 书架与阅读统计：使用/shelf/sync管理书架，支持专辑/有声书统计（按 books.length + albums.length + (mp非空 ? 1 : 0) 计算）；调用/readdata/summary生成阅读时长、天数和偏好分析摘要。
• 笔记与书评管理：通过/book/bookmarklist查看划线和想法，利用/book/readreviews获取公开点评，并支持热门划线趋势分析。
• 个性化推荐：基于/discover/recommendations提供书籍推荐，扩展阅读发现。

关键工作流程：

1. 鉴权设置：需配置环境变量WEREAD_API_KEY（格式wrk-xxxxxxxx），请求头中包含Authorization: Bearer $WEREAD_API_KEY，API自动关联用户身份。
2. 请求构造：以POST方式发送JSON体，必须包含skill_version: "1.0.3"和api_name（如/shelf/sync），业务参数必须平铺在根层级，禁止包裹在params等嵌套对象中。
3. 响应处理：解析返回JSON，检查errcode；若回包包含upgrade_info，需立即暂停并升级技能后再重试。字段解释以专用文档（如readdata.md）为准，禁止直接翻译字段名。
4. 结果展示规范：列表采用编号便于选择；时间戳（如updateTime）转为YYYY-MM-DD格式；阅读时长从秒转换为“X小时Y分钟”；对于书籍、章节或划线，拼接深度链接（如https://weread.qq.com/web/reader/...）方便在App中跳转。

注意事项与适用边界

• 数据依赖：需稳定的网络连接，API响应受微信读书服务状态影响，可能返回错误码需用户检查网络或重试。
• 权限限制：某些接口（如笔记导出）可能受API权限约束，无法获取全部数据；书架数量统计需严格按文档公式计算，避免错误。
• 字段准确性：回包字段名可能与直觉冲突（如count），必须参考对应说明文件（如shelf.md）解释，禁止凭经验猜测。
• 升级机制：技能版本由skill_version上报，服务端可能返回upgrade_info触发强制更新，忽略将导致功能失效。
• 适用场景：适合个人阅读数据分析、自动化笔记整理或开发集成，但不支持批量修改书籍或直接控制阅读行为（如翻页），仅限查询与统计操作。