# 版本与验证范围

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

- [集中 API 参考](api.html)
- [DeepQuantum · state API 文档](https://dqapi.turingq.com/api/_autosummary/deepquantum.state.html)

- [OpenQuantum · Python SDK Overview](https://docs.openquantum.com/core-sdk/overview/)
- [OpenQuantum · Quick Start](https://docs.openquantum.com/core-sdk/quickstart/)
- [OpenQuantum · Job Submission](https://docs.openquantum.com/core-sdk/job-submission/)
- [OpenQuantum · Backend Discovery](https://docs.openquantum.com/core-sdk/backend-discovery/)
- [OpenQuantum · Qiskit Backends & Targets](https://docs.openquantum.com/qiskit-plugin/backends-targets/)
- [OpenQuantum · PennyLane Device Options](https://docs.openquantum.com/pennylane-plugin/device-options/)

## 下载本页 Jupyter Notebook

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

[下载《版本与验证范围》Notebook（.ipynb）](../../notebooks/sdk_user_guide_versions.ipynb)