快速开始

对于 OpenCode v2，将包添加到原生 plugins 列表：

{
  "plugins": ["opencode-mem@latest"],
}

OpenCode 也会自动加载该包的 ./tui 配套组件，以便 自动捕获 / 画像 / 错误 toast 能在 TUI 中渲染（服务器插件 无法直接调用 ui.toast）。你无需在 plugins 中添加第二条条目。若你对远程 OpenCode 服务器运行仅 CLI 的 TUI， 请在该 CLI 的插件列表中注册 opencode-mem/tui（例如 cli.json），以便配套组件可以订阅 toast RPC 事件。

对于 OpenCode v1，将默认入口点添加到配置 ~/.config/opencode/opencode.json：

{
  "plugin": ["opencode-mem@latest"],
}

使用 @latest（或 semver 范围）且 opencode-mem.jsonc 中 autoUpdate: true（默认）时，当有更新的 npm 发布可用时，插件会清除 OpenCode 的缓存安装并提示你重启。像 opencode-mem@2.26.0 这样的固定版本永远不会自动更新。

OpenCode v2 上的自动记忆上下文

v2 插件通过模型的系统上下文提供自动记忆上下文。 这些块不会添加到已编写的用户提示中，也不会存储在聊天记录中。 使用 chatMessage.injectOn: "first"（默认）时，会话的初始上下文会 跨用户轮次与模型步骤保留。使用 "always" 时，它会在每次 已编写的用户轮次上刷新。

在主机或插件重启后，已恢复的会话会在其 下一次模型请求时从当前记忆存储重建上下文，即使没有新的用户提示到达。 重建的上下文可能因记忆与画像的演变而与原先不同。 恢复不会捕获合成用户提示，也不会在 OpenCode 插件存储中存储 记忆文本的第二份副本。压缩会使缓存的自动 上下文失效；现有的压缩记忆恢复也会继续运行。