面向外部开发者的 LoopX 中英双语教程。
本书先用六章建立长程 Agent 控制面的基础模型，再提供两条实践主线：
- 让 Agent 把已有 Git 项目安全接入 LoopX，并由读者验收结果；
- 给 LoopX 做开发者贡献，包括 Control Plane、Capability、Provider、Host/Runner、 Projection/Docs/fixtures，以及 Extension。
正文使用 Markdown，由 VitePress 构建，并发布到 GitHub Pages。
npm install
npm run docs:dev构建静态站点：
npm run docs:build验证中英文全部章节的正文、全书侧栏、本页目录挂载点和前后翻页：
npm run check:publication再用本机 Chrome 或 Chromium 启动一个全新的 preview，抽查中英文首章、中间章和末章在 hydration 后的页内目录、侧栏、翻页、同页语言切换、本地搜索入口与关键 Markdown 渲染：
npm run check:publication:browser两项出版检查都读取 .vitepress/dist，因此应在构建后运行。浏览器检查会自动寻找常见的
Chrome/Chromium 路径；非标准安装可通过 CHROME_PATH 指定。GitHub Pages workflow 会在上传
站点前依次执行构建、静态检查和浏览器检查。
- 本书拥有学习路径、概念解释和任务导向教程；
- 书内示例以当前官方 scaffold 和公开协议为基线，不依赖单独的配套练习仓库；
- LoopX 官方仓库 拥有 CLI、协议、源码和版本化行为。
当前内容以 LoopX GitHub release v0.4.1 为发布锚点；本地命令示例已在 loopx 0.4.0
CLI 表面核对。发布标签、已安装 CLI 与源码 checkout 可能处于不同 revision，运行前应读取
loopx --version、当前 --help 和官方 release notes。命令与产品行为发生冲突时，以实际使用的
LoopX 发布物和官方文档为准。
中文根路径是编辑事实源；英文版共享相同的章节结构、命令与产品合同，但按英语读者的任务重新 组织表达，不维护第二套产品规范。