前言¶
微信讀書裏的劃線、想法、書評和閱讀進度，默認都留在 App 裏。想按書整理成 Markdown、在本地檢索，或用一個頁面瀏覽已導出的內容，往往要手動複製，或自己寫腳本對接接口。下面介紹 SkillHub 上的社區 Skill「微信讀書評論、劃線拉取」（@user_568e5b5e/weread-sync，v1.0.0），它把官方 CLI weread-sync 的登錄、增量同步和 demo 瀏覽寫進 Agent 工作流，用自然語言即可觸發。
這是什麼¶
一句話定位：在 Cursor 等支持 Skills 的 Agent 裏，當你要查微信讀書的書籍、劃線、筆記、書評、閱讀狀態，或要把數據同步到本地 Markdown、打開本地可視化 demo 時，由 Agent 按固定流程調用 weread-sync。
- 出品與託管：社區來源（community），發佈者
user_568e5b5e，SkillHub 分類爲data-analysis。 - 依賴關係：Skill 本身不聲明
requires_api_key；實際數據拉取依賴本機全局安裝的 npm 包weread-sync，登錄態保存在本地。 - 官方入口：SkillHub 技能頁、API 座標頁。
核心功能¶
以下能力與安裝包內 SKILL.md 一致，均通過 weread-sync 子命令完成（支持 --json 輸出 JSON）：
- 登錄與狀態：
login掃碼登錄；status查看登錄與同步狀態、已同步書籍數；logout清除本機登錄態。 - 書籍與閱讀狀態：
notebooks列出有筆記/劃線的書；books-status按reading/finished/other分類；book-probe實時拉取單本書詳情、劃線、書評、章節。 - 導出與同步：
sync將書籍導出爲本地 Markdown；增量同步根據筆記數、書評數、進度等指紋判斷是否有變化，無變化則跳過；--force可強制全量重導；export-dir查看導出目錄及是否有數據。 - 本地瀏覽：
demo啓動本地可視化頁面，瀏覽已同步書籍與 Markdown 筆記。
安裝與啓用¶
1. 安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時可按 SkillHub 安裝說明 執行：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 將 Skill 裝進當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前客戶端的 skills 目錄，否則默認落在 ./skills/ 且 Agent 可能無法識別。常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
skillhub install weread-sync --namespace user_568e5b5e --dir ~/.cursor/skills/
也可讓 Agent 按官方提示安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_568e5b5e/weread-sync`。
3. 安裝並準備 CLI 工具¶
Skill 要求先全局安裝 npm 包：
npm install -g weread-sync
經過上面的步驟，在對話中提及查看微信讀書數據、同步 Markdown 或打開 demo 時，Agent 會按 Skill 中的流程引導你執行對應命令。
典型用法¶
Skill 內約定的操作順序如下。
首次使用：登錄
weread-sync login
顯示二維碼，掃碼後登錄態寫入本機。
拉取並導出 Markdown
weread-sync sync
需要全量重導時：
weread-sync sync --force
查看進度與書單（可選）
weread-sync status
weread-sync notebooks
weread-sync books-status
單本書探測（可選）
weread-sync book-probe
具體書名或 ID 參數以 weread-sync 自帶幫助爲準（weread-sync book-probe --help）。
打開本地可視化 demo
weread-sync demo
在 Agent 側，你可以直接用簡介中的意圖發起對話，例如：「同步我微信讀書裏的劃線和筆記到本地 Markdown」「列出有筆記的書」「打開 weread-sync 的 demo 頁面」。
適用場景與注意¶
適合誰
- 已在微信讀書長期積累劃線、想法、書評，希望落到本地 Markdown 做檢索或二次整理的人。
- 希望在 Agent 會話裏查閱讀狀態、書單，而不必每次手寫 curl 或查 API 的人。
使用注意
- 需要本機已安裝 Node.js/npm，並能執行
npm install -g weread-sync。 - 數據與登錄態在本地；換機或清緩存後需重新
login。 sync爲增量邏輯，若懷疑導出不完整，可用--force強制全量。- Skill 爲社區貢獻（community），頁面統計（截至資料抓取）：評分 100000，下載 1838，安裝 5；行爲以你本機安裝的 v1.0.0 與
weread-sync版本爲準。 - 與 SkillHub 上其他微信讀書類 Skill（名稱相近）不同，本 Skill 座標固定爲
@user_568e5b5e/weread-sync，安裝時注意--namespace user_568e5b5e。
結尾¶
「微信讀書評論、劃線拉取」把掃碼登錄、增量同步 Markdown、本地 demo 瀏覽收斂成一套 Agent 可執行的說明，適合把閱讀數據從 App 裏搬到本地文件體系。安裝與命令細節以 SkillHub 頁面與包內 SKILL.md 爲準：
- https://www.skillhub.cn/skills/user_568e5b5e/weread-sync
- https://api.skillhub.cn/user_568e5b5e/weread-sync
