前言¶
DeepSeek Harness (dsh) 理念是「一切皆插件」，社區維護了各類擴展。在開發智能體時，一個常見問題是記憶庫無限膨脹，導致上下文窗口溢出。dsh-memory-hermes 插件基於 Nous Research Hermes Agent 的記憶系統設計，提供了一種「有界策劃記憶」的方案。它不追求越攢越多的記憶庫，而是逼着模型維護一份精煉的長期事實清單，並在會話開始時凍結注入，提升提示詞緩存友好度。
核心功能¶
本插件提供以下能力：
* 雙文件記憶：分別維護 MEMORY.md (agent 筆記) 和 USER.md (用戶畫像)。
* 凍結快照：會話開始時讀入提示，會話內寫入實時落盤，下個會話才進快照。
* 後臺自省：fork 循環重看會話，雙路分流（memory 路 + skill 路）。
* 技能庫：沉澱技術經驗進 skill 庫，支持 curator 維護。
* 安全掃描：寫入時 + 注入渲染時 + 錯誤載荷三處掃描。
* 審批閘門：可配置每次寫操作彈審批。
* 併發安全：進程內 promise 鏈串行 + 跨進程 .lock 文件鎖 + 原子寫。
* 自省可觀測：記錄 review 落點，設置頁「活動」頁籤可查。
安裝與啓用¶
確保前置環境滿足：Node 22+（dsh 要求 ^22.19 || >=24），dsh CLI 可用。
cd dsh-memory-hermes
npm install
npm run build
npm pack
dsh plugin --profile web add "./dsh-memory-hermes-<version>.tgz"
安裝時需遵守兩條硬規矩：
1. 必須用 npm pack 出的 tgz 安裝，不要裸目錄或 link:。鏈接安裝會導致 Node 解析到插件本地 devDeps 的 node_modules，造成宿主無法識別服務，面板 RPC 404。
2. 裝進內置 profile (web/tui/headless)，不要在自定義 profile 裏手動補裝 @deepseek-ai/dsh-web-app。自定義 profile 的副本會遮蔽共享層，導致工具調度器 Symbol 查空，工具調用整輪失敗。
配置¶
v2 起，配置走 dsh settings 服務。插件註冊 memory-hermes 命名空間，bundle patch 的 entry config 作爲 base，$DSH_HOME/settings.yaml 裏的同名 section 作爲用戶層覆蓋。
在 $DSH_HOME/settings.yaml 中添加：
memory-hermes:
memoryCharLimit: 3000
配置項包含（schema 默認兜底）：
* memoryCharLimit：MEMORY.md 上限（默認 2200）。
* userCharLimit：USER.md 上限（默認 1375）。
* securityScan：是否開啓安全掃描。
* approval：是否開啓審批閘門。
* backgroundReview：後臺自省總開關。
* reviewTrigger：觸發策略（every-turn | token-delta | manual）。
* skillReview：是否開啓 skill 路分流。
* curatorEnabled：庫維護層總開關。
注意：id 覆蓋是整體替換 config，不深合併。修改配置後保存即生效（熱生效），無需重啓。
使用與命令¶
安裝後，可通過斜槓命令和設置頁使用：
/memory：查看/管理記憶。/memory review [focus]：手動觸發後臺自省。/memory compact：合併記憶條目。/memory skills：管理技能庫。
在 dsh web 設置導航的「記憶」頁，可以查看文件內容和活動記錄（包含逐步工具調用 trace）。
機制細節¶
- 凍結快照：會話開始時讀入提示，會話內寫入實時落盤，下個會話才進快照。這實現了 prompt-cache 友好。
- 溢出紀律：增長型超限寫入不落盤，報錯並要求合併重試；縮小型操作總是放行。
- 安全掃描：在寫入時、注入渲染時、錯誤載荷三處應用同一規則表（不可見 Unicode、注入話術等）。
- 後臺自省：每個 completed turn 結束後，按觸發策略（token-delta 或 every-turn）發起獨立 LLM 調用。支持 fork 循環（默認 8 步）進行記憶/技能分流。
- 記憶/技能分流：
- memory 路：存用戶畫像、行爲期望、當前狀態。
- skill 路：沉澱技術經驗、工作流修正。
- 併發安全：通過 promise 鏈串行、
.lock文件鎖和原子寫保證多進程安全。
注意事項¶
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- 若
approval: true，後臺 review 觸發會被抑制，因爲後臺寫無法彈審批。 - 配合 dsh 船載 session-query 可實現跨會話檢索（可選）。
總結¶
dsh-memory-hermes 提供了一套有界、精煉、併發安全的記憶管理方案。它通過凍結快照、後臺自省和技能庫分流，解決了智能體記憶膨脹和上下文混亂的問題。適用於需要長期維護穩定狀態和知識沉澱的開發場景。
