usepr/eva

解决的问题

EVA 是一个轻量级 AI 代理，旨在自动化编写脚本、创建测试用例、执行 shell 命令和分析数据等技术任务。它旨在提供一种高度便携的「单文件」替代方案，作为更复杂代理框架的替代品，使其在 Docker 或远程服务器等受限环境中易于部署。

工作原理

EVA 作为一个单一的 Python 文件（eva.py）运行，通过 OpenAI 兼容 API（如 DeepSeek、vLLM 或 Ollama）连接到 LLM。它通过目录作用域会话管理上下文，意味着在相同文件夹中重启时会记住之前的对话。为确保安全，它默认以只读模式执行命令，除非使用 --allow-all 标志，否则任何写入或执行操作都需要用户确认。

适用人群

专为需要快速、便携的 AI 助手来完成基于 shell 的自动化和数据分析，而又无需复杂安装流程的开发人员和系统管理员设计。

主要亮点

• 单文件架构：整个代理包含在一个 eva.py 文件中，支持「粘贴即用」的部署方式。
• 目录作用域会话：根据当前工作目录自动持久化并恢复对话。
• 灵活的 LLM 集成：支持任何 OpenAI 兼容 API，包括本地模型。
• 安全控制：内置安全审查机制，对潜在危险命令需用户确认。
• 可自定义行为：通过 EVA.md 文件定义代理的角色、设置和特定技能。