版本与验证范围
手册更新日期:2026-10-21。对应 SDK 0.4.14+20261027.simcompat,配套后端 0.16.9+20261019.releasealign。章节按功能简介、代码示例、参数说明、返回值和后续操作组织。网页、Markdown、搜索内容与下载 Notebook 使用同一套文档源。
本次同步内容
| 主题 | 当前说明 |
|---|---|
| 等待设置 | Core wait_for_job 默认使用 wait_timeout_seconds;Backend 通过 result() 等待结果。 |
| 查询与恢复 | 一次结果等待中的全部线路与平台排队共享总预算。等待超时后,继续查询同一个任务。 |
| 钱包选择 | QuantumSourceService / SchedulerClient 构造参数 currency="OPEN" 或 "FULL";默认 OPEN,只读属性。PennyLane 独立设备可选择,注入 scheduler 时继承并校验冲突。 |
| 报价与余额 | 金额和币种在 prepare 时固定。切换钱包时,使用对应客户端准备新报价。 |
| 设备选项 | 按设备声明提供动态 Options,使用扁平 configuration_data 或单次任务关键字。 |
| 独立能力专章 | 按 Qiskit、PennyLane、Core 分别说明查询入口、返回数据、设置方法和支持范围。 |
| 集中 API 参考 | 按模块与对象整理接口签名、参数、返回值及示例,统一查询实现与测试依据。 |
| 执行方式与映射 | 区分只读的 logical / physical 能力查询、本源云端拓扑映射和客户端固定布局。 |
| 物理布局 | 使用 physical_qubits 或 initial_layout 选择布局;固定布局按所选物理位置执行。 |
| 简洁列表 | 五列设备摘要;platform_active_tasks 展示该设备的平台未结束任务总数。 |
| 提交接口 | 设备专属选项使用平铺配置字典或所选框架的设备选项入口。 |
| 错误说明 | 解释发生的情况、可继续使用的查询标识和下一步操作。 |
| 文档组织 | 按入门、Core、Qiskit、PennyLane、参考分组;新增任务查询、底层提交、Sampler/Estimator、PennyLane 测量与梯度专章。 |
| 代码讲解 | 先说明操作目的,给出实际代码,再解释参数、返回值与下一步;进阶选项分开说明。 |
| 文档格式 | HTML、Markdown、搜索与逐页空输出 Notebook 同步生成;22 个章节页底提供下载,保留原 4 份完整实验。 |
当前平台只支持 public + stand 单通道。SDK 默认 OPEN,OPEN 和 FULL 独立扣费;历史记录按原通道、原报价和原币种展示。
源码与安装包
下载页提供 0.4.14+20261027.simcompat wheel,包含客户端级钱包选择与可选等待设置。下载后可按 SHA-256 清单核对文件;安装与内核选择方法见安装章节。
验证范围
文档检查覆盖内容生成、链接、Notebook 格式和示例兼容性。下载 Notebook 的输出区保持空白;运行实验后,任务状态与结果可作为本次验收记录保存。
维护与离线阅读
正文与示例由 scripts/guide-current*.mjs 等文档模块维护,运行 node scripts/sync-portal-guide.mjs --write 可离线生成。source-manifest.json 记录文档源文件和历史资料的校验信息。
可以直接打开 index.html 阅读。复制手册时保留 assets;需要下载示例和安装包时,同时保留 public 目录下的 notebooks 和 sdk 文件夹。手册目录和搜索支持离线使用。
写法参考与实现依据
章节组织参考 OpenQuantum 官方文档的功能简介、最小示例、参数表、返回值、进阶用法与后续阅读。正文说明 QuantumFerry 的实际 API、默认值、设备能力和计费方式。
API 参考采用模块、类与函数索引,再逐项列出签名、参数和返回值的组织方式;结构参考 DeepQuantum API 文档,接口内容依据当前 QuantumFerry 源码与离线测试。
- OpenQuantum · Python SDK Overview
- OpenQuantum · Quick Start
- OpenQuantum · Job Submission
- OpenQuantum · Backend Discovery
- OpenQuantum · Qiskit Backends & Targets
- OpenQuantum · PennyLane Device Options
下载本页 Jupyter Notebook
收录本页 Python 示例与说明,便于在 Jupyter Notebook 中学习和运行;安装命令保留为说明。