MaxGfeller/open-harness

解決的問題

OpenHarness 提供了一個在程式碼中直接建構通用 AI 代理的框架。它簡化了建立能透過工具（如檔案系統和 shell）與現實世界互動、透過會話維持長期記憶，並使用子代理與中間件處理複雜工作流程的代理的過程。

如何運作

基於 Vercel 的 AI SDK 建構，專案採用模組化架構：

• 代理：無狀態的執行器，使用特定模型與一組工具來執行任務。
• 會話：包裝代理的容器，負責管理對話歷史、處理上下文視窗壓縮，以及管理重試。
• 中間件：可組合的函數（如 withTurnTracking 或 withRetry），可套用於代理執行器以修改其行為。
• 工具：提供檔案系統存取（NodeFs）與 shell 執行（NodeShell）的預建提供者，以及對 Model Context Protocol (MCP) 的支援。
• 子代理：可將任務委派給巢狀代理的功能，這些代理可以是無狀態、可恢復，或在背景執行。

適用對象

希望建構需要工具使用與狀態管理的 AI 驅動 CLI 工具、使用 React 或 Vue 的聊天應用，或自主代理的開發者。

主要亮點

• 工具整合：內建對 bash 與檔案系統操作的支援。
• 狀態管理：提供專用的 Session 與 Conversation API，用於多輪互動。
• 可組合邏輯：中間件系統，可用於新增自動重試與上下文壓縮等功能。
• UI 就緒：包含專用套件，支援 React 與 Vue 3 以整合串流式聊天介面。
• 可擴充性：支援動態子代理目錄與 MCP 伺服器。