前言¶

本地智能體在運行過程中常面臨上下文丟失的問題。傳統的記憶方案往往依賴向量數據庫或嵌入模型，增加了基礎設施的複雜度。DeepSeek Harness（DSH）插件 dsh-memento 提供了一種基於文件的有界記憶方式，它不依賴嵌入、向量存儲或 LLM 調用，僅通過文件系統管理狀態，適合追求可控性和輕量化的本地開發場景。

是什麼¶

dsh-memento 是一個 DeepSeek Harness 插件，由用戶 janpauldahlke 維護。它爲本地智能體提供有界文件記憶，核心數據存儲在 ~/.dsh/memory/ 目錄下，通過 ME.md（個人資料）和項目 MEMORY.md（項目記憶）進行注入，並輔以收件箱機制處理臨時草稿。

核心功能¶

插件在 DSH Web UI 的右側欄提供 Memory 界面，主要包含以下能力：

• 文件編輯與注入：通過右側欄直接編輯 ME.md 和項目文件。編輯後的內容會作爲注入層，供 Agent 在新會話中讀取。
• 收件箱：提供臨時的草稿區。在聊天中觸發 Remember this: 或使用 memory_remember 工具時，內容會被追加到收件箱。收件箱是追加且永不注入的，僅供 Agent 讀取。
• 人工提升：Agent 永遠不會自動寫入注入層。用戶需要通過右側欄將收件箱中的內容“提升”到 ME.md 或項目草稿中，保存後纔會生效。
• 工具支持：
  • memory_remember：將一行文本追加到收件箱。
  • memory_history_search：對已結束的會話日誌進行只讀的“考古”搜索。

安裝與啓用¶

安裝該插件需要 Node.js 版本 >= 20，並確保運行 DeepSeek Harness Web Profile。

dsh plugin --profile web add dsh-local-memento

安裝後需要重啓 dsh web 並刷新瀏覽器。

典型用法¶

1. 記錄信息：在 DSH 聊天中輸入 Remember this: <具體內容>，內容會進入收件箱。
2. 整理記憶：打開右側欄的 Memory 界面，將收件箱中的行選中並點擊“↑ promote”，將其移動到 ME.md 或項目文件中。
3. 查詢歷史：使用 memory_history_search 工具搜索之前的會話記錄。

適用場景與注意¶

該插件適合需要明確記憶邊界、不希望引入向量數據庫或嵌入服務的本地智能體場景。

• 權限與來源：插件以當前 DSH 進程的權限運行。安裝前建議檢查源碼與許可證（MIT）。
• 注入機制：記住 Agent 永遠不會寫入注入層（ME.md 等），所有提升操作必須由人工在右側欄完成。
• 無 LLM 依賴：插件內部不進行 LLM 調用，所有邏輯基於文件讀寫。

結尾¶

dsh-memento 通過簡單的文件系統操作，爲本地智能體提供了一種可控的記憶管理方案。更多細節與源碼，請訪問：https://github.com/janpauldahlke/dsh-memento