Cube Sandbox

简体中文

English

简体中文

English

Appearance

2026.07.03 Release v0.5.0 ​

CubeSandbox 0.5.0 带来了四大核心特性：AutoPause/AutoResume 沙箱生命周期自动化（闲置沙箱自动暂停并在请求到达时毫秒级唤醒）、ARM64 (aarch64) 全栈原生支持（从 hypervisor 到 CI/CD 的完整适配）、腾讯云 Terraform 一键集群部署（生产级 IaC 部署方案），以及网络安全性增强（入向流量令牌鉴权、CubeEgress 启动期 Fail-Closed、出向策略路由）。其他重要更新包括：纯 Go 原生 rootfs 导出管线（绕过 Docker/skopeo/umoci，显著降低内存与构建时间开销）、快照运行时锁重构（消除高并发回滚死锁）、镜像 uid/gid 保留修复（修复非 root 镜像权限问题）、E2B SDK 对齐（完整的文件系统与 PTY API），以及一键升级模式（三路配置合并）。共计 116 个提交，来自 26 位贡献者。

🎯 核心特性 ​

AutoPause / AutoResume：沙箱生命周期自动化 ​

Agent 工作流中的沙箱大部分时间处于闲置状态——等待用户输入、回调、或 RL 的下一轮 rollout。AutoPause/AutoResume 让平台自动暂停闲置沙箱，并在新请求到达时原地唤醒，将物理资源在闲置期间完全释放。这是一个平台侧承担、per-sandbox 粒度的能力，语义与 E2B 的 lifecycle 参数对齐。

  • AutoPause 机制：新增的 cube-proxy-sidecar 组件内建 sweeper，通过 CubeProxy 的 log_phase.lua 上报的 last_active 时间戳跟踪沙箱活跃状态。当 idle >= timeout_seconds 时，sweeper 通过 CubeMaster → Cubelet 触发暂停：将 MicroVM 的完整状态（内存 + 文件系统）快照到 /data/cubelet/root/pausevm/<sandbox>，然后关闭沙箱。BootstrapWarmup 窗口可防止 sidecar 刚启动时的误暂停。
  • AutoResume 机制：当数据面请求到达已暂停的沙箱时，CubeProxy 的 sandbox_state.lua 门控拦截请求，向 sidecar 的 /internal/resume 发起内部子请求。Sidecar 通过 CubeMaster → Cubelet → containerd 驱动恢复流程，从暂停快照中原地恢复 VM。数据面请求会阻塞等待恢复完成（受 nginx proxy_read_timeout 约束）。同沙箱的并发恢复请求在进程内合并（singleflight 模式）；跨副本协调通过 Redis SETNX 分布式锁。
  • 可配置资源释放比例 (#553)：节点级配置 host.quota.paused_resource_release_ratio（float [0, 1]，默认 0）控制暂停沙箱向调度器释放多少 CPU/内存配额。设为 1.0 时，暂停资源全部释放，实现最大调度密度；设为 0 时，保留完整配额，确保恢复链路绝对可靠。恢复前会进行本地准入检查——若节点容量不足，返回 HTTP 409 并附带精确的容量诊断信息。
  • 入向流量令牌门控 (#639)：以 network.allow_public_traffic=false 创建的沙箱会获得一个 per-sandbox 的 traffic_access_token（UUID v4）。CubeProxy 在每个入站请求（包括冷路径和缓存命中路径）强制校验此令牌，缺失或错误令牌返回 HTTP 403。令牌值在所有日志中均被脱敏。兼容 e2b-traffic-access-token 和 cube-traffic-access-token 两种请求头。
  • Kill 路径：on_timeout="kill" 的沙箱走闲置超时 Kill 路径（task.Kill）。新增 POST /cube/sandbox/timeout 和 POST /cube/sandbox/refresh API，暴露 end_at 实现确定性的生命周期管理。CubeProxy 门控对 killing/killed 状态返回 410 Gone。

新增文件：CubeProxy/sidecar/（Go 二进制——sweeper、resumer、registry、stream consumer、last-active poller、Redis 协调）；CubeProxy Lua 模块（sandbox_state.lua、admin_phase.lua）；CubeMaster 生命周期端点；Cubelet pause/resume RPC。

ARM64 (aarch64) 全栈原生支持 ​

CubeSandbox 现已支持在 ARM64 主机上全栈原生运行，覆盖 hypervisor、guest agent、shim、网络（BPF）、构建系统、CI/CD 和部署工具。这是 Arm 工程团队与 Cube 项目组的深度联合研发成果，项目状态已从可行性验证推进到正式 Enablement。

  • Hypervisor 适配 (4dc72757)：SysCtrl 设备（guest 到 host 的信号通道：关机、重启、vsock-ready）从 PIO 端口 I/O（x86 专用）重写为 MMIO 内存映射 I/O，在 mmio_bus 的 LEGACY_SYS_CTRL_MAPPED_IO_START 地址注册。KVM 寄存器访问（get_one_reg）适配上游 API 变更。Seccomp 过滤规则按 ARM64 系统调用号差异对齐（SYS_lstat vs SYS_fstatat/SYS_newfstatat）。热迁移功能保持 x86_64 专属。
  • Guest Agent (cb5706a8)：RPC 就绪信号从 x86 的 ioperm() + PIO 端口写入（端口 0x680）改为 ARM64 的 /dev/mem 在物理地址 0x0903_0000（SysCtrl MMIO 区域）处 mmap + ptr::write_volatile。构建目标自动检测宿主机架构。
  • CubeShim (fe3044cf, 4feab884)：内核命令行按架构自适应——console=ttyAMA0,115200（ARM PL011 UART）vs console=hvc0（virtio-console）。x86 专用参数（no_timer_check、noreplace-smp）通过 #[cfg(target_arch = "x86_64")] 条件编译。Seccomp 白名单对齐：ARM64 上 SYS_mkdir → SYS_mkdirat；补充缺失的 SYS_faccessat2（ARM64 glibc 路径解析所用）。
  • BPF / CubeNet (cb263f24)：BPF //go:generate 指令中的硬编码 -target amd64 替换为 -target $GOARCH。按架构提供 vmlinux.h（amd64 + arm64 BTF 导出）。BPF 目标文件改为构建时生成；预编译 .o 文件从 git 中移除。需要 clang ≥ 14（已通过 apt.llvm.org 加入构建镜像）。
  • Multi-Arch 镜像构建 (c6bb3762, 475b4885)：Dockerfile.builder 通过 TARGETARCH 参数化 Go、protoc、Rust 工具链下载。CubeEgress、CubeAPI 和 envd 镜像支持 Multi-Arch Manifest List。容器化 make guest-kernel 目标支持本地和交叉构建，使用架构特定的内核配置（kernel-oc9.x86_64.config、kernel-oc9.aarch64.config）。
  • CI/CD (#720)：Builder image、VMLinux、one-click release 工作流均产出分架构制品。Release 工作流拆分为 release_amd64 和 release_arm64 两个 Job，分别在原生 Runner 运行，上传到同一个 GitHub Release。
  • 部署 (cb52bc72)：开发环境（run_vm.sh）自动检测架构——ARM64 使用 machine virt + UEFI 固件（qemu-efi-aarch64）。Release 打包脚本按架构选择合适的 mkcert 二进制。
  • 已知限制（已在文档中标明）：PVM（嵌套 KVM）仅支持 x86_64；ARM64 需使用裸金属物理机原生 KVM。热迁移仅支持 x86_64。

腾讯云 Terraform 集群化部署 ​

一套面向腾讯云的生产级、一键式 Terraform IaC 集群部署方案。只需一份 release bundle，执行 create.sh 作为唯一入口，即可自动拉起完整的 CubeSandbox 集群——包含受管控制面、高可用中间件和弹性计算节点。

  • 基础设施自动编排 (#629)：Terraform 自动创建私有 VPC（10.0.0.0/16）及按可用区的子网、NAT 网关（含弹性公网 IP）、安全组、以及一台跳板机（jumpserver）。云上托管服务自动创建：
    • MySQL（TencentDB 8.0）：多可用区半同步复制，4GB 内存 / 200GB 磁盘，创建 cube 应用账号及数据库级权限。
    • Redis（TencentDB 7.0）：标准主从架构，可配置内存（默认 1GB），密码保护。
    • CFS（云文件存储）：NFS 共享文件系统，供 cube-master 多副本挂载共享持久化存储（/data/CubeMaster/storage），ReadWriteMany 模式。可选——开启后启用多副本高可用模式。
    • TCR（腾讯云容器镜像服务）：私有容器镜像仓库，VPC 内网链路打通，按部署创建命名空间，生成长期访问凭证。
  • TKE 控制面 (#629)：托管 Kubernetes 集群（v1.34.1，GlobalRouter 网络，containerd 运行时），apiserver 仅限内网。四项控制面组件以 Deployment + CLB Service 形式部署：
    • cube-master：共享 CFS NFS 卷，CubeEgress 中间人 CA（ECDSA P-256，Terraform 自动生成），内网 CLB 端口 8089。
    • cube-api：公网 CLB 端口 3000，通过集群 DNS 代理到 cube-master。
    • cube-proxy：公网 CLB 端口 80/443，Redis 和 TLS 凭证以 Secret 注入。
    • cube-webui：公网 CLB 端口 80，nginx 反向代理到 cube-api 和 cube-proxy。
  • 可配置副本数 (#658)：cubemaster_replicas、cube_api_replicas、cube_proxy_replicas、cube_webui_replicas 变量（POC 模式默认 1 副本）。当 TENCENTCLOUD_USE_CFS=true 时，cube-master 支持多副本高可用，副本数同时驱动 spec.replicas 和调度器并发分配。
  • 弹性计算节点：私有 VPC 内可配置一台或多台 CVM 实例（PVM 或裸金属），通过 TKE 节点池弹性扩缩容。默认 1 节点，支持自定义数量和实例规格。
  • 一键升级模式 (#538)：install.sh --mode=upgrade 自动检测已有安装，执行三路 .env 配置合并（新默认值 + 旧自定义值 + 显式覆盖值），fail-fast 预检（磁盘空间、语义化版本兼容性、CIDR 冲突），并在任何破坏性操作前备份配置。用户自定义修改被保留，密钥值在 diff 报告中脱敏但在实际合并文件中保留。
  • 外部 MySQL/Redis 支持 (#514)：一键安装器支持通过 CUBE_EXTERNAL_MYSQL_* / CUBE_EXTERNAL_REDIS_* 变量接入已有的外部 MySQL 和 Redis 实例。本地 Docker 容器被 mask，所有组件（CubeMaster、CubeAPI、CubeProxy）使用外部端点。
  • 其他安装器改进：废弃 CUBE_PROXY_HOST_PORT，拆分为 CUBE_PROXY_HTTP_PORT / CUBE_PROXY_HTTPS_PORT (#588)。移除手动 SQL 初始化，改用 CubeMaster 内嵌 goose migration (#628)。CubeEgress 集成到计算节点启动流程 (#707)。改进外部依赖兼容性（Shell 安全的 env 持久化、redis-cli 超时兼容检测）(#673)。腾讯云部署配置了 cubelet 上报间隔与多节点调度器评分 (b8f22421)。镜像默认值更新为 v0.5.0 标签 (#719)。

新增文件：deploy/one-click/terraform/tencentcloud/（create.sh、destroy.sh、main.tf、variables.tf、tke-addons.tf、outputs.tf、lib-state-sync.sh、env.example）；docs/guide/tencentcloud-terraform-deploy.md（中英文各一份）。

网络安全增强 ​

入向、出向、数据面三个维度的关键网络安全补丁。

  • Per-sandbox 流量访问令牌 (#639)：已在 AutoPause/AutoResume 章节详述。CubeProxy 在 AllowPublicTraffic=false 时对每个入向请求强制校验 traffic_access_token，缺失或错误返回 403。令牌值不会被记录到任何日志中。
  • CubeEgress 启动期 Fail-Closed (c5f811d8)：在 CubeEgress 启动期间、L7 策略尚未从 CubeMaster 加载完毕时（bootstrap_status ≠ "ready"），CubeEgress 对所有非审计类流量返回 403，而非此前的 Fail-Open 放行行为。这消除了沙箱出向流量在 Egress 重启窗口内绕过所有域名/SNI/方法/路径控制的敞口。
  • 策略路由 / cube-router (7c514e9d)：可选的 cube-router 内核 dummy 网卡允许沙箱出向流量走宿主机 Linux 路由栈，而非被硬性重定向到主网卡。流量可从任意可路由设备（eth0、eth1、GRE 隧道、VXLAN、WireGuard）发出，无缝对接现有网络基础设施。已有的 CubeEgress L7 策略、DNS 白名单和端口映射全部保留。
  • BPF TCP 校验和修复 (7c2dd1ff)：修复跨节点端口映射沙箱回包 TCP 校验和错误。snat_tcp() 函数在仅 TCP 端口值变化的情况下错误使用了 BPF_F_PSEUDO_HDR 参数，导致多节点部署下校验和损坏。
  • from_world 清理 (5b919466)：移除 loopback 接口上无效的 from_world TC filter 挂载，减少不必要的 eBPF 挂载点。
  • 宿主机服务访问 (48d080e6)：沙箱到宿主机自身 IP 的出向流量现在通过 BPF 快捷路径转发，允许沙箱内代码访问宿主机上的本地服务。
  • 网络安全加固指南 (#663)：中英文运维安全指南，覆盖控制面默认攻击面、绑定策略（私有网卡 vs 防火墙白名单）、CubeAPI 认证回调的 path+method 双重校验、以及 TLS/凭证轮换指引。

✨ 功能增强 ​

SDK ​

  • E2B 文件系统 API 对齐 (#678)：Go 和 Python SDK 现已实现完整的 E2B 文件系统 API：list、stat、exists、remove、rename、mkdir、watch。含全面集成测试。
  • Python SDK PTY API (250d248a)：Python SDK 新增完整 PTY（伪终端）接口——create、connect、kill、send_stdin、resize，通过 PtyHandle 迭代器提供流式输出。直接通过 httpx 与 envd 的 Connect-JSON RPC 通信，不依赖 e2b Python 包。
  • Python SDK E2B network.rules 转换 (#568)：兼容 E2B 的 per-host {transform: {headers: {...}}} 凭据注入格式，翻译为 CubeEgress L7 action.inject 规则。使用 E2B per-host 凭据注入的代码可零改动切换。
  • Python SDK 双重编码修复 (#572)：修复执行日志和错误的双重编码问题。

性能 ​

  • 纯 Go 原生 rootfs 导出 (#558)：无守护进程、纯 Go 实现的 rootfs 导出管线，完全绕过 Docker、skopeo 和 umoci。核心优化包括并发预取、loop 挂载流式写入 ext4 块设备、逐层解压即删除策略，显著降低了峰值内存占用与构建时间开销。默认启用。
  • VirtIO Block 性能 (#575)：在 Hypervisor 的 virtio-blk 设备中启用 VIRTIO_BLK_F_SEG_MAX（多段请求）和 VIRTIO_RING_F_INDIRECT_DESC（间接描述符），fio 基准测试中顺序写入吞吐从 2888 MiB/s 提升至 3293 MiB/s。

模板管理 ​

  • 镜像拉取进度 TUI (#580)：基于 Redis 持久化的实时拉取进度跟踪。新增 template watch 和 template build-watch CLI 命令，提供交互式 bubbletea TUI（显示下载速度、逐层完成度、步骤清单），非 TTY 终端自动降级为纯文本输出。
  • 模板列表暴露最新 Job ID (#546)：模板列表和详情 API 暴露每个模板的最新 create/rebuild job ID。Web UI 在查看有活跃（running/pending/building）job 的模板时自动打开构建日志。
  • 制品资源泄漏修复 (#631)：引入 t_cube_artifact_node_placement 表，独立于 Replica 生命周期跟踪节点级制品放置。周期性制品 GC，以 MySQL GET_LOCK 保证高可用协调。加固 CubeMaster、Cubelet、CubeAPI 级联清理链路。AgentHub 快照级联清理增加路径穿越保护。

Web UI ​

  • 模板创建重构 (#675)：全新的多步骤模板创建表单，支持镜像源选择、实例规格配置、网络设置和高级选项。改进了表单校验和字段组织。

AgentHub ​

  • LLM 环境变量回退移除 (#602)：所有 AgentHub LLM 密钥和设置现在仅存储在数据库中，使用按安装实例的 CSPRNG 生成主密钥加密。环境变量回退路径全部移除。一键升级脚本主动删除过时的环境变量密钥。decrypt_or_passthrough 对不可解密的负载采取 Fail-Closed 策略。
  • 助理状态持久化 (#582)：认证信息、OpenClaw 运行时状态、模板继承关系和快照恢复行为持久化到数据库。包含 bcrypt 密码哈希、企微 Secret 解密、认证入口限流。支持数字助理的备份/恢复和安全克隆。

部署与安装器 ​

  • 一键升级模式 (#538)：已在集群部署章节详述。--mode=upgrade + 三路 env 合并 + 升级前备份 + fail-fast 预检。
  • 外部 MySQL/Redis (#514)：已在集群部署章节详述。支持接入已有外部数据库实例。
  • CUBE_PROXY 端口拆分 (#588)：CUBE_PROXY_HOST_PORT 废弃；拆分为 CUBE_PROXY_HTTP_PORT（默认 80）和 CUBE_PROXY_HTTPS_PORT（默认 443）。
  • 静态编译 (#583)：cube-api、cubemaster 和 cubemastercli 现为完全静态二进制（Go CGO_ENABLED=0 / Rust musl 目标），消除宿主机 glibc 依赖和版本偏差风险。
  • 内嵌 Migration (#628)：移除手动 SQL 初始化；CubeMaster 内嵌 goose migration 自动处理单节点种子数据。消除控制节点对 mysql 客户端的依赖。
  • CubeEgress 计算节点集成 (#707)：CubeEgress 集成到计算节点启动和停止脚本，Egress 策略执行覆盖所有节点。
  • resolvectl 兼容 (#703)：容忍旧版本 systemd（v240 以下）缺少 resolvectl default-route，防止 RHEL 8.3 等系统安装失败。

基础设施 ​

  • Redis Key 统一 (#609)：所有 Redis Key 集中在 pkg/base/rediskey 中，采用统一命名规范。移除读写/元数据连接池分离，简化为单连接池，降低多节点部署配置复杂度。
  • Migration 身份固化 (#620)：三层防线防止 migration 静默跳过：新 migration 必须使用 14 位 UTC 时间戳前缀（而非整数序号），支持乱序应用（out-of-order），以及启动时 SHA-256 内容指纹校验。CI 强制禁止修改已合入的 migration 文件。
  • 节点标签管理 API (#633)：POST /nodes/{id}/labels 和 DELETE /nodes/{id}/labels 端点用于管理员标签管理。K8s 兼容命名（DNS1123 子域名前缀），SELECT FOR UPDATE 竞争保护，每节点 64 标签上限，系统保留命名空间保护（kubernetes.io、beta.kubernetes.io、cube.cloud.tencentcloud.com）。
  • envd 版本上报 (#650)：实际采集到的 envd 版本作为沙箱注解传播，使 E2B SDK 能根据真实运行时版本进行特性门控，替代硬编码的版本常量。
  • 可配置 HTTP 监听地址 (#662)：CUBEMASTER_HTTP_BIND 使 HTTP 监听地址可配置，支持绑定到私有网卡以进行网络安全加固。
  • 腾讯云调度器评分 (b8f22421)：多节点调度器评分配置 real_time_weighted_average 插件，平衡 mvm_num、local_create_num、cpu_usage、quota_mem_usage 权重。priority_select_num 动态上限为 min(compute_node_count, 3)。

🐛 Bug 修复 ​

以下修复针对 v0.4.0 中存在的问题：

  • 高并发回滚死锁修复 (#693)：快照运行时活跃绑定重构为独立的 t_cube_snapshot_runtime_active 表，引入沙箱级和资源级分布式锁，从根本上消除了 MySQL 1213 死锁错误。
  • 镜像 uid/gid 保留修复 (#671、#608)：两个互补的镜像权限保留修复：
    • Native Export 路径 (#671)：移除 WithNoSameOwner() 选项——此前该选项会将所有文件的 uid/gid 压缩为提取用户，破坏镜像原始权限。
    • Template Center (#608)：umoci unpack --rootless 现在仅在 euid ≠ 0 时传递（root 身份运行时不再传递）。Docker-export 回退路径增加 --same-owner --numeric-owner。修复 Browser 沙箱中 Chromium profile 写入失败和 CDP 不可达、以及 Python 镜像 envd exec 因 /home/user 权限导致 EACCES 的问题。
  • Hostdir 挂载超时保护 (#691)：Hostdir bind 和 remount 操作通过有界子进程执行，每步 3 秒超时。此前，卡住的 NFS 等宿主机挂载点会导致沙箱创建无限期阻塞。
  • CubeProxy envd 流式缓冲修复 (#647)：对 envd 服务端流式端点禁用 nginx 响应缓冲。此前 nginx 会缓存早期的流帧，破坏后台命令和 Watch 流的即时返回语义。
  • MSI-X Table/PBA 鲁棒性加固 (#619)：VMM 中 MSI-X table/PBA 读写路径上 guest 可触发的 panic 替换为优雅错误处理。恶意或有缺陷的 guest 不再能通过无效 MSI-X 访问导致 VMM 进程崩溃。
  • CubeProxy 实现细节泄露修复 (#653)：移除暴露内部故障码的 X-Cube-Retcode 响应头和 $cube_retcode 访问日志字段。错误响应统一为不透明 HTTP 状态码 + 标准 JSON Body，防止通过区分错误码枚举沙箱 ID 或探测基础设施弱点。
  • Auth Callback 方法转发 (#315)：X-Request-Method 现在转发到认证回调，实现（路径 + 方法）粒度的鉴权。此前，仅路径白名单无法区分同一路径的 GET 和 DELETE 操作，只读凭证可访问破坏性端点。
  • CubeEgress 计算节点 CA 刷新 (#614)：计算节点上的 CubeEgress 现在从 CubeMaster 刷新中间人 CA，修复主节点 CA 轮换后的 CA 不匹配问题。
  • 模板信息回填 (#594)：回填模板详情响应中缺失的 created_at 和 image_info 字段。
  • 快照删除 Job 清理 (#559)：快照删除后清理孤儿 job 行，防止失效构建 job 引用。
  • 跨副本节点状态同步 (#542)：启动 Nodemeta 定期重载协程，实现跨副本节点状态同步，修复多副本 CubeMaster 部署中节点状态过期问题。
  • BPF 内层 Map BTF (#595)：CubeVS 内层 map 现在带 BTF key/value 创建，修复高版本内核上的 BPF map 兼容性。
  • 一键安装根目录加固 (#649)：移除可配置的安装根路径；安装前缀安全性断言加强，防止误擦除系统目录。
  • 一键安装 MIRROR 持久化 (#622)：MIRROR 环境变量持久化到 .one-click.env，确保重启后镜像仓库选择一致。
  • 一键安装相同 CIDR 重装 (#586)：区分相同 CIDR 重装与 CIDR 变更场景，使用 systemd 优雅停止服务。
  • 一键安装计算节点 Quickcheck 启动竞态 (#637)：计算节点启动后检查容错短暂启动竞态。
  • 一键安装 DATABASE_URL 持久化 (#611)：DATABASE_URL 持久化到本地 MySQL 的安装和 systemd 启动路径。
  • Python SDK 流式文件体 (377a99dc)：IPOverrideTransport 中请求体拷贝前先缓冲，修复 multipart 上传失败。
  • CubeProxy 日志清理 (#593)：移除 CubeProxy 中的无效日志字段和失效后端桩代码。
  • envd 命令环境变量传递修复 (#566)：修复通过 commands.run 启动 envd 时 create-time 环境变量丢失的问题。
  • Sandbox Preview 路由修复 (#570)：修复缺失的 /cube/sandbox/preview 路由处理器，此前 cubemastercli tpl render 会静默失败。
  • 一键升级 Bundle 完整性修复 (#597)：修复一键升级包中缺失 scripts/common/ 目录导致升级预检脚本不可用的问题。
  • Template 创建 Cube CA 转发修复 (#652)：修复创建模板时 with_cube_ca 参数未正确转发的问题，确保客户端能够控制是否将 CubeEgress 根 CA 注入模板 rootfs。
  • 腾讯云部署 semver 辅助函数 (#587)：增加 semver_compare 和 version_lt 函数，确保升级决策逻辑正确。

📚 文档 ​

  • ARM64 部署指南 (64931ff2)：所有部署指南（快速入门、裸金属、开发环境、多节点、自构建）更新中英文，增加架构特定说明，标注 ARM64 PVM 限制。
  • 网络安全加固指南 (#663)：中英文运维安全指南，覆盖控制面攻击面、绑定策略、认证回调配置、TLS/凭证指引。
  • 腾讯云 Terraform 部署指南 (ae81121d)：中英文完整 Terraform 集群部署指南。
  • 快照/克隆/回滚深度解析 (#680)：中英文技术深度解析博客，介绍快照、克隆和回滚机制。
  • 沙箱日志指南 (#692)：新增 cubecli logs 使用指南及示例。
  • 多节点调度器评分指引 (#672)：配置多节点调度器评分以实现工作负载均衡分布的指引。
  • Host Mount 权限修复 (#560)：Host Mount 权限处理说明文档。
  • v0.4.0 发布博客 (#585)：中英文版本发布公告和 Agent 友好服务技术博客。
  • 网络深度解析博客 (#627)：中英文 CubeSandbox 网络技术深度解析。
  • README 优化 (#640、#666、#646)：产品亮点、v0.4 展示、基准测试报告链接、架构图更新、主页标语优化。
  • 文档优化 (#665)：交叉文档链接修复、快照/回滚/克隆侧边栏导航、本地化文档流保持 (#668、#664)。
  • 安装指南链接 (#475、#466)：基准测试博客中增加安装指南引导，安装错误消息中增加问题排查链接。

⚙️ 工程改进 ​

  • Multi-Arch CI (#720)：Builder image、VMLinux、one-click release 工作流均支持 amd64 + arm64，产生分架构制品和 Multi-Arch Manifest。
  • Python SDK 发布工作流 (#700)：GitHub Actions 工作流，由 python-sdk-v* 标签触发 PyPI 发布。版本交叉校验（tag vs pyproject.toml vs __init__.py），智能变更检测（跳过无变化的发布），twine check 验证。
  • Cubelet 上报默认间隔 (#722)：上报告间隔默认值改为 1s，提供更灵敏的指标。
  • CI Release 工作流加固 (#724)：为 gh release 命令添加 --repo 参数，确保正确的仓库指向。