前言¶
DeepSeek Harness (DSH) 的核心能力之一是通過插件擴展生態。對於知識管理場景，將閱讀筆記和進度接入 DSH 是常見需求。微信讀書的數據通常分散在客戶端，通過常規爬蟲或 Cookie 方式獲取不穩定且存在風控風險。
下面介紹的 weread-export 插件，通過調用微信讀書官方 Skills Agent Gateway (i.weread.qq.com/api/agent/gateway)，提供了穩定的數據讀取與導出能力。
插件簡介¶
插件名稱：weread-export
維護者：zhengjy01
類別：聯網工具
許可證：MIT
這是一個集成到 DeepSeek Harness 的微信讀書插件。它使用官方 API Key（wrk- 開頭）而非 Cookie 抓取方案，可以讀取書架、劃線/想法、閱讀統計，並支持一鍵導出到 flomo、本地 Markdown 或 Notion。
安裝與啓用¶
在終端執行以下命令安裝插件：
dsh plugin --profile web add github:zhengjy01/weread-export
安裝完成後，重啓 DSH GUI 即可生效。
配置¶
插件需要配置 API Key 和可選的 flomo 憑據。
- 打開微信讀書 Skills 配置頁 https://weread.qq.com/r/weread-skills，用微信讀書賬號登錄。
- 點擊「創建 Key」，複製以
wrk-開頭的 Key。 - 在 DSH Web 設置頁的「微信讀書」面板中填入 Key，或在對話中調用
weread_config進行配置。 - （可選）若需導出到 flomo，在「Flomo」面板配置 API URL / API Key。
配置信息會保存在 ~/.dsh/weread-export.json（權限 0600），同步快照保存在 ~/.dsh/weread-export-cache.json。
工具與用法¶
插件提供了多個 Agent 工具，以下爲常用命令：
- weread_config
配置或清除 API Key、默認 flomo 標籤、導出條數（0=全部）、默認導出目標、本地目錄、Notion Token/目標頁等。添加test: true可測試連接。 - weread_search
搜索書城，支持書名、作者、評分、在讀人數、bookId 或鏈接。 - weread_book
查看書籍詳情、閱讀進度及章節目錄概覽。 - weread_shelf
查看書架，顯示書名、進度、最近閱讀時間及是否讀完（支持實時或緩存模式）。 - weread_notes
不傳 bookId 查看筆記本概覽；傳入 bookId 查看該書劃線與想法。 - weread_readdata
查看閱讀統計（周/月/年/總計）。 - weread_sync
拉取書架 + 筆記本概覽到本地緩存。 - weread_flomo
快捷導出劃線到 flomo。標籤可自定義，默認按配置導出條數（0=全部），超長內容自動拆分。flomo 憑據複用 dsh-flomo。 - weread_export
多目標導出。默認dest=flomo，支持local（需指定localDir）或notion（獨立 Token）。可配合limit控制條數或使用 LLM 模板整理。
注意事項¶
- 微信讀書偶爾會要求客戶端升級 skill 版本，插件運行時會提示升級信息，需等待插件更新。
- flomo 未配置時，調用
weread_flomo會提示先配置憑據。 - Key 存儲在用戶目錄下，請注意權限安全。
總結¶
該插件通過官方 API 接入了微信讀書的核心數據流，解決了數據獲取與歸檔的痛點。適合希望將閱讀數據沉澱到 flomo 或本地筆記系統中的 DSH 用戶。
