核心用法
Neutron Memory 是一款面向 AI 代理的语义化长期记忆系统，通过双层机制实现智能上下文管理：
Auto-Capture（自动捕获）：在对话结束后自动保存会话内容至云端记忆库，无需手动干预。启用方式：export VANAR_AUTO_CAPTURE=true
Auto-Recall（自动召回）：在新对话开始时，基于语义相似度而非关键词匹配，智能检索相关历史上下文并注入当前会话。启用方式：export VANAR_AUTO_RECALL=true
手动操作：提供 save（保存内容）、search（语义搜索）、diagnose（环境诊断）三个核心命令，支持灵活的阈值调控（0-1 相似度过滤）和结果数量限制。
显著优点
- 零摩擦体验：安装后完全自动运行，背景非阻塞式处理
- 语义级检索：基于向量嵌入的 meaning-based search，突破关键词局限
- 细粒度控制：Auto-Capture/Auto-Recall 默认关闭，纯 opt-in 设计，用户完全掌控数据流向
- 透明可审计：全部源码为可读 bash 脚本，无编译二进制，API 通信仅通过 HTTPS
- 低成本入门：$20 免费额度，无需信用卡
潜在缺点与局限性
- 云端依赖：所有记忆存储于 Vanar 托管服务（
api-neutron.vanarchain.com），存在服务商锁定风险 - 隐私边界：启用 auto-capture 后，完整的用户-助手对话原文会被上传，敏感场景需谨慎评估
- 网络要求：功能完全依赖 API 连通性，离线不可用
- 调试门槛：语义搜索结果的质量受 embedding 模型限制，可能存在召回偏差
- 生态封闭：仅支持 Vanar 提供的 Neutron API，无自托管或第三方后端选项
适合人群
- 需要 AI 代理维持长期项目上下文的知识工作者
- 跨会话协作场景频繁的开发者、研究员、内容创作者
- 能接受云端存储、重视便捷性高于绝对数据主权的用户
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 数据驻留 | 记忆数据存储于 Vanar 服务器 | 明确知晓数据跨境/第三方托管 |
| 密钥泄露 | API key 以环境变量形式管理 | 避免硬编码，遵循最小权限原则 |
| 过度召回 | 低阈值设置导致无关上下文污染 | 调整 threshold 参数（建议 0.5+） |
| 服务中断 | API 不可用导致记忆功能失效 | 关键信息建议本地备份 |
| 隐私泄露 | Auto-Capture 上传敏感对话 | 敏感场景保持手动模式，不启用 auto 开关 |