LoopX 是黄瑞腾开源的一个 loop engineering 状态内核，专门解决 Agent 跑长任务时容易断片和漂移的问题。作者清华 EE 出身，现任职字节跳动 AML 团队，同时也是 OpenViking 的核心贡献者。

首先要明确一点：LoopX 本身不做 Agent 执行器，而是架在这些执行器之上的控制面。它把目标、门禁、待办、证据、配额调度、交接等状态外置出来，让每一轮新的 Agent 调用都能清晰读取当前该做什么、边界在哪、上一轮留下了什么证据。

六大核心状态模块

作者将这套状态体系拆分为六个部分：

• Goal / Vision：目标是什么，哪些决策不能被局部优化牺牲
• Todo / Gate：当前要推进的事项，以及必须留给人判断的关键节点
• Identity / Authority：谁能认领任务、写回状态、批准变更
• Evidence / Receipt：每次推进留下的可回溯证据
• Quota / Scheduler：何时该继续执行，何时该安静等待
• Handoff / Recovery：换模型、换会话、换机器后如何无缝接续

可以理解为一块专为 Agent 设计的可执行看板。普通看板只展示进度，LoopX 的状态会直接约束和驱动下一轮 bounded turn，看板本身成为执行系统的一部分。

为什么需要 LoopX？

长任务最大的痛点就是容易跑偏。当目标变更、用户反馈介入、需要人工决策的节点出现，或多个 Agent 同时操作同一个仓库时，传统方案很难进行有效干预。

LoopX 将这些问题转化为结构化状态：当前目标是什么、谁的判断算数、上一轮做了什么、下一步归人还是归 Agent、哪些操作可自动执行哪些必须等人。结构化的数据才是最稳定的依据，而不是仅靠模型上下文硬凑。

作者在推特分享了两条实测轨迹，分别跑了 220 多小时和 270 多小时，中间经历多轮执行、等待、人工决策和跨会话恢复，状态始终没有丢失。项目仓库中还包含自动修 PR、自我迭代升级、协调多个硬件相关子 Agent 动态工作流等可复现案例。

快速上手

Python 3.11+ 即可运行，不依赖任何第三方库。官方提供了一键安装脚本：

curl -fsSL https://raw.githubusercontent.com/huangruiteng/loopx/main/scripts/install-from-github.sh | bash
export PATH="$HOME/.local/bin:$PATH"
loopx doctor

安装完成后，用 loopx bootstrap 将当前项目接入。日常最常用的命令：

• loopx status：查看当前该谁动手
• loopx history：查看历史执行记录
• loopx quota should-run：判断本轮是否该自动执行

项目还提供了一个可选的本地 dashboard，可以直观查看所有接入项目的目标、待办和证据。

适用场景与局限

用数据状态管理长程任务是一套有效的方法，但受限于当前模型能力，适用场景仍然有限——主要适合批量修 issue、跑实验、盯 CI 等场景。如果指望它独立完成严肃性、长周期的项目，目前并不推荐。Human in the loop 仍然是最可靠的方式。

📦 仓库地址：huangruiteng/loopx