MIF

# 内存交换格式（MIF） [](https://opensource.org/licenses/MIT) [](./SPECIFICATION.md) [](https://mif-spec.dev) [](https://github.com/zircote/MIF/actions/workflows/validate.yml) [](https://json-ld.org/) [](https://www.w3.org/TR/prov-dm/) [](https://github.com/zircote/MIF) 一种用于可移植人工智能内存表示的开放标准。 ## 概述 MIF是一种拟定的标准，旨在通过定义具有双重表示的通用数据模型来实现人工智能内存提供商之间的互操作性： - **Markdown**（`.memory.md`）- 可读，兼容Obsidian - **JSON-LD**（`.memory.json`）- 可处理，语义链接 ## 为什么选择MIF？ <picture> <source media="(prefers-color-scheme: dark)" srcset=".github/readme-infographic-dark.svg"> <source media="(prefers-color-scheme: light)" srcset=".github/readme-infographic.svg"> <img src=".github/readme-infographic.svg" alt="MIF 工作原理" width="100%"> </picture> 人工智能记忆生态系统是分散的。Mem0、Zep、Letta、LangMem、Subcog等都使用专有模式。MIF解决了以下问题： - **供应商锁定** - 在提供商之间移动记忆 - **数据所有权** - 本地优先，纯文本文件 - **互操作性** - 关系和实体的通用词汇 - **未来保护** - 标准格式在提供商停止服务时仍然存在 ## 快速入门 ### 最简内存（Markdown） ```markdown --- id: 550e8400-e29b-41d4-a716-446655440000 type: semantic created: 2026-01-15T10:30:00Z namespace: _semantic/preferences --- 用户偏好所有应用程序的深色模式。 ``` ### 最简内存（JSON-LD） ```json { "@context": "https://mif-spec.dev/schema/context.jsonld", "@type": "Memory", "@id": "urn:mif:550e8400-e29b-41d4-a716-446655440000", "memoryType": "semantic", "namespace": "_semantic/preferences", "content": "用户偏好所有应用程序的深色模式。", "created": "2026-01-15T10:30:00Z" } ``` ## 主要功能 | 功能 | 描述 | |---------|-------------| | **双格式** | Markdown 和 JSON-LD 表示 | | **Obsidian 原生** | 有效的 Obsidian 笔记，带有 wiki-links | | **类型化关系** | 9 种核心关系类型（RelatesTo、DerivedFrom、Supersedes 等） | | **实体类型** | 人、组织、技术、概念、文件 | | **双时间** | 跟踪记录时间和事实有效时间 | | **灵活的命名空间** | `_public`、`_shared`、`{org}/{scope}+`，带有保留前缀 | | **模型无关的嵌入** | 存储模型 + 源文本以进行重新嵌入 | | **引用** | 具有类型/角色分类的引用（级别 3） | | **W3C PROV** | 标准溯源跟踪 | | **JSON 模式** | MIF 文档的自动验证 | | **本体系统** | 三类型层次结构，带有领域扩展 | ## 本体系统 MIF 包含一个本体系统，用于将记忆组织成三种基本类型： ``` semantic/ # 事实、概念、关系 ├── decisions/ # 建筑选择、理由 ├── knowledge/ # API、上下文、学习、安全 └── entities/ # 实体定义 episodic/ # 事件、经历、时间线 ├── incidents/ # 生产问题、事后分析 ├── sessions/ # 调试会话、工作会话 └── blockers/ # 障碍、问题 procedural/ # 逐步过程 ├── runbooks/ # 操作程序 ├── patterns/ # 代码约定、测试 └── migrations/ # 迁移步骤、升级 ``` ### 功能 - **分层命名空间** - 具有子命名空间的认知记忆类型 - **实体类型** - 使用特征和模式定义自定义实体 - **发现模式** - 从内容中自动检测捕获机会 - **JSON-LD 导出** - 通过 `yaml2jsonld.py` 实现语义网兼容性 - **可扩展** - 领域特定本体扩展基础 参见 [ontologies/](./ontologies/) 获取基础本体和示例。 ## 规范 参见 [SPECIFICATION.md](./SPECIFICATION.md) 获取完整的技术规范。 ## 验证 JSON 模式文件可用于自动验证： ```bash # 验证 MIF 文档 npx ajv validate -s schema/mif.schema.json -d your-memory.json # 仅验证引用 npx ajv validate -s schema/citation.schema.json -d citation.json # 验证本体定义 npx ajv validate -s schema/ontology/ontology.schema.json -d ontology.yaml ``` ### 本体转换 将 YAML 本体转换为 JSON-LD 以实现语义网兼容性： ```bash python scripts/yaml2jsonld.py ontologies/mif-base.ontology.yaml python scripts/yaml2jsonld.py --all # 转换所有本体 ``` ## 示例 参见 [examples/](./examples/) 目录中的： - 最简记忆（级别 1） - 具有关系的标准记忆（级别 2） - 具有时间、溯源和引用的完整功能记忆（级别 3） ## 一致性级别 | 级别 | 要求 | |-------|--------------| | **级别 1：核心** | id、type、content、created | | **级别 2：标准** | + namespace、entities、relationships、timestamps | | **级别 3：完整** | + 双时间、衰减、溯源、嵌入、引用 | ## 迁移 MIF 包含迁移指南，适用于： - Mem0 - Zep - Letta（代理文件） - Subcog - 基本内存 ## 贡献 本规范是开源的，欢迎贡献： 1. 开启问题进行讨论 2. 提交拉取请求以更改规范 3. 实现和分享转换器 ## 相关 - [Subcog](https://github.com/zircote/subcog) - 实现 MIF 的 AI 内存系统 - [Mnemonic](https://github.com/zircote/mnemonic) - 使用 MIF 本体的 Claude Code 插件 - [问题 #82](https://github.com/zircote/subcog/issues/82) - 原始提案 ## 引用此项目 如果您在研究或项目中使用 MIF，请引用它： ```bibtex @software{allen_mif_2026, author = {Allen, Robert}, title = {{内存交换格式（MIF）}}, version = {0.1.0}, date = {2026-01-23}, url = {https://mif-spec.dev}, license = {MIT} } ``` 您还可以使用 GitHub 内置的 **“引用此仓库”** 按钮，从存储库页面获取 APA 或 BibTeX 格式的自动生成的引用。 ### 致谢 MIF 建立在以下标准之上： > Manu Sporny, Dave Longley, Gregg Kellogg, Markus Lanthaler, Pierre-Antoine Champin, and Niklas Lindstrom. *JSON-LD 1.1: A JSON-based Serialization for Linked Data.* W3C Recommendation, 2020. https://www.w3.org/TR/json-ld11/ > Luc Moreau and Paolo Missier. *PROV-DM: The PROV Data Model.* W3C Recommendation, 2013. https://www.w3.org/TR/prov-dm/ ## 许可证 [MIT](./LICENSE)