Agent Harness 设计拆解

以 OpenAI Codex（Rust 实现）为样本，拆解一个生产级 agent harness（脚手架/运行时框架）的设计。

所谓 harness，指模型之外的一切驱动逻辑：会话管理、轮次调度、工具执行、审批沙箱、上下文维护、持久化恢复…… 模型本身只是一个"给它输入、它吐输出"的推理引擎；是 harness 让它变成一个能连续做事、能被打断、能与人协作的 agent。

目录

  1. 01
    运行时模型session/thread/turn/step/task 层级与生命周期；中断、steer、recover
  2. 02
    交互与事件协议前端控制协议 + 模型流式协议
  3. 03
    模型接入与推理控制把"黑盒引擎"变成可调、可换、可续的服务
  4. 04
    上下文与指令管理历史增量、压缩/窗口、片段注入、指令体系
  5. 05
    LOOPagent 的"心跳"：调用模型 → 执行行动 → 回灌结果 → 再次调用模型
  6. 06
    工具系统spec/暴露面、发现、执行与并发、结果/错误回灌
  7. 07
    多 agent 与编排spawn/消息/并发上限
  8. 08
    安全策略沙箱后端、权限模型、策略判定、网络、自动审查
  9. 09
    Human in the loop介入时机与形式
  10. 10
    持久化与可恢复性事件溯源/checkpoint、resume/fork/rollback
  11. 11
    可扩展性MCP/插件/skills/hooks/扩展 API、配置分层、宿主形态
  12. 12
    可观测性tracing/metrics/回放
  13. 13
    Transcripts 设计总览同一段历史的多种读法：模型、live、committed、preview、协议投影

附录

Codex 核心 Harness 架构图