Surreal-Memory
基于SurrealDB的AI智能体持久化图记忆系统
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Surreal-Memory。 它的用途是：基于SurrealDB的AI智能体持久化图记忆系统 完整的 Skill 内容见：https://321skill.com/skills/surreal-memory/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“记住我们周二讨论的服务器宕机根本原因是JWT令牌过期，由Alice的代码审查报告提出。” 它会将“服务器宕机”、“JWT过期”、“Alice的审查”作为神经元存入，并用`CAUSED_BY`和`SUGGESTED_BY`突触连接它们。之后当你问：“周二为什么宕机？” AI能通过遍历图记忆，自动推理并回答出完整的因果链。
介绍
Surreal-Memory 解决了AI智能体缺乏长期、结构化记忆的问题。传统向量数据库的记忆是孤立且静态的，而该工具将记忆存储为相互连接的神经元和突触，形成一张动态的知识图谱，使智能体能够像人类一样通过关联进行推理和回忆。
使用上，它通过简单的命令行即可初始化并集成到现有AI工具链中。智能体可以将关键信息（如代码修复、用户反馈、项目决策）作为“神经元”存入，并通过定义“突触”类型（如CAUSED_BY, LEADS_TO）来建立记忆间的逻辑关系。当需要回忆时，系统通过图遍历和激活扩散来找到相关记忆链，而非简单的关键词匹配。
它非常适合需要复杂推理、多跳问答和长期上下文维护的场景的用户，例如开发具备自主思考能力的智能体、管理复杂项目、或分析需要追溯因果关系的事件。对于希望AI助手能记住过往对话细节并进行深度分析的全栈开发、智能体开发者和项目经理而言，这是一个强大的底层记忆增强工具。
需要注意的是，其核心依赖SurrealDB数据库，部署时需要运行该服务。虽然基础功能无需Embedding API，但若想结合向量搜索进行语义召回，仍需配置相应的模型。初次使用时，建议从记录简单的任务上下文开始，逐步建立记忆网络。
核心特点
核心区别在于用图结构（神经元+突触）替代向量存储，使记忆具备显式逻辑关系，支持无需Embedding API的多跳推理；同时，它基于完全开源的SurrealDB，将上游NeuralMemory的付费高级功能（如向量搜索、语义召回）全部免费提供。
注意事项
不适合仅需简单键值对存储或对部署额外数据库（SurrealDB）有严格资源限制的轻量级、一次性任务场景。
常见问题
Surreal-Memory和普通的向量数据库记忆有什么区别？
主要区别是记忆结构：向量库靠相似度搜索找孤立点；Surreal-Memory用图存储记忆点和关系，能通过关系链进行逻辑推理和追溯原因。
需要付费或者API密钥吗？
不需要。所有功能（包括向量搜索、语义召回）完全免费开源，无需任何付费许可证或外部Embedding API密钥即可使用基础图记忆功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/surreal-memory/raw/index.md 读取 Surreal-Memory 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/surreal-memory/raw/index.md（查看排版版本）