SuperAPI AI 工具集

jerlin-weread-skill

办公与效率

查看项目

更新于 10-15 23:30

技能介绍

用途:这是一个微信读书助手技能,用于在对话中查询微信读书的书籍、书架、笔记与阅读数据。所有接口通过 scripts/weread.sh 调用,脚本负责鉴权和参数平铺。

主要能力:搜书找书(search)、书籍详情与章节进度(book-info、chapters、progress)、书架(shelf)、阅读统计与偏好(readdata)、笔记划线想法(notebooks、bookmarks、my-reviews)、热门划线及划线下想法(best-bookmarks、read-reviews、underlines、review-detail)、公开点评(reviews)、推荐好书(recommend、similar),以及组合出的用户阅读概况与阅读画像。

使用方式:查看子命令列表用 weread.sh -h,查看某子命令参数与回包字段用 weread.sh <subcmd> -h。调用任何接口前应先阅读对应 reference 文档确认字段含义、计数口径和工作流。用户输入书名时,先调 weread.sh search 获取 bookId,再执行后续操作,并在对话中记住已查询的 bookId。

鉴权:需设置环境变量 WEREAD_API_KEY,格式为 wrk-xxxxxxxx;未设置时提示用户执行 export WEREAD_API_KEY=<你的apikey>。API Key 绑定用户身份(vid),无需手动传。

限制与规则:errcode 非 0 表示错误,需给出中文提示;回包出现 upgrade_info 时按其 message 指引完成升级后重试。回包字段名与直觉含义冲突时服从 reference 说明,字段禁止直接翻译。时间戳展示为 YYYY-MM-DD,阅读时长单位为秒需转为「X 小时 Y 分钟」。展示书籍、章节、划线时可附深度链接,如打开书籍 weread://reading?bId={bookId},跳转章节加 chapterUid,跳转划线位置用 weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid};range 格式为起始-结束,需拆分填入,且仅在回包同时含 chapterUid 和 range 时生成划线链接。