39、【Agent】【OpenCode】本地代理分析(三)

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

背景

上篇 blog
【Agent】【OpenCode】本地代理分析(二)

分析了 OpenAI 风格的核心特征:固定的 endpoint 路径 /v1/chat/completions(所有的聊天请求都会发到这里),请求格式统一,统一的认证方式,统一的流式响应格式,由于 OpenCode 只发送 OpenAI 风格的 endpoint 和格式,所以本地代理这里必须监听 /v1/chat/completions,接收 OpenAI 格式的 JSON,再转发给 DashScope,然后收到指定请求 /v1/chat/completions 时,开始拼接 request body,该本地代理考虑了 HTTP request body 可能是分块传输的形式,通过监听 data 事件把所有数据块拼成完整的字符串 body,然后介绍了分块传输的概念,并提到分块传输时,不会同时出现 Content-Length 字段,最后介绍了分块传输的适用场景,下面继续分析

OpenCode

上篇 blog 提到了分块传输的适用场景,当然,HTTP 请求也不一定要分块传输,如果提前知道 body 的长度,主动设置 Content-Length,也是可以的,此时请求就不会使用 chunked,比如

javascript 复制代码
const body = JSON.stringify({ ... });
req.setHeader('Content-Length', Buffer.byteLength(body));
req.write(body); // 一次性发送

最后再总结下

  • 分块传输(Chunked):把数据切成多块发送,适合一边生成,一边传输的场景
  • 代理需考虑拼接场景:网络传输可能一次只收到一部分(一个 chunk),也就是分块传输,代理应该综合考虑所有可能场景
  • Node.js 的 data 事件 :每次收到一个数据库,就触发一次 data 事件,需手动拼接
  • Node.js 的 end 事件:所有块接收完成,此时可以安全处理完整 request body
  • 对开发者透明,Node.js 已处理完底层 chunk 格式,只需拼接字符串

OK,回到拼接 request body 这里

javascript 复制代码
let body = '';
req.on('data', chunk => body += chunk);
req.on('end', () => { ... });

上面介绍了分块传输的相关内容,下面再看另一个点:箭头函数

javascript 复制代码
chunk => body += chunk

这是 JavaScript 中的一种简洁函数写法,这种写法是下面这种传统写法的简写

javascript 复制代码
let body = '';
req.on('data', function(chunk) {
  body = body + chunk;
});

所以 chunk => body += chunk 就是一个函数,其作用是把收到的数据块 chunk 拼接到 body 后面,下面来详细拆解其中的语法点

  • chunk :函数参数名(叫 data,part,x 都行,名字不重要) ,当 HTTP 请求发送数据时,Node.js 会分多次调用这个函数,每次调用时,都传入一个数据片断 (也就是这里的 chunk)
  • =>:表示这是一个箭头函数,其左边是参数,右边是函数要做的事
  • body += chunk :函数体内容,body = body + chunk 的简写

举个例子

  • 初始:body = ""
  • 第一次收到 chunk = 'Hello':body = 'Hello'
  • 第二次收到 chunk = 'World':body = Hello World

其核心思想在于,每当有新数据到来时,就将其追加到 body 这个变量里 ,这也是 Node.js 的语法特性所要求的,req.on('data',...) 需要开发者传入一个回调函数,这个回调函数告诉 Node.js,当数据到达时,需要执行回调函数里的操作,而这里的箭头函数可以让代码更简洁,更清晰:

  • 冗长写法
javascript 复制代码
req.on('data', function(dataChunk) {
  body = body + dataChunk;
});
  • 简洁写法
javascript 复制代码
req.on('data', chunk => body += chunk);

OK,再举个类似的例子,比如

javascript 复制代码
x => x * 2

等价于

javascript 复制代码
function(x) { return x * 2; }

OK,再回到本地代理的实现部分,下面是 end 事件的处理


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

相关推荐
锋行天下1 分钟前
langgraph 全栈项目(三)
前端·人工智能·后端
黄啊码16 分钟前
【黄啊码】最近面了十几个想转 FDE 的程序员,一个都没招
人工智能
锋行天下1 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
七夜zippoe1 小时前
Agent 告警设计:分级告警、智能降噪与值班排班
开发语言·ai·agent·告警·智能降噪·值班排班
大模型真好玩1 小时前
用 Seedance 2.5 Flash 实现1分钟AI短剧,满足孩子的超级英雄对战梦
人工智能·aigc·deepseek
FengY_HYY1 小时前
从人类组织到人类&大模型组织,我的位置在哪里?
人工智能·程序员·llm
Flynn Liang2 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
锋行天下2 小时前
langgraph全栈项目(一)
前端·人工智能·后端
程序员cxuan2 小时前
不得了,Google 造反了,Opus 5.5 又被干了
人工智能·后端·程序员
数字新视界2 小时前
能耗管理系统提升企业能源效率的实践与展望
大数据·人工智能·数据中心·机房管理·模块化机房