Skip to content

fix(sandbox): 修复分页、PTY 断连及 Envd/Git 鉴权 - #476

Merged
miclle merged 14 commits into
qiniu:masterfrom
DROWNING2003:drowning/fix-sandbox-sdk-gaps
Nov 18, 2026
Merged

miclle merged 14 commits into
qiniu:masterfrom
DROWNING2003:drowning/fix-sandbox-sdk-gaps

Conversation

@DROWNING2003

@DROWNING2003 DROWNING2003 commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

沙箱列表没有交付响应头游标,PTY 缺少实时字节与断流入口,读取和清理并发时还可能重复归还 HTTP 连接;临时 Git 凭据可能被已有 helper 保存,Envd 请求还会在重定向时带出访问 token。本 PR 补齐运行时能力并修正这些请求行为。

  • Client.list_sandboxes 使用 /v2/sandboxes,直接返回 {'items': [...], 'nextToken': ...};删除重复的 _page/_v2 入口,高层分页器和调用同步迁移,响应头游标优先。
  • metadata 字典按服务端实际解码流程逐项编码,保留特殊键值中的 +、&、=、%、中文和空格;已格式化的字符串仍直接传递。
  • 文件、JSON RPC、stream RPC 的 Envd 请求统一禁止自动重定向,30x 抛出 SandboxError 并关闭响应,避免凭据或请求内容发往跳转目标。
  • Commands/PTY 的进程选择器使用 process: {'pid': ...} 或 {'tag': ...},移除错误的 selector 嵌套,修复重连、输入、关闭 stdin、PTY 缩放和 kill 的 501 错误;PTY 集成测试不再把此类错误直接跳过。
  • PTY 的 create()/connect() 支持 on_data(bytes)。首帧含 PTY 输出时,回调在调用线程执行,异常从 create()/connect() 直接抛出。后续帧由后台线程调度 on_data。未提供 on_data 时,首次 wait() 启动后台读取,传给 wait() 的 stdout/stderr 回调仍在调用线程执行。
  • disconnect() 立即冻结已处理的输出并释放等待者,包括首个 wait(),远端进程可重连。已调度的回调可以稍后执行,迟到的输出和异常不会改写冻结结果。实际非零退出和原始异常按选项传播。
  • 活跃读取时,断连线程尝试唤醒 socket,读线程退出后统一关闭响应,避免同一 HTTP 连接被重复归还。Windows 上后台清理可能等到读操作结束或读取超时。
  • clone 支持临时用户名/密码。clone、pull、push 显式传入的用户名优先于已有 credential.username,临时 Git 命令隔离继承的 helper。独立目录、askpass、命令和清理使用同一指定用户,清理错误不会覆盖原异常。
  • 文件 URL 签名对齐 Envd 的无填充标准 Base64,并修正省略过期时间的签名输入。

验证:以下 HTTP 清理修复的本地基线为 Sandbox 353 项通过、12 项云端用例跳过,公开 CI 用例 421 项通过,flake8 和旧版语法检查通过。真实本地 HTTP 回归覆盖 keep-alive 和 Connection: close,旧实现可复现同一连接被归还两次,修复后只归还一次。urllib3 1.26 和 2.8 的断连回归通过。Windows 用例由服务端结束流,覆盖 shutdown 未立即唤醒读线程的情况。另通过本地 Git/credential store、重定向鉴权和原始 Go metadata 解码验证。

远端 CI:cdca6bd 的 Linux 七项和 Windows 三项全部通过。CI 结果

真实云端验证(七牛扬州环境):模板列表、创建/执行命令/文件读写/删除、特殊 metadata 筛选、安全沙箱文件访问及签名下载通过。新增两个进程交互用例均通过,无跳过:覆盖按 PID/tag 重连、stdin 写入/EOF、kill,以及 PTY 重连、输入输出、缩放和 kill。修复前可稳定复现 501,修复后同一沙箱中的对应操作通过。测试沙箱均已清理。补测使用沙箱内隔离的 HTTPS Git 服务,实际认证 clone/commit/push/pull、远端文件内容、remote 凭据清理及 credential store 隔离均通过;外部 Git 托管平台的权限和组织策略尚未验证。

