前言¶
在 DSH 和多 Agent 工作流裏，一個常見問題是：dsh、Codex、Claude Code 與 Hermes 各自產生記憶，彼此隔離；開發者想檢查、修正或複用沉澱下來的事即時，缺少一個可直接編輯、可人工審查的存儲層。
unified-agent-memory 針對這一點提供一個共享 Obsidian Vault 記憶倉庫，並用本地 SQLite FTS5 索引提供檢索。下面介紹它的定位、核心能力、安裝方式和典型用法。
這是什麼¶
unified-agent-memory 是維護者 Noelune 提供的 DSH 插件。npm 包名爲 dsh-unified-agent-memory，倉庫名爲 unified-agent-memory，許可證爲 MIT。
它面向 dsh、Codex、Claude Code 與 Hermes 等 Agent 運行時，提供共享的 Obsidian Vault 記憶倉庫。Python 核心要求 Python 3.9+，且僅使用標準庫；具體核心依賴標準庫模塊包括 sqlite3、json、hashlib、argparse、os。
DSH 側環境要求 Node >=20，並聲明 peerDependencies：
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-tools ^0.1.0-rc.6
插件在 DSH 中提供這些工具：
memory_search
memory_show
memory_submit
memory_status
核心功能¶
共享 Vault 與本地索引¶
該插件爲 dsh、Codex、Claude Code 與 Hermes 提供共享的 Obsidian Vault 記憶倉庫。SQLite FTS5 本地全文索引文件位於：
~/.unified-memory/index-<vault-hash>.db
這樣，多個 Agent 可以圍繞同一份 Markdown 知識倉庫提交、檢索和複用事實，同時開發者可以直接用文本編輯器審查內容。
知識生命週期管理¶
插件支持知識生命週期管理，覆蓋：
1、知識攝取
2、知識晉升
3、衝突裁決
4、衰減遺忘
其中，遺忘/衰減爲可逆歸檔，不刪除。遺忘評分採用：
重要性 × (持久地板 + 時間衰減) + 訪問強化
檢索能力¶
基礎檢索通過 memory_search 提供。混合檢索可執行：
memory search --hybrid
混合檢索融合 BM25、語義向量與概念圖譜；無向量時可回退純 BM25。
可選語義向量層¶
語義向量層是可選能力：
memory embed
該能力使用 SiliconFlow Qwen/Qwen3-Embedding-4B，並在本地 SQLite 存儲向量。
會話自動提煉¶
會話自動提煉使用：
memory digest
該能力默認開啓，可按日期遊標冪等執行，也可使用 --dry-run 預覽，或使用 --off 關閉。
版本化取代¶
當新事實取代舊事即時，插件會把舊事實移入“已取代”小節，並標記 superseded。檢索時只返回最新版本。
安全輸出與憑據脫敏¶
插件提供提示詞隔離防護與憑據脫敏。檢索輸出使用 <memory-data> 標記包裝，用於區分數據上下文與系統指令。
DSH 自動部署¶
插件提供 DSH 自動部署流程，可寫入 AGENTS.md / CLAUDE.md 等規則文件，並執行 selfcheck。
默認部署決策如下：
1、主控 Agent 優先分配給 Hermes，未檢測到則分配給部署 Agent。
2、索引模式爲 local machine。
3、知識晉升模式爲 human-confirmed review。
4、自動連接 dsh / Codex / Claude / Hermes。
非 DSH 環境可通過 docs/AGENT-DEPLOY-PROMPT.md 中的 Prompt 觸發部署。
安裝與啓用¶
1、在 DSH 中安裝插件：
dsh plugin --profile web add dsh-unified-agent-memory
2、安裝完成後，調用 memory_status 查看插件狀態。
3、如果需要手動初始化 Python core，可按下面步驟操作：
git clone https://github.com/Noelune/unified-agent-memory.git
cd unified-agent-memory
pip install -e ./core
python setup/setup.py init --vault ~/Documents/AgentMemory
先克隆倉庫並安裝 Python core，再初始化指定 Vault 目錄。
典型用法¶
提交與檢索事實¶
提交一條事實：
memory submit "staging 服務器環境綁定在 127.0.0.1:8080" --agent alpha
檢索這條事實：
memory search "staging 服務器"
晉升與裁決¶
生成待晉升清單：
python -m unified_memory.promoter --review
應用晉升結果：
python -m unified_memory.promoter --apply
先做 --review 查看待晉升內容，再做 --apply 應用晉升。
混合檢索與向量層¶
使用混合檢索：
memory search --hybrid
啓用可選語義向量層：
memory embed
會話自動提煉¶
預覽會話提煉結果：
memory digest --dry-run
關閉會話自動提煉：
memory digest --off
遺忘歸檔¶
執行遺忘歸檔：
python -m unified_memory.forgetter --apply
該操作是可逆歸檔，不刪除原始內容。
適用場景與注意¶
適合需要讓多個 Agent 共享記憶、並且希望知識可人工審查的 DSH 使用者。尤其是同時使用 dsh、Codex、Claude Code 與 Hermes 的多 Agent 場景。
使用注意：
1、該插件以當前 dsh 進程權限運行；安裝前應檢查源碼、依賴和許可證。
2、許可證爲 MIT，Node >=20，Python 核心要求 Python 3.9+ 且僅使用標準庫。
3、語義向量層爲可選能力；若啓用，API key 存於 ~/.unified-memory/secrets.yaml，權限爲 0600 / 用戶 ACL，失敗時靜默降級。
4、遺忘/衰減爲可逆歸檔，不刪除。
5、DSH 插件生態強調插件化；社區目錄屬於獨立站點，不應理解爲 DeepSeek 或幻方的官方應用商店。
結尾¶
unified-agent-memory 提供的是共享 Obsidian Vault、本地 SQLite FTS5 檢索，以及覆蓋攝取、晉升、裁決與遺忘的知識生命週期管理。適合需要把多個 Agent 的記憶統一到可審查倉庫中的 DSH 工作流。
GitHub：
https://github.com/Noelune/unified-agent-memory
目錄頁（項目線索中的 URL）：
https://www.skillhub.cn/plugins/Noelune/unified-agent-memory
