---
name: classiq-synthesis
description: 使用 Classiq 官方 SDK 构建结构化 Qmod 模型，或通过用户自行配置的凭据调用远程综合；区分模型准备、云端综合和量子执行。
---

# Classiq 模型与综合

适用于把明确的门序列纳入 Classiq 工作流。`classiq_cloud` 默认关闭；用户按自己的厂商许可显式执行
`node scripts/setup-paper-tools.mjs classiq-synthesis` 并启用连接。依赖固定为 Classiq 1.29.1，
上游 SDK 使用专有评估许可，OpenQuantum 不复制或再分发其源码。

- `prepare_classiq_model` 接受 `numQubits` 与 `gates`，使用真正的 `qfunc`、`allocate`、`create_model` 构建模型，返回 `modelJson`。不需要账户，不调用云综合。
- `synthesize_classiq_circuit` 接受同一结构化门输入，通过官方 SDK 请求远程综合。模型会发送至 Classiq 和服务提供的签名 S3 地址；调用可能消耗额度或产生费用。
- 账号申请、服务许可和 `CLASSIQ_XCH_TOKEN` 由用户自行设置。通过 Harness 凭据引用读取 token，不把值放入 Tool 参数、Skill、模型、配置文件或结果。此版本支持主站 `https://platform.classiq.io` 的非交互 exchange token。
- 控制门首个 target 为控制位，旋转角为弧度；保留输入位编号和空闲位。没有任意 Python/Qmod 源码入口。
- 只调用综合，不申请 shots 或提交量子执行。远端综合产物不代表电路等价性或硬件可用性已经验证。
- `requestTimeoutSeconds` 约束远程综合等待和单次传输；`execution` 控制 worker 的部署资源限制。不自动重试、跳转、登录或取消。超时后先让用户查看账户中的作业状态，避免重复提交。
- SDK telemetry 关闭。厂商错误正文不回传，避免派生 token 或账户信息进入日志。凭据缺失在 SDK 导入和网络请求前失败。
- 当前 L1，`scientificValidation=not_evaluated`。离线协议 fixture 只验证真实 SDK 的传输行为，不证明真实云服务已连通。

参考：[Classiq 官方文档](https://docs.classiq.io/)、[官方安装与注册](https://docs.classiq.io/getting-started/registration_installations/)。
许可依据为固定 `classiq` wheel 的 `LICENSE.txt`；上游示例仓库的许可证不能替代 SDK 许可。