记忆先写成记录,后面的会话才有东西可找
README 描述的处理顺序是捕获工具使用中的观察、生成语义摘要,再让后续会话访问。比如一项实现选择或一次问题处理,可以作为背景被找回;这里保存和检索的是记录,模型本身没有因此重新训练。
这也决定了它适合解决哪类重复工作:当助手需要知道“之前做了什么、当时为什么这样做”时,已有观察比重新口述整段项目历史更容易定位。
先搜索引,看到相关记录再取详情
官方搜索流程是 search、timeline、get_observations。第一步给出紧凑索引和记录 ID;第二步看相关观察前后的时间关系;最后一步才读取选中的完整记录。
例如你想继续处理一个旧问题,可以先找相关条目,再看它发生在什么上下文里,最后读取需要的细节。这条顺序把检索范围逐步收窄,不必每次都将所有项目历史放回助手的上下文。
装了 npm 包,插件还不一定已经接上
官方特别提醒,全局 npm 安装得到的是 SDK/库,不会自动注册插件钩子或配置工作服务。Claude Code 用户应选择官方安装器或插件市场路线,并按说明重启;OpenCode、T3 Code 等宿主则有各自的接入说明。
实际连接由几个部件配合:生命周期钩子捕获会话事件,本地 HTTP 服务提供查看和搜索入口,SQLite 保存记录,Chroma 参与语义与关键词混合搜索。系统要求包括 Node.js 20 以上,文档也说明了 Bun 和 uv 的用途。
把数据放在哪里,安装时就要选清楚
当前安装流程会让用户选择记忆提供商,也提供明确指定提供商、跳过账号交互的方式。托管观察服务、自己的模型密钥和既有服务计划,对应不同的费用与数据安排,不能只看开源许可就认为全部环节都免费。
隐私标签、云同步和截图保存另有设置。特别是保存截图、将它上传、交给观察模型处理,并不是同一个开关。开始记录实际项目之前,先沿着官方配置说明确定哪些内容进入记忆、哪些内容会离开本机。
需要重新补充项目背景时,可以从那次工作的观察记录查起。至于要保留多少历史、使用哪一种记忆提供商,应该跟着自己的项目和工具来选,没必要在第一次安装时全部打开。