Midas 是面向长周期 AI 智能体的本地记忆层，定位为“住在你机器上、紧挨着 AI 助手的记忆”。它旨在解决 AI 助手在会话之间遗忘一切的问题：编码智能体可以记住三个会话之前的决策、约定和 bug，而无需把每条消息都送进 LLM 去“提取”事实。
主要能力
- 本地优先与零 LLM 摄取：据资料，摄取或查询阶段不调用 LLM，因此没有 API 花费，数据不离开本机，本地操作快速（约几十毫秒，无每轮网络往返）。召回返回逐字来源轮次，而不是 LLM 改写结果，避免提取步骤悄悄幻觉出用户从未说过的“事实”。
- 自动保持最新：类型化信念修订会用新值取代旧值，而不是堆积重复；选择性遗忘让记忆保持有界，全程无需 LLM。
- 安全可构建：来源守卫让记忆参与规划，但阻止仅凭记忆就发起外部或破坏性操作，除非用户明确确认且确认仍然有效；已被取代的记忆根本不能授权操作。
- 一个文件，多个工具：Claude Code、Cursor 和聊天应用可指向同一个 SQLite 文件，共享同一份实时记忆。
- 可治理的记忆：除召回外，还提供动作安全、决策遵循、重复错误避免、恢复保真度、冲突检测/精确度以及对抗性记忆安全等经测量的属性。资料称安全评测阻止 10/10 对抗攻击（ASR 0.00），且无过度阻止（benign-pass 1.00）。
- 玻璃盒可观测：提供本地检查器 midas inspect，可查看智能体记住了什么、为什么、来源是什么，并可纠正、固定或遗忘；每次写入/修订/遗忘都会追加到存储内防篡改的哈希链审计日志（仅哈希，不含内容）。
使用方式
- 安装并接入：通过一条命令把记忆接入编码智能体；midas init 创建一个共享记忆（~/.midas/memory.sqlite3），并将检测到的 MCP 客户端（Claude Code、Codex、Grok Build、Cursor、Claude Desktop、Windsurf、VS Code、Gemini CLI、Cline、Zed）指向它。
- MCP 服务器：作为标准 MCP 服务器，可将任意客户端指向 midas-mcp 命令，默认使用共享存储。可通过环境变量覆盖，如 MIDAS_MCP_DB、MIDAS_MCP_MAX_RECORDS、MIDAS_MCP_MIN_IMPORTANCE、MIDAS_MCP_NAMESPACE 等。
- 工具集包括：remember、capture（策略门控的自动存储）、recall（来源可追溯）、build_context、resume、memory_state、memory_diff、memory_conflicts、open_loops/remember_commitment/close_loop、check_memory_use（守卫）、memory_policy、maintain、stats、forget、forget_matching、forget_all；提示包括 memory_session、distill。
- 导入既有记忆：midas import --from claude-md CLAUDE.md（或 cursorrules、jsonl、mem0、zep）把规则和导出转为一等、可召回、可治理的记忆。
- 可选钩子：midas init --claude-hook 安装 Claude Code SessionEnd 钩子，把每轮用户回合提供给记忆，仍由 Midas 的无 LLM 策略决定实际保留什么。
- Python SDK 与 CLI：提供 Python SDK（midas-memory），以及 midas update、midas inspect、midas audit、midas doctor 等命令；midas doctor 可诊断接线问题（只读取配置路径和版本，不读记忆内容）。
- 可选加密：设置 MIDAS_MCP_KEY 并安装 [encrypted] 额外项后，存储为 SQLCipher 数据库。
适用场景
- 长周期编码智能体：跨会话记住决策、约定、bug、承诺与未完成事项。
- 多客户端共享记忆：IDE 中捕获的事实可从聊天应用召回，无需重启。
- 需要审计与治理的记忆：希望知道记忆来源、历史、冲突和动作授权原因的场景。
- 隐私敏感与成本敏感场景：不希望每条消息产生 token 花费或数据出境。
限制
- 资料明确说明 Midas 以放弃整段对话能力换取 $0、隐私和可审计性，并公布测量结果说明这一取舍在哪里受限。
- 检索是其强项，对无 LLM 设计基本已达上限；前沿的额外杠杆是保结构提取，而这需要 Midas 故意不在摄取阶段运行的能力较强的模型；小型本地提取器被测量为无帮助，可选的蒸馏开关默认关闭，不宣称其为收益。
- GUI 应用不共享 shell PATH，若客户端提示“command not found”，需使用 which midas-mcp 得到的绝对路径；Windows 的 JSON 路径使用正斜杠。
- 项目处于早期，但构建范围窄且以测量为先。
许可与隐私：MIT 许可，完全免费开源，无付费层级、无功能门槛、无遥测、无账号；记忆存于本机 SQLite 文件，capture/recall/forget 不发起网络调用；唯一对外流量是一次性嵌入模型下载（本地后端）和包安装。
