QuantumFerry 用户使用手册

版本与验证范围

手册更新日期: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 源码与离线测试。

下载本页 Jupyter Notebook

收录本页 Python 示例与说明,便于在 Jupyter Notebook 中学习和运行;安装命令保留为说明。

下载《版本与验证范围》Notebook(.ipynb)

输入关键词;所有搜索都在本机完成。