---
name: qoolqit-workbench
description: 用真实 QoolQit 编译器把用户无量纲原子阵列和脉冲转换为 Pulser 程序并本地模拟；明确能标、距离/时间换算、纳秒量化和许可边界。
---

# QoolQit 无量纲模拟程序

<!-- BEGIN NATIVE SDK ACCESS -->
## 原生 SDK 路径

本能力同时支持 **QoolQit 的原生公开 API**。用户需要 程序、编译/执行流程与后端模型 时，由 Agent 在固定依赖环境中编写和运行任务代码，不限于下文便捷 Tool 的预设模型。

使用 `node scripts/sdk-access.mjs inspect qoolqit-workbench` 定位环境，按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航：`qoolqit`；导航不是 API 白名单。

上游自定义许可证，安装前按当前使用范围核对。

下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同；原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
<!-- END NATIVE SDK ACCESS -->


这是默认关闭、需明确选择启用的可选能力。QoolQit 使用 PASQAL **MIT-derived** 许可，其专利许可限内部研究与学术用途，不能称为标准 MIT。Agent 经 Harness 调用 `qoolqit_local` 的 `simulate_qoolqit_analog`。

- `atomPositions`、`durations`、`rabiAmplitude`、`detuning` 均无量纲；后两者各有段数+1个端点值。全程常数 `phaseRad` 用 rad，Rabi 非负，位置不同。
- `energyScaleRadPerUs=E` 指定物理角频率能标；真实 `UnitConverter` 给出时间因子 `1000/E` ns、距离因子 `(C6/E)^(1/6)` µm。转换后的 C6、坐标、时长和单位全部返回。
- Tool 构造真实 `QuantumProgram(Register,Drive)`，调用 `compile_to(profile="default")`，再以编译得到的 Pulser Sequence 运行 QuTiP。没有仅把 QoolQit 名称映射到 Pulser。
- 编译后的 `compiledSegmentDurationsNs` 记录各段实际纳秒时长；量化为 0 ns 的正段以及 1 ns 内不等端点会明确拒绝，避免上游静默丢段。总时长至少 4 ns。能标改变会改变网格，不能假设离散模拟具有精确尺度不变性。
- 输出位序、相位符号、求解容差和 raw norm 约定与本地 Pulser 相同。相位驱动为 `Ω/2*(exp(-iφ)|g><r|+exp(iφ)|r><g|)`。从全 ground 态、完整 2^N 空间演化，虚拟 Rb70S 设备无硬件校准。
- 先检查单位换算和单原子脉冲面积，再分析相互作用。比较能标时同时检查编译时长和网格收敛；`timeSteps` 网格会并入实际分段边界。
- 显式执行 `node scripts/setup-paper-tools.mjs qoolqit-workbench` 准备独立锁定环境。上游依赖树带有云客户端，但此 Tool 不构造它、不使用凭据或网络服务。调用时不安装依赖。
- 规模由调用方决定，使用 `execution` 管理资源。当前 L1，`scientificValidation=not_evaluated`；编译、数值对照和运行成功都不代表科学 Acceptance。

[上游与许可说明](references/UPSTREAM.md)。