Johnson-Durui/ApexCluster
开发工具本地运行的多厂商 Agent 集群,把需求变成 PRD、原型与经 Docker 验证的代码。
这个项目自带 2 个 Agent 技能看技能清单和安装方法 →项目介绍
ApexCluster 是一套在本机运行、由程序状态机掌权的多 Agent 产品与软件工程工作台。它把任务分成两层:架构层从一段原始需求出发,经过澄清、方案发散、跨厂互审和原型搭建,在关卡 A 输出 PRD.md、ARCHITECTURE.md、DEV_GUIDE.md、结构化验收契约 CONTRACT.json 和可运行的 demo/;实现层再做里程碑互签、隔离并行编码、跨模型家族评审、独立验收,最终生成可追溯的 TRACE。
它的核心差异在于不靠模型自称「测试通过」推进流程。阶段流转绑定契约文件、源码与产物的 SHA-256 哈希、结构化命令回执和最终 TRACE;实现作者与评审者必须来自不同厂商家族;五个旗舰席位按 4 → 3 → 2 加权,只能向权重更低的目标派单,四个 Worker 池每池最高 64 并发。适合希望直接拿到 PRD 与原型的产品经理,以及愿意配置多家模型密钥的工程团队。仓库提供单厂商预设和全旗舰预设,也能复用本机已登录的 Claude Code 与 Codex CLI 账户做评审。
快速使用
零成本离线演练(不需要 API Key):需要 Node.js >= 22.12、Git 和运行中的 Docker。使用脚本化 Provider,不调用真实模型,但会真实构建并执行隔离容器:
git clone https://github.com/Johnson-Durui/ApexCluster.git
cd ApexCluster
npm ci
docker build -t dmw-sandbox:local docker/sandbox
npm run demo:offline
成功时终端最后一行输出 PASS。
运行真实流水线:先把 .env.example 复制为 .env 并填入厂商密钥,再把 config/chat.config.example.json 复制为 config/chat.config.json,填写本地镜像的不可变 sha256: ID 与 budget.maxUsd 上限,细节见 Docker 执行配置。只有 OpenAI 密钥时,可以只跑架构层并停在关卡 A:
npm run models:verify -- --provider openai
mkdir product
npm run pipeline -- --preset single-provider --requirement tests/fixtures/pipeline/todo-cli/requirement.md --workspace ./product
配齐五个厂商密钥后,--preset flagship 会执行架构加实现的完整流程。CLI 以 NDJSON 逐行输出,成功退出码为 0,非交互终端遇到人工关卡为 3,运行失败或配置不可用为 4/5。名册预设见 配置指南。
启动 Web 指挥台:依次执行 npm ci --prefix web、npm run build:web、npm start,服务仅监听 127.0.0.1,默认端口 5170。注意这种方式浏览器端无法授权新的产品目录,要针对本地目录跑完整流水线仍需使用 npm run pipeline。只想先看界面可以用预设数据的 在线演示,其中包含交付的 RoomDesk 示例应用。
使用约束
- 离线与沙箱流程要求 Node.js >= 22.12、Git 和 Docker;替代执行后端为 WSL
bwrap与 Windows MXC。 - 真实流水线需要所选名册中每个厂商的 API Key;
single-provider预设只覆盖到关卡 A 的架构阶段。 - 目标 workspace 目录必须已存在并经过本地授权,程序才能读写。
- 沙箱命令默认以非 root 运行且断网,依赖安装需走单独的受控安装通道。
- Web 工作台只绑定回环地址,后端不会向前端暴露密钥值。
- 每次运行可用
budget.maxUsd与budget.maxTokens限制花费,模型 ID 必须与本地注册表一致并通过models:verify。 - 项目采用 MIT 许可证。
HotRepo 点评
ApexCluster 于 2026-11-22 出现在 TypeScript 新项目榜上,约一小时内新增 5 个 Star,总计 105 Star、11 Fork。观察窗口短且窄,这组数据只能说明早期有过关注,不足以判断热度能否持续。技术上值得注意的是它把重点放在程序关卡上:跨厂商评审独立性、产物哈希、不可变容器摘要、拒绝静默降级的模型注册表,都是可核查的机制,而不是泛泛的「多 Agent」说法。代价是配置门槛:完整流程需要五家前沿厂商的密钥和钉死的沙箱镜像,因此单厂商预设和脚本化离线模式更适合第一次评估。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。