前言¶
DSH 智能體開發裏有一個具體痛點：會話結束後上下文會被清空，之前確認過的事實、任務經驗和環境信息不會自動保留。dsh-layered-memory 是 DeepSeek Harness（DSH）的跨會話長期記憶插件。它把值得留下的信息寫成文件放在磁盤上，之後的會話再按需取回。
這是什麼¶
該插件定位爲 DSH 的記憶插件，倉庫地址爲 https://github.com/DDDFXYqiming/dsh-layered-memory，採用 MIT 授權。
它圍繞以下能力提供服務：
- 跨會話長期記憶
- 命名空間隔離
- L1 索引注入
- L2 環境事實
- L3 任務經驗
- BM25 全文檢索
- 內容級近重複去重
- 跨命名空間提升
- 重試序列蒸餾
- 溯源
- 歸檔與回滾
- 自動維護
- 漸進式工具暴露
插件共提供 14 個記憶工具。它作爲 DSH 插件運行，插件以當前 dsh 進程權限運行，安裝前應先檢查源碼與許可證。
核心能力¶
先看工具暴露方式。progressive 模式下，Agent 按需調用一次 memory_activate，這批工具才進入它的工具列表。
下面按已覈實的使用路徑介紹幾個關鍵工具：
1、memory_write
寫入 fact/sop，evidence 必填。該插件要求只寫成功驗證過的信息。
2、memory_search
使用 BM25 全文檢索，包含已歸檔條目。需要跨庫查找時，可使用 all_namespaces。
3、memory_index
重建 L1 索引自動段，並保留 [RULES] 手動段。
4、memory_promote
用於跨命名空間提升，例如把項目局部經驗提升到全局 default。
5、memory_update
用於同主題記憶演進。系統不做自動矛盾檢測；一致性靠查重、memory_update、memory_maintain 合併候選、按時間線裁決保障。
6、memory_maintain
用於維護過程中的合併候選與一致性處理。
在寫入邊界上，已驗證事實可壓縮、遷移、supersede 或 archive，但嚴禁物理丟棄。插件也不存時間戳、PID、臨時路徑等易變狀態。
安裝¶
先確認運行環境：
Node >=22.19
peerDependencies 要求 @deepseek-ai/cordis >=4.0.0-rc <5 及多個 @deepseek-ai 包
從 GitHub 安裝：
dsh plugin --profile web add github:DDDFXYqiming/dsh-layered-memory
本地開發時也可以直接使用倉庫目錄：
dsh plugin --profile web add <本目錄>
典型用法¶
下面是一組可復現的調用順序：
1、如果插件處於 progressive 模式，先讓 Agent 調用 memory_activate，讓這批記憶工具進入工具列表。
2、需要寫入記憶時，調用 memory_write 寫入 fact/sop。evidence 必填，只寫成功驗證過的信息。
3、需要查找記憶時，調用 memory_search 做 BM25 全文檢索。檢索範圍包含已歸檔條目；需要跨命名空間查找時，使用 all_namespaces。
4、L1 索引需要重建時，調用 memory_index。該操作會重建 L1 索引自動段，並保留 [RULES] 手動段。
5、某條經驗從項目局部上升到全局可用時，調用 memory_promote，將項目局部經驗提升到全局 default。
開發與測試¶
開發環境可使用以下命令：
pnpm test
pnpm test:smoke
單元測試會 import @deepseek-ai/dsh-tools / @deepseek-ai/schemastery，這些是 DSH 內置包。
在 pnpm 11 預檢環境中，可能因 DSH 私有包報 ERR_PNPM_FETCH_404。倉庫建議/已配置 verifyDepsBeforeRun: false。
適用場景與注意¶
這個插件適合需要跨會話保留已驗證事實、任務經驗和環境信息的 DSH 智能體場景，尤其適合按命名空間隔離不同項目或工作區記憶的用法。
使用前注意幾點：
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼和 MIT 許可證。
memory_write的evidence必填，只寫成功驗證過的信息。- 不保存時間戳、PID、臨時路徑等易變狀態。
- 系統不做自動矛盾檢測，一致性依賴查重、
memory_update、memory_maintain合併候選和按時間線裁決。 - 已驗證事實可以壓縮、遷移、supersede 或 archive，但不應物理丟棄。
結尾¶
dsh-layered-memory 的價值在於把 DSH 會話中的已驗證信息沉澱爲可檢索、可演進、可隔離的跨會話記憶。DSH 生態的理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應寫成官方應用商店。
倉庫地址：https://github.com/DDDFXYqiming/dsh-layered-memory。
