Agent Memory Backpack

让 DSH 与 Codex 两个桌面共享同一份有版本、要审核、可门禁的本地知识。

这是什么：一个本地知识库插件——核心是只监听 127.0.0.1 的 HTTP 服务加一个 SQLite 文件，DSH 与 Codex 各有一个适配器，另有 MCP 入口与托盘桌面控制台。默认在本机运行，无需云账号；可选模型与向量服务由用户自行配置。

2026-10-20：记忆归属、临时事实有效期和检索续查改进，以及 五个同类项目的一手研究。

续作：存量历史与技能导航整理、证据随采纳和日记保留。

给谁用：同时使用 DSH 和/或 Codex、希望两个 agent 遵守同一套规范并复用同一批经验的人。

不是全自动的地方：两端桌面的「加载插件 + 信任 hooks」必须在各自的桌面 UI 里亲手确认一次，CLI 无法代劳——这是安全设计，不是缺陷。安装脚本把其余步骤做完，并把这一步明确打印出来。

规范与经验今天散落在每个 agent 自己的文件里：你在 DSH 里立了一条规则，Codex 不知道；你在 Codex 里踩过一次坑，下次在 DSH 里照样踩。Agent Memory Backpack（AMB） 把这件事收到一个本地库里——两端都从它读、都往它写，而写入要经过审核，改动留下修订史，一条规则可以直接拦住某个工具调用。

---

为什么

现在的做法各有短板。

• 各写各的 AGENTS.md：两端各存一份，互相不知道对方改了什么，也没人知道哪条还有效。
• 聊天历史当记忆：能回看对话，但不是结构化知识，检索靠关键词碰运气，改不了、也撤不回。
• RAG / 向量库：能读，但通常不能写回；基础设施重，数据常在别人机器上。
• 知识图谱：结构好，但要专门的工具链维护，日常使用成本高。

AMB 的选择：把记忆当作知识而不是文本。

• 有版本：每次修改是一条修订，可回溯、可取代、可按时间点看当时的库。
• 要审核：agent 提交的只能是候选，采纳是人（或明确授权的入口）的动作，门禁在服务端强制。
• 可门禁：一条规范可以按工具名直接拒绝调用，拒绝理由写清是哪条规则拦的。
• 本地：一个 SQLite 文件、一个本地服务，凭据分离，无对外网络出口。

与同类项目相比：目前开源的 agent 记忆方案（官方 MCP Memory、Mem0、Zep/Graphiti、Basic Memory、doobidoo MCP Memory 等）大多把记忆当作一段可检索的文本。AMB 多出来的是版本 + 审核 + 门禁这一层。它少什么：没有实体关系图谱、不做多模态。这些是刻意的取舍，不是没做完（向量检索是可选的，默认关闭，见下文）。

---

快速开始

前置：Windows x64、Node.js 24.13–24.x（实测 24.19）。用 Node 内置 SQLite，不需要另装数据库。

git clone https://github.com/czx455501074-afk/agent-memory-backpack.git
cd agent-memory-backpack
npm ci --ignore-scripts
npm run build

# 一条命令装齐：插件 + 核心 + 桌面控制台 + 开机自启
node scripts/amb-install.mjs --start

九步：环境检查 → 构建 → 数据目录与凭据 → 同步本机已有知识 → Codex 插件（可选）→ 桌面控制台（托盘） → 开机自动启动 → 启动核心 → 自检。

装完的状态：核心作为常驻服务运行；DSH 与 Codex 的适配器就位；桌面控制台驻留托盘（启动即隐藏、不占任务栏；托盘菜单可显示/隐藏主窗口、检查核心连接、切换开机自启、彻底退出）；核心与桌面端各写一条 HKCU 的 Run 项，登录后自动就位。

常用开关：--dry-run（只打印将执行的命令，不写任何东西）、--no-desktop、--no-startup、--no-sync、--codex-workspace PATH、--build（强制重建）。

桌面控制台用的是 desktop-tauri 的构建产物（NSIS 安装包）。没构建过时会跳过并打印构建命令——它需要 Rust 工具链，属于一次性前提，脚本不替你装。

只想用桌面窗口

从 Releases 下载 Agent Memory Backpack_1.0.0_x64-setup.exe（NSIS）或 .msi，发行说明里附了 SHA256。主窗默认隐藏、驻留托盘，由托盘菜单唤出。

桌面版只支持 Windows x64；macOS 与 Linux 不在本次范围内。

---

它能做什么