前言¶

Agent 在 DeepSeek Harness 中完成一次任務後，默認不會把項目背景、規則約束和後續糾正自動帶到下一次會話。如果你希望新會話能帶着上下文開工，同時又希望記憶數據仍以 Markdown 留在本機，zhujunpeng12/dsh-memory-system 是一個可以評估的 DSH 插件。

它把記憶數據放在本機 Markdown，默認使用 ~/.dsh-memory/，也可以把 MEMORY_VAULT 指向自己的 Obsidian Vault。

這是什麼¶

dsh-memory-system 是 zhujunpeng12 維護的 DeepSeek Harness 記憶插件，許可證爲 MIT。

它解決的問題是：讓 DSH 跨會話記住項目、規則和糾正，同時避免引入數據庫、向量服務或外部服務依賴。它不依賴後臺 LLM、不依賴向量檢索，也不要求必須使用 Obsidian、數據庫或外部 API。

核心能力¶

啓動熱記憶¶

新會話開始時，系統先注入一個有預算的熱包，而不是讓 Agent 先翻完整記憶庫。熱包限制在 ≤14KB，用於讓 Agent 在不讀全庫的情況下帶着上下文開工。

可以使用 memory_bootstrap 工具，或在倉庫目錄運行：

python vault-guard/bootstrap.py --cwd <項目目錄> --max-bytes 14000

推薦插件形態通過原生 agent/pre-step 在每個 session 首輪自動執行。

中文冷層召回¶

當任務需要歷史細節時，再觸發冷層召回。它使用 exact 匹配、中文 bigram BM25 和元數據重排，輸出限制在 ≤4.2KB 的冷包，並附 trace。向量檢索默認關閉。

可以使用 memory_recall 工具，或運行：

python vault-guard/recall.py --query <問題> --cwd <目錄> --force

授權寫入¶

寫入不是自動發生。memory_write 默認 dry-run，用戶確認後才落盤。

落盤過程使用以下機制：

• 30s 租約單寫鎖
• 5s 心跳
• before-image
• SHA-256 前置條件
• manifest
• receipt

raw 記錄只追加，糾錯必須使用 supersedes。

使用 memory_write 時，操作類型可以是 op=raw/replace/recover；只有 apply=true 時才落盤。

治理只讀¶

memory_govern 用於掃描記憶庫中的候選問題，包括：

• 重複
• 衝突
• 過期
• 體量
• 規則生命週期候選

它只讀，默認不寫。晉升、歸檔、刪除永遠需要人確認。

可以運行：

python vault-guard/govern.py --json --max-items 100

軌跡覆盤¶

memory_trajectory_review 只讀掃描會話軌跡，以用戶糾正作爲硬信號，產出覆盤候選。它不是自動判錯，也不是自動寫入記憶庫。

可以運行：

python vault-guard/trajectory-review.py --cwd <目錄>

安裝與啓用¶

安裝前提¶

安裝前確認環境中已有：

DeepSeek Harness 0.1.0-rc.7
Node.js 22/24
Python 3.10+

安裝命令¶

下面命令把倉庫安裝到 web profile：

npx @deepseek-ai/dsh plugin --profile web add github:zhujunpeng12/dsh-memory-system

安裝完成後，重啓 Harness。

啓用確認¶

重啓後，在新會話讓 Agent 運行 memory_gate，並確認新會話收到：

[vault-bootstrap]

這一步用於確認熱記憶注入鏈路是否生效。

典型用法¶

1、重啓 Harness 後，先確認新會話收到 [vault-bootstrap]。

2、需要手動注入熱包時，運行：

python vault-guard/bootstrap.py --cwd <項目目錄> --max-bytes 14000

3、需要查找歷史規則、項目約定或糾正記錄時，運行：

python vault-guard/recall.py --query <問題> --cwd <目錄> --force

4、需要寫入持久內容時，先用 memory_write 做 dry-run 預覽，確認無誤後再讓 apply=true 落盤。

5、懷疑記憶庫有重複、衝突、過期或體量問題時，運行：

python vault-guard/govern.py --json --max-items 100

6、收尾階段需要基於會話軌跡產出覆盤候選時，運行：

python vault-guard/trajectory-review.py --cwd <目錄>

適用場景與注意¶

適合¶

適合以下情況：

• 希望 DSH 跨會話記住項目、規則和糾正
• 希望記憶源是 Markdown，可用編輯器審閱
• 希望中文歷史召回可解釋，並能看到 trace
• 希望寫入有 dry-run、確認和可恢復機制
• 希望記憶數據留在本機，而不是進入數據庫或外部服務

不適合¶

不適合以下場景：

• 多租戶服務端
• 高頻多寫者
• 默認語義向量
• 全自動無審批記憶寫入

安全與權限¶

dsh-memory-system 的倉庫只包含機制，不包含任何個人數據。畫像、規則、事件和項目筆記應始終留在使用者本機。

使用前建議檢查源碼、許可證和寫入路徑。插件以當前 dsh 進程權限運行，安裝前應確認來源可信。寫操作默認 dry-run，治理只讀，晉升、歸檔、刪除都需要人工確認。

鏈接¶

• GitHub：https://github.com/zhujunpeng12/dsh-memory-system
• 目錄頁：本次已覈實資料未提供可確認的目錄頁 URL，本文不列具體地址；可按倉庫名 zhujunpeng12/dsh-memory-system 在社區目錄中搜索。這裏不把它寫成官方應用商店。