镜像自 HugoXK/LaunchPad@5cfa983 · upstream · 在 GitHub 上编辑 docs/harness-runtime.md ↗

Harness Runtime

Role 服务选择执行器并组装角色说明、assignment 和任务事实引用;Harness 负责会话连接与执行,不负责组队、验收或发布。定义、持续会话与本轮执行分别映射现有 Harness 注册、role_instances、task_runs;没有第二套任务系统。

公共边界与后端目录

roleHarness(id).createSession(spec, services) 创建公共会话;原 adapter 入口保留为兼容包装,实际执行统一经过该会话。HarnessSession<T> 提供 id / run / cancel / close。持续上下文按后端类型保存在 role_instances 或容器持久化目录,下一轮按恢复协议续接或从任务事实重建,不要求控制面常驻子进程。

当前已注册的 Agent 后端:

公共协作与安全边界:

Claude Code 的完整说明见 Claude Code harness;下文说明容器内 Codex(codex app-server)驱动。

容器内 Codex(codex app-server)

codex 驱动(src/harness/codex.ts + src/harness/app-server.ts)通过 runner/harness-entry.mjs 在容器内以独立进程组启动 codex app-server(stdio JSON-RPC 协议),兼容范围由 src/harness/agent-tools.ts 管理(当前 >=0.166.0 <1.0.0,协议基线 0.166.0;可用 node scripts/codex-protocol-lock.mjs 复核协议摘要)。

工具卷与配置

角色配置示例:

{
  "expected_revision": 3,
  "enabled": true,
  "roles": [
    {
      "role_id": "dev",
      "harness_ref": { "id": "codex", "model_source": "gateway" },
      "model_profile_ref": { "model_id": "<model id>" },
      "environment_profile_ref": { "id": "isolated-workspace" }
    }
  ]
}

协议、原生工具与护栏

长耗时运行汇报(Long execution reporting)

运行耗时长不等于卡死。连续执行的 RoleRun 在满 60 分钟及之后每 20 分钟(80、100……)向任务的 Manager 汇报进度,不中断正在工作的角色;旧配置中的整轮 timeoutMs 不再强制杀死运行。初始化、单次命令、授权租约以及显式角色/阶段资源预算仍按各自语义生效。

long_execution_report 记录精确的 run/assignment、已运行时间、近期活动、工具证据与检查点引用;long_execution_decision 记录 Manager 的继续或停止决定。用户取消、权限撤销与预算耗尽仍立即中断。

任务里的真实浏览器、源站允许范围和截图证据见 任务浏览器与执行证据。生产项目电脑镜像预装 Chromium 由独立单跟踪,不在本文展开。