使用说明

OpenMemory代码

具有强制长期记忆的人工智能代理开发平台

OpenMemory代码 是一个专门为编码项目设计的强大的AI代理开发平台。建立在以下基础之上 OpenMemory，它增加了全面的自动服务管理、MCP服务器支持、强制的AI代理合规性，以及为AI编码助手提供无限的长期内存。

🎯 什么是OpenMemory代码？

问题： AI编码助手（Claude Code、GitHub Copilot等）会忘记会话之间的上下文，无法维护项目内存，也没有强制机制来确保他们使用可用的内存系统。

解决方案： OpenMemory代码提供：

✅ 无限的长期记忆 -AI代理在会话中永远不会忘记
✅ 强制内存使用 -Git钩子和中间件防止绕过
✅ 自动服务管理 -一个命令启动一切
✅ MCP服务器集成 -原生Claude桌面支持
✅ 上下文注入 -AI助手的自动项目上下文
✅ 跨会话连续性 -从你停止的地方继续

🚀 快速开始

# 1. Clone repository
git clone https://github.com/fatstinkypanda/OpenMemory-Code.git
cd OpenMemory-Code

# 2. Install dependencies
npm run install:all

# 3. Build everything
npm run build

# 4. Start (all services auto-start)
npm start

就是这样！ OpenMemory代码现在正在运行：

后端：http://localhost:8080
上下文管理器：http://localhost:8081
MCP服务器：已准备好用于Claude桌面

初始化您的第一个项目

# Navigate to your project
cd ~/Projects/MyApp

# Initialize OpenMemory-Code
node /path/to/OpenMemory-Code/openmemory-init.js

# Start coding - AI agents automatically use long-term memory!

有关详细的设置说明，请参阅 QUICKSTART.md.

📖 主要特点

1.自动服务管理⚡

之前： 在单独的终端中手动启动3个服务 现在： 一个命令自动启动一切

npm start  # Starts backend + context manager + all services

Process Manager处理所有依赖服务
健康检查确保准备就绪
使用Ctrl+C进行干净关机（无孤立进程）
带有状态消息的自我记录

2.强制遵守人工智能代理🔒

五层强制架构：

Git预提交钩子 -在无效提交发生之前阻止它们
API中间件 -验证所有HTTP请求（违规时返回403）
持久的看门狗 -每5分钟监控一次合规性
架构验证 -强制执行数据结构要求
16+验证终点 -一致性、模式、决策、质量

结果： AI代理 无法绕过 存储系统没有检测和记录。

3.克劳德桌面MCP服务器🤖

原生模型上下文协议支持无缝集成Claude Desktop。

特征：

自动检测当前项目
一键式上下文注入
用于记录决策、行动和模式的工具
提示： load_project_context, quick_context

4.通用上下文注入🌐

上下文管理器 （端口8081）为任何AI接口提供项目上下文：

用于上下文检索的REST API
5分钟TTL缓存以提高性能
自动检测当前项目
Markdown或JSON格式
适用于Claude Code、Cursor、Windsurf、任何MCP客户端

5.长期存储器架构🧠

分层内存分解（HMD）：

语义记忆 -事实、知识、项目状态
情景记忆 -事件、行动、发展历史
程序性记忆 -模式、最佳实践、操作方法
反射内存 -架构决策、基本原理
情感记忆 -代理人情绪、信心水平

演出

95%的召回准确率
平均查询时间115ms
338 QPS吞吐量
自然记忆衰退
跨会话连续性

🏗️ 建筑

┌─────────────────────────────────────────────────────────────────┐
│                     OpenMemory-Code Ecosystem                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  npm start                                                       │
│    └─> OpenMemory Backend (port 8080)                           │
│        └─> Process Manager (automatic)                          │
│            ├─> Context Manager (port 8081)                      │
│            ├─> Watchdog (5-min monitoring)                      │
│            └─> All enforcement systems                          │
│                                                                  │
│  MCP Server (stdio)                                              │
│    └─> Started by Claude Desktop                                │
│    └─> Provides prompts, tools, resources                       │
│                                                                  │
│  Projects                                                        │
│    ├─> .openmemory (3-line link file)                           │
│    ├─> Git hooks (auto-validation)                              │
│    └─> Isolated memory per project                              │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

🆚 OpenMemory代码有什么新功能？

该项目建立在 OpenMemory 对AI编码助手进行了重大增强：

新增功能

✨ 流程经理 -自动服务生命周期管理
✨ 统一启动 - npm start 运行一切
✨ 快速初始化 - openmemory-init.js 便于设置
✨ 增强型MCP服务器 -更好的自动检测和上下文
✨ 综合文档 -快速启动，安装指南
✨ 发展重点 -为编码项目量身定制
✨ 无缝集成 -适用于Claude Code、VS Code

