注册并预检
以下接续已初始化的管理客户端。IMAGE_REFERENCE 是你已核对的镜像引用,protocol 必须匹配镜像内真实程序;示例使用 opencode-v1。区分镜像身份与版本标签
注册记录解析后的 Linux amd64 镜像 digest、执行命令、协议、能力和可选 registry Secret 引用。Harness 的id/version 是稳定选择键,可变镜像 tag 只是解析输入。之后移动 tag,不会静默更新既有注册或 Session。
未指定时,protocol 来自 ai.hexagon.harness.protocol,否则默认为 hexagon-json-v1;command 来自镜像 Entrypoint 与 Cmd。默认值不证明程序实现了该协议。默认能力列表只有 conversation;只有适配器与程序实际支持时才声明 Tools 或 initialization。注册会拒绝 Aider 的 Tools,以及 Aider/DeepSeek 的 initialization 等组合。
发布新定义时,先构建并验证镜像、记录解析 digest,定义变化后注册新 id/version,再用专用 Session 验证所需行为,最后为应用新任务选择该版本。重复 id/version 但解析定义不同会返回 harness_version_conflict,不能因此覆盖原版本。source package 与 OCI 注册共享版本命名空间。
分别记录三个检查点:注册成功解析元数据;Provider 准备并启动该镜像;Harness 完成所需行为。registry manifest 只证明第一项。镜像准备可能改变 Runtime 前提,因此运行身份和行为需要与源码镜像 digest 分开记录。
固定镜像示例的验证范围
上面的镜像与显式opencode 命令对应11 月 18 日 MiniMax 矩阵。选择已验证的 Modal 或 Fly Machines 连接,并按验证注册表使用精确的 MiniMax-M3 协议条目。该记录覆盖双 SDK、对话继续、远程 Tool、环境、产物与清理;本页不宣称本次重新拉取或执行了镜像。registry 可访问性与当前账户仍需验证。
如果选择不支持 OCI 的 Provider,在创建资源前保留失败预检的诊断,不删除兼容性检查,也不偷偷替换镜像掩盖失败。重复注册相同定义应返回相同选择;在相同 id/version 下改变 command 应产生版本冲突,变更应注册新版本。这两项都不能证明模型任务成功。随后按完整教程持久保存提交记录、验证输出与产物,最后确认计算资源及 Provider 所有的准备资源均已清理。
合并 Harness 证据复核将这里的精确 digest 匹配到 Python 与 TypeScript 独立 Modal 旅程,均验证产物并确认清理。当前隔离数据库检查另外证明,不支持镜像的 Provider 在创建 Session 或资源操作前被拒绝。这些检查不是新一轮镜像拉取或实云执行。
Provider 与身份边界
Modal 和 Fly Machines 支持原生 OCI;Fly 当前仅公开镜像。E2B 当前以 Session 自有 Template 构建公开 OCI 镜像,构建和创建有独立操作记录,关闭先清理计算再清理模板。其新增镜像组合仍需逐项验收。 Modal 会派生镜像补齐 Runtime 前提,支持的包管理器有限。准备阶段使用 root;当前代码写回镜像 USER,但既有运行说明报告实际执行为 root,因此 USER 不是已验证的安全边界。需要依赖身份时核验实际 uid,详见 Modal 接入。Fly 也可能准备 Runtime 依赖并以 root 执行。镜像 digest 标识源镜像,不表示运行文件系统从未被准备过程改变。 私有 registry 使用 enabled Secret,内容为 username/password JSON;密钥不进入普通 Agent 环境。私有镜像能力与公开 OCI 分开预检。镜像解析、拉取、执行、工具调用和清理各需验证。构建与失败
仓库模板可用node --import tsx tooling/build-harness-images.ts all 构建,不自动 push。构建可能下载依赖并创建本地镜像;检查各模板要求。recipe 不是已发布产物。
缺失入口、架构不支持、拉取授权、Runtime 依赖、模型协议和输出协议分别定位。模板 build receipt 丢失时查原操作,不能自动开始第二次构建。失败仍需保留并清理模板 / 资源。
依据:OCI 设计、镜像契约、注册实现。下一步:Harness 适配器、已验证组合、安全边界。