前言¶
在 DeepSeek Harness 的開發中，讓智能體具備查詢本地文檔的能力是常見需求。現有方案往往依賴雲端向量庫或需要配置複雜的本地環境。dsh-move-rag 插件提供了一個輕量級的解決方案：它不需要下載模型權重，也不依賴雲端服務，而是將知識庫運行在 Windows 桌面上，通過置頂窗口實現快速入庫與檢索。
是什麼¶
這是一個由 xingmen-1 維護的 DeepSeek Harness 插件，提供本地知識庫記憶功能。它通過一個常駐桌面的 WinForms 圖標，支持拖拽入庫、本地 RAG 檢索，並將檢索結果作爲工具暴露給 Agent。
核心功能¶
- 桌面臨時面板：WinForms 窗口，支持置頂、拖動。拖動到屏幕邊緣時，窗口會自動收起爲一條箭頭。
- 拖拽入庫：支持 PDF、Word、txt、md、csv、代碼文件及圖片。拖入桌面圖標或面板即可完成入庫。
- 本地 RAG：使用定長切片 + 哈希嵌入（512 維）+ 餘弦召回進行檢索。面板內可直接測試檢索效果。
- 工具接口：爲 DSH Agent 提供檢索工具
knowledge_search和開發工具kb_dev。 - 網頁同步：DSH 網頁側邊欄提供「知識庫」入口，可控制桌面圖標的顯示與隱藏。
安裝與啓用¶
使用官方安裝命令添加插件，安裝後需重啓 dsh web 以加載配置。
dsh plugin --profile web add github:xingmen-1/dsh-move-rag
典型用法¶
- 打開置頂：在網頁側邊欄點擊「知識庫」，打開「置頂」開關，桌面右上角會出現懸浮圖標。
- 入庫：將文件拖拽到桌面圖標上，或拖入打開的面板中。
- 檢索：在面板中輸入問題並回車，結果按相似度排序。
- 讓 Agent 使用：在對話中直接詢問，Agent 會自動調用
knowledge_search工具。
適用場景與注意¶
- 系統限制：插件目前僅支持 Windows。Linux/macOS 需要替換桌面面板與文件寫入實現。
- 嵌入原理：哈希嵌入是關鍵詞級別的語義近似，不是神經嵌入。它對同義改寫不敏感，但勝在離線、零依賴、速度快。
- 文件索引：圖片僅按文件名索引，沒有 OCR 能力。
- 文件大小：單個上傳文件上限 16MB（base64 走 JSON），本地路徑入庫上限 256MB。
結語¶
該插件適合需要在 Windows 環境下快速構建本地知識庫並給 Agent 賦予檢索能力的開發者。插件目錄與 GitHub 鏈接如下：
