33、【Agent】【OpenCode】本地代理（智能适配层）
【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除
背景
上篇 blog
【Agent】【OpenCode】模型配置（配置 Qwen 模型）
分析了 OpenCode Zen 剩余的描述，比如opencode/xxx不只有 6 个免费的模型，还有更多的 GPT，Claude，Gemini 等其他众多收费模型，其模型托管在 A 国，所以之前一直分析讨论的数据安全合规，以及网络延迟是个问题，接着介绍了配置模型直连国内 API 的方法，以 Qwen 为例，首先在 OpenCode CLI 输入/connect连接供应商，这里选择的是 Alibaba（China），然后输入 API Key，其敏感信息保存在auth.json（权限600，只有管理员能看），接着在 OpenCode CLI 输入/models选择模型，其中以 Qwen-Plus 为例，发现输入简单的【你是谁】的问题都要消耗 1w+ tokens，即使reasoning配置成false，依然也会消耗这么多 tokens，下面继续分析
OpenCode
OK，上篇 blog 把本土的模型给配上并使用了，其流量路径如下
下面准备在 OpenCode 和远端大模型 API 之间加一个适配层，也就是本地代理，由本地代理代为收发 OpenCode 给远端大模型 API 的消息和响应
用代理转发 OpenCode 到模型 API 的请求，虽然看似多此一举，但实际上能带来非常多实用且关键的好处，下面简单介绍下
- 首先是协议/格式兼容性适配：OpenCode 默认按 OpenAI API 格式发送请求，并且 OpenCode 模型库来源 https://models.dev/api.json，这里的模型库更新肯定比官方慢，比如虽然也是 Qwen-Plus，但是 DashScope 还提供了其历史版本
qwen-plus-2025-07-28，而这些历史版本的模型在 OpenCode 模型库是找不到的
想要在 OpenCode 通过/models切换模型也更不会有这些特定版本的模型
那么本地代理的第一个作用就出现了，由于 OpenCode 客户端是先将请求发送给本地代理，本地代理可以在转发前，自动重写请求体，比如在代理中修改
parsedBody.model='qwen-plus-2025-07-28';// 将 qwen-plus 映射为 qwen-plus-2025-07-28此时无需再 OpenCode 中填写 DashScope 特有的模型名，保持配置通用，也能用上供应商的特定模型
- 其次是统一认证管理（安全&便捷）：如果直接在 OpenCode 中填写 DashScope Key，有两点不便
1、Key 会明文暴露在 IDE 配置中（不安全），上篇 blog 【Agent】【OpenCode】模型配置（配置 Qwen 模型） 里有提到，敏感信息会存放在auth.json，需要加权限进行限制
2、换 Key 时，需要修改所有客户端配置
此时代理的第二个作用就出来了，客户端只需要填一个假 Key（比如sk_proxy），然后代理在转发过程中，可以自动替换成真实的DASHSCOPE_API_KEY，这样可以集中管理 Key，避免泄露，更换也方便
- 此外，代理还可以收集请求，响应日志，方便调试：当 OpenCode 直连模型 API 时，用户看不到 AI 请求细节，出问题时难排查，并且想优化 Agent 也不方便
此时代理的第三个作用：可以自动保存每条请求，响应到日志文件里，方便调试，比如把请求内容，以时间戳为文件名保存下来
// 保存为1712345678901.json{timestamp:1712345678901, request:{model:"qwen-plus", messages:[...]}, response:{choices:[...]}}方便后面复现问题，分析 token 消耗，审计内容等
OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog
【Agent】【OpenCode】本地代理（收益分析）