evoflux

Evoflux 是一个开源、本地优先的桌面工作空间，专为 AI 智能体团队设计。它将智能体对话、文件、终端、浏览器、git 和验证统一到一个界面中，提供两种主要模式：用于通用任务的 **Work** 和用于仓库感知开发的 **Coding**。 主要能力包括： - **Work 和 Coding 模式**，既支持临时任务，也支持持久化仓库。 - **主导与专家团队**，每个智能体都可以拥有自己的模型、技能、工具和权限。 - **自带模型**，支持约 200 个托管、云、路由或本地提供商，可按智能体选择。 - **仓库感知 Coding**，具备代码搜索、符号关系、LSP 反馈、git 工作流和可审查的差异。 - **Computer App Control**，允许智能体在 Windows 或 macOS 上通过其无障碍树在后台操作单个桌面应用窗口，并提供实时预览和逐操作审批。 - **WebBridge**，使智能体能够通过配对的、经过策略检查的中继，在你真实的 Chrome 或 Edge 浏览器中使用现有登录状态工作。 - **本地控制**，具备可检查的历史记录、权限、沙箱以及出站密钥/PII 脱敏。 - 集成 **memory、plugins、MCP、调度和内置浏览器**。 ## 下载 桌面版本已在 [GitHub Releases](https://github.com/evoelsewhere/evoflux/releases) 上提供，适用于 macOS、Windows 和 Linux。软件包包含原生 Python sidecar。Linux 软件包应通过系统包管理器安装（例如 `sudo apt install ./EvoFlux_*_amd64.deb`）。WebBridge 单独发布在 [evo-webbridge 仓库](https://github.com/evoelsewhere/evo-webbridge) 中。 ## 从源码运行 ### 要求 - Python 3.12+ - [uv](https://docs.astral.sh/uv/) - [Bun](https://bun.sh/) - Rust 和 [Tauri CLI](https://v2.tauri.app/start/prerequisites/) - 适用于你操作系统的 Tauri 先决条件 ### 设置 ```sh git clone https://github.com/evoelsewhere/evoflux.git cd evoflux uv sync cd web && bun install && cd .. ``` 启动开发应用： ```sh # React UI + 本地 API make dev-web # React UI + 本地 API + Tauri 桌面外壳 make dev-desktop ``` `make dev` 是 `make dev-web` 的别名。Web 服务器是内部开发界面；产品是桌面应用。首次启动时，连接一个模型提供商，然后启动 Work 会话，或在 Coding 模式下打开一个仓库。 ## 文档 详细的契约和指南位于 [`documents/`](documents/) 下： - [文档索引](documents/README.md) - [Agent Plugins 指南](documents/guides/agent-plugins.md) - [Coding 架构](documents/architecture/) - [开发指南](documents/development/README.md) ## 架构 技术栈为：Tauri 桌面外壳 → React UI ↔ 本地 FastAPI sidecar → 本地状态、智能体运行时、仓库和模型提供商。主运行时和项目状态保留在用户机器上；模型提供商可替换，而 harness 负责上下文、工具、权限、memory 和验证。 ## 项目布局 - `app/` – FastAPI sidecar、智能体、编码工具、memory、调度器、MCP - `web/` – React 界面 - `desktop/` – Tauri 外壳和 Python sidecar 打包 - `seed/` – Work 和 Coding 蓝图、技能和配置 - `tests/` – 后端和前端测试 - `documents/` – 架构、功能契约、指南和记录 ## 贡献 欢迎提交 issue 和 pull request。请保持改动聚焦，并包含最小相关测试运行。请通过 GitHub Security Advisories 私下报告漏洞。 ## 许可证 Apache License 2.0。