安装 SDK

使用 Python 3.12。当前下载包为 0.4.14+20261027.simcompat。

使用当前版本安装包

• 下载 SDK 0.4.13 wheel（本地构建）
• SHA 256 校验清单

把 wheel 下载到当前项目目录，然后在 PowerShell 执行以下命令，创建 Python 环境并安装 SDK。

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install "./quantum_source_sdk-0.4.14+20261027.simcompat-py3-none-any.whl[all,secure]"
.\.venv\Scripts\python.exe -m pip install ipykernel

只使用 Qiskit 时把 [all,secure] 换成 [qiskit,secure]；只使用 PennyLane 时换成 [pennylane,secure]；仅 Core 可使用 [secure]。secure 是可选依赖组，用于安装 keyring，以便将平台凭据保存到系统密钥库。若不使用账号保存功能，可省略 secure；它不影响设备功能或任务提交。

使用当前本地源码

当前 0.4.14+20261027.simcompat 支持客户端级 OPEN/FULL 钱包选择，以及等待时间、查询间隔和进度显示设置。使用源码安装时，在本项目 sdk 文件夹中执行下面的命令。源码安装和 wheel 安装任选一种。

py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install ".[all,secure]"
.\.venv\Scripts\python.exe -m pip install ipykernel

确认 Notebook 使用正确环境

在 PyCharm 的项目解释器和 Notebook 内核中选择刚安装 SDK 的 .venv/Scripts/python.exe。运行下面的代码可查看解释器路径和 SDK 版本。

import sys
from quantum_source_sdk import __version__

print(sys.executable)
print(__version__)

• 下一步：连接平台