OpenMemory代码
具有强制长期记忆的人工智能代理开发平台
 ](https://nodejs.org/) 
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, ollamaClaude桌面设置
编辑 ~/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______________________________________________________________________
📄 许可证
麻省理工学院许可证-版权所有(c)2025 Daniel A Bissey
该项目建立在 OpenMemory 由OpenMemory贡献者(MIT许可证)提供。
看 许可证 文件以获取详细信息。
______________________________________________________________________
🙏 归因
原始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·比西
