LoopX Book Labs

这是 LoopX Book 的可运行练习仓库。

当前包含三个可运行 Lab：

Lab	目标
project-onboarding	在可重置 Git 项目中验证 LoopX 连接与本地状态隔离
issue-to-pr	从 prior-work preflight 走到失败复现、issue branch、修复验证与 PR-ready evidence
standalone-extension	从官方 scaffold 构建 deterministic、zero-permission Extension

快速验证

要求：

• Python 3.11+；
• Git；
• 已安装 LoopX；
• 可选：jsonschema 与 pytest，用于 Extension tests。

创建虚拟环境并运行全部 smoke：

python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install -e './standalone-extension[test]'
./scripts/smoke.sh

如果只想体验 Issue-to-PR 主案例：

./issue-to-pr/smoke.sh

该 smoke 使用离线 GitHub provider fixture 和 LoopX 0.4.0 的真实 Issue-Fix 命令， 不会创建 Issue、PR 或其他外部写入。真实 GitHub sandbox 是 Lab 中单独标注的 opt-in 步骤。

验证 managed runtime：

. .venv/bin/activate

loopx extension install \
  --manifest standalone-extension/extension.toml \
  --execute \
  --format json

loopx extension run loopx-text-stats \
  --input-json standalone-extension/examples/request.json \
  --execute \
  --format json

extension install 只注册同一 Python 环境中已安装的 entrypoint，不负责下载或构建 package。

仓库边界

本仓库不提交：

• .loopx/ 与 .codex/goals/；
• 本机绝对路径；
• 凭据或 provider private config；
• raw Agent transcript、trajectory 或 verifier output；
• 真实项目的私有状态。