前言¶

DeepSeek Harness (DSH) 採用「一切皆插件」的架構。對於需要長期記憶或管理私有文檔的智能體開發者來說，構建一個本地知識庫是剛需。下面介紹 dsh-knowledge-lite，這是一個給 DeepSeek Harness 用的本地知識庫插件。每篇筆記是一個 Markdown 文件，數據完全在你本機，不依賴任何雲服務。

核心功能¶

插件主要提供以下能力：

1. 本地純文本存儲：每篇筆記對應一個 .md 文件，支持用任意外部編輯器直接修改。
2. 全文搜索 + 標籤篩選：支持對庫內的所有內容進行檢索。
3. 層級目錄：目錄即磁盤文件夾，支持在文件管理器裏手動移動文件，庫會自動識別。
4. 附件處理：
   • 文本類（.txt/.md/.py/.json/.csv 等）直接進正文。
   • Office 文檔（.docx/.xlsx/.pptx）零依賴抽取文本寫進正文，原件存入 files/ 目錄。
   • 其他類型（.pdf/圖片/壓縮包等）原樣存入 files/ 目錄，雙擊即可打開。
5. 拖拽移動：在界面上把筆記拖到任意目錄節點，即可移動文件。
6. 對話導出：支持將 dsh 對話整理成筆記（writeback）。

安裝與啓用¶

插件市場安裝¶

在 DSH 的 設置 → 插件市場 中搜索 dsh-knowledge-lite，點擊一鍵安裝。

手動安裝¶

針對開發模式或特定宿主版本（dsh 0.2.0-rc.2）：

git clone https://github.com/fangqiing/dsh-knowledge-lite.git
cd dsh-knowledge-lite
pnpm install

安裝後需將插件鏈接進 DSH 的插件目錄並重啓宿主（安裝前需徹底退出 DSH，否則可能遇到 EPERM 錯誤）。

配置與兼容性¶

路徑配置¶

該插件主要在 Windows + dsh 0.2.0-rc.2 下驗證。
默認筆記根目錄寫死爲 E:/dsh-kb（Windows 專屬）。非 Windows 平臺需編輯 lib/config.js 中的 DEFAULT_ROOT 進行修改，或首次啓動後在設置裏修改。

依賴要求¶

宿主版本需與 @deepseek-ai/dsh-* 0.2.0-rc.2 匹配。

目錄結構¶

插件核心文件位於 lib/ 目錄：
* store.js：負責筆記與層級目錄的存儲、掃描、移動、刪除。
* index.js：宿主（Node）側入口與 RPC。
* client.js：瀏覽器半側 UI（目錄樹、編輯器、附件列表）。
* attachments.js：Office 文檔零依賴文本抽取（ZIP + XML，無第三方庫）。
* writeback.js：把對話抽取爲筆記候選。
* config.js：筆記根目錄等路徑配置。
* writeback-prompts.js：抽取提示詞。

適用場景¶

適合需要管理個人知識庫、私有文檔檢索，或希望深度集成開發工作流的智能體開發者。使用時需注意，插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。