OpenCode 提示缓存优化从 0% 到 97.6% 的修复路径0. 相关 PR#5224 – 最初报告了系统环境提示词中动态文件列表导致缓存失效。#14743 – 核心修复 PR实现系统提示词拆分、工具排序、日期冻结和可选 1h TTL。#27378 – 将 #14743 中的系统提示词拆分和缓存稳定化拆分为独立 PR便于审查合并。1. 问题现象使用 OpenCode DeepSeek或 Anthropic Claude时API 账单显示输入 token 费用畸高输出 token 费用极低。例如连续数十次请求每次输入 1012 万 token输出仅数百 token而成本稳定在 $0.05 左右。这表明缓存命中率接近零每次请求均以全价重新写入完整上下文成本失控。2. 根因分析DeepSeek 等模型支持前缀精确匹配缓存哈希顺序为tools → system → messages。只要前缀中任一字节变化之后所有缓存块失效。OpenCode 旧版本存在以下导致前缀不稳定的因素#5224 首先指出环境动态污染问题系统提示词为单一整体动态内容环境变量、当前目录、项目 AGENTS.md与稳定内容Provider 指令、全局 AGENTS.md混在同一块任何动态变化均使整块缓存失效。Bash 工具 Schema 包含绝对路径Instance.directory随仓库路径变化导致工具哈希变化。Skill 工具加载顺序不确定Object.values()遍历导致顺序随机。系统提示词包含当前日期new Date().toDateString()跨天变化。默认缓存 TTL 仅 5 分钟会话间隙稍长即过期重新写入。3. 修复方案核心修复来自 #14743部分内容后续由 #27378 拆分。分为默认生效和可选开启两类。默认生效无需配置系统提示词拆分为两个独立块S1/S2S1稳定块Provider 指令、全局 AGENTS.md、全局 Skills已排序S2动态块环境变量cwd、平台、项目 AGENTS.md、项目 Skills拆分后切换仓库或项目时仅 S2 重写约 400 tokenS1约 17k token保持缓存命中。Bash 工具移除cwd字段当前目录信息改由环境块提供消除路径变化对工具哈希的影响。Skill 工具按名称排序保证工具描述顺序稳定。可选开启环境变量控制OPENCODE_EXPERIMENTAL_CACHE_STABILIZATION进程生命周期内冻结日期首次调用new Date().toDateString()后固定并缓存指令文件读取结果防止跨天或文件系统变动使 S1 前缀改变。OPENCODE_EXPERIMENTAL_CACHE_1H_TTL将 M1第一个缓存标记的 TTL 从默认 5 分钟延长至 1 小时写入成本从 1.25 倍升至 2 倍适用于会话间隙较长的场景。OPENCODE_EXPERIMENTAL作为统一开关可同时启用上述两项。4. 环境变量完整列表变量作用推荐值OPENCODE_CACHE_AUDIT记录每次 LLM 调用的缓存命中率、读写 token 数至~/.local/share/opencode/log/dev.log1OPENCODE_EXPERIMENTAL同时启用系统提示词拆分和缓存稳定化1OPENCODE_EXPERIMENTAL_SYSTEM_PROMPT_SPLIT显式启用 S1/S2 拆分1OPENCODE_EXPERIMENTAL_CACHE_STABILIZATION显式冻结日期和指令读取1OPENCODE_EXPERIMENTAL_CACHE_1H_TTL将 M1 TTL 延长至 1 小时1所有变量需在opencode进程启动前设置。5. 实测数据DeepSeek在 DeepSeek 模型上测试跨仓库场景/tmp/folder-a→/tmp/folder-b5 分钟内对比启用优化前后的首次请求场景首次请求缓存命中率读取 token写入 token修复前0%0~18,000修复后拆分 稳定化 1h TTL97.6%~17,000~400仅 S2环境块需写入S1 全部命中。后续请求命中率升至 99% 以上。该数据与 #14743 在 Anthropic Claude 上的结果一致。6. 使用建议6.1 环境变量设置临时生效PowerShell$env:OPENCODE_CACHE_AUDIT1;$env:OPENCODE_EXPERIMENTAL1;$env:OPENCODE_EXPERIMENTAL_CACHE_1H_TTL1永久生效添加到系统环境变量。6.2 自动化任务延续OpenCode 原生支持-c--continue参数恢复最近会话无需依赖任何第三方 Goal 插件。例如使用 PowerShell 循环脚本while($true){opencode run-cContinue the task...Start-Sleep-Seconds 10}该方式不引入额外插件且因环境变量生效缓存前缀保持稳定。注意某些第三方 Goal 插件可能因实现不当如强制重新注入上下文破坏缓存应避免使用。建议直接使用 OpenCode 原生的-c或--session参数。6.3 避免 Compaction 干扰上下文过长触发 Compaction 时系统提示词可能重新生成导致缓存失效。可在opencode.json中调大defaultTokenBudget如 300000以延后压缩。6.4 兼容性部分提供商如 llama.cpp Qwen不支持多 system 块可在配置中关闭拆分{provider:{id:{options:{splitSystemPrompt:false}}}}本优化对 OpenAI、DeepSeek、Gemini 等支持自动前缀缓存的提供商均有效。7. 已知未覆盖场景项目级 Skills / MCP 工具不同项目工具描述不同S1 仍会变化无法跨项目复用。跨机器缓存技能描述可能因机器而异。Plan/Build 模式切换TaskTool描述变化待后续处理。Compaction 后缓存对齐#10342。8. 总结OpenCode 缓存命中率低的根本原因是系统提示词前缀不稳定。#5224 首次报告#14743 通过拆分系统块、冻结动态内容、排序工具等机制修复#27378 辅助拆分审查。启用相应环境变量后在 DeepSeek 上跨仓库首次请求缓存命中率从 0% 提升至 97.6%显著降低输入 token 成本。建议所有使用付费模型的 OpenCode 用户开启这些优化并利用原生-c参数实现自动化任务延续避免使用可能破坏缓存的第三方 Goal 插件。结合OPENCODE_CACHE_AUDIT可实时监控效果。