前言¶
在 DSH 的多會話工作流裏，常見的問題是：用戶偏好、已驗證步驟和失敗教訓沒有穩定載體，新的會話又要重新說明。已有做法通常是把上下文複製到提示詞，或手動維護一份筆記；這種方式依賴人工更新，也容易遺漏。
下面介紹 dsh-memory。它是面向 DeepSeek Harness（DSH）的長期記憶插件，用於把已完成會話中的可複用信息抽取出來，形成摘要與記憶文件，並注入後續會話。
這是什麼¶
dsh-memory 是一個記憶類插件，倉庫爲 yan5236/dsh-memory，許可證爲 MIT。
它解決的是 DSH 會話之間的長期記憶問題：會話結束後做結構化抽取，達到冷卻後全局整合，隨後把摘要常駐注入到會話中，並提供記憶查詢與添加工具。
該插件需要 DeepSeek Harness。它通過 GitHub 分發，而不是 npm；package identifier 爲 @nanmicoder/dsh-memory。
核心功能¶
下面列出已覈實的幾項能力：
- 會話結束後按會話抽取結構化記憶，默認防抖窗口爲 3 分鐘。
- 達到冷卻後，全局整合新的 raw memories 到
MEMORY.md和memory_summary.md，默認冷卻爲 6 小時。 memory_summary.md作爲摘要常駐注入每個會話。- 提供
memory_list、memory_read、memory_search、memory_add四個記憶工具。 - 會話內容按數據處理，輸入輸出進行脫敏，記憶路徑限制在 memory root。
- 使用持久化 claim 避免重複抽取或重複整合；失敗後帶退避重試。
- 提供 Settings → Long-term memory 頁面，用於查看統計、手動運行和配置。
- 提供記憶管理器，支持文件樹、編輯和兩步刪除。
- Phase 1 和 Phase 2 可分別設置
off/low/high/max推理 effort。
其中，memory_add 僅在用戶明確要求時寫入。
安裝與啓用¶
先確認 DSH 環境可用。下面以 web profile 爲例。
在終端執行安裝命令，把插件添加到 web profile：
dsh plugin --profile web add 'git+https://github.com/yan5236/dsh-memory.git#main'
安裝後先做配置驗證，確認插件已經進入 profile：
dsh --profile web --dump-config
輸出中應包含：
- id: dsh-memory
如果 dump-config 缺少這一行，需要將 @nanmicoder/dsh-memory 加入 profile 的 dsh.profile.bundles 數組。
經過上面的步驟，啓動 DSH：
dsh web
啓動後打開：
Settings → Long-term memory
記憶文件默認位於：
$DSH_HOME/memories/
典型用法¶
啓用插件後，可以從頁面和會話工具兩處使用。
在 Settings → Long-term memory 頁面，可以查看統計、手動運行和配置插件。常見配置項包括：
memoryRoot
provider
model
consolidationCooldownMs
idleDebounceMs
maxRolloutsPerRun
maxSummaryChars
其中，memoryRoot 對應記憶文件根目錄，默認路徑爲 $DSH_HOME/memories；consolidationCooldownMs 對應全局整合冷卻時間，默認值爲 6 小時；idleDebounceMs 對應會話結束後的防抖窗口，默認值爲 3 分鐘。
在 DSH 會話中，模型可以使用四個記憶工具：
memory_list
memory_read
memory_search
memory_add
memory_add 不是自動寫入工具，僅在用戶明確要求時寫入。
另外，也可以將 README 中的 one-prompt install 代碼塊粘貼到 DSH 會話中，由 agent 執行安裝、註冊和驗證。如果某一步寫入 $DSH_HOME/profiles 被權限策略阻止，應請求用戶切換 Full access 或批准操作，不得繞過或靜默失敗。
適用場景與注意¶
這個插件適合需要跨會話保留偏好、步驟和失敗教訓的 DSH 使用者，尤其是使用 web profile、希望減少重複說明並保留可查詢記憶文件的場景。
使用前注意以下幾點：
- 該插件以當前 DSH 進程權限運行，因此會讀寫 DSH 相關文件。
- 安裝前應檢查源碼和許可證；許可證爲 MIT。
- 插件通過 GitHub 分發，不是 npm 包；package identifier 爲
@nanmicoder/dsh-memory。 package.json聲明engines.node爲^22.19.0 || >=24.0.0。- 社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係；不要把插件分發源理解爲官方應用商店。
- 本文資料中未提供可驗證的目錄頁 URL；倉庫地址爲
https://github.com/yan5236/dsh-memory。
結尾¶
dsh-memory 的核心價值是：把會話中的可複用信息抽成長期記憶，通過摘要注入和四個記憶工具，讓後續會話減少重複指令。經過安裝、驗證和啓動後，可以在 Settings → Long-term memory 頁面查看統計、手動運行和配置。倉庫地址：https://github.com/yan5236/dsh-memory。
