搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

Johnson-Durui/ApexCluster

开发工具

本地运行的多厂商 Agent 集群,把需求变成 PRD、原型与经 Docker 验证的代码。

这个项目自带 2 个 Agent 技能看技能清单和安装方法 →
138
11
TypeScript
MIT
创建于 3 天前

项目介绍

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 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. superplanehq/superplane把常规 backlog issue 编排成经过校验的 PR,串联编码 Agent、CI 与人工审批。Go8,201
  2. muaaz9329/cheap-ag在 Claude Code 中让强模型只做规划、便宜模型按测试实现,降低贵模型用量。TypeScript169
  3. paperclipai/paperclip把多个异构编程 Agent 当成一家公司来管:目标、组织架构、预算和审计都在一个面板里。TypeScript106,775