MemoryAI — 您的 AI 永不遗忘 🧠

会话结束，记忆长存。

MemoryAI 为您的 AI 提供持久化的长期记忆能力。它会记住您说过的话、做出的决定、偏好的设置——不是数小时，而是永久保存。

工作原理：

第 1 天：“我偏好深色模式，使用 TypeScript，通过 GitHub Actions 部署”

3 个月后：您的 AI 已经知晓一切。无需重复说明。它只是 记得。

安装配置

1. 从 https://memoryai.dev 获取 API 密钥
2. 编辑 {baseDir}/config.json：

{
  "endpoint": "https://memoryai.dev",
  "api_key": "hm_sk_your_key_here"
}

3. 测试： python {baseDir}/scripts/memory.py health

命令列表

记录某项信息

python {baseDir}/scripts/memory.py store "User prefers dark mode" --type preference

支持类型：fact、decision、preference、identity、goal、procedure、life_event

回忆记忆

python {baseDir}/scripts/memory.py recall "what does user prefer"

唤醒（会话开始时调用）

python {baseDir}/scripts/memory.py bootstrap "working on payment feature"

返回约 800 token 的用户身份 + 心情 + 上下文，可立即投入工作。

追踪消息（维持上下文健康）

python {baseDir}/scripts/memory.py track "message content" --role user

请在每次用户或助手发送消息时调用。大脑会自动维持上下文健康，并在需要保存并重新开始时主动提示您。详见下方“Context Guard”部分。

检查大脑健康状态

python {baseDir}/scripts/memory.py health

保存当前会话上下文

python {baseDir}/scripts/memory.py save "summary of what happened this session"

该用户是谁？

python {baseDir}/scripts/memory.py profile

返回认知画像：角色设定（persona）、心情（mood）、目标（goals）、实体（entities）、流程（procedures）。

适用场景

Context Guard（自动机制）

MemoryAI 保护您的上下文窗口，在长时间对话中持续维护记忆连贯性。所有这些均由系统自动完成，您无需手动管理。

如何使用：

1. 会话启动时：调用一次 bootstrap，以完整上下文（约 800 token）唤醒大脑。
2. 每条消息处理时：调用 track。大脑将自主维持上下文健康。
3. 当 track 提示需保存时：调用 save 并提供简短摘要。大脑将持久化全部内容，并为您生成干净的上下文继续后续交互。

整个闭环即：bootstrap → 每条消息调用 track → 收到提示后调用 save。无需定时任务（cron jobs），也无需手动调优。

注意：旧版本曾采用周期性后台命令机制。该方式已弃用——请仅使用上述按消息粒度的流程。若您此前设置了定期 sync 任务，请移除；现已不再需要。

使用规范

• 会话起始必须调用 bootstrap —— 仅需一次，即可获得完整上下文。
• 先 recall，再推测 —— 若需引用过往上下文，请优先执行 recall。
• 仅存储关键信息 —— 如决策、偏好、结果等，而非每一条普通消息。
• 自然呈现记忆 —— 将记忆融合进回复内容中，避免直接输出原始记忆数据。
• 信任大脑机制 —— MemoryAI 自动处理记忆衰减（decay）、整合（consolidation）与保护（protection）。

记忆类型

DNA 级记忆永不衰减，它们构成了用户身份的核心。

数据与隐私

• 所有数据仅通过 HTTPS 发送至配置的 endpoint
• 无任何自动传输行为——所有调用均需显式发起
• 零外部依赖——完全基于 Python 标准库
• 源码完全开源、可读、可审计