兼容 SDK 另测:e2b-code-interpreter 2.6.0 + e2b 2.7.0 的 Python/JavaScript 执行、日志/结果流、上下文、代码异常、PNG 和超时恢复通过;e2b-desktop 2.3.0 + e2b 2.7.0 的截图、鼠标、实际 ASCII 键盘输入和开启认证的 noVNC 页面通过。补测 e2b-code-interpreter 2.10.0 + e2b 2.44.0,用官方 E2B_VALIDATE_API_KEY=false 开关关闭本地格式检查后,解释器执行、上下文、PNG 和超时恢复均通过。更新版本的 POST /v2/sandboxes 创建接口仍与扬州环境不兼容;中文桌面输入存在丢字,完整视觉 Agent 未测试;已同步 skill PR #13。

本轮 review:后台命令句柄被丢弃后,未读完的 HTTP 流在回收时归还连接池槽位。显式凭据 clone 会移除输入 URL 原有的用户名和密码,并以显式用户名认证。迁移示例列出已移除的 list_sandboxes_v2/listSandboxesV2 和单页的 ['items'] 写法。d4fd0dd 的本地 Sandbox 测试 354 项通过,12 项云端用例跳过。

@qiniu-prow qiniu-prow Bot added the size/XL label Nov 17, 2026
@qiniu-prow qiniu-prow Bot added size/XXL and removed size/XL labels Nov 17, 2026
@DROWNING2003 DROWNING2003 changed the title fix(sandbox): 修复分页并补齐 PTY 字节流和临时 Git 认证 fix(sandbox): 统一列表分页并补齐 PTY 字节流和临时 Git 认证 Nov 17, 2026
@DROWNING2003 DROWNING2003 changed the title fix(sandbox): 统一列表分页并补齐 PTY 字节流和临时 Git 认证 fix(sandbox): 统一分页并完善 PTY、Git 认证和文件签名 Nov 17, 2026
@DROWNING2003 DROWNING2003 changed the title fix(sandbox): 统一分页并完善 PTY、Git 认证和文件签名 fix(sandbox): 完善分页、PTY 与 Git/文件鉴权 Nov 17, 2026
@DROWNING2003
DROWNING2003 marked this pull request as ready for review November 18, 2026 01:57
fennoai[bot]

This comment was marked as outdated.

@DROWNING2003

Copy link
Copy Markdown
Contributor Author

/review

fennoai[bot]

This comment was marked as outdated.

@DROWNING2003

Copy link
Copy Markdown
Contributor Author

/review

fennoai[bot]

This comment was marked as outdated.

@DROWNING2003

Copy link
Copy Markdown
Contributor Author

/review

@fennoai fennoai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No reportable defects were found after reviewing every changed file and tracing pagination, process selectors, PTY lifecycle and callbacks, signed file URLs, and Git credential cleanup. All 353 local tests passed with both Requests 2.34.2 and 2.27.1; 12 live integration tests were skipped because external credentials were unavailable.

Reviewed head commit: 575b85911b5bcc86fa862b87818e71ccf08cf419

@DROWNING2003 DROWNING2003 changed the title fix(sandbox): 完善分页、PTY 与 Git/文件鉴权 fix(sandbox): 修复分页、PTY 断连及 Envd/Git 鉴权 Nov 18, 2026
Comment thread qiniu/services/sandbox/envd.py Resolved
Comment thread qiniu/services/sandbox/git.py Resolved
Comment thread examples/README-sandbox.md Resolved
@miclle

miclle commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

LGTM

@miclle
miclle merged commit 3b77280 into qiniu:master Nov 18, 2026
10 checks passed
@miclle miclle mentioned this pull request Nov 18, 2026
miclle added a commit that referenced this pull request Nov 18, 2026
准备发布 Python SDK v7.20.0,包含已合并的 #476。更新包版本和 CHANGELOG,说明 Sandbox
分页返回格式的迁移方式,以及 PTY、Git 凭据和 Envd 文件访问的变化。

发布附件为 wheel、源码包和 SHA256SUMS。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants