LoopX 发布流程揭秘：能力使用门槛与发布就绪检查清单
【免费下载链接】loopxLong-horizon agent control plane for durable, governed work across Codex, Claude Code, and other harnesses.项目地址: https://gitcode.com/GitHub_Trending/lo/loopx
LoopX 是一个面向 Codex、Claude Code 等 Agent 运行框架（harness）的长时程（long-horizon）Agent 控制平面。这篇文章揭秘它的发布流程：一项"能力（capability）"要跨越哪些使用门槛才能交付给新手，以及每个版本发布前必须通过的发布就绪检查清单。
为什么 LoopX 需要一道"发布门槛"？
LoopX 的日常工作是让 Agent 持续执行目标：跑基准测试、修 issue、写周报、管理配额……这些动作横跨多个 harness，风险天然更高。所以它的设计原则是：目录存在 ≠ 功能可用，代码合入 ≠ 版本可发布。
这对普通用户意味着一件事：你装回来的每个版本，其能力边界都是被验证过的，而不是"理论上应该能工作"。
能力使用门槛：三道关卡才能"出厂"
在 loopx/capabilities/ 目录下，每个内置能力（如 issue-fix、explore、periodic-report）都遵循同一套门槛。根据 loopx/capabilities/README.md 的定义，一项能力要成为"随版本发布的产品能力"，必须同时满足：
- 注册元数据：每个能力包内含一个
catalog_entry.py，声明稳定 id、命令、provider 边界、文档来源和校验方式；根目录的 loopx/capabilities/catalog.py 只负责组合这些包级条目，不维护第二份映射表。 - 真实入口：必须能通过 CLI 实际调用，而不是只有文档。
- 持久化校验：有可重复执行的 smoke 测试兜底，保证能力行为稳定。
新手自检命令（这是判断"当前版本到底能做什么"的权威来源）：
loopx capability list --format json # 列出已注册能力及 provider 就绪状态 loopx capability show issue-fix --format json # 查看单项能力的成熟度、写入边界show会返回用户价值、成熟度、入口命令、显式写入边界和持久化校验信息——在启用任何高级路径或可选 provider 之前，先读这个回执。
💡 简单类比：能力像 App 商店的应用——光有源码仓库不算上架，必须通过审核（注册+入口+校验）才能出现在你的设备里。
发布就绪检查清单：一个版本如何"过安检"
版本从"能跑"到"敢发布"，LoopX 用一条证据链把关，核心由三个模块支撑：
1️⃣ 金丝雀晋升就绪（Promotion Readiness）
loopx/promotion_gate.py 负责把一次"发布就绪证据"追加到运行时台账。执行入口是 examples/canary/canary-promotion-readiness-smoke.py，它在不改动已安装发布版本的前提下，预检四件事：
- ✅公共边界契约：扫描仓库，确认没有敏感内容泄露到公共投影；
- ✅状态投影：status markdown、用量/事件/决策投影都能正常渲染；
- ✅安装器包装：release/canary 两个安装包装器行为正确；
- ✅Dashboard 演示就绪：演示路径可正常走通。
全部通过后，会向运行时发布台账追加一条promotion_readiness_event_v1证据记录，供 status、doctor、quota 守护组件清除"就绪证据过期"告警。
2️⃣ 发布候选体检（Release Candidate）
loopx/release_candidate.py 对发布包做"上膛检查"：
- 逐个导入代表性 CLI 模块（
loopx.cli、loopx.quota、loopx.status等），任何一个导入失败都会记录具体异常； - 实际执行代表性命令（
version、commands --format json、各命令--help），确认分发路径完整可用。
3️⃣ 精确提交资格回执（Release Qualification）
loopx/cli_commands/canary_release_qualification.py 中的canary release-qualification子命令会校验一份exact_release_commit_qualification_manifest_v0清单，要求干净检出的 HEAD、tree、包版本与 tag与每一份回执精确匹配，覆盖五类回执：
| 回执类型 | 校验内容 |
|---|---|
| 确定性（deterministic） | 相同提交跑两次结果一致 |
| 金丝雀（canary） | 小流量冒烟路径通过 |
| 全量公共（full-public） | 公共安全扫描无越界 |
| 安装（install） | 安装流程可复现 |
| 实时模型（live-model） | 真实模型调用链路可用 |
关键设计：只验证、不执行、不发布——它是一道纯安检门，不会替你按下发布按钮。
4️⃣ 发布清单哈希（Release Manifest）
loopx/release_manifest.py 生成release.json清单：版本 tag 统一加v前缀，对发布目录做逐文件 SHA-256 哈希树，确保你下载到的每个字节都可复核。
新手上手：如何看懂自己手里的版本
不用读源码，三步即可确认当前发布状态：
loopx capability list --format json—— 这个版本实际提供了哪些能力；loopx doctor—— 安装新鲜度、就绪证据是否完整；- 查看运行时台账中的 promotion-readiness 事件 —— 最近一次发布就绪检查的结论。
总结
LoopX 的发布哲学可以浓缩为一句话：能力靠三道门槛出厂，版本靠四份回执过安检。能力注册元数据、真实入口、持久化校验构成使用侧门槛；金丝雀晋升就绪、候选体检、精确提交资格、清单哈希构成发布侧清单。对新手来说，记住loopx capability list / show这条"权威读回"命令，就掌握了判断一切能力可用性的钥匙。
想深入了解能力与扩展的边界划分，可以继续阅读 docs/reference/extensions.md 和 docs/guides/getting-started.md。
【免费下载链接】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），仅供参考
