前言¶

在 DSH 裏做閱讀相關的工作流，常見做法是瀏覽器書籤加獨立腳本，或者把筆記手工複製到 Obsidian。微信讀書官方提供了 Agent Skill API，但要把書架瀏覽、獨立閱讀窗口、AI 問答和筆記歸檔串成一條線，仍需要自己拼界面和鑑權。維護者 SaltedFish-ZZJ 的客戶端插件 書嶼（倉庫 SaltedFish-ZZJ/dsh-weread-shelf）把上述能力放進 DSH 左側欄：接官方 wrk- Key 拉書架與劃線，用 Chrome --app 獨立窗口閱讀（規避 iframe 攔截），陪讀臺與「問嶼」走 DSH 或自定義 OpenAI 兼容接口，劃線與 AI 回答可寫入 Obsidian。下面按定位、功能、安裝、配置與邊界說明用法。

這是什麼¶

書嶼是 DSH 的 客戶端（web）bundle 插件，分類上屬於客戶端面板，不是純宿主路由擴展。它需要 DSH 桌面版 0.2.x（package.json 中 engines.dsh 爲 >=0.2.0-rc.2）。當前倉庫版本 0.9.9，許可證 MIT。社區目錄頁：skillhub.cn 插件條目；源碼與說明：GitHub。

一句話定位：把微信讀書書架搬進 DSH 左側欄，並銜接獨立窗口閱讀、陪讀 AI 與 Obsidian 歸檔。

核心功能¶

以下能力均來自 README 與 package.json 說明，按使用路徑歸納。

書架與「今日帶」¶

• 通過微信讀書官方 Agent Skill API（Key 形如 wrk-xxxxxxxx）同步書架：全部書籍、書單文件夾，支持平鋪 / 分類 / 進度 / 首字母四種分組，以及在讀·讀完·未開始篩選，並支持全站書城檢索。
• 「今日帶」展示日期、今天讀到 / 本週讀到 / 連續閱讀、今天翻開的書，以及一條可輪換的「舊句重逢」劃線。

閱讀與陪讀臺¶

• 打開閱讀：使用 Chrome --app 打開無地址欄的獨立窗口；不用內嵌 iframe（微信讀書會攔截 frame，且有第三方風險提示）。
• 陪讀臺：點「打開閱讀」後可自動進入左右分欄——左側針對當前書的 AI，右側爲該書的劃線、想法與隨手記（可在設置中關閉「打開閱讀後自動進入陪讀臺」，默認開啓）。

全局 AI「問嶼」與 Agent 工具¶

• 問嶼：跨書提問，做推薦、串聯與主題檢索。
• 向 DSH Agent 註冊 4 個只讀工具：weread_shelf、weread_notes、weread_stats、weread_search，對話中可直接查書架、筆記與統計（示例：「我書架裏有哪些經濟類的書」）。

Obsidian 與統計¶

• 單條劃線、想法、AI 回答或隨手記可寫入 Obsidian；整本書可一次歸檔（去重、按章節分組、維護書單 MOC）。
• 統計視圖包含閱讀日曆熱力圖、連續天數、趨勢圖、24 小時極座標鍾、分類環形、周分佈、筆記密度散點、書架進度環牆等。

數據與隱私（官方口徑）¶

• 只調用官方網關 POST i.weread.qq.com/api/agent/gateway，17 個接口均爲只讀：不改進度、不加書架、不導出正文。
• 除微信讀書與你在設置裏指定的 AI 接口外，不向第三方發請求；寫入 Obsidian 僅在你點擊「存進知識庫 / 整本存進知識庫 / 隨手記」時發生。
• wrk- Key 與自定義 AI 接口 Key 存在 DSH credentials，不進本倉庫與配置文件。

安裝與啓用¶

需要已安裝 DSH 桌面版 0.2.x。插件爲本地 bundle，啓用後左側欄出現「書嶼」圖標；首次打開需配置 API Key。

通過 DSH「發現」安裝（推薦）¶

DSH 插件市場爲索引驅動，無單獨「上傳」入口。本倉庫提供 format-1 索引，推薦 URL：

https://cdn.jsdelivr.net/gh/SaltedFish-ZZJ/dsh-weread-shelf@main/market/index.json

備用：

• https://raw.githubusercontent.com/SaltedFish-ZZJ/dsh-weread-shelf/main/market/index.json
• https://ghproxy.net/https://raw.githubusercontent.com/SaltedFish-ZZJ/dsh-weread-shelf/main/market/index.json

