线性光学与持久跟踪¶
English · 上一章：连接 Engine · 下一章：平衡计算链
这两项属于 Studio–Engine v0.1 路线，只对当前 studio-project/0.1 严格快照启用。v0.2 项目使用后续的平衡和专用筛选工作流，不会启用通用 v0.1 跟踪按钮。
计算线性光学¶
前置条件：
- 当前 v0.1 authoring draft 已通过结构/闭环检查，并产生当前 Engine snapshot；
- 晶格至少包含一个正长度非 Marker 元件；
- 已选 execution target。
操作：
- 打开 v0.1 项目，例如：
- 在 Execution Targets 中选择已通过测试的目标。
- 点击 Calculate → Evaluate Optics（
Ctrl+R）。 - Studio 依次验证精确项目、打开会话、计算并取回 Twiss 产物。
- 在 Optics Result 查看
Qx、Qy、水平/垂直色品、β 函数和色散。
结果显示前会检查：项目/修订身份、产物哈希、行数和顺序、有限值、正 β 以及每个权威晶格实例的覆盖。计算期间修改项目不会把完成结果提升到新修订。
当前是合格的 4D 线性光学筛选，不自动证明耦合机器、非线性接受度、误差容差或工程可行性。
提交持久 CPU 跟踪¶
点击 Calculate → Submit CPU Tracking Job…，填写：
| 字段 | 默认值 | 范围/规则 |
|---|---|---|
| Turns | 100 | 1–1,000,000 |
| Macro-particles | 1,000 | 1–100,000 |
| Random seed | 8,675,309 | 0 到 2^53−1 |
| Checkpoint interval | 10 turns | 0 到总 turn 数 |
总工作量不得超过 50,000,000 particle-turns。一个快速例子可直接使用默认值；要做可重复比较，请保留 seed，并一次只改变一个设计参数。
提交前 Studio 会把精确请求写入恢复日志。如果网络在响应到达前中断，同一请求可安全重放，不会凭空提交一个不同任务。
在 Tasks 中管理任务¶
Tasks 面板显示 Job、Target、Phase、Progress、Access 和 Result。你可以：
- Refresh target：读取所选 target 的主体作用域任务列表；
- Reconnect selected：使用系统凭据库中的 token 继续观察；
- Cancel selected：请求合作式取消并继续观察到终态；
- Open artifact：重新验证并打开结果；
- Export artifact…：导出结果 JSON、evidence manifest 和 checksum sidecar。
多个已接受任务可以并行观察；只有“正在提交且尚未安全落盘”的窗口是串行的。
跟踪结果怎么看¶
结果页显示：
- turns × macro-particles；
- survived/lost 数量；
- loss-state 分类；
x, px, y, py, zeta, delta的最终均值和标准差；- random seed、backend、是否建模孔径；
- project revision、job ID 和 artifact hash。
它回答“这批宏粒子在当前理想模型和有限 turn 数下发生了什么”，不回答机器动力学孔径、Touschek 寿命或集体效应。没有 modeled aperture 时，存活也不能说明真空室边界安全。
修改项目后的行为¶
旧任务和结果不会被删除。它们继续绑定原 revision，可用于历史审阅；当前项目页面不会把它们当作新修订结果。若要比较两次运行，确保 turns、粒子数、seed、Engine source 和物理边界一致。