编程 agent 接进交付流程之后,真正难的问题往往不是模型不够强,而是没人说得清:谁在什么时候必须签字。Tencent/LoopForge 把这个问题的答案做成了一道审批门:AI 的提交不能直接落地,先停在 Human gate 上,等人核对 artifacts,点下批准,或者被打回某一步重做。仓库地址是 https://github.com/Tencent/LoopForge,也可以从 Tencent/LoopForge 进入,主语言 Go,截至 2026 年 11 月 16 日 GitHub API 抓到 1610 stars、282 forks;仓库创建于 2026 年 7 月下旬,近期进入密集发版,Release 页上 v0.3.9-rc.1(2026-11-13)与 v0.3.8(2026-11-12)前后脚出现。官方对它的定位逐字是:"Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates." 一句话概括:它不承诺更强的模型,它给的是一套自托管的交付流水线,把「谁在什么时候必须签字」写进流程本身。本篇只写官方 README、docs 与 LICENSE 里可核的内容;官方没给的性能基准、团队规模上限、安全审计报告,一个都不替它补,所有命令与文件名都能回指到官方原文。
先把两种工作法分开。装好之后可以走 Chat with Main Bot:在对话工作区里让各角色作为 subagent 听候调遣,沙箱由 Docker 提供,适合人随时盯着推进的活。也可以走 Run an SOP:由引擎按节点顺序,把一条交付流程在各自的沙箱里跑完,检查点与签字点预先写进流程,人只在规定的位置出现。两条路径跟踪同一份 requirements,最后都汇入交付与成本报表,所以选哪条不是立场问题,而是这次交付要不要留固定签字点的问题。报表口径一致还意味着工作方式可以渐进:先在对话里把一个想法试跑顺,再把它固化成 SOP 交给引擎,而不是两条路各记一本账、互相看不到对方干了什么。本篇的重心放在后者,因为审批门只有在流程化之后才成其为门。
五类节点,逐类拆开
LoopForge 的 SOP 由五类节点组成,官方逐字表照抄如下,一类一类看。读这张表的建议顺序是先看 Script 与 Human gate,再看 Agent:前两类节点决定了这条流水线的性格,Script 节点多的流程把确定性工作交还给 shell,AI 只出现在真正需要判断的位置;Human gate 多的流程签字点就密,交付节奏慢,但每一步落地前都有人对过。节点密度是部署者自己设计的,LoopForge 提供的是这五种积木,不替你决定密到什么程度。
Agent,官方原话 "A role (prompt, executor, model, rules, Skills and MCP tools) that designs, implements, reviews or tests.":一个角色由 prompt、executor、model、rules、Skills 与 MCP 工具组成,负责设计、实现、评审或测试其中一类工作。
Script,官方原话 "A deterministic shell step: build, test, lint, generate a report. No AI where AI is not needed.":确定性的 shell 步骤,做构建、测试、lint、生成报告。后半句值得单独抄一遍:No AI where AI is not needed,不需要 AI 的地方就不用 AI。五类节点里唯一一条直接写价值观的话出现在这里,不是偶然。
Human gate,官方原话 "Pauses the run until someone checks the artifacts and approves, or sends the work back to a step.":整条流水线在这里暂停,等人检查 artifacts 之后批准,或者把工作退回某个步骤。这是本篇的题眼,AI 的提交就卡在这一类节点上。
Sub-SOP,官方原话 "Runs another SOP as a sub-workflow.":把另一条 SOP 当子工作流来跑,长流程可以拆层。
Preview build,官方原话 "Builds a static site and archives it for review.":构建静态站点并归档,供人评审时点开看。
引擎的调度规则官方原话是 "Each node declares its artifacts and dependencies, and the engine starts each step once its dependencies complete.":每个节点声明自己的 artifacts 与 dependencies,依赖全部完成,引擎才启动该步。SOP 设计器还支持 rework-on-failure 连线,失败检查可以把工作退回更早的步骤重做,而不是停在原地报错等人工救场。把五类节点看全会发现,这套结构里没有任何一个节点叫「智能体自动完成一切」;恰恰相反,Script 把能不用 AI 的地方明确圈了出来,Human gate 把必须有人签字的地方明确卡了下来。
角色分离与十个 CLI
写代码的 agent 不审自己的代码,这条原则在 LoopForge 里是结构性的,不靠自觉。官方逐字:"Planning, implementation, review and testing each get their own prompt, executor, model, rules, Skills and MCP tools." 规划、实现、评审、测试各自拿到独立的 prompt、executor、model、rules、Skills 与 MCP 工具,评审角色与实现角色默认就不是同一份配置;想用一个 agent 既写又审,得自己显式去改,而不是默认就发生。
executor 的可选面是一份十个 CLI 的清单,官方逐字:"CodeBuddy, Codex, Claude Code, OpenCode, Cursor CLI, Antigravity, Kimi Code, Pi, DeepSeek Harness and ZCode." 每个 SOP 角色可以独立选 executor,内置角色默认 CodeBuddy。安装方式官方分了档:CodeBuddy、DeepSeek Harness 镜像内置;Claude Code、OpenCode、Kimi Code、Pi 首次使用时从 npm 安装并缓存;Cursor CLI 与 Antigravity 由 provider 安装器在首次聊天时装,不进 SOP 沙箱;ZCode 不捆绑,装在服务或执行机的 PATH 里。凭据隔离官方逐字:"The seven agent CLIs after Claude Code keep their model and MCP configuration in a private home directory per run, so they always use the responsible user's own key and Base URL from personal settings." Claude Code 之后的七个 agent CLI,每次运行都把模型与 MCP 配置放进各自的 private home directory,用的始终是责任人自己的 key 与 Base URL,团队铺开时每个成员配自己的凭据。另有两条固定规则:需求澄清、AI 通知摘要、Bot 回复与 run 评估当前固定用 CodeBuddy,服务端对其他 CLI 的模型是拒绝而不是自动切换。
官方 recorded run:一次真实交付
README 里给出了一次完整走查,先标明这是官方自报的记录,不是第三方实测。原话逐字:"A delivery we actually ran: four CodeBuddy roles planned a Python fix, implemented it, reviewed it independently and summarized the delivery. Three real tests passed; the run waited for human approval, then verified the accepted code had not changed." 拆开看:四个 CodeBuddy 角色规划了一个 Python 修复,实现它,独立评审它,最后总结交付;三个真实测试通过;run 停下来等人工批准;批准之后再复验一次,确认被接受的代码没有变。最后这一步最值得注意——批准之后还要验证代码未变,说明「人批的东西」和「实际落地的东西」要靠引擎对上号,而不是靠信任。官方同时给了可复验件:e2e/api/45-delivery-model.test.mjs,范围与已知缺口写在 docs/validation.md。对一个自托管工具来说,能给你一个测试文件自己去跑一遍,比任何宣传语都实在。
从零部署:七步走完
部署路径官方写得相当完整,按顺序走,每一步都能对应到官方原文。
- 拉仓库:
git clone https://github.com/Tencent/LoopForge.git,然后cd LoopForge。 - 起服务:运行
./start.sh。官方说明它会拉取 compose.yaml 里 pinned 的 GHCR 镜像而不做本地构建,创建 MySQL 与平台服务,生成配置与会话 secrets,装好内置沙箱、starter SOPs 与欢迎项目;宿主机不需要安装 Go 与 Node.js。安装器会检查 Docker、Compose、Python 3 与 curl,缺什么提示装什么,Compose 插件会校验官方发布 SHA-256;想跳过交互确认,设LOOPFORGE_YES=1。后续管理用./start.sh logs、stop、restart、pull,改源码开发走./start.sh dev。 - 建管理员:服务默认监听 0.0.0.0:8090,第一个注册的账号就是管理员。云主机场景下安装器会从厂商元数据服务读公网 IP;管理员账号建好之前,官方建议只放行自己的 IP。
- 试 demo:没有 API key 也能跑。demo 项目里有一条「Platform check · script & approval」SOP,只有 script 与 human gate 两类节点,正好把本篇的主题完整走一遍。
- 配凭据:真实交付要在平台设置里给各 CLI 配好个人 key 与 Base URL,按上一节的凭据隔离规则,各角色各用各的。
- 接 GitHub:接入是可选的,内置 OAuth App 设备码授权,不需要手动建 PAT,手动 PAT 仍然支持;GitLab、Gitea、Gogs 走 Git SSH。
- 跑第一条 SOP:内置 backend、frontend、bug-fix、product 四类 SOP,官方原话 "Start from built-in backend, frontend, bug-fix and product SOPs.",它们是只读蓝图,拷进自己的项目才能跑与改。
安全边界:官方原话逐条看
这一节是本篇的重点。每一条都是官方原话,不做吓唬式渲染,也不做淡化,读完自己划线。
第一条,沙箱的起点是宿主的 Docker socket。官方逐字:"In the default Compose installation, SOP runs and conversation workspaces both use Docker sandbox containers started through the host Docker socket." 默认 Compose 安装下,SOP 运行与会话工作区都通过宿主 Docker socket 起沙箱容器。紧接着是官方自己给的边界判定:"Docker socket access grants control of the host daemon, so this setup is for trusted teams, not untrusted multi-tenant isolation." Docker socket 访问等于控制宿主 daemon,所以这套设计面向 trusted teams,不是不可信多租户隔离。想拿它做对外多租户服务,官方明确说了不适用,这条线不要自己往宽了读。
第二条,新装实例监听全网卡,实例内数据对登录用户互见。官方逐字:"New installations listen on all interfaces (existing bind settings are kept) and are designed for a trusted team: signed-in users can read project data across the instance, and teammates can sign up from the login page (AGENTFLOW_ALLOW_SIGNUP=false in .env turns that off)." 新装监听所有网卡,登录用户可以读本实例内跨项目的数据,登录页允许队友自行注册;不想要开放注册,把 .env 里的 AGENTFLOW_ALLOW_SIGNUP=false 打开即可。官方 FAQ 里把同一件事又说了一遍:"Read the account and access model and set up HTTPS before opening it up." 公开给更多人用之前,先读 account and access model 文档并配好 HTTPS。
第三条,漏洞报告走 SECURITY.md 的私密渠道,不要开公开 issue 张扬。
四条合起来读,结论不是「绝对安全」也不是「不能用」,而是官方自己划的那条线:这是一套面向互相信任团队的自托管工具,网络暴露面、账号注册、HTTPS 收口,都是部署者自己的责任清单。如果你的团队连内部都谈不上互相信任,需要的不是调几个开关,而是另一类产品形态;官方把账号与访问的设计写进了 account and access model 文档,部署前把它读完,比读任何二手解读都有用。
MIRROR 与 digest 校验
网络环境拉 GHCR 镜像经常要走镜像站,LoopForge 给了 MIRROR 机制,但把信任问题摆在明面上。官方逐字:"Setting MIRROR trusts that host, because the download is tagged with the official name." 设置 MIRROR 就是信任那台主机,因为下载下来的镜像会被打回官方名字。所以官方同时给了校验办法:GitHub Release 页记录 digest,用下面这条命令核对 @ 之后的摘要是否一致。
docker image inspect --format '{{index .RepoDigests 0}}' ghcr.io/tencent/loopforge:<pin>示例用法是 MIRROR=ghcr.nju.edu.cn ./start.sh。另外注意区分两件事:Docker 自己的 registry-mirrors 配置(如 docker.nju.edu.cn)只加速 Docker Hub,不能当 LoopForge 的 MIRROR 用,名字像,作用对象不同。
许可证:三处并存,如实三值
许可证这件事,LoopForge 呈现出三种读法,本篇三种都写,不挑一种下结论。第一处,README 的徽章与 License 节标 MIT,License 节原话:"MIT. Third-party components keep their own licenses and notices; see THIRD_PARTY_NOTICES.md." 第二处,LICENSE 文件本身是腾讯开源声明体,开头逐字:"Tencent is pleased to support the open source community by making LoopForge available. Copyright (C) 2026 Tencent. All rights reserved. LoopForge is licensed under MIT, except for the third-party components." 即按 MIT 授权、第三方组件保留各自许可。第三处,GitHub API 的自动检测因为声明体带有附加条款,给出 NOASSERTION。三处并存如实写完即可:既不必只说 MIT 一个值,也不必把 NOASSERTION 引申成「不是开源」,第三方组件的许可细目以 THIRD_PARTY_NOTICES.md 为准。另一个实用提醒:引用许可证时别只截徽章那一半,第三方组件的许可可能与主仓库不同,细目文件才是落点;媒体口径与这三处的差异,一律以仓库文件原文为准。
LoopForge Local:本地形态
除了自托管平台,还有一条本地路线:LoopForge Local。装法是 npx -y loopforge-cli@latest install claude,之后在 Claude Code 里跑 /start-devflow "<request>"。支持矩阵按官方表格:Claude Code、CodeBuddy、Codex、Cursor 四个有 Classic 与 Portable 双版本,Pi、DeepSeek Harness、Hermes Agent 有 Portable 版本。环境要求 Node.js 20+ 与 Python 3.8+,外加一个编码助手;证据落在本地的 artifacts/{task_slug}/ 目录。Local 与平台的关系,是同一套节点词汇在两个规模上的应用:平台把流水线跑在服务端的沙箱里,Local 把流程跑在你自己的编码助手会话里,证据目录的结构保持一致。官方把「导出平台 SOP 供本地独立执行」标为 planned,尚未发布,本篇按未公布不编处理,等官方落地再补。
常见问题
Q1:LoopForge 会替我选最强的模型吗? A1:不会。它的定位不是提供更强的模型,而是编排:CodeBuddy 到 ZCode 共十个 CLI 都是可选 executor,每个 SOP 角色独立选择,内置角色默认 CodeBuddy。它管的是谁做什么、在哪个沙箱、按什么顺序、过哪些检查、谁来签字。
Q2:没有 API key 能不能先体验? A2:可以。demo 项目里的「Platform check · script & approval」SOP 只含 script 与 human gate 两类节点,不需要任何模型 key 就能在部署完成后跑通,正好用来观察审批门的暂停、批准与退回行为。
Q3:部署前最需要注意什么安全问题? A3:三件事。默认安装经宿主 Docker socket 起沙箱,Docker socket 访问等于控制 host daemon,只适合 trusted teams;新装监听 0.0.0.0:8090 所有网卡,登录用户可读实例内全部项目数据;登录页默认可自行注册,用 .env 里 AGENTFLOW_ALLOW_SIGNUP=false 关闭,公开前先读 account and access model 并配好 HTTPS。
Q4:走镜像站拉镜像安全吗? A4:官方把话说得很直白:设置 MIRROR 就等于信任那台主机,因为镜像会被打回官方名字。要用镜像站,就同时用 GitHub Release 记录的 digest 核对,docker image inspect 输出中 @ 之后的摘要与 Release 页一致才算数。
Q5:LoopForge 是 MIT 许可证吗? A5:要分三处看。README 徽章与 License 节标 MIT;LICENSE 文件是声明体,写明按 MIT 授权但第三方组件保留各自许可;GitHub API 自动检测结果为 NOASSERTION。三个值并存是事实本身,第三方细目见 THIRD_PARTY_NOTICES.md。
延伸阅读
- AgentCore 会话与 SOP 视角:另一条把 agent 流程做成长期会话的路线,与本篇的自托管流水线互为参照。
- coding agent 接入边界:讨论 coding agent 的访问与边界问题,可补足本篇未展开的平台侧视角。
- Copilot 模型弃用迁移 SOP:同为照做清单式 SOP,处理的是模型下线后的迁移动作。
- Univer 办公套件开源解读:另一篇开源项目解读,对象是办公文档场景的 agent 编辑。