OpenCode Memory 插件（opencode-mem） + Go 套餐：安装、配置、使用全指南

发布时间：2026/7/7 5:45:09

OpenCode Memory 插件 Go 套餐安装、配置、使用全指南概述OpenCode Memoryopencode-mem是 OpenCode 的长期记忆插件。它自动捕捉对话中的关键信息构建用户画像并通过向量数据库实现跨会话记忆检索。结合Go 套餐无需自备 API Key开箱即用。一、前置条件已安装 OpenCode CLI已开通Go 套餐访问 opencode.ai/auth 查看计划Node.js 18二、安装2.1 安装 opencode-mem 插件# 通过 opencode 插件市场安装opencode plugin opencode-mem2.2 验证安装# 查看配置文件中的插件列表cat~/.config/opencode/opencode.json# plugin 数组应包含 opencode-mem2.3 确认 Go 套餐登录opencode auth status# 应显示已登录及 Go 套餐信息三、配置3.1 启用插件编辑~/.config/opencode/opencode.json{$schema:https://opencode.ai/config.json,permission:allow,server:{hostname:127.0.0.1,port:4096},plugin:[opencode-mem]}三、配置3.1 启用插件编辑~/.config/opencode/opencode.json{$schema:https://opencode.ai/config.json,permission:allow,server:{hostname:127.0.0.1,port:4096},plugin:[opencode-mem]}3.2 配置 opencode-memGo 套餐原生方式推荐编辑~/.config/opencode/opencode-mem.jsonc{ // ---- 存储 ---- storagePath: ~/.opencode-mem/data, // ---- 嵌入模型本地运行无需联网 ---- embeddingModel: Xenova/nomic-embed-text-v1, // ---- Go 套餐原生 Provider推荐 ---- // 无需硬编码 API Keyopencode 负责认证 opencodeProvider: opencode-go, opencodeModel: opencode-go/deepseek-v4-flash, // ---- 自动记忆捕捉 ---- autoCaptureEnabled: true, autoCaptureMaxRetries: 3, autoCaptureIterationTimeout: 30000, // ---- Web 管理界面 ---- webServerEnabled: true, webServerPort: 4747, webServerHost: 127.0.0.1, // ---- 去重与清理 ---- deduplicationEnabled: true, deduplicationSimilarityThreshold: 0.90, autoCleanupEnabled: true, autoCleanupRetentionDays: 30, // ---- 用户画像 ---- injectProfile: true, userProfileAnalysisInterval: 10, // ---- 搜索 ---- similarityThreshold: 0.6, maxMemories: 10 }3.3 配置 opencode-mem手动 API Key 方式备选如果你偏好显式指定 API Key 而非使用 Go Provider{ // 注释掉 Go Provider 相关行 // opencodeProvider: opencode-go, // opencodeModel: opencode-go/deepseek-v4-flash, // 使用手动配置 memoryProvider: openai-chat, memoryModel: deepseek-v4-flash, memoryApiUrl: https://opencode.ai/zen/go/v1, memoryApiKey: 你的 Go 套餐 API Key }推荐使用方式 3.2Go Provider更安全简洁Key 变更时无需修改配置文件。四、重启生效修改配置文件后需重启 opencode# 重启 opencode 终端会话即可重新加载插件# opencode 配置变更后新会话自动生效重启后插件自动加载日志路径tail-f~/.opencode-mem/opencode-mem.log五、使用5.1 自动记忆捕捉Auto-Capture配置项autoCaptureEnabled: true插件会在每次对话空闲约 10 秒后自动分析当前会话内容提取关键信息存入向量数据库。无需手动干预。示例5.2 Web 管理界面浏览器打开http://localhost:4747或命令行一键打开# WindowsStart-Processhttp://127.0.0.1:4747# macOSopenhttp://127.0.0.1:4747# Linuxxdg-openhttp://127.0.0.1:4747Web 界面可- 浏览所有记忆条目 - 按项目/时间筛选 - 搜索记忆 - 手动添加/编辑/删除记忆 - 查看用户画像5.3 在对话中使用记忆OpenCode 会自动将相关记忆注入 AI 上下文。你也可以通过injectProfile功能让 AI 了解你的偏好。配置项injectProfile: true5.4 记忆搜索记忆搜索通过 Web UIhttp://localhost:4747完成支持关键词检索和项目筛选。六、测试与验证6.1 检查 API 连通性# Go Provider 方式无需 Keycurl-s-XPOSThttps://opencode.ai/zen/go/v1/chat/completions\-HContent-Type: application/json\-d{ model: deepseek-v4-flash, messages: [{role: user, content: Hello}] }Go Provider 方式下opencode 自动处理认证curl 测试仅用于验证端点可达。6.2 验证插件加载# 查看配置文件中的插件列表cat~/.config/opencode/opencode.json# plugin 数组应包含 opencode-mem6.3 检查日志确认无报错Get-Content ~/.opencode-mem/opencode-mem.log-Tail30正常日志示例[INFO] Auto-capture session: xxx [INFO] Memory stored successfully: xxx [INFO] Web server started on http://127.0.0.1:4747异常排查错误原因解决 401 Incorrect API key API Key 无效切换到 Go Provider 方式或更新 Key session.create returned no session id Go Provider 未连接检查 opencode auth list API request timeout 网络波动增大 autoCaptureIterationTimeout opencode provider is not connected opencode 未登录执行 opencode auth login6.4 验证 Web UIcurl-s http://127.0.0.1:4747|Select-String-Patternopencode# 应返回 HTML 页面内容6.5 完整端到端测试1. 在 opencode 中执行一条对话如我的名字是张三 2. 等待约 10-15 秒auto-capture 触发 3. 查看日志确认记忆已存储 4. 打开 http://127.0.0.1:4747 确认该条记忆出现在列表中七、常见问题Q: 如何查看 Go 套餐用量opencode stats# 或浏览器访问 https://opencode.ai/authQ: 如何切换到不同的模型Go 套餐支持以下模型- deepseek-v4-flash - mimo-v2.5 - qwen3.7-plus修改opencodeModel即可。Q: 记忆数据存在哪里本地路径: ~/.opencode-mem/data/ 存储方式: SQLite 向量数据库网络依赖: 无需外部服务项目隔离: 每个项目自动分片存放Q: 可以关闭自动捕捉吗// 设为 false 即可关闭 autoCaptureEnabled: false关闭后仅通过 Web UI 或 API 手动管理记忆。八、总结opencode-mem Go 套餐 - 零外部依赖嵌入模型本地运行 - 零 API Key 管理Go Provider 自动认证 - 全自动记忆捕捉 - 本地向量数据库数据不出域 - Web UI 可视化管理Go 套餐下配置 opencode-mem 仅需两步# 1. 配置 Go ProvideropencodeProvider:opencode-go# 2. 重启 opencode 终端会话使配置生效就这么简单。