Tencent/LoopForge
Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
LoopForge — 它是什么
LoopForge 是一个面向使用 AI 编码代理交付软件的团队的自托管工作区。您在聊天窗口中描述需求,系统协调 AI 代理、沙箱和审批步骤,将该请求转化为实际的代码更改——通常是一个拉取请求。
它围绕三个理念构建:
- 与“主机器人”聊天 — 您输入请求,它会打开一个隔离的 Docker 工作区,检出您的仓库,将工作委派给专门的 AI 角色(规划者、实现者、审查者、测试者),并在完成后打开 PR。
- SOP(标准操作程序) — 一旦您找到有效的工作流,您可以将其保存为可重复的固定步骤序列(AI 代理、脚本和人工审批门)。此后每个请求都遵循相同的阶段和相同的检查。
- 人工控制 — 审批门会暂停运行,直到有人审查工件并批准、将工作发送回更早的步骤或重试。如果您不希望,没有签署就不会交付任何内容。
实际的编码工作由现有的 AI 编码工具完成——CodeBuddy、Codex 或 Claude Code。LoopForge 不会取代它们;它编排它们,在它们周围添加角色、沙箱、检查点和历史记录。它运行在您自己的基础设施上,并采用 MIT 许可。
两种工作方式
| 与主机器人聊天 | 运行 SOP | |
|---|---|---|
| 最适合 | 探索、快速修复、与代理迭代 | 具有固定阶段和签署的可重复交付 |
| 运行方式 | 主机器人按需打开 Docker 沙箱,并将项目角色作为子代理调用 | 引擎按顺序运行代理、脚本、人工门和子 SOP 节点,每个节点在自己的沙箱中 |
| 您通过以下方式保持控制 | 在回复中排队或引导消息;暂停、恢复或接管正在运行的 SOP | 在人工门处批准,将工作发送回所选步骤,从任何节点重试或重新运行 |
| 交付 | PR/MR,或直接合并到共享分支 | 文档、代码或 PR,以及每个节点的工件和日志 |
两条路径都跟踪相同的需求,因此每个更改都链接回所请求的内容,并计入交付和成本报告。
为什么存在
要求编码代理“修复这个 bug”会得到取决于特定运行的结果——它可能跳过计划、忘记测试、审查自己的代码,或在无人注意的情况下中途停止。LoopForge 通过以下方式解决此问题:
- 可重复性 — 每个需求都有相同的 SOP、相同的阶段、相同的检查。
- 分离的角色 — 规划、实现、审查和测试各自拥有自己的提示、执行器、模型、规则和工具。
- 人在环路中 — 在关键位置设置审批门;您可以阅读报告、批准或将工作发送回去。
- 可观察和可恢复 — 节点状态、工具跟踪、日志和工件集中在一处;从任何节点暂停、重试或重新运行。
- 您的技术栈,您的服务器 — CodeBuddy、Codex 或 Claude Code 作为执行器;GitHub、Skills 和 MCP 作为工具;Docker 沙箱或您自己的机器作为运行时。
快速开始
git clone https://github.com/Tencent/LoopForge.git
cd LoopForge
./start.sh
安装程序检查 Docker、Compose、Python 3 和 curl(提供安装缺失组件的选项),拉取预构建的发布镜像,创建 MySQL 和平台服务,生成密钥,并安装内置沙箱、入门 SOP 和欢迎项目。您不需要在主机上安装 Go 或 Node.js。启动后,您配置模型 API 密钥和 GitHub 授权。
服务默认监听 0.0.0.0:8090。创建的第一个账户成为管理员。新账户加入一个演示项目,其中包含仅脚本的 SOP(无需 API 密钥),因此您可以立即试用。
SOP 如何工作
SOP 是交付遵循的工作流。它由以下节点类型组成:
| 节点 | 作用 |
|---|---|
| 代理 | 一个角色(提示、执行器、模型、规则、Skills、MCP 工具),负责设计、实现、审查或测试 |
| 脚本 | 一个确定性的 shell 步骤——构建、测试、lint、生成报告。不需要 AI 的地方不使用 AI |
| 人工门 | 暂停运行,直到有人批准或将工作发送回某个步骤 |
| 子 SOP | 作为子工作流运行另一个 SOP |
| 预览构建 | 构建静态站点并归档以供审查 |
每个节点声明其工件和依赖项;引擎在每个步骤的依赖项完成后启动该步骤。内置 SOP 涵盖后端交付、前端交付、产品提案和 bug 修复——它们是只读蓝图,您可以复制到项目中运行和编辑。
主要功能
- 聊天工作台 — 每个对话的执行器、模型和权限模式;
@引用角色、技能、需求、SOP 和仓库;消息排队和引导;生成的文件在侧面板中打开。 - 对话工作区 — 按需 Docker 沙箱,检出仓库并将项目角色作为子代理;暂停、恢复或接管正在运行的 SOP。
- SOP 设计器 — 可视化画布,包含所有节点类型、失败重做边、验证、版本历史记录和发布。
- 角色 — 在 SOP 节点和聊天子代理之间共享的可重用定义。
- 需求 → 交付 — 端到端跟踪,包含 PR/MR 状态、合并检测和直接分支合并。
- 运行与审批 — 实时节点状态、工具跟踪、工作日志、工件快照和统一的“需要审查”收件箱。
- AI 定时任务 — 定期代理任务,带有共享的版本化模板市场。
- 洞察与成本 — 工程指标、业务领域报告和令牌/成本核算。
- 执行环境 — 平台工作器、Docker 沙箱或连接的本地机器。
- 团队就绪 — 密码账户、项目和成员、浅色/深色主题,以及 OpenAPI 描述的 HTTP 和 MCP API。
LoopForge Local
不想运行服务器?LoopForge Local 将内置的交付工作流带入您已经使用的编码助手:
npx -y loopforge-cli@latest install claude
然后在 Claude Code 中运行 /start-devflow "<您的请求>"。支持的主机包括 Claude Code、CodeBuddy、Codex、Cursor、Pi、DeepSeek Harness 和 Hermes Agent。它需要 Node.js 20+ 和 Python 3.8+。
常见问题解答要点
- 无需 API 密钥即可试用 — 演示 SOP 仅使用脚本和人工门。聊天和代理步骤需要您选择的执行器的密钥。
- GitHub 是可选的 — 聊天、文档和新项目在任务工作区中运行。当您想更改现有代码或打开 PR 时,连接 GitHub。
- 与 Dify/n8n/Flowise 不同 — 那些是通用 AI 工作流构建器;LoopForge 专为使用编码代理的软件交付而构建:实现者/审查者角色、带有真实仓库的 Docker 沙箱、GitHub 交付、人工验收门和运行证据。
- 与直接使用 Claude Code/Codex/CodeBuddy 不同 — LoopForge 编排它们;每个代理步骤运行其中一个 CLI,LoopForge 添加谁做什么、在哪个沙箱中、按什么顺序、使用哪些检查以及谁签署。
许可证
MIT。第三方组件保留其各自的许可证。
相关
- 项目
- 项目
- 项目
- 项目