前言¶
在 DeepSeek Harness（DSH）中，普通 Session 結束後，Agent 很容易遺忘用戶偏好、項目約束和已驗證的經驗。dsh-memory 解決了這個問題，融合了 Claude Code 的 Auto Memory 與 Codex 的 Session 記憶整理思路，爲 DSH 提供簡單、透明、上下文友好的長期記憶。
核心能力¶
- 本地 Markdown 存儲：權威記憶保存在本機
$DSH_HOME/memory目錄，用戶可自行閱讀和備份。 - Global / Workspace 隔離：Global 保存跨項目偏好，項目事實僅進入當前 Workspace，避免信息污染。
- 漸進披露：Agent 先接收 Global 記憶與當前 Workspace 的索引，詳細內容按需通過 DSH 文件工具讀取。
- 安全寫入：檢測到併發修改時拒絕直接覆蓋，防止數據丟失。
- Session 整理：篩選已結束且穩定的 Session，由獨立整理 Agent 提煉記憶。
- 可觀察性：記錄整理結果，可選 Debug 日誌（不記錄對話正文或 API key）。
- 雙語界面：Memory 頁面跟隨 DSH Web 的 locale 自動切換。
安裝與啓用¶
- 執行安裝命令：
dsh plugin --profile web add @hr98w/dsh-memory
- 安裝完成後，完全重啓
dsh web以加載插件。
使用方式¶
- 保存項目約定：在測試 Workspace 中告訴 Agent：“記住，這個項目的發佈檢查代號是松果，每次發佈前先提醒我檢查回滾方案。”
- 查詢約定：新建同一 Workspace 的 Session，詢問：“這個項目發佈前有什麼約定？”
- 配置整理模型：在設置頁面選擇 Session 整理使用的模型。
- 管理跨項目偏好：在全局記憶中保存跨項目的通用偏好。
注意事項¶
- 重啓生效：安裝或更新後必須完全重啓
dsh web才能生效，刷新頁面無效。 - 併發限制：併發保護限於同一個 MemoryStore 實例，建議由一個 DSH 進程負責同一
$DSH_HOME的記憶寫入。 - 數據隱私：Debug 默認關閉，不記錄對話證據、記憶正文或 API key。Web 管理接口只允許本機訪問。
- 本地優先：權威記憶保存在本機，但不代表所有模型處理都離線完成。
- 插件生態：DSH 理念是“一切皆插件”，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
總結¶
dsh-memory 通過本地存儲與漸進披露機制，解決了 Agent 長期記憶的問題。其開源 MIT 許可證允許自由使用與修改。
