在 DSH 中開發智能體時,對話輪次往往在會話結束後就丟失了。與其依賴雲端的記憶服務,不如將對話保存爲本地文件。dsh-save-chat 正是爲此設計,它將對話保存爲 Markdown,並提供檢索接口。
插件介紹¶
dsh-save-chat 是一個 DeepSeek Harness 插件,由 xypang33-sketch 維護。它解決了智能體開發中“對話留存”的問題,將對話輪次保存爲本地 Markdown 文件。它提供兩層存儲結構:按會話組織的集合(項目級)和跨項目的個人知識庫。所有數據均爲本地純 Markdown 文件,無數據庫依賴,零依賴。
核心功能¶
- 保存對話輪次:保存提問與完整回答的內容。
- 雙層存儲結構:支持按會話的集合(Project-local)和跨項目的個人知識庫。
- 模型檢索能力:模型可調用
search_knowledge和read_knowledge進行按需檢索。 - 零依賴與純文件:僅依賴 Markdown 文件,無數據庫,不產生遙測數據。
- UI 交互:提供心形按鈕保存、側邊欄面板瀏覽、右鍵菜單管理。
- 圖片保留:對話中的圖片會隨 Markdown 文件一起保留。
- 本地全文搜索:使用 BM25 算法在本地進行全文搜索。
安裝與啓用¶
安裝前請確認當前運行的 DSH 進程(Profile)。安裝命令如下:
dsh plugin --profile web add dsh-save-chat
若使用桌面客戶端,將 --profile web 替換爲 --profile desktop。安裝後需要重啓 DSH 才能生效。
使用步驟¶
- 添加插件:在 DSH 的設置中找到插件選項,添加
dsh-save-chat。 - 保存對話:在對話回覆行的操作欄中,點擊心形圖標即可保存整輪對話。
- 瀏覽內容:在側邊欄面板中瀏覽已保存的收藏內容。
- 添加到知識庫:在側邊欄或右鍵菜單中選擇“添加到知識庫”,將其提升爲可被模型檢索的持久化內容。
- 引用與檢索:右鍵菜單支持複製引用(
@/path/file.md)。將引用粘貼到新對話中,或直接詢問模型“我們上次得出了什麼結論?”,模型會調用檢索工具返回結果。
適用場景與注意事項¶
該插件適合需要在本地持久化對話記錄、利用本地文件進行知識管理且希望減少雲服務依賴的開發者。
- 文件位置:知識庫文件存儲在
~/.dsh/knowledge/<YYYY-MM>.md。會話集合文件位於<session workspace>/.dsh-favorites/<session title>.md。 - 本地存儲:僅本地存儲,不發送遙測或服務器請求。
- 按需檢索:知識庫內容僅在模型需要時檢索,不會自動注入,節省 Token。
- 模型調用成本:保存對話或總結圖片時會產生少量模型調用。
- 配置要求:需要重啓 DSH 才能生效。
總結¶
dsh-save-chat 提供了一種輕量級、本地優先的方式管理 DSH 對話。它通過純 Markdown 文件和檢索工具,將對話轉化爲可搜索的知識資產,適合構建個人知識庫或項目歸檔。