amux 智能体控制平面
在一个自托管控制台中调度、监督并恢复并行编程智能体。
按维度查看评分与理由
证据显示了分层作用域、默认限制代理只能写自身 worker 层、按用途列出的 macOS 权限、发送前确认、来源戳、消息账本、TLS/令牌、秘密扫描以及备份和卸载保留数据等控制。扣分原因是 localhost 免认证、服务默认暴露于本地网络、公开隧道仅依赖不可猜 URL、文件根可默认为 HOME，且自动计划、循环和代理工具仍可能产生广泛外部影响；权限故障有时会静默或挂起。依赖采用集中版本和部分精确锁定，但所给文件没有依赖漏洞审计、更新机器人或供应链验证证据，因此 dependency_security 仅得 1。发布者身份未知本身未作负面推断。
README、工作区结构、UI 测试和 CI 工作流总体描述同一套 Rust 控制平面，并展示了原子领取、持久工作项、降级状态、恢复、备份落地确认以及针对历史故障的回归守卫。依赖和平台要求、systemd/launchd 路径及非 systemd 回退写得较清楚。扣分在于未执行这些测试，herdr 集成明确不在 CI 覆盖内，macOS 权限缺失可静默失败，云端仍保留待迁移的 Python 镜像；许可证和产品描述之间也存在一致性问题。错误信息有不少精确诊断，但并非所有路径都能可靠显式报错。
材料明确覆盖个人本机、多代理团队、移动端、云端、macOS、多个 Linux 发行版、不同模型供应商、tmux/herdr 后端及业务操作界面，场景和受众十分丰富。能力边界也明确区分 Rust 主服务器、遗留端口、公开隧道、模型判断与自动化、核心权限和可选权限，并诚实标注未覆盖的 herdr 集成。扣分主要在触发精度：虽然计划、循环、状态门、CAS 领取和发送时机有说明及测试，但自主循环、自然语言 cron 和消息重放的完整歧义处理规则未在所给源码中展示。
README 的架构、原语、配置、平台、CLI、权限、安全、迁移、命名和资源导航非常完整；安装、升级、卸载、示例、FAQ 链接和已知限制也很具体。worker/session 与 group/tag 的兼容命名得到明确解释。主要扣分来自许可证：描述称“open-source”或 MIT，而 README 徽章和 LICENSE 实际加入 Commons Clause，Cargo 元数据又只写 MIT，且用户提供的许可证元数据为 NOASSERTION，形成实质冲突。存在 changelog 链接和迁移记录，但未提供修订对应的完整变更日志内容；维护渠道有安全邮箱、贡献指南和 issue 路线图，但发布者未被验证且未给出正式支持或更新承诺。
共享看板、原子任务领取、来源戳消息、状态门、持久历史、恢复、调度、移动控制和可切换模型共同提供了明显超过单个代理会话的增量价值。CLI、dashboard、可审计证据、失败提示和移动/无障碍测试使输出具有较强可操作性。扣分在成本收益：单 Rust 二进制和 SQLite 降低部署成本，但仍需 Rust、tmux、代理 CLI、模型调用、若干系统权限以及运维存储；日志显示权限超时和云备份磁盘事件等实际成本，材料也没有给出可泛化的性能或经济收益测量。
证据大量使用具体 issue/card 编号、故障日期、可观测签名、API 路径、测试名称、状态断言和第二连接备份确认，README 的许多结构性声明也由 Cargo 工作区、Playwright 测试和 CI 守卫交叉支持。材料清楚区分“模型判断”与自动化、模拟边界与真实集成、只读检查与显式 live 写入，以及未被 CI 覆盖的 herdr 路径，因此事实与推断分离较好。扣分在 claim_traceability：部分营销性主张、日志统计和“几十个并行 worker”等效益仅由仓库文字陈述，所给片段无法逐项追溯或独立复核；本评估也未执行任何测试。
- 不要把 8824 或兼容端口 8822 直接暴露到互联网；localhost 免认证，公开隧道 URL 也只是不可猜而非经过认证。
- 在授予 Full Disk Access、Messages、iTerm2 或 Accessibility 前按实际功能最小化授权；文档明确说明部分拒权路径可能静默失败或长时间挂起。
- 将真实 server.env、认证令牌、服务账号和连接器密钥视为敏感信息；CI 的模式扫描不能替代密钥轮换、依赖审计或运行时秘密管理。
- 在采用前由法律人员确认许可范围：LICENSE 是 MIT 加 Commons Clause，和 Cargo 的 MIT 元数据、描述中的“MIT/open-source”不一致。
- 自主计划、循环、消息重放及自愈重启可能重复或延续外部操作；先在隔离工作区验证审批门、幂等性、停止机制和恢复行为。
- herdr 路径未获 CI 集成覆盖，云端仍有 Python 镜像待迁移；不要从 Rust 主路径的测试推断这些路径具有同等保障。
这个 Agent 能做什么，适合哪些场景？
amux 是面向 AI 编程智能体的本地优先、自托管控制平面，可并行运行 Claude Code、Codex、Gemini CLI、OpenCode 和 Ollama 工作进程。系统由一个 Rust 工作区构成，包括基于 axum 的服务器、嵌入式单页控制台、amux-rs CLI 和共享领域类型，并以 SQLite 保存状态和事件日志。工作进程默认运行在 tmux 会话中，也可选择未经 CI 集成验证的 herdr 后端；用户可以通过网页控制台、CLI 或 iOS 客户端查看和干预运行。它提供带原子认领与状态门禁的看板、定时任务、自主循环、分层内存与环境配置、带来源记录的消息、模型切换以及崩溃恢复。部署边界是一台由用户管理的 macOS 或 Linux 主机，服务默认通过 https://localhost:8824 提供 API 和控制台，不应将该端口直接暴露到互联网。
amux-server-rs 启动并管理并行编程智能体会话，将工作项存入共享看板，并通过 compare-and-swap 保证同一任务不会被两个工作进程同时认领。工作进程可以查看同组成员、读取对方终端状态，并通过服务器记录真实发送者的消息互相协调；操作者也能从控制台或手机向正在运行的会话输入指令。调度器执行一次性任务、cron 风格计划和自定节奏循环，watchdog 可自动压缩上下文、重启崩溃会话并重放最后一条消息。服务器还提供文件浏览、编辑和搜索，以及 .mdai 计算型 Markdown DAG：POST /api/files/mdai/run 会按上游优先顺序解析来源、调用配置的辅助模型、缓存相同输入并记录运行历史。所有 /api 请求进入结构化请求日志；控制台通过 SSE 与增量同步接收更新，amux-rs 则提供 board、workers、send、schedules 和 health 等命令。
- 同时维护多个功能分支的工程团队，可让多名 Claude Code、Codex 或 Gemini CLI 工作进程从同一看板原子认领任务，并用 peer check 区分 done 与 verified。
- 需要夜间持续执行工作的个人开发者，可配置 every 15m 或 daily at 9am 等计划，并依靠自主循环和 watchdog 处理长期运行及会话崩溃。
- 希望在手机上监督本地编程会话的自托管用户，可通过控制台或 iOS 客户端查看工作进程并在任务执行中途发送转向指令。
- 需要审计智能体协作过程的团队，可利用来源由服务器确认的工作进程消息、完整消息历史、事件日志和任务完成证据。
- 需要从文件与历史指令生成周期性简报的用户，可建立引用普通文件、目录、其他 .mdai 节点或 amux:messages 的计算型 Markdown DAG。
- 在不同任务间选择不同模型的 AI 工程团队，可在运行中的工作进程上切换模型或提供商，同时保留会话上下文。
这个 Agent 有哪些优点和局限？
- 任务认领使用 compare-and-swap，并将 done 与需要同行检查的 verified 分开，降低并行工作进程重复领取或未经验证即结案的风险。
- 服务器、控制台和 CLI 集成为一个 Rust 工作区；控制台嵌入服务器二进制，构建时不需要 Node.js 或 npm。
- 同时支持多种编程智能体与模型切换，并提供来源由服务器确认的消息、分层作用域配置和持久消息账本。
- 具备面向长期运行的 watchdog、崩溃重启、最后消息重放、结构化请求日志和计划任务历史。
- .mdai 将文件、目录、消息历史和其他节点组合为带循环检测、输入哈希缓存及历史记录的计算 DAG。
- 必须自行运行并维护本地服务、SQLite 数据、TLS 证书、认证令牌以及 tmux 会话；它不是免运维的托管服务。
- 默认部署使用自签名 HTTPS 证书，首次访问需要接受浏览器警告，而且文档明确禁止直接将 8824 端口暴露到互联网。
- herdr 后端没有由 CI 覆盖真实集成，绿色构建只能证明后端选择逻辑，不能证明实际联通。
- macOS 上的 Messages、iTerm2、邮件或系统自动化功能可能需要 Automation、Full Disk Access 或 Accessibility 权限，缺失授权可能导致超时或静默失败。
- 许可标识为 MIT + Commons Clause，允许使用、修改和自托管，但商业转售需要单独许可；仓库元数据中的 License 字段同时标为 NOASSERTION。
- 旧 Python 服务、pipx 和 Homebrew 安装渠道已退役；遗留 8822 端口仅为兼容绑定，现有部署需要迁移到 Rust 服务和 8824 端口。
如何安装或部署这个 Agent？
要求 tmux 3.2+，以及 Claude Code、Codex CLI 或 Gemini CLI 中至少一种。运行：
git clone https://github.com/mixpeek/amux && cd amux && ./install.sh安装器会检查 Rust 工具链与 tmux，并在安装缺失组件前征求确认；随后构建工作区，将服务器和 CLI 安装到 ~/.local/bin，并在首次启动时创建 ~/.amux、SQLite 数据库、TLS 配置和认证令牌。macOS 上会配置 launchd；受支持的 systemd Linux 包括 Ubuntu 22.04+、Debian 11+ 和 Fedora 36+，安装后可运行：
systemctl --user enable amux-server amux-builder.timer
systemctl --user start amux-server其他 Linux 可手动启动：
AMUX_RS_PORT=8824 ~/.local/bin/amux-server-rs如何使用这个 Agent？
打开 https://localhost:8824，首次接受自签名证书警告，并从控制台创建第一个工作进程。认证令牌位于 ~/.amux/auth_token；本地主机调用可免认证。先验证服务：
amux-rs health常用操作包括：
amux-rs board add "task title" --type code
amux-rs board list --status todo
amux-rs workers list
amux-rs send worker-1 "implement the login endpoint and report back"
amux-rs schedules list运行 .mdai 节点可调用：
curl -sk -X POST https://localhost:8824/api/files/mdai/run -H 'Content-Type: application/json' -d '{"path":"weekly.mdai"}'日常更新代码后可执行 make run；开发迁移时使用采用临时数据库的 make dev。远程访问应使用文档列出的 Tailscale 方案或 amux tunnel，而不是直接公开 8824 端口。