前言¶
在 DeepSeek Harness (DSH) 的 Web 環境下構建智能體時，上下文記憶往往是一個難點。默認情況下，對話是獨立的，無法自動積累長期知識。dsh-simple-memory 插件旨在解決這一問題，它提供了一套基於零代碼存儲的檢索式記憶方案。不需要配置數據庫或向量數據庫，插件通過文件系統與模型交互，幫助開發者在項目旁維護一份結構化的記憶倉庫。
插件定位¶
這是一個由社區成員 a903067276-rgb 獨立開發的非官方插件。它採用 Markdown 文件作爲存儲介質，利用 DSH 的插件系統作爲入口，將記憶管理融入日常對話流中，避免中斷正常工作流。
核心能力¶
會話索引注入¶
每次開啓新會話時，插件會在 agent/pre-step 階段注入三部分內容：
1. 當前項目進度：顯示最近的項目狀態，防止模型使用過期信息。
2. 最近 6 條筆記：自動抓取最近編輯過的筆記標題和首行結論，幫助模型快速關聯上下文。
3. 分類計數與搜索入口：提供全局或項目維度的記憶概覽。
四動作記憶菜單¶
點擊輸入框左側的燈泡圖標，會彈出一個四動作菜單，用於直接操作記憶：
* Recall (回顧)：審查當前對話輪次，列出值得記憶的候選內容（包括決策、坑點、偏好），確認後寫入。
* Promote (提升)：整理暫存池 (staging.md) 和夢境池 (dreams.md)，確認後將其提升至全局或項目目錄。
* Browse (瀏覽)：在側邊面板中查看、搜索和閱讀已存儲的記憶，無需佔用對話回合。
* Dream (夢境)：隨機抽取 3-5 條記憶，尋找跨項目的共性、矛盾或可複用方案，生成洞察並寫入夢境池。
記憶格式與限制¶
插件強制記憶文件遵循特定格式：分類-主題.md，且單個文件大小限制爲 2KB。這種限制迫使記憶條目保持精簡，便於檢索。
跨會話搜索¶
啓用全文本索引後，可以使用 session_search 功能在過往會話記錄中搜索關鍵詞（時間、工作區、標題、最佳匹配片段）。
夢境池機制¶
dreams.md 用於存放生成的跨項目洞察。這些內容包含來源記憶、連接關係和目標建議，同樣需要手動確認提升後纔會生效。
安裝與啓用¶
在終端中執行以下命令添加插件：
dsh plugin --profile web add "github:a903067276-rgb/dsh-simple-memory#main"
添加完成後，重啓 dsh web。進入設置頁的 “Memory” 板塊，點擊 “Initialize memory repo” 即可一鍵初始化記憶倉庫的目錄結構。
使用流程¶
日常記憶記錄¶
在對話過程中，當需要記錄關鍵信息時，點擊輸入框左側的燈泡圖標。選擇 Recall 模式，模型會列出候選條目，確認無誤後點擊寫入。或者，選擇 Dream 模式，讓模型基於已有記憶生成新的洞察。
記憶整理與提升¶
在 Promote 模式下，插件會列出暫存池和夢境池中的內容。你需要判斷這些內容的歸屬（是放入全局 common/ 目錄，還是放入特定項目），確認後執行提升操作。
瀏覽與搜索¶
點擊 Browse 模式，可以在彈出的面板中查看記憶列表。面板支持按項目或全局分組，並提供搜索框用於快速定位內容。
工作原理與文件結構¶
插件的核心是文件系統。默認記憶根目錄位於 ~/Documents/DSH/memory/（可在設置中修改）。
memory/
├── common/ # 全局經驗，跨項目複用
├── projects/ # 按項目分區的記憶
├── references/ # 冷知識庫，僅搜索
├── archive/ # 歸檔區，遺忘的記憶
├── staging.md # 待提升池
└── dreams.md # 夢境洞察池
所有記憶文件均以 Markdown 格式存儲，插件負責解析這些文件並將其內容注入到 DSH 的上下文中。
適用場景與注意¶
適用場景¶
- 需要長期維護項目上下文的智能體開發。
- 需要在多個項目間複用經驗（如代碼規範、踩坑記錄）。
- 希望保持零配置、零數據庫依賴的開發者。
注意事項¶
- 平臺支持：macOS 爲開發驗證環境，Linux 和 Windows 預期可用但未經過充分測試。
- 依賴要求：DSH Web 版本需 >= 0.1.0-rc.6。插件與舊版 DSH 的兼容性爲盡力而爲。
- Git 依賴：可選。安裝 Git 後，整個記憶根目錄會初始化爲一個 Git 倉庫，提供回滾安全機制。
- 非官方項目：該項目由社區成員維護，請根據需要自行檢查源碼與許可證。
