最新动态:Sandbox 获得持续输入能力
Vercel 于 2026 年 10 月 26 日发布 Sandbox 命令支持标准输入的公告。本文在 10 月 27 日核验官方更新日志与文档;这是前一日发布的新功能,不是今天刚公布的版本,也不意味着所有命令行程序都能直接迁移。它值得全栈团队关注的原因,是后端任务与工具进程之间终于可以采用更自然的持续对话方式。
公告确认,运行中的命令现在可以接收 stdin 数据,适用场景包括读取标准输入的命令行程序与 stdio MCP 服务。TypeScript SDK 通过 runCommand() 的 stdin: true 和 detached: true 开启手动写入,再使用 writeStdin() 发送内容、closeStdin() 结束输入。公告也介绍了可读流转发和 Python 接口,但这些属于不同调用方式,不应混写成同一套 API。官方发布公告
文档边界:输入管道不等于交互终端
当前 JavaScript SDK 文档说明,未指定 stdin 时,命令读取的是空输入;手动写入的数据按调用顺序传递。这里提供的是管道而非终端。若进程不读取输入,写操作会在三十秒后失败;失败时可能已有部分数据到达进程,后续写入会被拒绝。关闭输入后,进程消费完已有内容才会读到输入结束。上述行为直接影响超时、重试与退出设计。SDK 参考文档
MCP 的 stdio 传输另有协议要求:服务从标准输入读取消息,向标准输出发送消息,以换行分隔 JSON-RPC 消息;日志可以写入标准错误,但不能污染协议输出。本文采用明确标注版本的 2025-11-25 规范页解释这些规则,并不把它称为本次 Vercel 更新的新协议。标准错误中出现文本,也不能单独作为业务执行失败的证据。MCP 传输规范
原创实施分析:先确定谁拥有任务状态
以下内容是基于接口边界提出的工程建议,并非官方性能结论。本文没有连接真实业务项目进行压测,也不提供吞吐量或成本下降比例。
对于“前端提交请求、后端启动工具、页面等待结果”的应用,建议由后端任务记录承担状态所有权,而不是让浏览器连接代表任务生命。页面刷新、用户关闭标签页、网络短暂中断,都应与工具是否完成分开处理。界面可以展示排队、运行、等待确认、完成与失败,但每个状态都需要后端证据,不能因为收到了第一段文本就显示成功。
建议给一次业务任务、一次进程执行和一次协议请求分别分配标识。业务任务用于回答用户正在处理什么;进程标识用于定位某次运行;协议请求标识用于匹配应答。把三者混为一个编号,会使重试后的结果覆盖、旧进程迟到的输出以及并发工具调用变得难以追踪。日志中保留关联关系,比记录全部原始输入更有价值。
输入适配层应是受控入口
不要让模型输出或浏览器传入的文本直接成为启动命令。建议预先确定可运行的程序、允许的参数和输入结构,再把用户数据交给输入适配层。输入通道只是传递数据的方式,不是权限校验器;程序接收到危险业务请求后,仍可能执行有副作用的操作。
适配层还应限制单条消息大小、等待队列长度以及单个任务的总输入量。多个业务分支需要发送消息时,先进入同一个串行写入队列,避免由不同调用点争夺发送顺序。队列满了应返回明确的繁忙状态,不能无限积压到进程或应用内存中。
失败后先查状态,再决定是否重试
最容易被忽略的是“不知道有没有执行成功”。写入失败不等于远端没有收到内容,用户看到超时也不等于操作没有发生。因此,对查询类请求可以制定有限重试策略;对发布文章、创建订单或修改记录等操作,应先查询结果,或使用业务系统提供的幂等机制,再决定是否重新提交。
幂等标识应由任务系统生成并持久化,而不是每次重试都换一个。若目标系统没有幂等或查询接口,宁可把任务标记为需要核对,也不要把未知状态包装成确定失败后自动重放。这样的保守处理会增加一点人工判断,却能避免重复副作用。
原创验证方案:按层次建立验收证据
第一层,只验证输入输出闭环
先选择不会访问生产数据的简单程序,验证发送内容、结束输入、等待退出与读取结果的完整路径。测试空输入、多次写入、中文文本以及较长内容,分别记录预期结果和实际结果。完成这一步只能证明通道可用,不能证明 MCP 握手、业务权限或工具语义正确。
再加入一个故意不读取输入的测试进程,确认应用能够结束等待并记录原因;加入一个提前退出的进程,观察写入端如何报错。测试报告应区分连接失败、输入失败、进程退出和业务拒绝,不要将它们全部归为“工具异常”。
第二层,检查协议与业务隔离
接入目标 MCP 服务时,使用与该服务兼容的客户端完成初始化和能力协商,而不是自行拼接几行消息后宣布集成成功。协议解析器应处理分段到达的数据,并将日志与协议结果分开存储。随后选择只读工具进行端到端测试,确认请求、应答和界面展示能正确对应。
最后才引入可写工具,并在独立测试账户中验证权限不足、用户取消、服务中途退出以及重复提交。上线门槛不应只是正常请求通过,还应包括异常请求不会触发额外操作、敏感字段不会进入日志,以及失败任务能被人工定位。
原创上线建议:把小接口变化做成可回退的能力
建议先对少量内部任务启用新路径,保留旧执行方式或明确的停用开关。监控重点包括任务完成率、输入等待时间、异常退出原因和人工核对数量;这些是建议观察的指标,并非本文已经获得的测量结果。只有用同一类任务、同一数据范围比较,性能或成本结论才具有解释力。
这次更新的实际价值,不是把所有工具瞬间变成可靠代理,而是减少了应用与持续运行进程之间的输入障碍。全栈团队真正需要补齐的仍是状态管理、协议适配、权限限制和失败恢复。先证明错误路径可控,再扩大工具的业务权限,比仅演示一次成功调用更接近生产可用。
评论
暂无评论。