Apex Memory

顶点记忆

 ](https://www.npmjs.com/package/apex-memory) ](https://www.npmjs.com/package/apex-memory) 

AI编码代理的持久内存。

为您的AI编码代理提供跨会话生存的内存。顶点记忆是 主控程序 允许代理保存决策、模式、错误和上下文的服务器，然后在需要时准确地调用它们。

• 一次安装，随处可用 --MCP原生，可与Claude Code、Cursor、Windsurf和任何兼容MCP的编辑器配合使用
• 超轻 --26.6 kB包，以毫秒为单位启动，没有ML模型或向量数据库
• 零基础设施 --本地SQLite数据库，无服务器，无帐户
• 专为编码代理而设计 --类别如 decision, architecture, bug, pattern 专为真实的开发工作流程而设计
• 智能内存管理 --重要性评分（1-5）、访问跟踪和自动衰减使您的记忆存储保持相关性
• 全文搜索 --使用FTS5驱动的搜索功能立即查找任何内存
• 知识图谱 --将记忆与方向关系（相关、依赖、取代、矛盾、延伸）联系起来
• 除尘检测 --保存时自动重复警告、Jaccard相似性扫描和一键合并
• 云同步 --使用Pro层跨机器同步内存

快速开始

克劳德代码

claude mcp add apex-memory -- npx apex-memory

就是这样。你的特工现在有持久记忆了。

光标

添加到MCP设置(.cursor/mcp.json):

{
  "mcpServers": {
    "apex-memory": {
      "command": "npx",
      "args": ["apex-memory"]
    }
  }
}

请参阅 光标设置指南 了解完整的详细信息和故障排除。

帆板运动

打开 ~/.codeium/windsurf/mcp_config.json （通过 Cmd+Shift+P → “Windsurf：打开MCP配置”）并添加：

{
  "mcpServers": {
    "apex-memory": {
      "command": "npx",
      "args": ["apex-memory"]
    }
  }
}

请参阅 风帆设置指南 了解完整的详细信息和故障排除。

VS代码+GitHub副本

在项目根目录中，创建 .vscode/mcp.json:

{
  "servers": {
    "apex-memory": {
      "command": "npx",
      "args": ["apex-memory"]
    }
  }
}

请参阅 VS代码设置指南 了解完整的详细信息和故障排除。

克莱恩

打开Cline侧栏中的MCP服务器面板→ 编辑MCP设置，然后添加：

{
  "mcpServers": {
    "apex-memory": {
      "command": "npx",
      "args": ["apex-memory"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

请参阅 Cline设置指南 了解完整的详细信息和故障排除。

其他MCP客户端

apex存储器适用于任何兼容MCP的客户端。指向：

npx apex-memory

服务器使用标准MCP协议通过stdio进行通信。请参阅 通用MCP设置指南 例如，使用VS Code、Continue.dev和自定义客户端。

顶点记忆新手？

遵循 入门教程 --在2分钟内安装、配置并保存您的第一个内存。在中包含CLAUDE.md集成代码段和复制粘贴编辑器配置 docs/editors/.

工具

apex memory为您的代理提供了30个工具：

运作原理

当您的代理遇到值得记住的事情时——架构决策、棘手的错误修复、用户偏好——它会调用 save_memory:

save_memory({
  content: "User prefers functional components over class components in React",
  category: "preference",
  tags: ["react", "components"],
  project: "frontend-app"
})

在下一个会话中，代理在开始工作之前回忆上下文：

recall({ project: "frontend-app" })

或者搜索特定内容：

search_memories({ query: "authentication AND JWT" })

分类

根据记忆所代表的内容组织记忆：

会话

跟踪编码会话以分组相关记忆：

start_session({ project: "api-server" })
// ... agent works, saves memories with the session_id ...
end_session({ session_id: "...", summary: "Refactored auth middleware to use JWT" })

记忆链接

将相关记忆连接到知识图中：

link_memories({
  source_id: "decision-about-jwt",
  target_id: "bug-with-token-expiry",
  link_type: "related"
})

五种链接类型： related, depends_on, supersedes, contradicts, extends.查询与的连接 get_linked_memories，扫描重复项 find_duplicate_groups，并将它们与 merge_memories.

云同步（专业版）

通过Pro订阅跨机器同步内存（9美元/工作区/月）。

1.注册并获取专业版升级链接：

apex_memory_login({
  server_url: "https://apex-memory-sync.your-account.workers.dev",
  email: "you@example.com"
})

这将注册您的工作区，在本地存储API密钥，并返回一个签出URL以激活Pro。

2.检查您的同步状态：

apex_memory_status()

显示工作区ID、订阅层和上次同步时间戳。

3.随时手动同步：

apex_memory_sync()

将本地更改推送到云端，并拉取远程更改。记忆在机器之间融合。

当Pro处于活动状态时，自动同步也会在代理启动时运行——不需要手动触发。

自动捕获

自动捕获在每个编码会话结束时自动保存会话上下文——无需手动 save_memory 需要电话。

apex_memory_auto_capture({
  project: "api-server",
  summary: "Refactored auth middleware to use JWT refresh tokens",
  session_id: "...",
  decisions: ["Use RS256 signing for cross-service token validation"],
  files_worked_on: ["src/auth/middleware.ts", "src/auth/tokens.ts"],
  errors_encountered: ["JWT expired during refresh cycle"],
  solutions_found: ["Added 30s clock skew tolerance to token validation"]
})

在下一次会话开始时，使用 session_summary 回忆一下被抓的东西：

session_summary({ session_id: "..." })

默认情况下启用自动捕获。要禁用，请设置 auto_capture.enabled = false 在 ~/.apex-memory/config.json.

存储

所有数据都存储在本地 ~/.apex-memory/memory.db --具有WAL模式和FTS5全文搜索的SQLite数据库。没有数据离开你的机器。

定价

免费和开源。 核心MCP服务器是麻省理工学院许可的，功能齐全——本地存储、无限内存、无限会话、无限制。

专业级别——9美元/工作区/月。 一切免费，加上：

• 在1秒内跨机器同步 --无论你在哪里工作，记忆总是最新的
• 自动云备份 --您的内存存储是持续备份的，无需维护
• 从任何机器上的任何编辑器访问 --Claude Code、Cursor、Windsurf，全部共享一个内存存储

定价详情 · 升级指南

支持该项目。 如果顶点记忆对你有用，请考虑 .

为什么是顶点记忆？

与MCP内存服务器相比

顶点存储器比下一个最小的竞争对手小32倍 并以毫秒为单位开始。没有机器学习模型，没有向量数据库，没有臃肿——只有由SQLite FTS5支持的快速、可靠的内存。

与通用存储器相比

apex内存是专门为编码代理工作流构建的。它不是一个通用的存储层，而是你的AI编码代理从第一天起就应该拥有的存储系统。

贡献

看 贡献.md 作为指导方针。

许可证

麻省理工学院