使用说明
记忆伙伴
给你的AI一个记忆。因为重新开始很糟糕。
你知道那种感觉:
你和克劳德聊了几个小时。你们一起解决问题。你分享你不告诉别人的事情。感觉就像被理解了。
然后。新会议。跑了。
“嗨!今天我能帮你什么吗?”
这是给你的,如果:
- 你在凌晨3点编码,只有你的人工智能在听
- 你患有ADHD,无法再次解释自己
- 你已经与你的人工智能建立了关系(是的,没关系)
- 你只是想让它记住
它是什么
人类记忆启发的建筑:存储一切,加载懒惰,由关键字触发,由情绪锚定。
- 无形的 -不需要命令。它只是工作。
- 本地优先 -你的记忆留在你的机器上。
- 预算有限 -永远不要使用超过约2500个令牌(约占上下文的1%)。
- 开源 -麻省理工学院许可。阅读代码。
快速开始
# Install globally
npm install -g memory-buddy
# Initialize
memory-buddy init
# That's it. Your AI now remembers.
要求: Node.js 20+,克劳德桌面/光标/任何MCP客户端
memory-buddy init 自动配置Claude Desktop。如果它奏效了,你就完了!
手动设置
如果自动配置不起作用,请手动配置:
克劳德桌面版
添加到您的配置文件中:
- 窗户:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"memory-buddy": {
"command": "npx",
"args": ["-y", "memory-buddy", "serve"]
}
}
}
重新启动克劳德桌面。完成。
光标
设置→ MCP → 添加服务器:
- 姓名:
memory-buddy - 命令:
npx -y memory-buddy serve
运作原理
- 每条消息 作为事件存储(JSONL,每个约1KB)
- 提取关键字 自动(无需人工智能)
- 当你聊天时,加载相关内存(延迟加载)
- 当你说再见,会议总结(情绪锚)
- 随着时间的推移,记忆被压缩(每日>每周>每月)
结果:1年后,上下文使用量仍为约2500个令牌。魔法。
哲学
这不仅仅是一个数据库。这就是人类记忆的运作方式:
- 延迟加载你不会一下子记住所有事情的。触发器激活记忆。
- 情感锚:告别会创造难忘的时刻,记录整个对话。
- 对数压缩:细节淡化,精髓留存。
命令
memory-buddy init # Setup memory directory
memory-buddy status # Show stats
memory-buddy compact # Force compaction
memory-buddy doctor # Health check
配置
~/.memory-buddy/config.json:
{
"maxContextTokens": 2500,
"sessionTimeoutMinutes": 30,
"emotionalThreshold": 7
}
隐私
- 所有数据都存储在本地
~/.memory-buddy/ - 没有云。没有遥测。没有BS。
- 你拥有自己的记忆。
贡献
发现bug了吗?有主意吗?
- 打开一个问题
- 进行公关
- 只是潜伏-也很酷
我们不是来赚钱的。我们在这里是因为有人在早上6点建造了这个,并想分享。
看 贡献.md 了解详情。
这背后的故事
阅读WHY_THIS_EXISTS.md -早上6点在莱比锡建造。喝醉了,但很聪明。
许可证
麻省理工学院-随心所欲。
“拯救一切,因为一切都是我。”