前言¶
DeepSeek Harness（DSH）每次開啓新會話時，上下文都會重置。你需要重新解釋背景、項目決策或之前的約定。dsh-keepsake 解決了這個問題，它自動提取對話內容並存儲在本地，以便在未來的會話中自動注入，避免重複交代背景。
這是什麼¶
dsh-keepsake 是 DSH 的記憶插件，由 axuan-1314 維護。它負責自動提取對話中的有效信息（如人設、項目說明、決策等），並將其落盤保存。在後續對話中，它會自動將這些記憶注入到會話中，讓模型“記得”之前的上下文。插件附帶一個本地“記憶管理”面板，你可以在這裏查看、編輯、刪除記憶，或配置人設。
核心功能¶
自動提取與注入¶
插件在每輪對話結束時自動判斷是否有值得記錄的內容。如果提取成功，會將內容作爲“人設”、“全局記憶”、“項目說明”和“項目索引”四段形式注入到後續的對話中。這通常通過插件自有的用戶消息通道實現。
本地記憶管理面板¶
安裝後，在 DSH 的設置頁會出現“記憶”區塊。點擊“打開記憶管理”可以進入面板：
* 瀏覽與編輯：查看所有記憶條目，支持修改標題、描述和正文。
* 增刪改查：支持新增條目、刪除條目以及導入/導出記憶。
* 項目概覽：按工作區查看各項目的記憶數量和狀態。
語義召回（可選）¶
通過配置嵌入服務，插件支持按內容語義檢索記憶。開啓後，模型在回答問題時可以檢索到最相關的記憶條目。
管道健康與備份¶
- 健康監控：面板會顯示提取管道的健康狀態，包括失敗原因統計和最近的失敗詳情。
- 自動備份：重置、導入或清空記憶前，插件會自動創建全量備份，支持回滾。
安裝與啓用¶
插件支持三種宿主 Profile（web / headless / desktop）。安裝命令如下：
dsh plugin --profile web add https://github.com/axuan-1314/dsh-keepsake/archive/refs/tags/v0.3.1.tar.gz
安裝完成後，通過 DSH 的設置頁開啓記憶功能即可使用。
數據與隱私¶
- 零依賴：無需
npm install，沒有運行時依賴。 - 本地存儲：所有數據存儲在本地
~/.dsh/memory/，不上傳遠端。 - 權限隔離：管理面板和 API 僅本機可訪問。
- 日誌記錄：提取失敗時會記錄日誌到
extraction-errors.log。
注意事項¶
- 不支持自動更新：需要手動重新安裝新版本。
- 數據安全：數據僅本地存儲，確保本地環境安全。
