ionq-programs git:20261012.5ce3b3eA

Immutable. This exact content never changes and is served at /api/v1/blob/72cccee216fd4ec6.

---
name: ionq-programs
description: 使用 IonQ 官方 qiskit-ionq 在本地准备结构化量子电路，返回 IonQ QIS 指令、OpenQASM 2 和测量映射。
---

# IonQ 程序准备

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

本能力同时支持 **Qiskit IonQ 的原生公开 API**。用户需要 原生门、电路转换、provider、backend 与 job API 时，由 Agent 在固定依赖环境中编写和运行任务代码，不限于下文便捷 Tool 的预设模型。

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

本地程序构建与外部调用分开；账户、凭据、费用、设备操作和数据外发沿用宿主及用户授权。原生 SDK 访问不自动启用服务。

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


通过 `ionq_local.prepare_ionq_program` 将用户门序列转换为 IonQ QIS 程序。输入为 `numQubits`、`gates`，
每个门具有 `gate` 和 `targets`，RX/RY/RZ 必须给出弧度 `angle`。控制门的第一个 target 是控制位。

- 支持 H/S/T/X/Y/Z/CX/CZ/RX/RY/RZ；所有量子比特从输入编号保留，不自动重排或删空闲位。
- 输出添加全量末端测量，`classicalToQubit[c]` 是经典位 c 对应的量子位。Qiskit 字符串通常把高编号经典位写在左端，不要误读为 q0 在左。
- 这是本地程序转换，不是 IonQ 原生脉冲编译、云端模拟或真实量子硬件运行。
- 真机任务沿用已有可选硬件入口，需要独立配置凭据与明确的执行授权。本 Tool 没有凭据或网络路径。
- 先运行 `node scripts/setup-paper-tools.mjs ionq-programs`。环境隔离并锁定依赖；计算时不自动安装。
- 当前为 L1，`scientificValidation=not_evaluated`。