跳转到主要内容
Harness 是执行 Agent 逻辑的引擎。它负责模型交互、对话和工具使用;Runtime 监督它的进程,控制平面管理任务、授权与云资源。

三条分发路径

当前内置 Pi 1.5.2 和 OpenCode 1.2.27 支持 conversation、tools、initialization,声明支持三种模型协议。查询 catalog() 确认部署实际注册项;历史文档中的版本不能替代当前目录。

内置 Harness 的最小选择

以下预检片段复用首个 Session中的已初始化客户端与已启用连接 ID,不注册镜像,也不分配 Sandbox。选择一个准确的 selector;把 Pi 换成 OpenCode 是切换 Harness,不是转换模型协议。
然后沿教程的持久创建、提交、观察和关闭流程继续。预检 ready 证明配置兼容性检查通过,不会安装 CLI、调用模型或证明任务成功。已有 Session 固定 Harness 选择;比较两个引擎时分别创建 Session,检查实际任务结果、Tools、产物和清理。

OCI 模板目录

下面是当前模板/适配器索引,发布镜像与 recipe 的来源和固定版本见镜像目录。列出名称不代表该模板已完成全部真实组合验证。 下面是 2026 年 11 月 20 日的仓库快照。“适配器契约”指本地调用与结果解析测试,不等于容器执行通过。“有范围的实云记录”指验证注册表中精确匹配镜像、命令和协议的条目;选择组合前仍需读取其模型、SDK 与场景字段。没有匹配条目表示目录缺少对应证据,不表示程序一定不能运行。 契约来源:Runtime 适配器测试、Managed CLI 测试、源码包结果测试。这些检查的范围小于镜像构建、云启动或完整用户旅程。生命周期还取决于 Sandbox:原生对话 ID 不能保证任意进程与内存在空闲后继续存在。

Codex

codex-v1,使用 Responses,Tools 经 MCP bridge,原生对话继续。需要核对所注册镜像的来源、digest 和具体执行证据。

Hermes

hermes-v1,使用 Chat Completions,Tools 经 MCP bridge,原生对话继续。

OpenClaw

openclaw-v1,声明三种模型协议,Tools 经 MCP bridge。不要把一类协议通过外推为其余两类通过。

DeepSeek Harness

deepseek-v1,当前 Messages 路径,提供构建 recipe。初始化能力有限,不应声明当前适配器不支持的 initialization。构建产物发布和云执行需单独处理。

OpenCode

opencode-v1,声明三种协议和 Tools。OCI OpenCode 与内置 OpenCode 是两条分发路径,Provider 要求不同。

Aider

aider-v1,当前 Messages,恢复历史继续对话;当前适配器不提供连接 Tools,也不支持声明 initialization。

Pi

pi-v1,三种协议,Tools 通过 Pi extension。模板可构建不等于已有可拉取镜像。

Claude Code

claude-code-v1,当前 Messages,Tools 经 MCP bridge;按实际权限运行,不将 root 不兼容的 bypass 模式当默认方案。

Python Agent

hexagon-json-v1,当前 Messages 示例,实现 mailbox 工具与自定义会话契约。自定义代码必须自己正确持久化对话。

选择与验证

根据协议表选择模型,根据 Tools / initialization 要求选择适配器,再检查 Sandbox 的 OCI、私有镜像和恢复能力。提交明确结果任务,验证两轮、工具、产物、取消与清理;必要时增加休眠恢复。 能力声明由适配器限制。不能通过注册 tools 为 Aider 增加未实现功能,也不能靠换版本字符串改变镜像行为。 下一步:OCI 注册、source package、模型协议。依据:Runtime 协议、注册检查。