القائمة
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书、生成阅读热力图
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | weread-skills |
| description | 微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书、生成阅读热力图 |
| version | 1.0.4 |
通过 Agent API Gateway 调用微信读书接口，提供搜索、书架、笔记、书评等能力。
| 能力 | 说明 | 用户示例 | 详细说明 |
|---|---|---|---|
| 搜索书籍 | 在书城搜索 | "帮我搜一下三体" | search.md |
| 书籍信息 | 查看书籍详情、章节目录、阅读进度 | "这本书有多少章" "我读到哪了" | book.md |
| 书架管理 | 查看书架 | "看看我的书架" | shelf.md |
| 阅读统计 | 阅读时长、天数、偏好分析、阅读统计摘要 | "我这个月读了多久" "今年读了几本书" | readdata.md |
| 笔记划线 | 查看个人笔记数量与内容，包括划线、想法/点评、书签数量 | "看看我在三体里的笔记" "导出我的划线" "在这本书有多少笔记" | notes.md |
| 章节热门划线 | 查看书籍/章节热门划线、划线热度及划线下想法 | "看看这章有什么热门划线" "这段话下面有什么想法" | notes.md |
| 书籍点评 | 查看书籍的公开点评 | "三体这本书有什么点评？" "看看推荐的点评" | review.md |
| 推荐好书 | 个性化推荐/相似推荐 | "给我推荐几本书" | discover.md |
| 阅读热力图 | 生成 GitHub 风格 SVG 阅读热力图 | "生成阅读热力图" "更新热力图" | heatmap.md |
根据用户意图参考对应说明文件了解接口参数、回包结构和工作流。
POST https://i.weread.qq.com/api/agent/gateway
Authorization: Bearer $WEREAD_API_KEYWEREAD_API_KEY 从环境变量获取，格式 wrk-xxxxxxxxexport WEREAD_API_KEY=<你的apikey>api_name 指定接口，其余为接口参数，每次请求必须带 skill_versioncurl -X POST "https://i.weread.qq.com/api/agent/gateway" \
-H "Authorization: Bearer $WEREAD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api_name": "/store/search", "keyword": "三体", "count": 10, "skill_version": "1.0.3"}'
正确：业务参数平铺在 body 顶层。
{"api_name":"/user/notebooks","count":100,"skill_version":"1.0.5"}
正确：下一页继续平铺 lastSort。
{"api_name":"/user/notebooks","count":100,"lastSort":1516907353,"skill_version":"1.0.5"}
错误：不要把业务参数包在 params 内。
{"api_name":"/user/notebooks","params":{"count":100,"lastSort":1516907353},"skill_version":"1.0.5"}
上面的错误写法会导致 count、lastSort 未被转发，后端按默认值返回第一页，看起来像分页失效。
errcode 非 0 时表示错误，给出中文提示{"api_name": "/_list"} 可查看所有可用接口及参数定义"skill_version": "1.0.3"（取本文件顶部 version 字段的值），用于服务端检查版本更新。如果回包中出现 upgrade_info 字段，必须立即暂停当前操作，按照 upgrade_info.message 中的指引完成升级，升级完成后再重新执行用户请求，不得忽略该字段api_name、skill_version 放在同一层；不要包在 params、data、body 等对象里。只有接口文档明确声明的数组/对象字段（如 /book/readreviews 的 reviews）才允许作为业务字段传入。readdata.md，书架先读 shelf.md），确认接口参数、字段含义、单位、计数口径和工作流；禁止仅凭字段名或经验猜测含义。/store/search 获取 bookId，再执行后续操作/shelf/sync 回答“书架有多少本书/多少条目”时，必须按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算；albums[] 是专辑/有声书，也属于书架里的书，详细规则见 shelf.mdupdateTime、createTime、finishTime、readUpdateTime 等），展示时须转为 YYYY-MM-DD 格式（如 1748563200 展示为"2025-05-30"），不得直接展示原始数字在展示书籍、章节、划线等内容时，如果回包字段足以构造链接，应附上对应的跳转链接，方便用户点击后直接在微信读书 App 中打开对应位置。想法/点评不一定都有划线位置，只有具备 chapterUid 和 range 时才生成划线位置链接。
weread://reading?bId={bookId}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
示例：
weread://reading?bId=3300045871
使用场景：
weread://reading?bId={bookId}&chapterUid={chapterUid}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
chapterUid | 章节 UID | /book/chapterinfo 返回的 chapters[].chapterUid |
示例：
weread://reading?bId=3300045871&chapterUid=107
使用场景：
weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
chapterUid | 章节 UID | 划线/想法所属的 chapterUid |
rangeStart | 划线起始位置 | range 字段中 - 前面的数字 |
rangeEnd | 划线结束位置 | range 字段中 - 后面的数字 |
userVid | 用户 VID | API Key 鉴权后自动关联的用户 ID（从 /shelf/sync 等接口的上下文获取，或省略） |
range 解析：划线接口返回的
range格式为"起始-结束"（如"900-2004"），拆分后分别填入rangeStart和rangeEnd。
示例：
weread://bestbookmark?bookId=3300045871&chapterUid=107&rangeStart=900&rangeEnd=2004&userVid=583802764
使用场景：
/book/bookmarklist）时，每条划线附上跳转链接（range 字段可直接解析）/book/bestbookmarks）时，每条附上跳转链接；/book/underlines 只是划线热度统计，不含划线文本/review/list/mine、/book/readreviews）时，只有返回内容包含 chapterUid 和 range 时才附上跳转到对应划线位置的链接；整本书评或无法定位到划线的点评不强制生成该链接