前言¶

DeepSeek Harness（DSH）採用插件化架構，開發者常需要爲智能體配置持久化記憶。現有的記憶方案往往涉及向量數據庫或自動提取，配置較重。dsh-md-memory 插件提供了一種輕量級方案：模型將需要保留的內容寫入 markdown 文件，宿主在會話中注入這些文件。這解決了跨會話記憶的簡單需求，同時保持了文件的可讀性和可控性。

插件簡介¶

該插件由 CuteSamurai24 維護，開源協議爲 MIT。它不自動提取聊天內容，也不依賴向量或全文引擎。記憶的寫入完全由模型顯式調用工具觸發，確保了操作的透明度。

安裝與卸載¶

插件默認開啓。通過以下命令安裝：

dsh plugin --profile web add github:CuteSamurai24/dsh-md-memory

安裝後需要重啓 dsh web 使其生效。

如需卸載，運行：

dsh plugin --profile web remove dsh-md-memory

注意：卸載插件不會刪除 ~/.dsh/memory 目錄下的文件。

文件結構與內容¶

記憶數據存儲在 ~/.dsh/memory 目錄下，結構如下：

~/.dsh/memory/
  user.md              跨項目的用戶信息、身份、基礎偏好
  agent/MEMORY.md      每次會話通用的熱規則（保持簡短）
  agent/topics/*.md    按需加載的主題文件

在 Windows 系統上，路徑對應 C:\Users\<你>\.dsh\memory\。你可以直接用文本編輯器打開這些文件進行查看、編輯或刪除。

記憶工具與使用規範¶

插件提供統一的 memory 工具，支持以下操作：

• 讀取類：read、search、list
• 寫入類：append、edit、write
• 管理類：create、delete

使用時需注意以下限制：

1. 追加規則：向 user.md 追加內容時，必須提供一個 reason（一句話理由），說明爲何這條信息在當前項目之外也成立。
2. 容量限制：user.md 限制在 8KB，agent/MEMORY.md 限制在 12KB，單個 topics/*.md 限制在 20KB。長材料應放入 topics 目錄。
3. 子代理限制：子代理無法寫入記憶，這避免了並行任務中因併發寫入導致的衝突。

限制與注意事項¶

該插件並非“第二大腦”，它不承擔自動從聊天中提取信息的功能。此外：

• 安全性：不進行密鑰掃描，不要讓模型在此目錄中寫入敏感 Token。
• 搜索能力：search 功能僅支持簡單的子串匹配，不支持向量檢索或全文檢索。
• 禁用方式：如需關閉，在 ~/.dsh/settings.yaml 中添加配置：

md-memory:
  enabled: false

結語¶

dsh-md-memory 適合需要在 DSH 中保留簡單文件記憶、且希望保持配置透明和輕量的場景。它通過顯式的工具調用和文件存儲，爲開發者提供了一個可控的記憶層。

• GitHub 倉庫
• 插件目錄