LoopX：长时运行 AI 智能体工作本地控制平面，带来多方面功能与应用可能
LoopX：核心介绍
LoopX 是用于长时运行 AI 智能体工作的本地控制平面。当 Codex、Claude Code、Cursor 或用户自己的运行时执行有限轮次的操作时，它能确保目标、关卡、待办事项、证据、配额和交接过程保持稳定。LoopX 能将具备执行能力的智能体连接成可管理、可复盘、可持续改进的数字员工。它是轻量级的状态内核和与智能体无关的本地控制平面，适用于循环工程，可让长时运行的工作具备可审查性、可重启性，且更易于在不同轮次、工具和智能体之间进行交接，但不会取代智能体运行时。LoopX 主要用于长时运行的 AI 智能体和对等智能体团队的循环工程，确保循环持续推进，同时保留人工判断环节。
选择 LoopX 的原因
单个会话中，智能体可完成一项任务，但长时运行的工作更具挑战性，目标会变化，所有者会决策，证据会过时，智能体需交接工作，且调度程序可能持续消耗资源，仅靠聊天记忆和计时器无法有效管理。LoopX 将持久的控制状态整合在紧凑层面：目标 / 问题 / 项目，经 LoopX 状态（目标 + 关卡 + 待办事项 + 范围 + 证据 + 配额），判断是否需人工判断、是否有安全回退方案，再由 Codex 等智能体执行一轮操作，最后记录证据、交接和确定下一个待办事项，由配额决定下一次执行时机。可将 LoopX 看作适用于长时运行工作的原生智能体看板，看板卡片含身份、权限等信息，移动操作通过验证的操作符实现，LoopX 状态是真实数据来源。已注册的智能体互为对等关系，认领、租赁等信息决定下一个执行的智能体，无需持久领导者身份。LoopX 在持续数天的工程等工作中非常有用，但它并非自主生产控制器，危险权限等仍由人工掌握。
实际案例展示
OpenViking 问题修复和自动机器学习（Auto ML）轨迹各自跨越 200 多个小时的循环生命周期，涵盖多个有界轮次、决策和证据更新，这里的生命周期指项目实际花费时间，并非连续 200 小时的模型执行时间，也不意味着可无人值守自主生产。
开源问题修复
超过 200 小时的公共贡献过程，PR 交付和可复用的修复知识共同发展。LoopX 创建者以 OpenViking 贡献者身份采用此流程，从首次创建 PR 到最新审查或更新，公共贡献序列历时超 200 小时。问题修复功能分开管理仓库上下文等，关联的 PR 等仍具权威性。
自动机器学习实验
超过 200 小时的所有者运行实验过程，假设、证据等能在一个图表中清晰可见，编辑的公共安全图保留 200 多个小时内的决策谱系，这是实验轨迹的证据，并非连续计算等结果的声明。
自动研究
提议者、执行者和评估者 / 推广者智能体可并行迭代，待办事项等信息保持可见。更多可查看产品介绍等内容。
试用 LoopX 的要求与步骤
要求
需 Python 3.11 及以上版本、curl、tar、macOS 或 Linux shell。若进行贡献者克隆 / 预发布测试工作流，还需 Git。Python 包除标准库外无其他运行时依赖。
安装（无需克隆）
通过命令 curl -fsSL https://raw.githubusercontent.com/huangruiteng/loopx/main/scripts/install - from - github.sh | bash 安装，再执行 export PATH="$HOME/.local/bin:$PATH" 和 loopx doctor。
从项目根目录连接
使用命令 cd /path/to/your - project、loopx connect 和 loopx status。若项目未初始化且连接时提示缺少状态信息，可使用引导式路径 loopx start - goal --guided --project . --goal - text "Your long - running objective"。LoopX 会重用现有状态，需将 `.loopx/`、`.codex/goals/` 和 `.local/` 添加到忽略列表中。
从智能体主机启动
推荐启动方式有：Loop 驱动程序（Codex App），要求智能体连接到 LoopX，运行 loopx doctor 等；Codex CLI，在项目中启动并连接诊断 LoopX；Claude Code，安装可选适配器后运行相关命令；OpenCode，安装静态命令门面；Cursor 等，使用安装程序和 loopx doctor 并手动连接或调用 LoopX。具体设置消息和主机恢复路径可参考《入门指南》，主机集成可查看相关合约。核心操作步骤包括 loopx quota should - run 等，成功连接标志有 loopx doctor 通过检查等。基于克隆的安装方式仅适用于希望使用实时预发布包装器的贡献者。
功能特性解析
LoopX 将控制平面机制归纳为五个问题，包括目标是什么、接下来会发生什么等，对应保持可见不同信息。
控制平面界面
包括目标状态和状态跟踪，可使用 loopx status 等命令；配额和交互合约，可使用 loopx quota should - run 等命令；智能体运行时桥接，可使用 loopx heartbeat - prompt 等命令；操作界面，可使用 loopx serve - status 等命令；外部投影，可使用 loopx lark - kanban 等命令；领域功能，可使用 loopx issue - fix 等命令；实验性上下文学习，可使用 loopx reward - memory experiment - status 等命令；治理模式，捕获可复用的模式。LoopX 提供生命周期目标等基本功能。
运行时职责
智能体通过主机 / 运行时进行规划等操作；供应商调用外部系统并返回信息；能力模块定义结果等；内核管理持久的待办事项等。执行路径为智能体 -> 能力模块 -> 供应商；控制路径为供应商回读信息 -> 能力模块过渡 -> 内核。扩展是可选供应商的打包和管理方式，具体可参考《架构与扩展及功能》文档。
高级路径说明
首个有效循环无需启用所有可选界面，仅在工作需要时添加。启用高级路径前，可检查当前目标的只读功能目录。
预设和自动研究
安全预设涵盖日常分类等，一键式研究路径可协调角色，同时保持配额和证据可见，可参考相关文档，预设检查是只读操作，可使用命令报告循环是否准备好重复运行。
受控轮次
LoopX 可根据相关信息生成有界轮次决策，当前 Codex CLI 的快速入门和激活合约记录在《LoopX 轮次：Codex CLI》文档中。
探索图和控制
探索功能可选且默认关闭，在任务有可衡量条件时效果最佳，但不能替代生产审批，可从探索功能及其 Lark 展示映射开始使用。
审查智能体工作
使用 loopx review - packet 可获得紧凑视图，智能管理界面描述操作模型，项目级奖励模型描述价值信号，具体对等工作流可参考跨运行时实现审查演示。
应用和投影路径列举
包括本地先读式 UI、公共产品概述、文档门户、飞书 / Lark 投影、通用主机集成、自定义多智能体运行器等，可选投影可使状态更易查看，但不是真实数据来源。
操作和恢复要点
每日检查可从 loopx status 等命令开始，自动轮次需检查配额，静默跳过等不消耗配额，用户关卡阻塞时安全回退方案可继续执行但不能绕过关卡，对等智能体交付前后使用相关命令确保信息可见，调度程序节奏遵循相关规则。发布公共文档或示例前，需运行 loopx check 命令进行检查。碰撞恢复等记录在相关文档中。
高级文档指引
根据角色选择合适文档路径，使用托管文档门户访问已发布文档站点，文档索引是完整信息来源。
使用和操作
包括《入门指南》《用户手册》等文档。
理解控制平面架构
涉及生命周期目标不变性和内核。
状态交互模型
包括参与者、存储、交互合约和回写。
交互模式目录
可复用的路由、关卡等模式。
循环工程原则和陷阱（中文版）
包括《控制平面开发者课程》《产品愿景》等文档。
集成和扩展
包括《集成指南》等文档。
验证和治理
包括《配额分配》等文档。
作者和贡献者相关信息
涉及《项目历史》等文档。LoopX 处于早期阶段，最有价值的反馈来自实际长时运行智能体项目，可使用 GitHub Issues 报告问题，对于文档修复等可提交开放 PR，中文用户和贡献者可加入 Lark 开发者群组或微信群。外部贡献者可从《贡献者任务》开始参与工作，参考《贡献指南》，项目角色和公共历史记录在相关文档中，LoopX 分开管理本地活动状态与公共仓库，请勿提交相关文件。
当前状态与未来展望
v0.4.x 版本是早期但可用的长时运行智能体工作本地控制平面，不是完整的智能体平台等。目前提供持久状态内核等功能，在此基础上实现引导式启动等。支持级别明确，状态和 CLI 合约稳定，多个主机集成和高级路径可选、默认关闭或实验性。LoopX 不会授予凭证等。未来里程碑包括更简单的安装和主机打包等。LoopX 采用 MIT 许可证。LoopX 能否在未来更好地满足长时运行 AI 智能体工作的需求呢？