继承自OpenMemory

✅ 分层记忆分解（HMD）
✅ 多扇区存储系统
✅ 记忆衰退和强化
✅ AI代理执行架构
✅ 综合验证系统
✅ 高性能召回

📚 文档

QUICKSTART.md -5分钟后开始
安装_方法.md -比较安装选项
AUTOMATIC_STARTUP.md -技术深潜
集成已完成.md -集成总结

💡 用例

使用Claude Code的独立开发人员

# One-time setup
npm start  # Keep running
node openmemory-init.js ~/Projects/MyApp

# Daily work
cd ~/Projects/MyApp
code .  # Claude Code has full project memory!

优点：

Claude Code记住所有架构决策
无需重新解释项目结构
跨会话的一致编码模式
永远不会失去上下文

团队开发

共享OpenMemory实例
每个开发人员的AI助手使用相同的内存
整个团队的一致理解

长期项目

第1天：做出架构决策
第30天：AI从第一天起就记住一切
第100天：提供完整的项目历史记录

🛠️ 安装

方法1：直接存储库（推荐）

git clone https://github.com/fatstinkypanda/OpenMemory-Code.git
cd OpenMemory-Code
npm run install:all
npm run build
npm start

方法2：全球系统

# Install globally
./.ai-agents/enforcement/install-global.sh  # Linux/macOS
.\.ai-agents\enforcement\install-global.ps1  # Windows

# Use global commands
openmemory-start
openmemory-init ~/Projects/MyApp

方法三：Docker

docker compose up --build -d

看安装_方法.md 以进行详细比较。

🔧 配置

环境变量

# Backend port
OM_PORT=8080

# Context Manager port
CONTEXT_MANAGER_PORT=8081

# Disable auto-start
ENABLE_CONTEXT_MANAGER=false

# Embedding provider
OM_EMBEDDING_PROVIDER=synthetic  # or openai, gemini, ollama

Claude桌面设置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "openmemory-code": {
      "command": "node",
      "args": ["/absolute/path/to/.ai-agents/context-injection/mcp-server/dist/index.js"]
    }
  }
}

📊 演出

度量	值
回忆@10	95%
平均查询	115毫秒
吞吐量	338 QPS
存储（100k）	1.5 GB
成本（1M内存）	17-30美元/月

与替代方案相比：

比Zep快2-3倍，超级内存
比云解决方案便宜6-10倍
95%的召回率与媒介数据库的68-78%相比

🤝 贡献

欢迎投稿！

# Fork and clone
git clone https://github.com/yourusername/OpenMemory-Code.git

# Create feature branch
git checkout -b feature/amazing-feature

# Make changes and test
npm run dev

# Submit pull request

📄 许可证

该项目建立在 OpenMemory 由OpenMemory贡献者（MIT许可证）提供。

看许可证文件以获取详细信息。

🙏 归因

OpenMemory代码 建立在良好的基础之上 OpenMemory 创建者零点以及OpenMemory贡献者。

原始OpenMemory功能

分层记忆分解（HMD）
多扇区存储系统
记忆衰退和强化
AI代理执行架构
MCP服务器实现
综合验证系统

我们的补充

自动服务管理系统
生命周期控制流程管理器
统一的启动脚本
增强的项目初始化
上下文管理器自动启动
全面的快速入门文档
专注于AI编码助手

我们感谢最初的OpenMemory团队创建了如此强大和设计良好的内存系统！

🔗 链接

github： https://github.com/fatstinkypanda/OpenMemory-Code
原始OpenMemory： https://github.com/caviraoss/openmemory
作者丹尼尔·A·比西
电子邮件： support@fatstinkypanda.com
问题： https://github.com/fatstinkypanda/OpenMemory-Code/issues

📞 支持

问题： https://github.com/fatstinkypanda/OpenMemory-Code/issues
电子邮件： support@fatstinkypanda.com
原始OpenMemory不一致： https://discord.gg/P7HaRayqTh

🎯 项目目标

OpenMemory Code旨在：

✅ 让AI编码助手真正强大，拥有无限内存
✅ 强制使用内存，使AI无法绕过系统
✅ 提供与Claude Code、VS Code等的无缝集成。
✅ 轻松支持多个项目
✅ 无限期保持跨会话连续性
✅ 保持设置简单和自动
✅ 建立在坚实的OpenMemory基础之上

我们专注于一件事： 通过强制执行，让AI编码助手永远记住一切。

由以下材料制成❤️ 通过丹尼尔·A·比西

建立在 OpenMemory 通过零点和贡献者