Aposhuang
チュートリアル
zh

OpenCode 没有记忆?三种方案让它跨会话记住你(附实测踩坑)

huajianhuajian ·
10-2210
<figure><img src="/uploads/covers/ocmem-tutorial-9265b595.jpg" alt="Making OpenCode remember you" loading="eager"><figcaption>OpenCode memory setup | aposhuang.com</figcaption></figure><blockquote style="border-left:4px solid #d97757;background:#faf6f2;margin:16px 0;padding:10px 16px;color:#40484f"><p>环境:OpenCode V1(实测 1.19.3)/ Linux / Node 22 说明:文中标「实测」的结论均在本机复现过;标「未验证」的是社区说法,尚未复现。</p></blockquote> <h2>导语</h2> <p>用 OpenCode 写代码的人几乎都会遇到同一件事:昨天刚跟它讲清楚的项目约定,今天开个新会话,它又什么都不知道了。</p> <p>这不是 bug,而是架构选择。理解这一点,才知道该往哪个方向补。本文给出三条可行路线——文件级分层记忆、外部向量库、Hermes Agent 当大脑——并把配置过程中踩到的坑一并写清楚,省你重复排查。</p> <h2>一、为什么每次都要「从头开始」</h2> <h3>1.1 三个根因</h3> <p><strong>(1)会话是无状态的。</strong> 新开 session 时,模型能看到的只有三样:系统提示、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code>、当前会话历史。历史存在本地 SQLite(<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">~/.local/share/opencode/opencode.db</code>),要复用它必须续上同一个 session;换个新会话,它就真的什么都不记得。</p> <p><strong>(2)长对话会被压缩。</strong> 对话变长后走 compaction:旧内容被折叠成摘要。这对控制 token 是合理的,代价是细节丢失,表现为「刚才说过的事它转眼就忘」。</p> <p><strong>(3)它不会自己总结。</strong> 会话结束时不会写「这次学到了什么」。而 Hermes Agent 会把用户偏好、环境事实存成条目逐轮注入,任务完成后还能把流程沉淀成技能文档。</p> <p>一句话:<strong>OpenCode 是项目内的编码工具,不是全天候的个人 Agent。</strong> 两者对「记忆」的投资方向本来就不同。</p> <h3>1.2 两种记忆模型对照</h3> <table style="width:100%;border-collapse:collapse;font-size:14px;margin:16px 0"><thead><tr><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">维度</th><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">OpenCode 原生</th><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">Hermes Agent(常驻型)</th></tr></thead><tbody><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">跨会话记忆</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">无(除 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code>)</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">有,逐轮注入</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">载体</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">项目/全局 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code></td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">用户记忆 + 技能库 + 会话检索</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">自我沉淀</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">不会</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">会(任务完成后写技能)</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">长对话</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">压缩后丢细节</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">检索补回</td></tr></tbody></table> <p>结论很直接:<strong>想让 OpenCode 有记性,必须外加一层。</strong> 要么靠文件,要么靠插件写文件并注入,要么靠外部向量库检索。</p> <h2>二、方案 1:像 Hermes 一样分层记忆(文件 + 插件)</h2> <p>照 Hermes 的做法分三层,各管一段:</p> <ul><li><strong>用户层</strong>:你的偏好(语言、详略、口径),跨项目不变。</li><li><strong>项目层</strong>:仓库规范与当前进度,跟着仓库走。</li><li><strong>技能层</strong>:踩过的坑、可复用流程。</li></ul> <h3>2.1 保底层:AGENTS.md</h3> <p>OpenCode 原生就读这个文件,不依赖任何插件,因此它最可靠,也不会因为插件升级而失效。</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang=""><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0"># 全局(所有项目生效) ~/.config/opencode/AGENTS.md # 项目级(只在该仓库生效) &lt;你的仓库&gt;/AGENTS.md</code></pre> <p>写什么决定它有用还是添乱:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="markdown"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">## 用户 - 简体中文回复,结论先行,短。一次只留一个明显的下一步。 - 能自己验证的不要问,直接查完给结论。 ## 环境 - Linux 12 核 / 30GB,Python 3.12,Node 22。 - 项目用 pnpm,不要用 npm 装依赖。 ## 坑 - 本仓库的 calendar.py 遮蔽标准库 calendar,datetime.strptime 会抛 AttributeError。 ## 在建 - 模块 billing-export 未完成:未注册、未迁移、E2E 未通过。</code></pre> <p><strong>不要写进去的三类东西:</strong></p> <ol><li>一次性的任务进度——隔天就过期,而过期的事实比没有更糟;</li><li>大段日志与报错原文——占 token,且模型抓不到重点;</li><li>模型自己「猜」的结论——会越猜越偏。</li></ol> <blockquote style="border-left:4px solid #d97757;background:#faf6f2;margin:16px 0;padding:10px 16px;color:#40484f"><p>提示:写入 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code> 这类「代理指令文件」时,多数环境会要求人工确认(Hermes 会弹授权框)。这是有意的护栏,不要绕过。</p></blockquote> <h3>2.2 自动化层:opencode-hermes-memory</h3> <p>它把上面的内容自动化:写文件、注入系统提示,还能把流程沉淀成 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">SKILL.md</code>。</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">cd ~/.config/opencode npm install opencode-hermes-memory</code></pre> <p>在 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode.jsonc</code> 的 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugin</code> 数组登记(V1 写法):</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="json"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">{ "$schema": "https://opencode.ai/config.json", "plugin": ["opencode-hermes-memory"] }</code></pre> <p>它会创建以下结构,并注册 5 个工具(<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">memory_save</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">memory_search</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">skill_create</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">skill_update</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">skill_list</code>):</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang=""><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">~/.config/opencode/ ├── hermes-memory/ │ ├── memory.md # 环境事实、坑、工作流(约 1000 token) │ └── user.md # 用户偏好(约 500 token) └── skills/ └── &lt;skill-name&gt;/SKILL.md</code></pre> <h3>2.3 关键坑:记忆条目的格式(实测)</h3> <p>插件判断「有没有真内容」靠这行正则:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="js"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">return /^- \[/.test(content.replace(/^#.*$/gm, "").replace(/^_.*_$/gm, ""))</code></pre> <p>意思是:<strong>每条记忆必须是 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">- [日期] 内容</code> 开头的列表项</strong>,否则它认为记忆为空,<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">getSnapshot()</code> 返回 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">null</code>,一句都不注入。</p> <p>第一版写成裸的 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">- 简体中文回复……</code>:插件初始化日志正常、工具也能调用,但注入是空的。排查了一阵子才发现问题在格式。正确写法:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="markdown"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">## 沟通 - [2026-10-22] 简体中文回复。结论先行、短。 - [2026-10-22] 讨厌一次性建议,方案要两侧对称。</code></pre> <h3>2.4 重启与验证</h3> <p>配置改完必须重启,否则不生效:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">systemctl --user restart opencode-serve systemctl --user is-active opencode-serve # 应为 active curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:4096/config # 应为 200</code></pre> <p>验证要用「模型不可能猜对」的问题,而不是「总结一下我的偏好」这种它编也能编出来的题:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0"># 1) 记忆里独有的具体事实 opencode run "不要查文件、不要跑命令,只根据记忆回答:这个项目的测试命令是什么?本地服务端口是多少?" # 2) 验证「注入」是否真的生效,而不只是工具可用 opencode run "只看系统提示里 'Hermes Persistent Memory' 段,原样说出 '### User Preferences' 第一条"</code></pre> <p><strong>实测结果(2026-10-22)</strong>:第 1 问答对了——问的都是本机环境里的具体事实,它既没读文件也没跑命令,但它走的是 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">memory_search</code> 工具;第 2 问回答「系统提示里没有这一段」。</p> <blockquote style="border-left:4px solid #d97757;background:#faf6f2;margin:16px 0;padding:10px 16px;color:#40484f"><p>所以:<strong>可靠的是「文件 + 搜索工具」这条链;系统提示自动注入在 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode run</code> 路径下未生效,属于未验证项。</strong> 如果你只需要「能用」,<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code> 加 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">memory_search</code> 已经够;如果坚持每轮自动注入,先用第 2 个问题验证,别信初始化日志。</p></blockquote> <h2>三、方案 2:Supermemory(外部向量库)</h2> <p>前面两种都是「当前项目 + 全局」的静态文件。真正的跨项目检索——「上个月 A 项目里那个 XSS 过滤器怎么写的」——需要向量库。</p> <h3>3.1 安装</h3> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">cd ~/.config/opencode npx -y opencode-supermemory@latest install --no-tui</code></pre> <p>安装器会:在 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugin</code>(V1)和 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugins</code>(V2)里登记、注册 TUI 底栏、创建 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">/supermemory-init</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">-login</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">-logout</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">-status</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">-index</code> 五个命令,并提示登录。</p> <h3>3.2 坑一:它会把 V1 服务搞崩(实测)</h3> <p>安装器会写入 V2 专属的两个键:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="json"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">"plugins": ["opencode-supermemory"], "permissions": [{ "action": "supermemory_recall", "resource": "*", "effect": "allow" }]</code></pre> <p>V1 启动时直接拒绝,服务进入 crash-loop:</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang=""><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">Error: Configuration is invalid at ~/.config/opencode/opencode.jsonc ↳ V2 permissions are not supported by OpenCode V1. Use V1 "permission" rules or run opencode2. permissions</code></pre> <p><strong>处理</strong>:只保留 V1 的 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugin</code> 数组,删掉 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugins</code> 与 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">permissions</code> 两个键,再重启。删掉后服务正常 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">active</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">/config</code> 返回 200(实测)。</p> <p>判断自己有没有崩,看三个信号:</p> <ul><li><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">systemctl --user is-active</code> 在 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">active</code> 与 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">activating</code> 之间反复跳;</li><li><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">/config</code> 连不上(返回 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">000</code>);</li><li>日志里只有 TUI 配置加载记录,随后进程 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">status=1/FAILURE</code>。</li></ul> <h3>3.3 坑二:必须给 API key</h3> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">npx opencode-supermemory@latest status # 看注册状态 export SUPERMEMORY_API_KEY="sm_..." # 或在对话里 /supermemory-login</code></pre> <p>没有 key 时插件能加载、命令也在,但记忆功能不工作。这一步只能账号持有人自己做。</p> <h2>四、方案 3:Hermes Agent 当大脑,OpenCode 干粗活</h2> <p>思路:规划与长期记忆留在 Hermes Agent,执行交给 OpenCode。Hermes Agent 把提炼过的任务简报写进项目 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code>,再命令行唤醒 OpenCode 改代码;它汇报后,由 Hermes Agent 把新学到的东西写回长期记忆。</p> <blockquote style="border-left:4px solid #d97757;background:#faf6f2;margin:16px 0;padding:10px 16px;color:#40484f"><p><strong>边界说明(未验证)</strong>:网上流传的 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">hermes start --daemon</code>、在 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">agent.config.json</code> 里挂 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode_executor</code>、以及 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode run --task "..." --path ...</code>,本机都没有复现成功。<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode run</code> 的实际用法是:</p></blockquote> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">opencode run "你的指令" # 可选 --model 指定模型</code></pre> <p>真要落地,用「文件契约 + 命令行调用」最稳:</p> <ol><li>Hermes Agent 写 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code>(只放本次任务上下文与禁止事项);</li><li>执行 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode run "任务"</code>;</li><li>读回 diff 与测试输出,再把经验写回长期记忆。</li></ol> <p>这套做法的价值不是「更聪明」,而是<strong>每次给 OpenCode 的都是最干净的简报</strong>:上下文短、不吃压缩、不容易失忆。它解决的是「上下文太长导致健忘」,不是「完全没有记忆」——这两件事别混。</p> <h2>五、附带运维:数据库会膨胀(实测)</h2> <p><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">~/.local/share/opencode/opencode.db</code> 会随会话增长,而且删掉的数据不会自动回收。</p> <p>实际情况:文件 <strong>1276 MB</strong>,但按表统计真实数据只有约 <strong>170 MB</strong>(<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">event</code> 96 MB + <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">part</code> 56 MB),其余全是空页。表现是「用久了启动慢、查询卡」,不是坏了。</p> <p>清理(先停服务,VACUUM 需要独占):</p> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang="bash"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">systemctl --user stop opencode-serve cp ~/.local/share/opencode/opencode.db ~/.local/share/opencode/opencode.db.bak-$(date +%Y%m%d-%H%M) python3 - &lt;&lt;'PY' import sqlite3, os p = os.path.expanduser("~/.local/share/opencode/opencode.db") c = sqlite3.connect(p, timeout=30) print(c.execute("pragma integrity_check").fetchone()) # 先做完整性检查 c.execute("pragma wal_checkpoint(TRUNCATE)") c.execute("vacuum") c.execute("pragma optimize") c.close() PY systemctl --user start opencode-serve</code></pre> <p>结果:<strong>1276 MB → 172 MB,WAL 86 MB → 0</strong>,完整性 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">ok</code>,72 个会话一条没少。</p> <h2>六、排错速查</h2> <table style="width:100%;border-collapse:collapse;font-size:14px;margin:16px 0"><thead><tr><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">症状</th><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">原因</th><th style="border:1px solid #d5dbe3;padding:8px 10px;background:#f4f6f9;text-align:left;font-weight:700">处理</th></tr></thead><tbody><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">服务在 active / activating 之间反复跳</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">配置里有 V1 不认的键(<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">plugins</code>、<code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">permissions</code>)</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">删掉这两个键,重启</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">插件日志正常,但模型说没记忆</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">记忆条目不是 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">- [日期] 内容</code> 格式</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">统一加 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">- [YYYY-MM-DD]</code> 前缀</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">/config</code> 返回 000</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">服务没起来</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">前台跑 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode serve --port 4097</code> 看真实报错</td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">用久了慢、启动卡</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">SQLite 未回收空页</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top"><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">wal_checkpoint(TRUNCATE)</code> + <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">VACUUM</code></td></tr><tr><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">新开 session 就失忆</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">正常行为</td><td style="border:1px solid #d5dbe3;padding:8px 10px;vertical-align:top">靠 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code> / 插件 / 向量库</td></tr></tbody></table> <h2>七、到底该选哪个</h2> <ol><li><strong>先写 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">AGENTS.md</code></strong>(全局 + 项目各一份)。零成本、原生生效、不受插件版本影响。这一步能解决大部分「它又忘了」。</li><li><strong>再装 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">opencode-hermes-memory</code></strong>,把偏好与环境事实搬进 <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">memory.md</code> / <code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:.9em;background:#eef1f5;color:#b02a37;padding:2px 5px;border-radius:4px">user.md</code>,用「独有数字」验证一次,别用主观题验证。</li><li><strong>最后才考虑 Supermemory</strong>。只有真的需要跨项目检索历史代码时才值得,且要接受「注册账号 + API key」的门槛。</li><li><strong>方案 3 是工作流选择,不是配置项。</strong> 它优化的是上下文长度,不是记忆本身。</li></ol> <h2>结语</h2> <p>把「记忆」当成工程问题,而不是模型能力:</p> <ul><li><strong>写在文件里</strong>,让它在会话开始前就存在;</li><li><strong>用唯一事实验证</strong>,别用主观题自欺;</li><li><strong>把膨胀的数据库定期压回去</strong>,别让工具自己拖慢自己。</li></ul> <p>这三件事做完,OpenCode 的「失忆」就不再是玄学。</p> <h3>附录:本文涉及的文件清单</h3> <pre style="background:#0f172a;color:#e6edf3;padding:16px 18px;border-radius:10px;overflow-x:auto;font-size:13.5px;line-height:1.6;margin:14px 0;white-space:pre;tab-size:2" data-lang=""><code style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:13.5px;color:inherit;background:none;padding:0">~/.config/opencode/opencode.jsonc # plugin 数组(V1) ~/.config/opencode/tui.jsonc # supermemory 底栏(可选) ~/.config/opencode/package.json # 插件作为 npm 依赖 ~/.config/opencode/AGENTS.md # 全局记忆(最可靠,需人工批准写入) ~/.config/opencode/hermes-memory/memory.md # 环境事实 ~/.config/opencode/hermes-memory/user.md # 用户偏好 ~/.local/share/opencode/opencode.db # 会话库(可 VACUUM 收缩)</code></pre>

コメント0

コメント作成の権限がありません