huangruiteng loopx - 中文翻译

LoopX 面向长期运行的 AI Agent 工作的本地控制平面。在 Codex、Claude Code、Cursor 或您自己的运行时执行有界回合时，保持目标、门禁、待办事项、证据、配额和交接的稳定。公共网站 · 试用 LoopX · 查看真实循环 · 工作原理 · 用户手册 · 简体中文

把会干活的 Agent，接成可管理、可复盘、可持续改进的数字员工。

一个轻量级状态内核和与 Agent 无关的本地控制平面，用于循环工程。LoopX 让长期运行的工作可审查、可重启，并更易于在回合、工具和 Agent 之间交接。它不会取代您的 Agent 运行时。

面向长期运行的 AI Agent 和同级 Agent 团队的循环工程。保持循环运转。保持判断由人掌控。

为什么选择 LoopX

一个 Agent 可以在单次会话中完成一项任务。但长期运行的工作更难：目标会变化、所有者决策会出现、证据会过时、Agent 会将工作移交给同级，而调度器在没有有用进展后仍可能继续消耗资源。仅靠聊天记忆和计时器不足以管理这些。

LoopX 将持久化的控制状态保存在一个紧凑的层中：

objective / issue / project
        │
        ▼
LoopX state: objective + gates + todos + scope + evidence + quota
        │
        ├─ human judgment needed? ── yes ─▶ ask a concrete question and wait
        │
        ├─ safe fallback available? ──────▶ run one bounded agent slice
        │
        ▼
Codex / Claude Code / Cursor / shell agent executes one turn
        │
        ▼
write evidence + handoff + next todo ─▶ quota decides the next tick

一个有用的心智模型是面向长期工作的 Agent 原生看板。卡片承载身份、权限、证据和延续性。移动操作是经过验证的算子，如 claim、gate、monitor 和 writeback。看板只是一个投影；LoopX 状态才是事实来源。

已注册的 Agent 是同级关系。声明（claims）、租约（leases）、任务边界、能力和类型化延续决定谁下一步行动；不需要持久的领导者身份。

LoopX 在以下场景中很有用

运行跨多天的工程、研究、基准测试或实验目标
必须保留范围、证据和审查状态的 issue 和 PR 循环
周期性心跳或监控工作
具有所有者、安全、发布或私有数据门禁的项目
所有权、租约和交接至关重要的同级 Agent 团队
创作者、研究或运营工作流，其进展必须对非工程运营人员保持可读

LoopX 不是自主生产控制器。危险权限、发布、生产写入和最终所有权始终由人类掌控。

证据

这些不是单回合演示。OpenViking Issue-Fix 和 Auto ML 轨迹各自跨越 200+ 小时的循环生命周期，包含许多有界回合、决策和证据更新。生命周期时长是墙钟项目时间，不是 200 小时的连续模型执行，也不代表无人值守的生产自主性声明。打开每个可视化图以检查公共安全图、证据分支和跨回合保留的决策。

开源 Issue 修复

200+ 小时的公共贡献轨迹：PR 交付和可复用的修复知识共同演进。LoopX 的创建者以 OpenViking 贡献者的身份使用此路径。所呈现的公共贡献序列从首次创建 PR 到最新呈现的审查或更新，跨越 200+ 小时的墙钟时间。Issue-Fix 能力将滚动仓库上下文、带修订戳的修复知识和面向审查者的偏好分开保存；关联的 PR 加上当前 checkout 源码和测试仍然是权威来源。

Auto ML 实验

200+ 小时的所有者运行实验轨迹：假设、匹配证据、无效谱系、运行中的重复实验以及 promote/stop 门禁在一个图中保持可见。经过编辑的公共安全图保留了该 200+ 小时窗口内的决策谱系。这是轨迹证据，不是连续计算、独立复现或生产结果的声明。

Auto Research

提议者、执行者和评估/晋升 Agent 并行迭代，同时 todo、配额、证据和定向唤醒保持可见。

更多可检查的界面：

公共主页：产品叙事、快速入门和长期运行证据
展示目录：包括受阻 P0 安全轮换、LoopX 自我迭代和动态工作流编排
跨运行时实现审查演示
公共用户手册

试用 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

如果项目尚未初始化且 connect 提示状态缺失，请使用引导路径：

loopx start-goal --guided --project . --goal-text "Your long-running objective"

LoopX 应复用现有状态而不是覆盖它。请保持 .loopx/、.codex/goals/ 和 .local/ 被忽略。

从您的 Agent 宿主开始

| 推荐起始方式 | Loop 驱动 | |---|---| | Codex App | 让 Agent 将此项目连接到 LoopX，运行 loopx doctor，保留现有状态，并报告当前门禁和下一个待办事项。然后使用 $loopx 或从 /skills 中选择 loopx。 | | Codex App 心跳自动化 | 从配额 should-run.scheduler_hint 刷新 | | Codex App over SSH | loopx agent-onboard --agent-type codex-app-ssh --project . 返回可见的 /goal | | Codex CLI | 在项目中启动 codex，让它连接并诊断 LoopX，然后使用 $loopx 或 /skills。可见的 /goal ；默认无隐藏的无头执行 | | Claude Code | 安装可选适配器，然后运行 /loopx 后跟 /loop。原生 Claude Code /loop 由 LoopX 门禁控制 | | OpenCode | 安装静态命令门面；选择 --with-goal-bridge 以支持循环目标。OpenCode 命令门面和显式目标桥 | | Cursor、shell 或自定义运行器 | 使用安装程序并运行 loopx doct |