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}
}