Engine 能力与版本边界¶
本章面向 Engine 管理员和需要确认能力边界的高级用户。Studio 自己不计算这些物理量；它要求 Engine 公布并满足精确能力，再验证取回的产物。
当前路线总表¶
| Studio–Engine 路线 | 用户功能 | 项目 | 执行方式 | 当前状态/边界 |
|---|---|---|---|---|
| v0.1 | 4D Twiss 光学 | v0.1 | 交互式一次性 | 可运行，SCREENING |
| v0.1 | 通用 CPU tracking | v0.1 | 持久任务 | 可运行，最多 50M particle-turns |
| v0.2 | supplied-slice radiation–RF equilibrium | v0.2 | 一次性 | 可运行，result/0.1 |
| v0.3 | lattice-derived slices + equilibrium | v0.2 | 一次性 | 可运行，8/32/128 收敛，result/0.2 |
| v0.4 | matched distribution | v0.2 + 合格 equilibrium/0.2 | 一次性 | 128–8192 粒子；linear/planar/uncoupled |
| v0.5 | local momentum acceptance | v0.2 + 合格 equilibrium/0.2 | 一次性，≤1800 s | 稀疏孔径、非寿命 |
| v0.6 | Touschek | v0.2 | 历史持久任务 | 公式错误；禁止新提交，仅恢复历史证据 |
| v0.7 | corrected Touschek | v0.2 + beam/equilibrium gates | 持久任务 | 可运行；screening lifetime，不是总寿命 |
| v0.8 | exact-lattice DA/FMA | v0.2 | 持久任务 | 可运行；CPU fixed-δ 4D finite-turn |
| v0.9 | orbit error/correction | v0.2 + reviewed profile | 持久任务 | 可运行；planar reference-δ ideal model |
“一次性”表示客户端进程中断后没有 durable reconnect/cancel 语义；“持久”表示远端任务在 Studio 退出后可继续，并保存恢复身份。
已接受 Engine 来源¶
这些 identity 用于部署审核，不是普通用户要输入到项目里的值：
| 路线 | 已接受/要求的 Engine source |
|---|---|
| v0.1 | e50a6e6952cbb85fd1e3a831e4b5b2010b9b6bd9 |
| v0.2 | dc9860b43cc9a2d929e0568df814f28d733270bc |
| v0.3 | fdab5539893d66bf37bf05fb4ab246ecab1476b7 |
| v0.4 / v0.5 | f4189eba95469be1e286d6169e2781376c4e58c8 |
| v0.6 历史 | 5063daaa2ac6501645742c6997fc72d46679aabb |
| v0.7 | 79fad5d1bb3d2f3b3b9be417d6eb23a6bb1332a9 |
| v0.8 当前 gate | 5253d6758042381bab15ed9c385aef78bd0331f6 |
| v0.9 当前 gate | 3b14dbcc5e525235a44db32ad96e20be5c33e3ef |
不要假设最新 Engine commit 一定满足旧路线的精确身份。按发布/验收记录部署，并为不兼容 source gate 建立不同 Studio target。
v0.8 固定限制摘要¶
- CPU-only，turn 512/1024/2048；
- 最多 7 个 δ、2048 turns、8192 final launches、65536 convergence trials；
- radial/angle intervals 8/16/32，magnet slices 2/4/8；
- 三个产物：lattice projection、nonlinear screening、job summary；
- RF kick、radiation、quantum excitation、collective effects、errors/correction、strong coupling、GPU/SLURM 不可用。
v0.9 固定限制摘要¶
- 一个 reviewed portable-FODO profile；
- 512 element definitions、128 occurrences、128 BPM、128 correctors、512 seeds、32 error scales 上限；
- 正式 profile 使用 8 BPM、16 correctors、8 seeds、3 scales；
- 四个产物：error model、correction screening、tolerance summary、job summary；
- coupling/skew、dispersion/chromaticity、LOCO、survey/measured response、hysteresis、power supply dynamics、GPU/SLURM 不可用。
明确尚不可用的系统级能力¶
当前没有通用 GPU 或 SLURM RPC 执行、任意工作流 daemon/dashboard、normal-mode coupling、强耦合修正、完整 collective-effect/IBS/wake/space-charge、真实误差容差下的 DA/FMA/lifetime、机器测量闭环和 AI agent 自动运行接口。界面中只读 OFF 开关不能通过修改项目 JSON 绕过。
兼容性检查清单¶
Engine 部署后依次确认：
- SSH principal 与运行用户正确；
- Engine executable 指向被接受构建；
- Hello 和 GetCapabilities 返回预期 protocol/namespace/build/source；
- CPU、permissions、durability/reconnect/fetch 与工作流一致；
- request/project/artifact limits 足够；
- v0.8/v0.9 state root 独立，namespace 和 job 前缀不交叉；
- Studio 中先 Test SSH，再 Test Engine，最后在专用页面检查 runtime gate；
- 使用 fixture 做 acceptance 时，把它标记为 reference/acceptance，不得提升为用户项目正式结果。
更详细的冻结协议和验收记录仍保留在仓库 protocol/ 与 docs/round_* 中；普通用户无需阅读 protobuf。