前言¶
在 DSH（DeepSeek Harness）裏做智能體開發時，一個常見問題是會話之間的上下文不容易沉澱：某條規約、某次會話總結、某段處理經驗，當前會話能用，下一次會話不一定會自動帶入。dsh-memory-manager 就是爲這類問題提供的記憶管理插件。下面介紹它的定位、能力、安裝方式和典型用法。
這是什麼¶
dsh-memory-manager 是爲 DSH 打造的記憶管理插件，由 tuanmaoOVO 維護，許可證爲 MIT。它是宿主級插件，記憶庫數據跨會話共享並存儲於磁盤，用於把規約記憶、會話總結、上下文計劃和 Agent 記憶工具接入 DSH。
核心功能¶
這個插件主要圍繞“記憶庫、注入計劃、Agent 工具、面板與圖譜”幾件事展開。已覈實的能力包括：
- 跨會話記憶庫
- 文件夾記憶庫（Obsidian 兼容）
- 不可變快照 + 可編輯標註層
- 記憶標籤與啓用開關
- 規約記憶自動注入
- 會話總結
- 上下文計劃注入
- 6 個 Agent 記憶工具
- 印象（impressions）
- 組合（composedOf）與雙向鏈接（backlink）
- 左側力導向圖譜雙視圖
- 完整對話側欄面板
- 消息跳轉（JumpReceiver）
- 跨工作區會話列表
- 設置頁自由開關
- 非破壞性輪次排除 / 恢復
在使用上，可以先在記憶庫中保存規約記憶或會話總結記憶，再按會話選擇“加入計劃”或打開“臨時記憶模式”。如果記憶庫中存在規約記憶或會話總結記憶，新會話會自動常駐注入。Agent 工具行爲受 modelTools 與 enabled 雙重門控，其中 memory_pin / session_inject 需要能確定當前會話。
安裝與啓用¶
安裝前先確認本地已有 DSH 環境，並拿到 dsh-memory-manager 的倉庫路徑。插件安裝命令使用本地文件路徑，不是 GitHub 包路徑：
dsh plugin --profile <profile名> add file:<本倉庫路徑>
執行完成後，重啓 DSH。插件聲明：
node >=18
啓用後，DSH 設置頁提供自由開關；Agent 工具行爲還受 modelTools 與 enabled 雙重門控。
典型用法¶
下面是一組按順序可復現的操作。
1、在 DSH 所在環境執行安裝命令：
dsh plugin --profile <profile名> add file:<本倉庫路徑>
然後重啓 DSH。
2、在瀏覽器打開對話，點擊輸入欄左側「記憶 · 已關閉」按鈕打開側欄面板。
3、在「記憶庫」頁把記憶「加入計劃」，或在「計劃」頁打開「臨時記憶模式」。
4、如果記憶庫中存在規約記憶或會話總結記憶，新會話會自動常駐注入。
5、點面板頭部的「圖譜」按鈕打開左側力導向圖譜浮層。
6、如需快速體驗圖譜與檢索，可以把 libraryPath 指向：
examples/memory-library/
適用場景與注意¶
適合使用 dsh-memory-manager 的場景包括：
- 需要把規約、會話總結、長期經驗沉澱爲跨會話記憶庫。
- 希望 Agent 通過記憶工具讀寫記憶，並按計劃參與注入。
- 希望在瀏覽器側欄面板和左側圖譜中查看、檢索、跳轉相關記憶。
- 需要非破壞性地排除或恢復某些輪次參與注入。
需要注意：
- 插件以當前
dsh進程權限運行，安裝前應檢查源碼與許可證。 - 它是宿主級插件，記憶庫數據存儲於磁盤並跨會話共享，配置
libraryPath時要確認路徑可讀寫。 - Agent 工具不是無條件可用，受
modelTools與enabled雙重門控；memory_pin/session_inject需要能確定當前會話。 - 安裝命令中的
file:<本倉庫路徑>是本地文件路徑，不要替換爲未經確認的遠程包路徑。
結尾¶
經過上面的安裝和啓用步驟，dsh-memory-manager 可以把 DSH 中的會話經驗從手工整理變成可管理、可注入、可檢索的插件能力。先做記憶庫體驗，再做規約與會話總結注入，是接入它的一個穩妥路徑。
GitHub 倉庫：https://github.com/tuanmaoOVO/dsh-memory-manager
目錄頁：以插件線索爲準；已覈實資料未給出具體 URL。
