
LoopX 开发者手册导读从控制平面基础到贡献路径一条完整的中英文书目【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopxLoopX 是一个面向长程 Agent 任务的**控制平面Control Plane**开源项目它的开发者手册Developer Book以中英文语义镜像的方式把控制平面基础 → 项目接入 → 开发者贡献 → 工程边界串成一条清晰的学习路径。这篇导读帮你 10 分钟看懂这本中英文书目的全部章节找到适合自己的阅读起点 长程任务中的真实工作轨迹决策、实验、验证与自我修复的闭环一、这本开发者手册解决什么问题普通 Agent 会话擅长在一次上下文内推理和执行但真实开发工作会经历中断、交接、等待 CI、跨会话协作。LoopX 把目标Goal、工作队列Todo、权限Gate/Evidence/Quota和恢复条件放进项目拥有的控制平面让长程任务可审计、可恢复、可交接。docs/book/index.md 明确了这本书的定位它不是 CLI 命令参考也不要求你成为 Kernel 核心贡献者而是给外部开发者一条稳定的路径帮你判断当前任务只需一次普通会话还是需要持久 Goal什么时候需要项目级 Todo、Gate、Evidence、Quota 与恢复合同如何从协议与不变量出发定位贡献 owner、修改实现并组织验证。二、书目结构一览4 部分 1 课程按 mkdocs.zh.yaml 的导航中文版书目组织如下部分章节覆盖内容开始Welcome Wagon、1.0 Workspace、如何使用本书30 分钟从读者到参与者第一部分控制面基础第 1–6 章 状态机专题Session、Goal、Turn、恢复与运行边界第二部分接入现有项目第 7–9 章连接 Git 项目从 Codex App / CLI 启动第三部分开发者贡献第 10–16 章协议地图、规则修改、Extension 生命周期第四部分工程边界第 17 章 附录验证、兼容、安全与术语入口开发者课程Control-Plane Course进入 Kernel / CLI / 调度实现的领读LoopX 管家跨 Goal 的个人控制平面工作区集中展示需要你确认、执行中、观察中与已安排的 Agent 工作三、第一部分控制平面基础第 1–6 章这是全书的地基读完后你会建立完整的控制平面心智模型从一次会话到长程任务——为什么一次 Session 不足以承载跨天任务execution plane 与 control plane 如何分工普通会话、Codex Goal 与 LoopX——三层状态与四类 Actor 的边界持久状态与只读投影——canonical state、event 与 read-only projection工作图、权限与 Peer 协作——Todo 工作图、Gate、claim、lease 与 authority主要状态机与状态流转——把九组状态机连成一张图一轮受治理的工作——Turn 如何决定、执行、验证和写回恢复、自修复与运行边界——retry、replan、self-repair 与 terminal closure。LoopX 1.0 Workspace按 Goal 组织的工作面板展示 Blocked、Queued、Running 与 Completed 的任务流转四、第二部分接入现有项目第 7–9 章这条主线不需要修改 LoopX 源码目标是在自己的仓库里跑通一个可恢复的 Goal连接你的 Git 项目推荐把接入任务直接交给 Agent你负责验收 Goal、identity 与 Git 边界.loopx/、.codex/goals/不进入 Git从 Codex App 启动与从 Codex CLI 启动两条可选的 Host 启动路径。五、第三部分开发者贡献第 10–16 章给 LoopX 做贡献不只等于修改 Kernel也不只等于开发 Extension。贡献地图 给出协议优先的源码入口开发任务 → 贡献结果与 placement → 所属协议族 → 协议拥有的不变量 → bounded context → 当前实现与验证后续章节依次覆盖沿一条协议链定位实现、修改一条 Control-Plane 规则、从聚焦验证到 PR以及 Extension 三件套——选择正确的放置位置、创建 standalone Extension、生命周期与 managed runtime。六、Welcome Wagon4 条路线从读者到参与者 Welcome Wagon 提出先完成一件真实的小事四条路线互不依赖路线时长产物 跑通一次约 15 分钟一个可恢复的 Goal 反馈一次约 10 分钟可行动的公开反馈 贡献一次约 45–60 分钟可审阅的 PR 评审一次约 30 分钟一条推进决策的 review开始前只需只读确认环境loopx --version、node --version、loopx doctor、git status --short --branch。七、中英文版本如何配合中文入口docs/book/index.md英文入口docs/book/en/index.md两个版本是语义镜像章节、行动、命令、链接目标或边界出现实质差异都属于文档缺陷——这本身就是一条低门槛的贡献方向补术语一致性。站点基于 MkDocs Material 生成见 mkdocs.en.yaml。八、版本基线速查发布锚点v1.0.4运行时要求Python 3.11 与 Node.js 22.18.0TypeScript Effect runtime 由 LoopX 自动管理无需手工维护 daemon运行书中命令前先执行loopx --version与loopx doctor版本不一致时以当前发布物的--help为准术语拿不准时随时查阅附录术语与命令入口。结语LoopX 开发者手册的价值不在于读完而在于按图索骥想理解为什么用控制平面读第 1 章想接入自己的项目直接进第二部分想提交第一份贡献从 Welcome Wagon 路线 C 或贡献地图开始。选一条路线留下一个可验证结果再决定是否继续深入 【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考