Agent Skills
返回列表
📚

WeRead — 微信读书助手

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencent-wechatreading。

技能介绍

你要解决什么问题

如果你平时用微信读书,但习惯在 Cursor、Claude 等 Agent 里直接问「书架上有啥」「三体读到哪了」「把我这本划线和想法拉出来」,传统做法是打开 App 翻找,或者猜接口字段含义。WeRead 提供一条经 Agent API Gateway 调微信读书的路径,把搜书、bookId 解析、书架同步、阅读统计、笔记与公开书评等动作收敛成可编排的请求。

技能怎么工作

调用统一走 POST JSON:api_name 指明接口,业务参数平铺在 body 顶层(不要塞进 params),且每次必须带 skill_version 与 Authorization: Bearer $WEREAD_API_KEY。用户说书名时,工作流通常是先调 /store/search 拿到 bookId,再查章节、进度、/shelf/sync、笔记或点评;对话里应记住已解析的 bookId,避免重复搜书。

能力面大致对应几类文档:search.md(书城搜索)、book.md(详情/目录/进度)、shelf.md(书架,含 books + albums + mp 计数规则)、readdata.md(时长与统计)、notes.md(个人划线/想法与章节热门划线)、review.md(公开书评)、discover.md(推荐)。展示时 Unix 时间戳转成 YYYY-MM-DD,阅读秒数转成「X小时Y分钟」;列表用编号;有 deepLink 就链成「打开阅读」,没有也别自拼 weread://。

边界与注意点

  • API Key 绑定用户身份,涉用户数据的接口会自动注入 vid,但仍依赖环境变量里的有效 Key。
  • 回包字段名可能与直觉不符,解释结果要以对应说明文件为准,不要直译字段。
  • 若响应里出现 upgrade_info,需先按指引升级技能版本再继续,不能忽略。
  • 公开能力以 SKILL 所列接口为准;不能替代微信读书客户端里未暴露的交互。

使用场景

  • 写读书复盘时,先在对话里搜书名,再拉阅读进度与当月阅读时长做对照
  • 对比多本书的公开书评与章节热门划线,选题或写读书笔记前快速扫一眼共识段落
  • 整理某本书的个人划线、想法和书签数量,按章节列出便于贴进 Obsidian
  • 问「书架有多少本」时用同步接口,把纸质书、专辑有声书和公众号条目一起算清

适合人员

  • 常在微信读书做标注、又要在 Agent 里复述「读到哪、划了什么」的连载读者
  • 写文化/社科书单推文、需要拉评分、书评与推荐列表的内容编辑
  • 把阅读习惯量化成周报,要看天数、时长与偏好的自学者
  • 维护个人知识库、希望用书名触发查笔记而非手动导出截图的笔记党