37、【Agent】【OpenCode】本地代理分析（一）

【声明】本博客所有内容均为个人业余时间创作，所述技术案例均来自公开开源项目（如Github，Apache基金会），不涉及任何企业机密或未公开技术，如有侵权请联系删除

背景

上篇 blog
【Agent】【OpenCode】本地代理（JavaScript 脚本）
详细分析了选择了 JavaScirpt 脚本作为本地代理，是基于开发效率，生态适配和使用场景的综合考虑，比如 JavaScript 与前端，IDE 插件生态天然契合，JSON 处理极其简单，然后解释了JSON.parse()得到的是 JS 对象，不能直接用于 HTTP 传输，需要先将 JS 对象转成字符串，此外，还有异步 IO 高效处理流式响应，零依赖快速启动等好处，所以对于临时调试，JS 是最轻量的选择，然后列举了下不适合 JavaScript 的场景，提到所有主流语言都能实现本地代理，选择取决于开发者的熟悉度和需求，没有最好的语言，只有最合适当前场景的工具，下面继续分析

OpenCode

OK，下面来分析这个本地代理的实现

// dashscope-proxy.jsconsthttp=require('http');consthttps=require('https');constserver=http.createServer((req,res)=>{console.log(`📥 Received${req.method}${req.url}`);if(req.method==='POST'&&req.url==='/v1/chat/completions'){letbody='';req.on('data',chunk=>body+=chunk);req.on('end',()=>{// 从原始请求中获取 Authorization 头constauthHeader=req.headers['authorization']||'';constoptions={hostname:'dashscope.aliyuncs.com',port:443,path:'/compatible-mode/v1/chat/completions',method:'POST',headers:{'Authorization':authHeader,// 直接透传'Content-Type':'application/json','Content-Length':Buffer.byteLength(body)}};constproxyReq=https.request(options,(proxyRes)=>{res.writeHead(proxyRes.statusCode,proxyRes.headers);proxyRes.pipe(res);// 自动处理流式/非流式 + 自动 end()});proxyReq.on('error',(e)=>{console.error('Proxy error:',e.message);res.writeHead(502);res.end('Bad Gateway');});proxyReq.write(body);proxyReq.end();});return;}res.writeHead(404);res.end('Not Found');});server.listen(2048,'127.0.0.1',()=>{console.log('✅ DashScope proxy with full OpenCode & Ollama compatibility running on http://127.0.0.1:2048');});

该本地 HTTP 代理服务器可以接收来自 OpenCode（或其他兼容 OpenAI API 的客户端，不仅仅是 OpenCode）的请求，并将请求转发给阿里云 DashScope 的 API 兼容接口

首先是代理的整体结构

consthttp=require('http');consthttps=require('https');constserver=http.createServer((req,res)=>{// 处理每个进来的 HTTP 请求});server.listen(2048);// 假设监听在 127.0.0.1:2048

这里使用 Node.js 内置模块 http 创建一个本地 HTTP 服务器，该服务器监听本地的2048端口，所有发往http://127.0.0.1:2048的请求都会进入这个回调函数

进入服务器后，首先打印记录日志

console.log(`📥 Received${req.method}${req.url}`);

该日志会打印收到的请求方法（比如POST）和请求路径（比如/v1/chat/completions）

然后这里只处理特定请求

if(req.method==='POST'&&req.url==='/v1/chat/completions'){// 处理特定请求}

这里只处理 OpenAI 风格的聊天请求，该条件（/v1/chat/completions）是 OpenCode 默认发送的 endpoint，其他请求（比如/v1/models）可以忽略，这里提到了 OpenAI 风格和 endpoint，它们都是现代 AI 开发的核心概念，下面详细解释下

首先是 Endpoint（端点），Endpoint 是模型 API 提供服务的具体 URL 地址，客户端通过 endpoint 向服务器发送请求，可以类比成餐厅的点菜单：

• 餐厅 = 模型 API 服务商（比如 OpenAI，DashScope）
• 菜单上的每道菜 = 一个 endpoint
• 用户想点宫保鸡丁，就得告诉服务员，点这道/menu/kungpao-chicken

从技术角度，Endpoint 是 HTTP 请求的目标路径（URL Path），这个路径决定了服务器执行什么操作，常见的模型 API Endpoints 如下

所以，这里的判断条件/v1/chat/completions就是一个 endpoint，是专门用于发起聊天请求的入口地址

OK，然后是 OpenAI 风格，是指遵循 OpenAI API 的请求格式，相应格式和 endpoint 设计规范的一套标准，由于由于 OpenAI 的 API 设计简洁，很流行，许多其他厂商（如阿里云 DashScope，Google，Gemini，Ollama，Llama.cpp 等）都提供了兼容 OpenAI API 的接口，让开发者无需该代码就能切换后端

OK，本篇先到这里，如有疑问，欢迎评论区留言讨论，祝各位功力大涨，技术更上一层楼！！！更多内容见下篇 blog
【Agent】【OpenCode】本地代理分析（二）