用途:army-run 用于启动并持续运行一个智能体集群,包含监督循环(supervisor)和 Web 工作区(serve)两个进程,二者共享同一个 SQLite 数据库;重启任一进程都不会丢失状态。工作区供人类查看和操控集群。
主要能力:监督循环按 tick 遍历到期且无运行中的活跃代理,先做无 LLM 的前置检查,再检查通道与预算,然后预留预算、开启运行、组装 capsule 并驱动 acpx 会话,将 NDJSON 流入线程,最后在一个事务中分类结果并计算下次唤醒。结果词表包括 WORK_DONE、NO_WORK、RATE_LIMITED、BLOCKED、RETRYABLE_ERROR,分别对应不同的下次唤醒策略。工作区提供状态、账户、终端标签页,并可附加到真实 tmux 会话查看运行。
使用方式:先 cd app && npm install。然后用 AOA_DB=./aoa.db AOA_PROJECT_ROOT=/path/to/project make -C .. supervisor & 启动监督进程,再执行 AOA_DB=./aoa.db AOA_PROJECT_ROOT=/path/to/project make -C .. serve 启动工作区。工作区会打印 URL 和认证 token,打开 http://127.0.0.1:8787/?token=…。可用环境变量包括 AOA_DB、AOA_PROJECT_ROOT、AOA_PORT(默认 8787)、AOA_TICK_MS(默认 15000)、AOA_TOKEN,以及 AOA_ORCHESTRATOR_HARNESS(默认 claude)。另可运行 ./scripts/aoa doctor <project> 做无 LLM 的环境检查。
适用场景:需要持续、可观察地调度多个代理协作完成项目任务,并希望状态可恢复、成本可控的场合。空闲代理不产生费用,安静集群的稳态是每天少量回合。
限制与注意事项:不要用两个监督进程连同一个数据库;不要让人类直接用代理的 acpx 会话名附着,否则可能被协调逻辑误杀;不要删除前置检查或缩短 floor;不要用 acpx 的 --no-wait。工作树应放在项目旁而非项目内。资料未提供具体价格、平台支持范围或效果承诺。