主机与账户前提
控制平面需要可运行的 OpenSSHssh 和 ssh-keygen,支持 ed25519 密钥生成;连接验证会检查这些条件。管理端 HTTPS 与 SSH 入口必须可达。某个平台能启动 Hexagon,不代表其 SSH 工具与私有传输已验证。
准备有 machine 读取、创建和删除权限的 API key。config 只有 template,默认 agent-browser;可用的明确模板版本取决于账户。标识最多 128 字符,以小写字母或数字开始,其余允许小写字母、数字、点、@、下划线和连字符。
以下使用本地管理客户端,hosted 初始化见自托管。保存返回 ID 后复用,不重复创建连接。
执行与私有预览
使用 connection.id,按首个 Session完成双 SDK 的实际任务与产物。当前创建要求 timeout_seconds 为 60—86400 的整数;控制平面承担期限管理,创建不请求 Provider 自动删除。 前台命令最多 600 秒、后台最多 3600 秒。命令返回截断或无效 UTF-8 时失败,不能把部分输出当完整回答。文件写入核对字节数和 SHA-256;读取要求有效 Content-Length 且最多 64 MiB,上层 API 仍可能更严格。 私有预览使用短期 SSH 证书与本机私有隧道,证书目标、机器标识、host trust 和过期时间均需匹配。浏览器不获取账户 key 或 SSH 私钥。应用服务监听、Runtime 健康与用户授权分别检查;SSH 可连接不等于任务服务可用。suspend/resume 与清理
空闲使用原生 suspend,下一轮向同一 Session submit 自动 resume。当前策略保留内存与文件系统,但仍需按具体 Harness 验证文件、对话及服务恢复;不能从单轮成功推断休眠成功。 suspend/resume/create/delete 均有 Provider operation。只有目标机器、操作类型和成功状态匹配才认为操作完成。paused 不是已删除;关闭须完成 delete 并确认 machine 不存在。控制平面停机会影响其负责的到期工作,本地停止不证明远程清理。明确拒绝与未知创建
只有同步 create 返回 HTTP 429,且结构化error.code=quota_exceeded、没有 operation ID 时,当前实现才把它识别为明确未分配。平台记录 rejected,Run 报 sandbox_quota_exceeded;释放额度并关闭被拒绝 Session 后,才创建新的 Session。原被拒绝 Session 不会自动重试。
普通 429、速率限制、传输错误、操作轮询失败不具有相同含义。创建响应丢失后保留原 operation,并通过精确名字和 metadata 分页查询。空列表或人工确认“已查看”不证明从未创建,不能在结果未知时循环创建新资源。
仓库记录过 Instabox 管理连接间歇失败和未确认创建;历史成功旅程不能覆盖这些问题。当前账户状态应以实际查询和原始私有记录为准,不能从文档推断已无遗留资源。
分阶段记录验收
11 月 16 日恢复记录区分了三个真实云场景:创建响应丢失后找回原带标签的 machine;保存删除回执后中断,恢复时继续轮询原回执;保存回执之前丢失删除响应,恢复时复用相同的稳定删除幂等键。这些是平台实现的 Provider 专属恢复路径,不是让应用通用重发远程副作用的指令。当前源码在没有删除回执时使用
hexagon-delete-<machine-id>,已有回执时查询该回执。
同一记录还包含 Python / TypeScript 各自的 Pi 1.5.2 + SiliconFlow international 任务、串行分配,以及等待授权时实际终止 worker 的恢复验证。历史账户的一台机器配额和当时的资源缺失审计结论都有时间范围,不代表当前账户保证。账户验证、故障恢复和完整任务应分别记录。
排查与验收
额度较小时串行验证两套 SDK,不删减任何 SDK 的旅程。完成条件包括实际任务、文件完整性、私有访问、两轮恢复、删除确认与产物留存。本页核对实现,没有新运行云任务;参阅执行矩阵与serverless 证据。
依据:Instabox 工程指南、连接器、SSH 传输。下一步:对账、故障排查、已验证组合。