步驟：

1. 打開 設置 → 插件 → 發現（Discover）→ 索引源 → 添加
2. 填入上述 jsDelivr 地址（索引只接受最終 http(s) URL，且不跟隨重定向）
3. 在發現裏搜索「書嶼」並安裝（各版本 source 爲 git + 40 位 commit，安裝時拉取固定 commit，不跟 main 漂移）

索引約束（README 摘錄）：相對圖標須與索引同放在可解析的 https 路徑；本倉庫 market/icon.svg 與 market/index.json 一併發佈。

從本地 bundle 安裝¶

若你已有插件目錄（例如自行下載的源碼樹），在 DSH 中二選一：

• 對 Agent 說明本地路徑，由其調用 plugin_manager install_bundle 安裝並啓用。
• 設置 → 插件 → 從本地路徑安裝，選中該目錄。

裝好後在左側欄打開書嶼，按提示完成首次 Key 配置。

獲取微信讀書 API Key¶

微信讀書 App → 我 → 設置 → 微信讀書 Skill → 獲取 API Key（wrk- 前綴）。Key 保存在 DSH credentials，不寫進 ~/.dsh-weread-shelf/settings.json。

配置與 AI 模型¶

面板右上角 設置 中常見項如下（README 表格）：

普通配置寫在宿主側 ~/.dsh-weread-shelf/settings.json。庫根默認 ~/Obsidian，若路徑不同請在設置中改成你的 Obsidian 庫。

默認 AI：走宿主 llm 與 DSH 當前選中模型，消耗 DSH token；wrk- Key 只拉數據。也可在「問嶼的 AI」中配置 OpenAI 兼容 base URL（如 https://api.deepseek.com/v1）、模型名與接口 Key（存 credentials weread/ai-key）。單書上下文約 3.5k 字符，輸出上限 1200 token，歷史最近 8 輪。

典型用法¶

1. 在書嶼設置中連接 wrk- Key，必要時修正 Obsidian 庫路徑與子目錄。
2. 在書架按分組或篩選找書，需要時用書城檢索；查看「今日帶」與統計頁掌握閱讀節奏。
3. 對某書點 打開閱讀，在獨立窗口閱讀；返回 DSH 使用陪讀臺就劃線、想法提問，或將內容 存進知識庫。
4. 在全局「問嶼」跨書提問；或在 DSH 對話裏通過只讀工具查書架、筆記與統計。
5. 閱讀告一段落時，對單書使用 整本存進知識庫 做歸檔與 MOC 維護。

適用場景與注意¶

適合誰：已在微信讀書重度標註、希望與 DSH Agent 和 Obsidian 同一桌面閉環的用戶；接受非官方 Skill 接口與「使用風險自負」免責聲明（README 寫明與騰訊 / 微信讀書無官方關係，且 App 會提示勿用第三方插件）。

權限與安全：插件以當前 DSH 進程權限運行；/api/weread/* 註冊在宿主 webServer（本機迴環），README 註明尚未走 connection 層會話校驗。安裝前請閱讀倉庫源碼與 MIT 許可證，自行判斷是否滿足環境要求。

已知邊界（README「已知邊界與路線圖」摘錄，便於設預期）：

• 官方接口不提供全書正文，陪讀 AI 基於簡介、目錄、劃線與想法，不能代讀全文。
• 網頁閱讀器無段落錨點，已去掉不可靠的「去原文」；/open 只接受 https 鏈接。
• 每次打開面板會重新拉書架，書多時可能偏慢；暫無本地增量緩存。
• 單賬號；暫無獨立安裝包與崩潰日誌收集。

開發側：單文件客戶端無構建步驟；npm test 跑離線 smoke 與 host 測試。Node 引擎要求 >=22。

結尾¶

書嶼把微信讀書書架、Chrome 獨立窗口閱讀、陪讀 AI 與 Obsidian 寫入收進 DSH 左側欄，併爲 Agent 暴露只讀書架/筆記/統計/檢索工具。安裝優先走發現索引；配置 Key 與 Obsidian 路徑後即可從書架到歸檔連貫使用。

• 目錄頁：https://www.skillhub.cn/plugins/SaltedFish-ZZJ/dsh-weread-shelf
• 倉庫：https://github.com/SaltedFish-ZZJ/dsh-weread-shelf