前言¶

做 DSH 插件開發的同行，多半會遇到一類需求：智能體能在會話裏聊文獻，但資料本身散落在 Obsidian 知識庫裏，閱讀、批註、筆記和錄音要切到別的工具。dsh-literature-hub 是維護者 3469915488-oss 發佈的客戶端插件，它把 Obsidian 知識庫中的 PDF、DOCX、Markdown 和 HTML 放進同一個閱讀界面，並在同一個窗口裏提供批註、富文本筆記、伴讀會話和本地 Whisper 轉寫。本文介紹它的定位、安裝方式和典型用法。

這是什麼¶

一句話定位：DSH 的本地文獻庫插件，以當前 dsh 進程的權限讀取本地知識庫，不聯網、不抓取網頁。它由社區維護者 3469915488-oss 維護，遵循 MIT 許可證。源碼聲明支持 DeepSeek Harness >=0.2.1-rc.5 <0.3.0-0，Node.js 版本要求 24 或更高。

需要說明的是，DSH 的生態理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係。本文寫入的是維護者倉庫中的事實。

核心功能¶

README 列出的能力和版本信息如下，均可在倉庫中核對。

文件與目錄管理：真實的文件夾樹，支持多級目錄、導入、改名、移動、當前層搜索和可恢復刪除。

閱讀：PDF 閱讀、DOCX 結構化正文解析、中文預覽；掃描版 PDF 按需調用本地 OCR。

批註：高亮、下劃線、勾畫、旁註和自定義標籤。正文標記、批註面板和筆記引用可以互相定位。

筆記：每篇文獻對應同目錄下的一個 Markdown 筆記，批註引用、自由筆記和錄音卡共用同一個富文本編輯器。

伴讀：使用 Harness 原生的伴讀對話，Agent 可以查詢當前資料、本地知識庫、筆記、批註、學習檔案和引用信息。

學習記錄：手動開啓學習後，可保存知識地圖、練習、錯題和複習卡。

離線轉寫：本地 Whisper 多語轉寫，支持波形播放和可拖動的錄音詳情窗。智能總結只在點擊後，把完整轉寫稿發送給當前 Harness 模型。

邊界方面，README 明確寫明文獻庫沒有聯網檢索或網頁抓取，原件、解析正文、批註、筆記和音頻都保存在知識庫中。

安裝與啓用¶

在 Harness 的「插件」頁選擇「添加插件」，輸入固定發佈版本，不要自己拼接安裝命令：

github:3469915488-oss/dsh-literature-hub#v2.1.3

重啓 Harness，在「已安裝」列表中啓用「文獻庫」。README 說明，插件關閉時依然保留知識庫資料、筆記、批註、錄音和會話投影。

默認知識庫爲 ~/Documents/Obsidian。如果使用其他 Obsidian 知識庫，需要修改 ~/.dsh/profiles/desktop/cordis.patch.yml：

- id: literature-hub
  config:
    vaultPath: /絕對路徑/我的-Obsidian-知識庫

安裝前建議先查看源碼和 LICENSE、THIRD-PARTY-NOTICES.md，確認運行權限和第三方依賴的許可範圍。插件以當前 dsh 進程的權限運行，能訪問該進程能讀到的本地文件。

典型用法¶

按照 README 的「五分鐘開始」，操作順序如下。

1. 在 Harness 的「插件」頁添加並啓用文獻庫，重啓應用。
2. 打開主側欄的「文獻庫」，在左側選擇已有目錄或創建文件夾。
3. 點擊「導入資料」，導入 PDF、DOCX、Markdown 或 HTML 文件。
4. 在正文選中文字，選擇高亮、下劃線、勾畫、旁註，或向伴讀提問。
5. 打開「筆記」編輯隨記，或錄製音頻後點擊「轉寫」。需要 AI 總結時，在錄音詳情中點擊「智能總結」。

界面佈局上，左側是 Obsidian 目錄和當前層檢索，中間閱讀原文，右側上方固定批註欄，右側下方是同一篇文獻的筆記和錄音。Harness 工作區側欄保持原生顯示，可以繼續進入插件、自動化任務與會話記錄。

Whisper 離線轉寫依賴本地部署，具體步驟見倉庫的 docs/Whisper部署.md。

適用場景與注意¶

適合想在 DSH 內完成「讀資料—做批註—記筆記—轉寫錄音」閉環、並希望資料留在本地知識庫的用戶。它面向的是有自己 Obsidian 知識庫、能接受手動配置路徑和本地建模轉寫的開發者。

注意事項：

• 版本號、許可證和配置字段只以倉庫原文爲準，上面給出的是 README 中明確出現的 v2.1.3、MIT 和 vaultPath。
• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 智能總結會在點擊後把完整轉寫稿發送給當前 Harness 模型，啓用前請確認這條數據流向。
• 社區目錄頁與 GitHub 倉庫是兩個入口，本文事實來自 GitHub 倉庫。

結尾¶

dsh-literature-hub 的價值在於把本地閱讀和批註收進 DSH 的工作區，同時不引入聯網依賴。如果你的文獻已經放在 Obsidian 裏，按上面的固定版本安裝、配置 vaultPath，再走一遍「五分鐘開始」即可驗證。

目錄頁：https://www.skillhub.cn/plugins/3469915488-oss/dsh-literature-hub

GitHub：https://github.com/3469915488-oss/dsh-literature-hub