supermemoryai/opencode-supermemory

opencode‑supermemory

是什么 – OpenCode AI 编程助手的插件，通过 Supermemory 服务提供跨会话和项目的持久化、可搜索记忆。它与 Supermemory 服务（https://supermemory.ai）通信，存储和检索“记忆”，例如用户偏好、项目架构、错误-解决方案模式和对话片段。

核心功能

• 自动捕获 – 每隔若干轮对话（可配置）后，对话将被保存到 Supermemory；会话结束时，剩余的对话将被清空。
• 上下文注入 – 在会话的首个消息中，代理会收到一份简洁的个人资料、项目记忆列表，以及（可选）个人记忆的语义搜索结果，无需用户主动提示。
• 理性召回 – 在回答前，代理会判断记忆搜索是否有帮助；若有帮助，则运行 supermemory 工具，结果将自动批准并注入模型请求（最多可配置的匹配数量）。
• 关键词提示 – 说出“remember”、“save this”等短语（或自定义正则表达式）会强制立即保存。
• 代码库索引 – /supermemory-index（或 /supermemory-init）命令使代理探索仓库并存储结构和模式信息。
• 压缩记忆 – 当 OpenCode 的上下文窗口达到阈值时，插件会在摘要步骤中加入相关记忆，并将摘要作为新记忆存储。
• 隐私保护 – 用 <private>…</private> 包裹的内容在存储前会被移除。
• 状态通知 – 小型非侵入式提示（或 TUI 消息）会通知用户记忆已保存、已召回，或有新版本插件可用。

安装与设置

bunx opencode-supermemory@latest install   # 为 OpenCode V1 和 V2 注册插件
bunx opencode-supermemory@latest login      # 或在配置文件中设置 SUPERMEMORY_API_KEY
bunx opencode-supermemory@latest status     # 验证连接性

安装程序会向 ~/.config/opencode/opencode.jsonc 写入两代的适当条目，并创建 /supermemory-index 命令。还提供了聊天内命令（/supermemory-init、/supermemory-login 等）。

使用方法

• 代理会自动获取记忆上下文；您也可以直接调用工具：

  {"mode": "search", "query": "how to build with bun"}
  

• 运行 /supermemory-index 让代理扫描仓库并填充记忆。
• 使用关键词短语或添加自定义正则表达式（配置中的 keywordPatterns）来触发手动保存。

配置（全部可选，存储在 ~/.config/opencode/supermemory.jsonc 或环境变量中）

设置	含义
SUPERMEMORY_API_KEY	Supermemory 服务的 API 密钥
captureEveryNTurns	自动保存之间的对话轮数（默认 3）
recallMode	direct（每个提示自动搜索）、advisory（代理决定）、off
maxMemories	每个请求注入的最大记忆数量
keywordPatterns	匹配时触发保存的额外正则表达式
compactionThreshold / compactionEnabled	触发摘要的阈值以及是否增强 OpenCode 2 的原生压缩
SUPERMEMORY_DEBUG=1	显示内部召回决策日志用于调试

支持的范围与类型

• 范围：user（个人）或 project（默认）。标签从 Git 远程或文件系统路径推导，确保在 Claude Code、Codex、Cursor 等工具中使用同一容器。
• 类型包括 project-config、architecture、error-solution、preference、learned-pattern、conversation。

许可证 – MIT。

---

所有细节均直接取自仓库的 README。