# Notebook 与测试

这里提供两类 Notebook：4 份从连接到结果的完整实验，以及与 22 个正式章节一一对应的逐页学习文件。逐页文件按原文保留示例和说明，可能包含不同用法或独立实验，请按所需功能选择单元格。每个章节页底也提供该页专属下载。

## 下载完整实验 Notebook

下面 4 份完整实验按连接、选择设备、准备线路、查看报价、确认和读取结果分成独立单元格。每份文件只有一种实验流程；逻辑映射和固定物理布局分成两份。

- [sdk_qiskit_current.ipynb](../../notebooks/sdk_qiskit_current.ipynb)
- [sdk_qiskit_physical_current.ipynb](../../notebooks/sdk_qiskit_physical_current.ipynb)
- [sdk_core_current.ipynb](../../notebooks/sdk_core_current.ipynb)
- [sdk_pennylane_current.ipynb](../../notebooks/sdk_pennylane_current.ipynb)

下载示例提供可运行代码和步骤说明，输出区保持空白。配置账号、设备和 shots 后，按步骤查看报价并确认实验；confirm 或自动批准入口会提交任务，真机实验会使用设备资源。

## 下载逐页学习 Notebook

每个 Python 示例单独一个代码单元格，章节说明和表格保留为 Markdown。PowerShell 安装命令在终端执行。概览、设备能力概念、下载和版本页提供说明型 Notebook；完整实验可从上方下载。

- [SDK 概览 · 本页 Notebook](../../notebooks/sdk_user_guide_index.ipynb)
- [安装 SDK · 本页 Notebook](../../notebooks/sdk_user_guide_install.ipynb)
- [连接与认证 · 本页 Notebook](../../notebooks/sdk_user_guide_connection.ipynb)
- [快速开始 · 本页 Notebook](../../notebooks/sdk_user_guide_quickstart.ipynb)
- [Core 入门与示例 · 本页 Notebook](../../notebooks/sdk_user_guide_core.ipynb)
- [设备发现与选择 · 本页 Notebook](../../notebooks/sdk_user_guide_backend_discovery.ipynb)
- [任务提交与报价 · 本页 Notebook](../../notebooks/sdk_user_guide_job_submission.ipynb)
- [任务查询与分页 · 本页 Notebook](../../notebooks/sdk_user_guide_job_query.ipynb)
- [Core 设备配置 · 本页 Notebook](../../notebooks/sdk_user_guide_capabilities_core.ipynb)
- [底层提交协议 · 本页 Notebook](../../notebooks/sdk_user_guide_low_level.ipynb)
- [Qiskit 入门与示例 · 本页 Notebook](../../notebooks/sdk_user_guide_qiskit.ipynb)
- [设备、Options 与 Target · 本页 Notebook](../../notebooks/sdk_user_guide_capabilities_qiskit.ipynb)
- [编译与物理布局 · 本页 Notebook](../../notebooks/sdk_user_guide_compilation.ipynb)
- [Sampler 与 Estimator · 本页 Notebook](../../notebooks/sdk_user_guide_qiskit_primitives.ipynb)
- [PennyLane 入门与示例 · 本页 Notebook](../../notebooks/sdk_user_guide_pennylane.ipynb)
- [设备选项与支持范围 · 本页 Notebook](../../notebooks/sdk_user_guide_capabilities_pennylane.ipynb)
- [测量、shots 与梯度 · 本页 Notebook](../../notebooks/sdk_user_guide_pennylane_measurements.ipynb)
- [设备能力概念 · 本页 Notebook](../../notebooks/sdk_user_guide_capabilities.ipynb)
- [结果与常见问题 · 本页 Notebook](../../notebooks/sdk_user_guide_results.ipynb)
- [API 参考 · 本页 Notebook](../../notebooks/sdk_user_guide_api.ipynb)
- [Notebook 下载 · 本页 Notebook](../../notebooks/sdk_user_guide_testing.ipynb)
- [版本与验证范围 · 本页 Notebook](../../notebooks/sdk_user_guide_versions.ipynb)

## 运行前检查

选择已安装 SDK 的 Python 3.12 内核，完成连接与认证，然后选择实验设备。示例使用 128 shots，可按设备采样范围调整。固定物理布局示例使用 1–11，请结合目标设备的可用比特和连接关系选择布局。

## 旧示例迁移

历史下载链接会引导到当前示例。用户已经运行并保存的 Notebook 可以继续作为实验记录保留。

## 验证范围

文档验证覆盖生成一致性、版本与安装包校验、链接、搜索索引、示例语法和离线接口兼容性。真机验收使用实际账号运行实验，并记录任务状态与计算结果。

- [安装说明](install.html)
- [版本与验证范围](versions.html)

## 下载本页 Jupyter Notebook

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

[下载《Notebook 下载》Notebook（.ipynb）](../../notebooks/sdk_user_guide_testing.ipynb)