前言¶
在 DeepSeek Harness(DSH)裏做長期協作時,模型往往只在單次會話內保留上下文;換會話或新開窗口後,項目約定、偏好和踩過的坑需要重新說明。社區裏也有各自實現的「記憶」方案,目錄結構和注入方式並不統一。若你已經在 Claude Code 裏用文件型自動記憶,或希望 DSH 與 Claude Code 共用同一套 MEMORY.md 索引,下面介紹維護者 jayhchen 發佈的記憶類插件 dsh-cc-auto-memory(npm 包名同插件 id,當前版本 0.1.2,MIT 許可證)。
這是什麼¶
dsh-cc-auto-memory 把 Claude Code 原生的 auto memory 機制移植爲 DSH 輕量插件:持久化、基於磁盤文件,不註冊專用 memory 工具,而是依賴模型在會話裏使用普通的 read / write / edit 管理記憶文件。磁盤格式與 Claude Code 一致;在 claude 存儲模式下可與 Claude Code 共用同一記憶目錄,雙向互通。
工作機制¶
每個會話開始時,宿主會向系統提示詞注入兩類內容:記憶使用說明(含記憶目錄路徑),以及 MEMORY.md 索引的前 200 行或 25 KB(二者以配置爲準)。模型據此讀寫記憶;每次對記憶文件的 write / edit 之後,宿主會維護 modified 時間戳並 enforce 索引大小限制,下一次會話再注入更新後的索引,形成循環。
按項目劃分記憶目錄:以 git 倉庫根目錄解析項目(不在倉庫內則用當前工作目錄);路徑 slug 中 / 會替換爲 -,每個倉庫一份獨立記憶。目錄內典型結構爲:
MEMORY.md:索引,一行對應一條記憶<topic>.md:每條記憶一個文件
子 agent 會話不會注入主會話的記憶,行爲與 Claude Code 一致。機制細節可參考 Claude Code 官方 auto memory 文檔。
存儲模式與設置頁¶
插件在 Settings → Auto Memory 提供只讀查看面板;創建、修改、刪除仍由會話中的 agent 通過文件工具完成。
- Storage mode:兩張模式卡片(DSH 獨立目錄 / 複用 Claude)加「Apply switch」。切換僅對新會話生效。
-dsh(默認):$DSH_HOME/projects/<slug>/memory/
-claude:~/.claude/projects/<slug>/memory/(尊重CLAUDE_CONFIG_DIR),與 Claude Code 共享同一記憶。
在 claude 模式下,模型對 ~/.claude/ 的寫入可能落在會話工作區外,會按會話沙箱策略觸發審批,屬預期行爲。
-
Project list:按當前模式過濾——
dsh只顯示$DSH_HOME下項目,claude只顯示~/.claude下項目。 -
Memory table:點擊任意行可在浮層中查看原始文件內容(純文本,不渲染 Markdown);Esc 或點擊遮罩關閉。
配置¶
可在用戶層覆蓋 cordis.patch.yml:
| 字段 | 默認值 | 說明 |
|---|---|---|
mode |
dsh |
存儲模式:dsh / claude |
claudeConfigDir |
'' |
claude 模式下 Claude Code 配置根;空則使用 $CLAUDE_CONFIG_DIR 或 ~/.claude |
maxIndexLines |
200 |
讀取 MEMORY.md 的行數上限 |
maxIndexBytes |
25600 |
讀取 MEMORY.md 的字節上限 |
安裝與啓用¶
DSH 生態採用「一切皆插件」;插件可在社區目錄站點檢索,該站點爲獨立社區資源,與 DeepSeek / 幻方無官方從屬關係。
Web 環境(CLI)安裝:
dsh plugin --profile web add dsh-cc-auto-memory
Desktop:打開應用內 Plugins 頁,搜索 dsh-cc-auto-memory 安裝。
運行環境要求 Node.js >= 20(見 package.json engines)。插件以當前 DSH 進程權限運行,安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證。
典型用法¶
安裝並啓用後,無需單獨調用 memory API:在新會話中,系統提示已包含記憶說明與 MEMORY.md 片段。你可以在對話中讓模型「把某條約定寫入記憶」或「更新某 topic 文件」,模型會使用 read / write / edit 操作記憶目錄;你可在 Settings → Auto Memory 只讀覈對內容。
若希望與本地 Claude Code 共用記憶,將 mode 設爲 claude(或在設置頁切換並 Apply),再開新會話;兩端的 MEMORY.md 與 topic 文件格式相同,可直接互認。
適用場景與注意¶
- 適合:需要在 DSH 中長期保留項目級事實、偏好與決策記錄;已在 Claude Code 使用 auto memory、希望 DSH 側無縫續用或雙端同步的開發者。
- 注意:索引注入有行數與字節上限,條目過多時需依賴
MEMORY.md索引設計與拆分 topic 文件;子 agent 無主會話記憶注入;claude模式下的跨目錄寫入可能觸發審批。
結尾¶
dsh-cc-auto-memory 把 Claude Code 的文件型自動記憶搬到 DSH:會話啓動注入索引、普通文件工具維護、可選與 Claude Code 共目錄。更多信息見社區目錄頁 jayhchen/dsh-cc-auto-memory 與 GitHub jayhchen/dsh-cc-auto-memory。