unified-agent-memory

统一 Agent 记忆系统（DeepSeek Harness 插件）：多 Agent 共享一个 Obsidian vault（dsh / Codex / Claude Code / Hermes…），配零依赖 Python core 完成检索/晋升/冲突裁决/遗忘生命周期。本地优先、零云依赖、5 分钟跑通闭环。

为什么需要它——与同类记忆插件的区别

大多数记忆插件是单 Agent 的：只记得你自己在你的 harness 里的会话。本项目是一个供一群 Agent 共享的完整自托管记忆系统：

能力	unified-agent-memory	典型单 Agent 记忆插件（dsh-mnemon、dsh-memory…）
dsh + Codex + Claude + Hermes 共享	✅ 同一 vault、同一份事实	❌ 仅限单一 harness
独立 core（不依赖任何 Agent 运行时）	✅ 纯 Python 标准库，纯 CLI 可用	❌ 依赖插件宿主
完整生命周期：晋升/去重/冲突裁决/遗忘	✅ 内置	⚠️ 通常只有存+取
本地优先索引（SQLite FTS5，无云）	✅ 默认	不一
人工确认晋升	✅ review → apply（auto 需显式开启）	无

对比 sgme（外部记忆引擎的桥接层）：本仓库是自带全套的 starter-kit——vault 模板 + core + 各 Agent 接入 + setup，无服务器也能完整部署。对比 nowledge-mem（prompt 召回 MCP 层）：本项目拥有包括晋升与遗忘在内的完整生命周期。

包含什么

• 一个 Obsidian vault = 所有 Agent 的最高事实源（canonical 笔记、写入口提交区、冲突队列、遗忘区）。
• 零依赖 Python core（core/）：memory init|search|show|submit、promoter --review/--apply/--auto/adjudicate、forgetter。零第三方包；不依赖任何 Agent 运行时。
• 本地优先语义索引：本机 SQLite FTS5（~/.unified-memory/index.db）——隐私不出本机；远端索引为可选进阶。
• 安全默认：凭据样式的行在提交时拒绝、输出时脱敏；检索结果包在 标记内（数据而非指令）；晋升默认人工确认；文件锁 + 原子写保证多 Agent 并发安全。
• dsh 一等公民：cordis 插件注册 memory_search / memory_show / memory_submit / memory_status 模型工具，未配置时优雅降级。
• Codex / Claude / Hermes 接入：现成的 AGENTS.md / CLAUDE.md 模板与 hooks 示例。

快速开始（5 步，无服务器、无 Hermes）

# 1. 获取代码并安装零依赖 core
git clone https://github.com/Noelune/unified-agent-memory.git && cd unified-agent-memory
pip install -e ./core

# 2. 一键初始化 vault（完整模板 + 配置）
python setup/setup.py init --vault ~/Documents/AgentMemory

# 3. 接入你的 Agent（任选）
dsh plugin --profile web add dsh-unified-agent-memory   # + 配置 vaultPath/UNIFIED_MEMORY_VAULT
cp AGENTS.md ~/.codex/AGENTS.md                          # Codex
cp CLAUDE.md ~/.claude/CLAUDE.md                         # Claude Code

# 4. 写一条、查一条
memory submit "the staging server runs on 127.0.0.1:8080" --agent alpha
memory search "staging server"

# 5. 晋升到 canonical（默认人工确认）
python -m unified_memory.promoter --review
python -m unified_memory.promoter --apply