Intelligent-Internet/zenith

Zenith: a continuous-improvement harness for long-running agent tasks. Turns Claude Code, Codex, or Hermes into a multi-agent mission orchestrator via MCP/ACP.

Zenith – 长期运行 AI 编码代理的框架

是什么 – Zenith 是一个基于 Python 的 代理框架，可让大型语言模型编码代理（Claude Code、Codex 或 Hermes）在数天或数周内持续工作，而不会过早终止。它通过运行一个 协调器 实现这一目标，该协调器反复检查任务的当前状态，然后决定是否：

启动工作子代理来编写代码，
启动测试子代理来验证输出，
注册可重复使用的“技能”以供后续使用，
重新规划剩余工作，或
在任务真正完成后停止。

为何重要 – 在长期软件工程任务中，最大的失败模式是 过早终止：代理认为任务已完成，但规范尚未满足。Zenith 的自适应循环（受 RALPH 基线启发）使流程持续运行，重新审视差距，仅在有纪律的规则判定工作完成时才停止。在作者 2026 年的技术报告中，Zenith 在八个基准任务上优于其他五种框架设计，取得了最佳平均排名，同时成本低于最强基线的一半。

快速开始

选项 1 – 让 LLM 为你安装

将 README 中显示的提示复制到 Claude Code、Codex 或 Hermes 中。该提示将：

检测你正在使用的编码代理。
使用 uv 安装 Python 依赖。
安装所需的 ACP 适配器（@agentclientprotocol/claude-agent-acp 或 @agentclientprotocol/codex-acp）。
注册一个 /zenith 技能，将后续所有指令转发给框架。

技能创建后，只需输入：

/zenith <your instruction>

Zenith 将接管任务。

选项 2 – 手动安装

# 克隆仓库并进入包目录
cd zenith
# 安装 Python 依赖（需要 uv）和 CLI
uv sync
# 检查 CLI
uv run zenith --help

# 安装你计划使用的代理所需的 ACP 适配器
npm install -g @agentclientprotocol/claude-agent-acp   # 用于 Claude Code
npm install -g @agentclientprotocol/codex-agent-acp   # 用于 Codex

创建一个指向你希望代理工作的目标代码库的项目空间：

uv run zenith init --workspace-dir /path/to/your-app --agent claude   # 或 codex

然后在该工作区中启动选定的代理（例如 claude 或 codex），并按 README 中所述发出协调器提示。

Zenith 的工作原理（概览）

协调器会话 – 单个 LLM 循环，每轮读取项目快照（文件、测试结果等）。
决策步骤 – 基于快照，选择以下四种操作之一：启动工作（编写代码）、启动测试（运行测试/验证）、注册可重用技能、重新规划 剩余步骤，或停止。
子代理 – 工作和测试代理通过 MCP/ACP 协议在隔离环境中运行，并将结果报告回协调器。
集成 – 协调器合并子代理输出，更新项目状态，并重复该过程。
自适应分配 – 协调器学习何时分配更多工作、何时专注于验证、何时停止，从而减少不必要的 API 调用。

报告性能

基准	模型	框架	平均排名（越低越好）	主导性	每任务成本
Frontier SWE	GPT‑5.5	Zenith	2.06	92 %	$175.68
（其他）	…	…	…	…	…

在八个长期任务上的消融研究显示：

平均排名：Zenith 1.38 vs. RALPH 1.75
平均成本：$175.68 vs. RALPH $407.58
胜场数：Zenith 在 8 个任务中赢了 5 个，是所有方法中最多的。

仓库结构

zenith/ – Python 包（zenith-harness）、CLI 入口点、MCP 服务器、捆绑的提示/技能和测试。
technical_report/ – 《从 RALPH 到 Zenith：长期运行代理的框架设计》技术报告的 PDF、LaTeX 源码和图表。

适合谁使用

AI 增强的软件工程师：希望让编码 LLM 在数天内自动完成大型功能或重构，无需手动干预的人。
研究人员：探索长期运行代理控制机制（间隙发现、自适应协调、停止规则）的人。
工具构建者：需要一个可通过 ACP 协议接入 Claude Code、Codex 或 Hermes 的可复用框架的人。

许可证

代码：Apache 2.0
报告与图表：Creative Commons BY 4.0

引用（如仓库中提供）：

@techreport{ii2026zenith,
  title       = {From RALPH to Zenith: Designing Harnesses for Long-Running Agents},
  author      = {{Intelligent Internet}},
  institution = {Intelligent Internet},
  year        = {2026},
  type        = {Technical Report},
  url         = {https://github.com/Intelligent-Internet/zenith}
}