usepr/eva

解決的問題

EVA 是一個輕量級 AI 代理，專為自動化撰寫腳本、建立測試案例、執行 shell 命令與分析資料等技術任務而設計。它旨在提供一種高可移植性、低開銷的複雜代理框架替代方案，讓使用者能以單一 Python 檔案的形式快速部署功能完整的代理。

工作原理

EVA 作為一個單檔案 Python 程式（eva.py）運作，可連接任何支援 OpenAI API 格式的 LLM（包括透過 vLLM 或 Ollama 的本地模型，或 DeepSeek 和 OpenAI 等雲端 API）。它維持以目前目錄為作用域的對話歷史，表示在相同資料夾中重新啟動時會記住上下文。它也使用設定檔（EVA.md）來定義其角色、設定與技能。

適用對象

專為需要快速、可攜式終端自動化與 shell 執行 AI 助手的開發者與系統管理員設計，無需複雜的安裝流程。

主要特色

• 單檔案架構：整個代理皆包含於一個 eva.py 檔案中，方便「貼上即用」式部署。
• 目錄作用域會話：根據工作目錄自動持久化並恢復對話。
• 安全審查：預設情況下，寫入/執行命令需使用者確認，但可透過特定旗標跳過。
• 本地模型支援：相容任何 OpenAI 相容 API，支援完全本地執行。
• 目標模式：包含 -g 標誌，允許代理循環執行直到達成特定目標。