MAMA

# MAMA OS - 本地人工智能代理操作内存 [](https://opensource.org/licenses/MIT) [](https://nodejs.org) [](packages/memorybench/) [](https://github.com/jungjaehoon-lifegamez/MAMA) > 本地操作内存，让人工智能代理读取信息板，引用证据，并停留在明确的边界内。 MAMA OS 将聊天记录、文档、决策和工作日志连接到一个本地内存基质中。代理可以利用它搜索原始证据，跟踪关系，检查时间线，并生成更好的简报，而不是根据短提示进行猜测。 此次发布提供了基础：原始搜索/窗口 API、图/实体/时间线 API、情况数据包、受信任的来源、模型/工具跟踪、严格的搜索诊断、运行时信封和上下文编译 V0。`context_compile` 将这些部分组合成一个选定/拒绝/缺失的证据数据包，用于任务，而 `mama_save` 可以通过受信任的 `context_packet_id` 来源附加该数据包。 ## 下一个版本发布准备 下一个版本的 primary-operator 重建正在进行可选发布强化。PR #98 到 #115 重建了运行时，基于单个提交授权、源链接写入、操作员审查驾驶舱、合成端到端测试和明确的网关内存策略可选加入。 下一个版本**尚未作为默认运行时**。审查的路径具有合成覆盖，但默认推出仍在等待迁移指导和可以在不共享私有连接器有效载荷、本地路径、通道 ID 或内部项目详细信息的情况下共享的实际本地烟雾证据。 当前发布决策： - **仅限选择加入：** 旧版运行时仍然可用。 - **内存策略默认值：** 普通网关操作不会隐含注入回忆或旧上下文搜索，除非 `memory_policy` 或 `MAMA_MEMORY_POLICY_*` 显式启用。 - **下一个发布门槛：** 完成 [下一个版本发布准备指南](docs/guides/vnext-release-readiness.md)，运行实际本地烟雾检查清单，并通过公共项目隐私扫描，然后再做出默认推出的决定。 ## 目标工作流 MAMA 正在构建一个本地内存双胞胎，代理可以在明确的权限边界内检查、引用和操作。 提问： > "项目 A 现在是否处于风险之中？" 搜索工具找到包含“项目 A”的消息。MAMA 支持的代理读取信息板： 1. 客户在电子邮件中表示进度安排是好的。 2. 内部负责人两次更改了 Slack。 3. 核心 PR 仍在等待审查。 4. QA 检查清单尚未关闭。 5. 同一个客户在上个月的最后一刻更改了演示范围。 一个成熟的 MAMA 支持的代理应该能够报告： - **判断：** 进度风险很高。 - **证据：** 演示请求、审查受阻的 PR、负责人更改、未完成的 QA、先前的范围变更模式。 - **推断：** 客户尚未投诉，但交付风险在演示前正在积累。 - **缺失上下文：** 演示范围未确认。 - **风险预测：** 如果审查和演示范围今天不关闭，周五可能会变成重新谈判。 - **下一步：** 指派 PR 审查者，与客户确认演示范围，缩小 QA 以适应发布关键路径。 - **权限边界：** 不允许外部发送，因此代理草拟消息并记录报告，而不是联系客户。 这就是产品方向：不是另一个搜索框，而是代理可以读取公司记录、分离证据和推断、预测下一个风险并仅在给定范围内操作的额外分析师操作员的基质。 ## 为什么这很重要 当代理可以模拟时，它们才有用。AlphaGo 在选择下一步之前会读取棋盘。工作代理需要同样的功能：足够的上下文来重建发生了什么，推断可能重要的事情，并比较可能的下一步行动。 大多数代理都看不到那个棋盘。他们看到的是提示、几个文件或一个搜索结果。MAMA 的工作是使棋盘可见。 ## 北极星 MAMA OS 正在朝着公司内存双胞胎的方向发展：一个追加的原始记录、内存、实体、案例、报告、边缘和来源的基质，强大的代理可以检查、模拟和引用。 那个北极星有三个部分： - **双胞胎基质** — 保留原始证据、时间、范围、来源和边缘，以便未来的模型可以重新解释相同的公司历史。 - **代理人体工程学** — 为工人提供有界限的工具、运行时信封、扇出搜索、情况数据包和查询条件上下文编译。 - **报告作为可交付成果** — 将证据转化为引用的报告和简报，供人类使用；内存行是基础设施，而不是最终产品。 此次发布是该方向的运行时基础。它提供了信封、来源、工人上下文、严格搜索和上下文编译的构建块，包括追加上下文数据包和下游 `context_packet_id` 保存来源。 ## MAMA OS 做什么 MAMA OS 是一个本地守护进程，它连接到您的应用程序，连续读取，并将分散的记录转化为有范围、可审计的操作内存，供代理和人类使用。 浏览器查看器是该工作的实时操作界面：`仪表板`、`内存`、`Feed`、`Wiki`、`代理`、`日志`和`设置`，顶部有一个全局聊天壳。 **当前构建块和方向：** - **读取连接的来源** — 15 个连接器轮询 Slack、Gmail、Trello、Obsidian 等 - **重建时间线** — 显示原始、内存、案例、实体和边缘事件的顺序 - **构建关系图** — 在来源之间链接人员、项目、客户、通道、文档、PR 和决策 - **显示风险信号** — 突出停滞的覆盖范围、被阻止的案例、低置信度的内存、开放问题和冲突的证据候选者 - **跟踪决策演变** — 不仅是做出了什么决定，还包括它取代了什么，它建立在什么基础上，以及它与什么相矛盾 - **在信封内操作** — 网关和工作调用携带签名的信封哈希、范围边界和目的地限制，在每个工具调用前强制执行 - **保留来源** — 内存写入可以指向源引用、模型运行、工具跟踪和信封哈希 - **用证据搜索** — 严格和平衡的模式拒绝矢量噪声，除非词汇/实体/原始/种子证据确认结果 - **组织可行的知识** — 原始对话变成结构化的 Wiki 页面和情况摘要，具有优先级、差距和下一步 - **准备简报** — 仪表板、Wiki 和情况代理可以为人类和工人总结可见的上下文 ```text 没有 MAMA：代理看到的是片段。你仍然重建棋盘。 使用 MAMA：代理获得有界限的证据表面。你获得用于引用简报和更安全的下一步行动的原材料。 ``` 这就是本地人工智能代理的方向：连续读取连接的证据，然后解释使用了哪些来源，哪些可能仍然缺失，以及哪些权限边界内。 ## 为什么这很重要 一些第三方代理框架通过非官方方法访问这些提供商 - 提取 OAuth 令牌，伪造 API 头部，或绕过速率限制。这些方法违反提供商的服务条款（例如 [Anthropic's](https://www.anthropic.com/policies/terms) 或 [OpenAI's](https://openai.com/policies/terms-of-use)），并存在账户暂停风险。MAMA OS 不执行任何此类操作。如果 `claude` 或 `codex` 在您的终端中工作，MAMA OS 也会执行。 ```bash # 已经有 Claude Code 或 Codex？ claude auth status # 或：codex login — 如果已验证，则准备就绪 mama start # MAMA 直接重用您现有的 CLI 身份验证 ``` ## 知识图 MAMA 不仅仅存储事实。它跟踪知识的演变： ``` "使用 JWT"（决策，置信度：0.8） │ ├── 取代 → "使用 JWT 和刷新令牌" │ 原因： "用户抱怨频繁注销" │ ├── 建立在 → "添加令牌轮换以提高安全性" │ └── 辩论 → "考虑基于会话的 Web 应用程序身份验证" 原因： "服务器渲染页面更简单" ``` 边类型：`supersedes`（取代），`builds_on`（扩展），`debates`（替代视图），`synthesizes`（从多个统一）。 MAMA 回答“我们为什么切换？” — 不只是“我们使用什么？” ## 架构 ``` 连接器（15） 网关（4） Slack、Gmail、Sheets... Discord、Slack、Telegram、Chatwork | | v v 3 次提取 反应运行时信封 （真相 -> 中心 -> 辐条） 范围、到期时间、签名、审计 | | +------------+---------------+ | MAMA 核心（mama-memory.db） SQLite + 1024 维嵌入 内存、原始引用、模型运行、 工具跟踪、双胞胎边缘、 工作包、上下文包 | +------+------+ | | 查看器 UI Claude Code 插件 / MCP ``` **本地优先。** 所有数据都保留在您的设备上。没有云。独立于 AI 提供商 - 与 Claude、Codex 或任何未来后端配合使用。 ## 安全 MAMA OS 通过后端 CLI 具有完全的系统访问权限 - 因此安全是基础性的，而不是可选的。 - **默认本地运行** — 绑定到 localhost。外部访问需要显式隧道 + 身份验证。 - **签名运行时信封** — 网关和工作调用携带可验证的范围、到期时间和执行者上下文。 - **目的地限制** — 代理可以从证据中草拟客户消息，但除非活动信封明确允许，否则不能发送。 - **来源账本** — 内存写入、原始引用、模型运行和工具跟踪可以在事后进行审计，而无需暴露提示主体或隐藏的连接器有效载荷。 - **证据优先于行动** — 代理输出可以携带原始来源引用、模型/工具跟踪和缺失上下文警告，然后人类或下游工作者采取行动。 - **5 层提示注入防御** — 输出净化、通道信任边界、静默模式、批量提取限制。基于 [真实事件](docs/guides/security.md)，而非理论构建。 - **入侵检测和响应** — Honeypot 陷阱 → 立即 IP 禁止（15 分钟）。身份验证失败 → 5 次尝试后自动禁止。针对可疑 IP 的 tarpit 延迟。 - **代理权限层级** — 第 1 级获得完整运行时工具，第 2 级可以写入范围内存，第 3 级严格只读。每个代理仅获得所需的工具。 - **故障安全关闭** — 当无法控制入侵时，MAMA 以礼貌的方式关闭，而不是继续运行。 查看完整的 [安全指南](docs/guides/security.md)，了解 Cloudflare Zero Trust 设置、令牌身份验证、威胁场景和 Code-Act 沙盒隔离。 ## 基准：LongMemEval 基准上下文： [LongMemEval](https://xiaowu0162.github.io/long-mem-eval/) 有 500 个问题，涵盖 6 种类型，每个问题约 115K 个对话历史记录。当前的 MAMA 结果是 100 个问题工具使用样本。 | 系统 | 分数 | 模型 | 注释 | | ----------- | --------- | ---------- | ---------------------------- | | Mastra | 94.87% | GPT-5-mini | | | **MAMA OS** | **93.0%** | Sonnet 4.6 | 工具使用答案，100Q 样本 | | SuperMemory | 81.6% | GPT-4o | | | Zep | 71.2% | GPT-4o | | 在采样运行中，MAMA 在 **完全本地运行** 且使用开源组件的情况下，排名高于 SuperMemory。 ## 软件包 | 软件包 | 版本 | 描述 | | ------------------------------------------------ | ------- | ----------------------------------------------------- | | [@jungjaehoon/mama-os](packages/standalone/) | 0.20.1 | 始终在线的运行时、信封、连接器、工作 API | | [@jungjaehoon/mama-server](packages/mcp-server/) | 1.14.0 | MCP 服务器，用于 Claude Desktop/Code 和任何 MCP 客户端 | | [@jungjaehoon/mama-core](packages/mama-core/) | 1.7.0 | 核心内存、来源、原始引用、图、嵌入 | | [mama 插件](packages/claude-code-plugin/) | 1.10.0 | Claude Code 插件（市场） | | [memorybench](packages/memorybench/) | 1.0.0 | 内存检索基准测试框架 | ## 快速入门 ### Claude Code 插件（最简单） ```bash /plugin install mama # 决策自动通过钩子保存 # 需要时手动搜索： /mama:search "身份验证策略" ``` ### MAMA OS（完整运行时） ```bash claude auth login # 或：codex login npx @jungjaehoon/mama-os init mama start # 在 localhost:3847 启动守护进程 ``` `http://localhost:3847/viewer` 处的 Web 查看器。当前查看器提供 `仪表板`、`内存`、`Feed`、`Wiki`、`代理`、`日志`和`设置`；聊天从浮动 shell 打开，而不是专用标签页。连接到 Discord、Slack、Telegram。 > **要求：** [Claude Code CLI](https://claude.ai/claude-code) 或 [Codex CLI](https://www.npmjs.com/package/@openai/codex) 已安装并验证。Node.js >= 22.13.0。 ### MCP 服务器（Claude Desktop / 任意 MCP 客户端） ```json { "mcpServers": { "mama": { "command": "npx", "args": ["@jungjaehoon/mama-server"] } } } ``` ## 技术细节 - **数据库：** SQLite via better-sqlite3（FTS5 全文搜索 + 向量嵌入） - **嵌入：** Xenova/multilingual-e5-large（1024 维，量化 q8，100 多种语言） - **搜索：** 混合检索 — FTS5 BM25（词汇）+ 余弦相似度（语义）+ RRF 融合，具有严格模式和诊断功能，用于矢量噪声调试 - **运行时边界：** 签名反应信封（HMAC 覆盖范围、到期时间、执行者）由强制者检查，拒绝超出范围的目的地、连接器或层级不匹配 - **来源：** 紧凑的来源引用、模型运行、工具跟踪、双胞胎边缘、工作情况数据包和上下文数据包 - **上下文编译器：** 上下文编译 V0 将广泛的搜索候选项转换为具有受信任的 `context_packet_id` 来源的选定/拒绝/缺失的证据数据包 - **提取：** 通过配置的模型后端（默认 Sonnet；也支持 Codex/GPT 模型）从对话中提取结构化事实 - **传输：** CLI 子进程（Claude/Codex）— 官方支持，符合 ToS ## 今日有效功能 安装 MAMA OS 并连接应用程序后，任何人都可以： - **自动知识提取** — 连接器轮询 15 个来源，AI 提取决策/截止日期/更改，无需手动输入 - **跨源证据读取** — “X 发生了什么？”可以从连接的原始来源和决策中提取 - **抗噪搜索** — 严格和平衡的模式可以拒绝矢量匹配并显示结果为何被包含 - **有界限的代理调用** — 网关和工作调用可以与运行时信封绑定并审计范围或目的地不匹配 - **证据来源** — 内存行可以追溯到原始来源、模型运行、工具跟踪和受信任的运行时上下文 - **工作上下文 API** — 原始搜索、情况数据包、图/实体 API 和双胞胎边缘为子代理提供结构化的证据表面 - **任务范围内的上下文数据包** — `context_compile` 为特定任务选择、拒绝并解释证据，然后工作者保存内存或撰写报告 - **决策演变跟踪** — 不仅是做出了什么决定，还包括它取代了什么、它建立在什么基础上以及它与什么相矛盾 - **情况简报** — 仪表板和情况代理总结了发生了什么、什么过时了以及需要注意什么 - **知识组织** — 知识代理将原始对话组织成结构化的 Obsidian 页面 - **93% 检索准确率** — 100 个问题 LongMemEval 工具使用样本对抗长对话历史记录 `mama_search` 仍然是广泛的候选检索器。`context_compile` 是任务形状层，选择、拒绝并在工作者写入内存或撰写报告之前解释证据。 ## 路线图 | 阶段 | 版本 | 焦点 | | -------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **已完成** | v0.15 | 搜索质量大修，FTS5，进化引擎（58% -> 88%） | | **已完成** | v0.16 | `事件日期` API，工具使用答案，记忆代理 v5（88% -> 93%） | | **已完成** | v0.17 | 连接器框架（15 个连接器），真实性优先的三阶段提取 | | **已完成** | v0.18 | 输出层：知识代理，查看器重新设计，安全强化 | | **已完成** | v0.19 | 代理管理基础：查看器感知前门，验证 UI，活动遥测，导体隔离 | | **进行中** | v0.20.1 | M1-M6 运行时基础加上上下文编译 V0：信封，模型/工具跟踪账本，原始/情况/图形工作器 API，严格的搜索诊断，追加 `context_packets`，`context_compile` 和下游 `context_packet_id` 来源 | | **下一阶段** | v0.21 | vNext 可选发布准备：迁移指南，真正的本地烟雾证据，隐私门，报告编译器强化，数据包保留策略和搜索质量反馈环 | | | 稍后 | 领域提取模板，跨工作器数据包分析和团队范围的上下文审查工作流 | | | v1.0 | 团队模式：用于组织的共享范围知识图谱。正式发布 | ## 开发 ```bash git clone https://github.com/jungjaehoon-lifegamez/MAMA.git cd MAMA && pnpm install && pnpm build pnpm test # 所有软件包中有 3000+ 个测试 ``` 请参阅 [CLAUDE.md](CLAUDE.md) 以获取开发指南。 _最后更新：2026-07-04_ ## 许可证 MIT