前言¶

微信讀書裏的書架、劃線和閱讀時長，平時只能在 App 裏翻。想在對話裏問「這個月讀了多久」「把某本書的筆記列出來」，要麼自己抓接口，要麼反覆截圖。下面介紹 SkillHub 上的「微信讀書」Skill：把搜索、書架、筆記、書評、閱讀統計和推薦接到 Agent，用自然語言驅動，背後走微信讀書 Agent API Gateway。

這是什麼¶

「微信讀書」是 SkillHub 社區 Skill，座標 @user_b4de96af/wxds123，分類爲 knowledge-management，發佈者爲 user_b4de96af，當前 SkillHub 頁面標註版本爲 v1.0.0。簡介寫明：微信讀書助手，支持搜索書籍、管理書架、查看筆記劃線、瀏覽書評、閱讀統計、發現推薦好書。

Skill 本體是通用 SKILL.md 格式：Agent 讀取說明後，按文檔調用 https://i.weread.qq.com/api/agent/gateway，並遵守參數平鋪、skill_version 上報等約定。標籤 requires_api_key=true 表示必須配置微信讀書側 API Key。

SkillHub 頁面數據（以抓取爲準）：評分 100000，下載 11522 次。

核心功能¶

以下能力與安裝包內 SKILL.md「支持的能力」表一致，按用戶意圖選用對應參考文檔（如 search.md、shelf.md、notes.md 等）。

接口統一爲 POST JSON，api_name 指定具體路徑；用戶只說書名時，應先 /store/search 解析 bookId 再後續操作。回包可帶 weread:// 深度鏈接，便於在 App 內打開書籍、章節或劃線位置。

安裝與啓用¶

1、安裝 SkillHub CLI¶

若尚未安裝，可按 SkillHub 官方安裝說明執行：

command -v skillhub && skillhub --version

未安裝時（完整包或僅 CLI，以官方文檔爲準）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安裝本 Skill¶

安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。

skillhub install @user_b4de96af/wxds123 --dir <你的 skills 目錄>

常見路徑示例（來自 SkillHub 安裝文檔）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可將官方頁面給出的提示詞發給 AI，讓其按 https://skillhub.cn/install/skillhub.md 完成安裝。

3、配置 API Key¶

Skill 要求環境變量 WEREAD_API_KEY，格式爲 wrk-xxxxxxxx，請求頭爲 Authorization: Bearer $WEREAD_API_KEY。未設置時，Agent 應提示用戶：

export WEREAD_API_KEY=<你的apikey>

Key 綁定微信讀書用戶身份（vid），需要用戶身份的接口由網關注入，無需手傳 vid。

4、調用約定（Agent 側）¶

• 網關：POST https://i.weread.qq.com/api/agent/gateway
• Body 爲 JSON，業務參數與 api_name、skill_version 平鋪在同一層，不要包在 params 內
• 每次請求必須帶 skill_version；安裝包內 SKILL.md 頂部 version 爲 1.0.3，應與請求中的 skill_version 一致
• 若響應含 upgrade_info，需先按指引升級再繼續

典型用法¶

對話式（推薦給終端用戶）¶

在已啓用 Skill 的 Agent 中，可直接用自然語言，例如：

• 「幫我搜一下三體」
• 「看看我的書架」
• 「我這個月讀了多久」
• 「看看我在三體裏的筆記」
• 「三體這本書有什麼點評？」
• 「給我推薦幾本書」

Agent 會按 SKILL.md 與各 *.md 能力說明選擇 api_name 並整理回包。

直連網關（排查或腳本）¶

搜索示例如下（skill_version 需與當前 Skill 文檔版本一致）：

curl -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"}'

查看可用接口列表：

curl -X POST "https://i.weread.qq.com/api/agent/gateway" \
  -H "Authorization: Bearer $WEREAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"api_name": "/_list", "skill_version": "1.0.3"}'

適用場景與注意¶

適合誰

• 已在微信讀書重度記筆記、管書架，希望用 Cursor / Claude Code 等 Agent 做檢索與彙總的人
• 需要把閱讀數據、劃線、點評納入對話工作流，而不是單獨開 App 翻找的人

限制與注意

• 必須持有有效的 WEREAD_API_KEY，且 Key 與賬號綁定；無 Key 無法調用網關
• 依賴微信讀書 Agent API Gateway 與 Skill 文檔版本；SkillHub 列表版本與包內 SKILL.md 的 version 可能不一致，以實際安裝包爲準配置 skill_version
• 分頁參數（如 lastSort）必須平鋪在 body 頂層，錯誤嵌套會導致一直返回第一頁
• 展示回包時需按 Skill 規範轉換時間戳、閱讀時長，並優先參考各能力說明文件的字段含義，避免按字段名直譯

結尾¶

「微信讀書」Skill 把書城搜索、書架、筆記劃線、書評、閱讀統計和推薦收斂到一套 Agent 可讀的 SKILL.md 與網關調用規範，適合在對話裏查自己的閱讀數據。安裝與詳情見 SkillHub：

• 頁面：https://www.skillhub.cn/skills/user_b4de96af/wxds123
• API 入口：https://api.skillhub.cn/user_b4de96af/wxds123