这个项目能做什么

amux 是面向 AI 编程代理的开源控制平面,旨在通过单一 Web 仪表板或移动应用协调多个 AI 工作器(如 Claude Code、Codex、Gemini CLI、OpenCode 和 Ollama)。它采用本地优先、自托管设计,以单一 Rust 二进制文件构建,并使用 SQLite 存储。 主要功能包括: - **原子任务**:共享看板,通过比较并交换(compare-and-swap)方式认领任务以防止重复工作;任务标记为“完成”需要提供证据,标记为“已验证”需要同行验证。 - **工作器感知**:工作器可以查看集群状态、窥视同伴终端,并通过带来源标记的工作器间消息传递进行协调。 - **引导干预**:用户可以从仪表板或手机向运行中的会话输入内容,在执行过程中重定向任务。 - **调度与循环**:支持 Cron 风格的周期性提示和自主循环,用于夜间运行。 - **分组与作用域**:工作器可以组织到具有共享内存、环境和门控的通道中。 - **模型切换**:在运行中的工作器上更换模型或提供商,而不会丢失上下文。 - **消息历史**:所有提示、回复和投递都会被记录,以便后续检索。 - **自愈**:看门狗会自动压缩、重启崩溃的会话,并重放最后一条消息。 安装非常简单,只需一条命令即可完成安装程序,设置服务器、CLI 和系统服务(macOS 上为 launchd,Linux 上为 systemd)。仪表板嵌入在服务器二进制文件中,CLI(`amux-rs`)提供用于看板管理、工作器控制和调度的命令。 架构由四个 Rust crate 组成:server、dashboard、CLI 和核心领域类型。它使用八个原语(看板、工作器、调度器、文件系统、分组、记忆、环境、消息)来组合新能力。 一个值得注意的功能是 `.mdai` 文件,这些是计算型 Markdown 文件,充当 DAG 中的节点,通过模型提示从连接的来源合成内容。这允许动态文档生成,并支持循环检测和缓存。 安全性采用本地优先设计,使用 bearer token 认证,项目强调不要将服务器端口暴露到互联网,建议使用 Tailscale 进行远程访问。 该项目采用 MIT + Commons Clause 许可证,可免费使用和自托管,商业转售需要单独许可证。项目正在积极开发中,路线图是成为围绕代理的持久操作系统。