前言¶

DSH 裏做記憶相關插件時，常見的問題是跨會話信息不連續：環境事實、項目約定、工具怪癖，以及用戶偏好、溝通風格、工作習慣，如果不能持久化，下一次會話還要重新交代。

dsh-hermes-memory 把 agent 的記憶分成兩個獨立的庫：MEMORY.md 記錄關於世界的事實，USER.md 記錄關於你的畫像。兩個庫各自獨立預算、獨立淘汰。下面介紹它的核心能力、安裝方式和使用注意。

這是什麼¶

dsh-hermes-memory 是 DeepSeek Harness（DSH）的雙庫記憶插件，維護者爲 isheng-eqi，許可證爲 MIT。

它把“環境事實 / 項目約定 / 工具怪癖”和“用戶偏好 / 溝通風格 / 工作習慣”分開保存，並提供 memory 工具、輔助工具、內置 Web 記憶面板，用於查看、編輯、刪除、添加兩個記憶庫條目。

核心功能¶

兩個記憶庫¶

• MEMORY.md：記錄環境事實、項目約定、工具怪癖，字符上限爲 2200 字符。
• USER.md：記錄用戶偏好、溝通風格、工作習慣，字符上限爲 1375 字符。
• 兩個庫的字符上限是硬編碼，不是 token 數；動態 Cordis 形態沒有配置通道，如需調整請使用 bundle 安裝。

memory 工具¶

memory 工具支持：

• add
• replace
• remove
• batch（全有或全無）

參數使用如下：

• action 爲 add / replace / remove / batch
• target 爲 memory / user
• replace / remove 使用 oldText 匹配
• batch 使用 operations 數組

匹配策略是精確匹配優先；UI 傳完整文本時永遠唯一命中，模型子串匹配作爲回退。多條命中會報衝突。超限時不靜默丟棄，會返回當前條目列表，模型當輪合併後重試；每輪失敗上限爲 3。

會話注入與提醒¶

• 會話開始時注入凍結快照。
• 會話中途寫入不改變已注入快照。
• 連續 10 輪無寫入時提醒持久化。

輔助工具¶

• memory_search
• memory_list
• memory_stats
• memory_debug

存儲與面板¶

• 存儲到 ~/.dsh/storages/hermes_memory.json。
• 寫入爲原子寫，跨會話、跨重啓持久。
• 內置 Web 記憶面板，可查看、編輯、刪除、添加兩個記憶庫條目。
• 無 webServer 的環境（TUI/headless）自動跳過面板層，工具與注入不受影響。
• 零外部依賴；工具內部無 LLM，即零 LLM 成本。

安裝與啓用¶

先確認插件以當前 dsh 進程權限運行，安裝前應檢查源碼和許可證。下面給兩種啓用方式。

bundle 安裝¶

使用安裝命令：

dsh plugin --profile web add github:isheng-eqi/dsh-hermes-memory

如果使用本地目錄，可以用：

dsh plugin --profile web add /path/to/dsh-hermes-memory

動態 Cordis 形態¶

在任意 DSH 會話中，讓模型執行 cordis_define 與 cordis_run。動態插件隨進程退出消失，重啓後需要重新運行；數據不丟。

典型用法¶

1. 讓模型記：直接對模型說“記住 XXX”；新會話開始自動注入記憶快照。
2. 自己查看 / 修改：點擊側邊欄「記憶」，在面板查看、編輯、刪除、添加條目。
3. 使用 memory 工具時，按目標庫選擇 target 爲 memory 或 user，再根據操作類型填寫 action、oldText 或 operations。

適用場景與注意¶

適合希望把 DSH 的環境事實和用戶畫像分開持久化的場景。它適合需要模型自主維護記憶，同時又需要人工查看和修正兩個記憶庫的用法。

注意以下事項：

• 字符上限爲硬編碼：MEMORY 2200 字符、USER 1375 字符。
• 動態 Cordis 形態無配置通道；如需調整請使用 bundle 安裝。
• 無 webServer 的環境（TUI/headless）自動跳過面板層，工具與注入不受影響。
• 未實現：write_approval 審批門、提示注入安全掃描、session_search。
• Node engines 爲 ^22.19 || >=24。
• 可選 peerDependencies 包括：
• @deepseek-ai/cordis >=4.0.0 <5.0.0
• @deepseek-ai/dsh-tools >=0.1.0-rc.6 <0.2.0
• @deepseek-ai/schemastery >=3.0.0 <4.0.0

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/isheng-eqi/dsh-hermes-memory
• GitHub：https://github.com/isheng-eqi/dsh-hermes-memory