前言¶
DeepSeek Harness（DSH）採用插件化架構。在開發或使用智能體時，每次對話和項目產出的文檔、表格、圖片等往往散落在各處，難以檢索和統一管理。dsh-library 是一個本地資料庫插件，旨在將所有產出收攏到一處，供人瀏覽、檢索，並讓助手通過路徑引用。
核心能力¶
- 三欄佈局：左側爲目錄樹，中間爲文件列表（支持網格與列表切換），右側爲內容預覽。整體視覺與 DSH 原生頁面保持一致。
- 整庫檢索：支持按文件名、路徑、標籤、備註進行全文搜索。同時提供類型、目錄、標籤三組篩選 Chip，計數隨口徑實時變化。
- 文檔直接預覽：支持 Markdown、Excel (.xlsx/.csv/.tsv)、Word (.docx)、JSON 與代碼文件在頁內直接查看，無需下載。
- 標籤與備註：每條資料可打標籤、寫備註，支持批量標註（一次最多 2000 條）。
- 多種入庫：支持拖拽進頁面、系統文件選擇、新建文檔/文件夾、從目錄導入。
- 助手權限控制：助手可把新產出存進庫，但不可修改/移動/刪除已有資料，整理權由人掌握。
- 零第三方依賴：運行時只依賴 Node 內置模塊與 DSH 自身提供的平臺件。xlsx/docx 解析基於 node:zlib 手寫最小 zip 讀取器。
安裝與啓用¶
- 安裝插件
& 'F:\DSH\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'D:\dsh-library'
-
編輯
package.json
編輯插件目錄下的package.json，完成以下兩步：- 將依賴規格從
link:改成file:（file:讓 pnpm 複製成實體目錄，解析鏈才完整）。 - 把
dsh-library加進dsh.profile.bundles數組 —— 不加這一行，插件不會進組合配置樹。
- 將依賴規格從
-
運行安裝
& 'F:\DSH\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop install
- 重啓 DSH
重啓後側邊欄出現「資料庫」入口即成功。
使用示例¶
- 收集產出：把每次對話、每個項目產出的東西收進一處：文檔、表格、圖片、音視頻、鏈接、附件。
- 配置插件：編輯
package.json，調整 bundle 配置。 - 運行測試：運行
npm test進行五套離線測試。
注意事項¶
- 助手權限限制：助手只能把新產出存進庫，不可修改/移動/刪除已有資料。
- 運行時依賴：運行時只依賴 Node 內置模塊與 DSH 自身提供的平臺件。
- 文檔解析：xlsx/docx 解析基於 node:zlib 手寫最小 zip 讀取器。
- 入庫策略：入庫四端點只新增不覆蓋。
插件地址¶
- GitHub：https://github.com/Hnqhj/dsh-library
- 目錄：https://www.skillhub.cn/plugins/Hnqhj/dsh-library
