← Back to home@xi-zhao

OpenQuantum

Open-source quantum Agent workspace with a desktop client, Web UI, messaging, Qiskit/MCP tools, and scientific validation

Stars
74
Language
JavaScript
Created
Aug 15, 2026
Updated
Sep 29, 2026
GitHub repo

Introduction

OpenQuantum

简体中文 · English · 日本語 · 한국어 · Español · Français · Deutsch · Português · Русский · العربية

让量子想法运行起来。
开源量子 Agent 与应用平台

CI status MIT 与组件许可证 Node.js 24 or newer

OpenQuantum 是面向量子研究、实验与教学的开源 Agent 与应用平台。你可以用自然语言选择方法、调用专业量子软件、查看计算过程与结果,也可以直接复跑算法示例、进入量子学习通准备课程,或接入自己的算法与应用。

提出问题,运行计算,共创能力。 从学习者的第一次实验,到研究者的方法比较,再到开发者的应用集成,都可以从已支持的任务开始。

为什么选择 · 浏览能力 · 开始使用 · 使用与结果 · 开发与扩展 · 路线与 RSI · 参与建设 · 开源生态

OpenQuantum Desktop 科研工作台:新会话、工作区与量子学习通入口
在科研工作台提出问题,查看工具调用,再带着结果继续探索。

为什么选择 OpenQuantum

让人、AI 与开放生态共同创造量子能力。

我们不重造量子软件生态,而是让专业能力更容易被使用、组合和继续建设。 OpenQuantum 的工作,是把领域方法、Agent 执行和开放工具接到具体任务上;它的价值不必等到真实 QPU 取得优势才开始,本地计算、教学实验和方法验证也是实际用途。

从问题出发,调用专业能力

让问题意识转化为探索能力。 你不必先学会每套 SDK,才能开始一个已支持的任务:Skill 提供工作方法,Agent 调用专业 Tool,工作台保留输入与结果。我们希望减少反复配置、接口学习和流程搭建,让学习者能够动手,让研究者把更多精力放在提出假设、设计对照与判断结果上,而不是替代这些判断。

让工具之间产生新的研究空间。 PyZX 电路优化、QCEC 等价性检查与噪声模拟,分别回答不同问题。把它们用于同一个研究目标,可以进一步追问“理想电路更简洁,含噪表现是否也更好”。我们持续建设这种有科学意义的组合:对齐模型、单位、位序和预算,理解方法何时适用、何时失效;接口接通本身不等于结论成立。各工具的当前范围见计算与资源配置。

让一次研究,成为下一次的起点

让一次工作留下可继承的经验。 常用步骤、计算结果与适用的独立检查,为复核和后续使用提供基础。我们希望进一步积累带条件的方法比较与失败证据:不仅知道一次计算成功,也理解它为什么适用、何时应换一条路线。有依据的负结果同样有价值,但程序报错不等于科学反驳。完整科学验收目前按相应能力的支持范围提供,经验整理也不等于系统已自动学习。

把你的方法,变成别人能用的能力

让成果从“有人做出”走向“他人继续创造”。 方法可以写成 Skill,计算程序可以接成 Tool,完整应用可以保留自己的界面和业务流程。研究者、教师、开发者与软硬件伙伴,可以从自己的专长出发贡献,而不必先重做整套平台。我们的目标不只是传播已有成果,也让它们进入新的课程、研究与应用;量子学习通是现有应用入口之一。

把选择权留给使用者和贡献者。 开源实现与扩展接口允许你检查、修改和维护自己的组合;模型服务与计算后端分别配置,不把所有应用绑定到单一模型或设备。上游作者、许可证与贡献继续可见,研究数据是否共享由使用者决定。我们希望保留下来的不只是一个界面,而是能够随模型、算力与研究方向变化继续使用的专业方法。

一个人因此完成了原本难以开展的探索,一项方法因此进入新的问题,一个贡献者因此做出新的应用,都是平台值得积累的价值。下一步是让这些经验不仅帮助使用者,也帮助改善下一轮研究的能力。

先运行一个任务 · 把你的能力接进来

可以用它做什么

选择一个方向,告诉工作台你的问题、输入和希望检查的结果。OpenQuantum 的 Agent 按任务使用 Skill 中的方法,并调用相应 Tool 执行计算;量子学习通提供独立的教学界面。

算法学习与方法比较 · 电路与量子信息 · 基态、化学与优化 · 误差缓解与量子纠错 · 哈密顿量模拟与开放系统 · 实验模拟与硬件 · 光子计算与量子网络 · 参考资料与选型 · 量子学习通

本地计算可以从无需量子云账户的任务开始。真实硬件和付费服务按需配置;各方法的输入范围、准备条件与验证状态分别保留在详细目录中。

v0.6.0 汇集近期新增的国内外公司与机构 SDK:从可微分电路、容错资源估算,到光子计算、脉冲编译和量子网络。三批接入分别见17 项厂商 SDK、20 项公司与机构能力和15 项网络、控制与云接口,另含 QuEra Bloqade Analog。每项开放的动作以适配说明为准;账户、鉴权、服务权限与适用许可由用户配置。

算法学习与方法比较

从一个可运行示例开始,修改输入、检查数值结果,再把方法用于自己的问题。已将 UnitaryLab 的 66 份 quantum-skills 指南适配为原生 Skill,其中 49 项提供可执行示例,逐项覆盖原算法库的 39 个模块及指南独有方法;其余指南用于分类、后端选择和迁移。

任务方向可运行的方法与示例
算法基础与搜索QFT、QPE、Hadamard test、振幅放大与估计、Grover、Shor、Simon、离散对数和图行走
线性系统与矩阵方法HHL、VQLS、QSVT 线性求解、绝热求解、LCU 与 QSP;附经典本征求解参考
哈密顿量模拟Trotter–Suzuki、qDrift、QSP、Taylor LCU,以及披露替换方式的 Cartan 示例
变分计算与机器学习VQE、VQD、QAOA、VQC、QCBM、CVQNN,以及梯度与量子 Fisher 信息计算
态制备与多体计算Möttönen、MPS、Isometry、变分态制备,分子 DMRG、Fermi–Hubbard VQE 与 Ising 演化
纠错构码与微分方程qLDPC 构码与 syndrome;一维、二维热方程和周期平流的薛定谔化示例

这些示例使用 Qiskit、PennyLane、quimb、PySCF、NumPy/SciPy 等开源后端,可直接运行,也可由 Agent 经已有代码执行工具调用。默认参数是教学算例;实际输入、参考误差和收敛状态需要按任务检查。

适配保留上游来源与许可证,不依赖闭源 UnitaryLab 运行时。工作流覆盖不表示上游 Python API、优化器或后端完全兼容;Cartan、CVQNN、DMRG 等差异在逐项覆盖表和运行说明中公开。

直接运行算法示例 · 选择相近方法

电路与量子信息

任务方向可以发起的任务可以查看的结果
量子电路分析或转换 OpenQASM / QPY 电路,比较转译,检查等价性,运行电路仿真电路结构、转译结果、等价性检查、态矢或采样分布
本地编译与仿真用 TKET、QSteed、MQT QMAP 编译或映射电路,用 Braket LocalSimulator、QCompute、Qibo 等运行本地模拟门集与线路映射、态矢或概率;保留各 SDK 的位序约定
可微分电路与混合程序用 PennyLane、DeepQuantum、TensorCircuit、MindQuantum 或 VQNet 求期望和梯度;用 Guppy / Selene 模拟测量、复位与经典反馈参数梯度、概率和程序执行结果
容错资源估算用 Microsoft QDK 估算物理资源,用 Qualtran 统计指定 Bloq 的门资源量子位、时间或门计数,以及对应硬件与分解假设
Qiskit / Cirq 互操作用 qBraid 按固定 OpenQASM 2 路径转换受支持的酉电路转换后的电路、保留的量子位编号与空闲位;可选完整酉矩阵对照
电路优化与测量式计算用 PyZX 做 ZX 重写与电路提取,用 Graphix 转换和模拟 MBQC 模式优化前后电路与门数、资源图和测量模式;可选独立对照
电路优化与切割用 Compact 优化门序列,用 QCut 切分电路并重建期望值优化前后电路与独立等价对照;切割开销、实际采样量与可选未切割参考
Clifford+T 噪声采样用 Clifft 研究 T 门干涉与噪声,或采样受支持的 Stim 格式电路最终位串频数与可选密度矩阵参考;另可返回中间测量及 detector / observable 原始奇偶记录
量子态与测量审计密度矩阵与纠缠指标;模拟已知 product / GHZ 态的局域随机测量状态指标与独立检查,子区纯度估计及有限样本误差

基态、化学与优化

任务方向可以发起的任务可以查看的结果
基态求解与验证提供二量子位实 Pauli Hamiltonian,在固定粒子扇区运行 VQE,并检查精确参考能量、收敛轨迹、独立检查,以及完整流程中的科学验收报告
量子化学与多体基态用 SQD 研究分子与活性空间,或用 TeNPy 计算 XYZ 自旋链基态SQD 能量与轨道占据,DMRG 能量、磁化、纠缠熵及收敛信息;可选精确参考
变分参数学习对 Pauli Hamiltonian 训练 Flow-VQE,学习低能量电路参数Flow 参数学习与等评估预算随机搜索比较
激发态与核分类用 OpenQARP VQD 搜索多个低能态,或用 cqlib 角度核训练 QSVM能量、残差、正交性与可选精确谱;独立测试集分类、解析核及经典基线
对称性与控制代数用 Symmer 在指定对称性扇区降比特,用 PauLie 分析 Pauli 生成元降维 Hamiltonian、Lie 代数分类与维数;可选能谱对照或闭包
组合优化用 QPanda、Ocean 或 Kaiwu 构建和求解本地优化问题,用 Qcover 评估给定 QAOA 参数优化解、约束检查、能量与相关量;按接口提供经典对照
化学算符与既有数据用 OpenFermion / pyChemiQ 映射费米算符,按需用 QCPortal 查询 QCArchive 既有单点记录Pauli 项,分子、能量、计算方法与来源;查询保留单位与缺失字段

误差缓解与量子纠错

任务方向可以发起的任务可以查看的结果
误差缓解用 Mitiq 运行 ZNE、REM、PEC 或 CDR,比较相同采样预算下的原始与缓解结果理想参考、经验偏差、方差和 RMSE,以及校准、训练与采样成本
量子纠错用 Stim / PyMatching 运行 surface-code memory,用 Deltakit 构建矩形码片实验,或进行 BP+LSD 解码实际含噪电路、固定 shots 的逻辑错误率与区间;LSD 的 syndrome 一致性检查

哈密顿量模拟与开放系统

任务方向可以发起的任务可以查看的结果
哈密顿量模拟提供实系数 Pauli Hamiltonian,用 Trotter–Suzuki 或 qDrift 构建演化电路或计算末态电路、资源指标、态矢及可选独立矩阵参考;步数、阶数、时间与随机种子可配置
开放系统动力学用 TJM 计算开放 Ising 链,用 Dynamiqs 扫描单量子位驱动与梯度,或用 OQuPy 研究环境记忆观测量轨迹、独立参考、梯度以及时间步长与记忆截断信息

实验模拟与硬件

任务方向可以发起的任务可以查看的结果
超导与原子实验模拟调校流程、原生门约束、transmon 泄漏;用 Bloqade Analog / Pulser 研究受支持的原子阵列与脉冲合成数据、动力学轨迹、逐原子占据与末态概率
脉冲程序与控制用 QUA、LabOne Q、Qblox Scheduler、Qililab 或 OQC QAT 构建程序、排程和离线编译程序、时序、目标指令或波形;当前适配不执行实验室设备程序
量子硬件接入发现后端、检查拓扑与凭据;按需启用云任务查询、提交与取消设备候选、使用条件;已启用任务接口的结果与状态
本地设备接口用 QDMI 查询已配置的 C 驱动驱动报告的设备、量子位、门与耦合信息;官方示例驱动用于接口验证,不代表在线 QPU

光子计算与量子网络

任务方向可以发起的任务可以查看的结果
光子电路与学习用 Perceval、Lightworks 计算线性光学输出,用 MerLin 运行批量推断与相移梯度;可选 MrMustard 高斯模型Fock 概率、梯度或光学矩;明确模式顺序与截断条件
网络建模与程序用 SimQN 模拟单链路损失与退相干,用 NetQASM 生成双节点程序链路统计和编译产物;SquidASM 数值仿真另需用户准备有许可的 NetSquid 环境

参考资料与选型

任务方向可以发起的任务可以查看的结果
算法参考与工具选型检索 Quantum-Practices 的 66 份算法指南、比较量子 SDK、复用研究步骤固定版本的参考材料、适用假设与选型建议
公开设备基准从 Metriq 的 410 条固定历史记录中按厂商、设备或基准类型查询原始参数、指标、时间、来源与许可;保留模拟器标签

量子学习通

把材料、课件与课堂放在一起,让学习者动手,也让教师组织自己的教学内容。

学习与教学场景可用功能
准备材料首页、课程库、材料附件、课程导入与 PPTX 导入
制作课程建课预览、课件编辑器和 Pro 专业工作台
课堂学习幻灯片、测验、互动问答与 PBL 项目式学习
继续学习本机课程、任务、材料与服务端学习记录持久化,兼容旧版课堂迁移

课程建设目标是覆盖中学基础到前沿研究,按初级、中级、高级组织内容,允许按知识基础跨阶段学习。当前公开资源仍在整理,完整课程体系尚未制作和发布。应用装配、启动和本机持久化已有验证,真实在线 AI 建课、问答和编辑仍待完整验收。

Pro 教学任务使用上游应用自己的工具与记录,尚未自动接入科研工作台的量子工具。媒体、语音和搜索等可选能力需要对应服务配置。安装、备份、迁移与逐项验证见量子学习通集成说明。

量子学习通:课程材料、课堂与课件编辑入口

准备学习通并打开课堂。

桌面、消息与多语言

桌面工作台

OpenQuantum 桌面端提供原生窗口、系统托盘、终端与通知,复用科研工作台的模型、量子 Skill、计算工具和执行记录。

提供 Mac(Apple Silicon / Intel)和 Windows 桌面安装包,也支持从源码构建。

下载并安装桌面客户端 · 从源码启动桌面客户端。

消息入口

通过 CC Connect,可从微信、飞书、钉钉、Slack、Telegram、Discord 等渠道发起任务,复用工作台已有的 Skill、Tool 和执行记录。

通过微信 ClawBot 与 OpenQuantum 对话的已有演示截图
微信渠道中的任务与回复示例。

配置微信、飞书与其他消息渠道。

界面语言

在「设置 → 通用设置 → 语言」选择简体中文、英语、日语、韩语、西班牙语、法语、德语、葡萄牙语、俄语或阿拉伯语。选择会保存,学习通跟随工作台;阿拉伯语使用从右到左的阅读方向。

OpenQuantum Desktop 实际界面的语言选择

界面语言不会改写已有对话、课程材料、用户 Skill 或工具输出。部分原生系统对话框在中英文之外使用英语回退。

快速开始

OpenQuantum 支持桌面安装包和源码运行,适合本机单用户使用。直接使用工作台可下载安装包;二次开发或使用源码主线能力可选择源码路径。

桌面安装包

从 GitHub Release 下载 Mac(Apple Silicon / Intel)或 Windows 安装包。安装包内置 Node 和 uv,无需先配置源码构建环境;当前为未签名测试构建。按安装说明安装并启动后,继续配置模型。计算组件的额外依赖按对应版本说明准备,量子学习通等可选应用另有安装步骤。

本页能力目录随当前源码维护。v0.6.0 发布说明汇集自 v0.5.1 以来的算法示例、互操作与 SDK 接入;安装文件以对应 Release 的实际附件为准。安装包包含适配代码,计算依赖仍需按所选能力显式准备。原有安装版需下载新版并覆盖安装;用户改过的 Skill 或 MCP 配置会保留,新默认内容可能需要手动比较采用,见数据与升级。

安装源码

先准备 Git、Node.js 24;Python 量子工具还需要 uv / uvx。其他依赖按所选能力安装,例如 RandomMeas 需要 Julia 1.12.7。

git clone https://github.com/xi-zhao/openQuantum.git
cd openQuantum
npm ci

没有模型密钥也可以先运行固定本地示例。要通过 Agent 发起任务,继续选择工作台入口并配置模型。

选择工作台入口

从同一源码目录启动的 Web 与 Desktop 使用同一套模型配置、量子能力和执行记录,共用 .openquantum/dsh 中的本机状态。切换前先退出正在运行的入口。

网页工作台

npm run dev

打开启动日志中带登录令牌的地址;认证后进入 http://127.0.0.1:3000。

桌面源码安装与启动

桌面客户端

完成源码依赖安装,并准备 Corepack 和系统 C++ 构建工具后:

npm run desktop:setup
npm run desktop:verify-install
npm run desktop

desktop:setup 构建固定的上游源码、下载 Electron、编译原生模块并准备 OpenQuantum 品牌资源。请使用仓库启动命令,加载模型和量子能力配置。

配置模型

在「设置 → 模型」填写支持 OpenAI-compatible Chat Completions 协议的服务地址、模型名称和 API Key,保持 OpenQuantum 为默认 Agent Preset。模型需要支持 Tool Calling,才能调用量子计算工具。 这里配置的是模型服务,量子云凭据在对应后端中另行配置。

内置 openquantum-public / openquantum-private 的默认地址均为 .invalid 占位地址,请替换为自己的服务。

高级模型配置与命令行诊断

界面保存的模型路由覆盖写入 Git 忽略的 $DSH_HOME/settings.yaml;密钥保存在本地环境或 Harness 凭据库中,项目配置只保存凭据引用。若希望使用 .env 提供服务地址和密钥,macOS 终端执行 cp .env.example .env,Windows PowerShell 执行 Copy-Item .env.example .env,再按文件内注释填写。.env 不覆盖模型名称;服务使用其他模型名时,仍需在「设置 → 模型」中配置。

以下命令检查 .env 或环境变量中的 public 路由,以及脚本固定的 kimi-k2.7-code、glm5.2 两个模型名,分别验证文本生成和 Tool Calling。它不会读取界面保存的路由覆盖;服务提供这些模型时可使用,其他模型请通过上面的工作台任务验证。

npm run models:probe -- --provider openquantum-public

按任务准备计算环境

源码中的本地 Python 计算工具使用显式准备的固定依赖。完成 npm ci 后,在仓库根目录选择要使用的能力执行准备命令;准备阶段可能联网下载和构建,计算调用不再自动安装依赖。

准备什么命令或入口
第一个 Bell 态实验node scripts/setup-paper-tools.mjs fatqat-workbench
Trotter / qDrift 哈密顿量模拟npm run capability:hamiltonian:setup
Clifft 采样与 qBraid 电路转换npm run capability:interop:setup
指定其他 Python 计算能力node scripts/setup-paper-tools.mjs <能力 ID>,例如 qec-memory-experiment;各 Skill 列出自己的准备命令
算法示例从最小依赖环境开始,按需补充梯度、PennyLane、张量或化学依赖

环境准备、连接启用与模型配置分别完成。默认开启的连接也需要准备依赖;计算时若缺少环境或锁文件已更新,Tool 会返回具体准备命令。Julia、QDMI 驱动和上游 MCP 服务按各自说明准备。详见本地计算环境。

跑通第一个任务

不需要模型密钥:复算一个固定案例

以仓库内固定的二量子位 Pauli Hamiltonian为输入,原生 solve_and_validate_ground_state Tool 在指定粒子扇区内运行无噪声 VQE,再用独立闭式计算检查结果。完成快速开始的 git clone 与 npm ci 后,在仓库目录执行即可复算,无需模型密钥或量子云凭据:

npm run demo:quantum-ground-state
-1.85727503 Ha
VQE 能量
-1.85727503 Ha
独立精确参考
4.44 × 10⁻¹⁶ Ha
能量差
15 项通过
本地计算检查

以上数值来自 2026-09-12 的本地复验;原始输出与运行记录包含完整数值、检查状态、时间、源码提交、输入摘要和 Node.js 版本。

这次运行检查了什么,以及还差什么

这次运行完成了 15 项本地计算检查,1 项会话来源检查未执行,尚未生成完整科学验收结论。差值表示该数值案例与精确参考的一致程度;科学适用范围仍是给定 Hamiltonian 和粒子扇区。

完整科学验收还需要通过 Harness 执行任务、保存结果文件和会话来源,并生成可重读的验收报告。配置模型后的验证入口见开发与验证。

让 Agent 执行任务:Bell 态的制备与采样

配置模型后,新建会话,发送下面的请求:

用 FatQat 从双量子位全零态出发,对 q0 施加 H,再以 q0 为控制位、q1 为目标位施加 CX。返回无噪声精确概率,并用 1024 次采样、seed=7 比较频数。

Agent 可以调用 FatQat 电路工具执行计算,工作台保留工具输入和返回结果。你可以查看精确概率与采样频数,再继续提出问题:

保持电路和 seed 不变,把采样量改为 8192 次,比较两次频率与精确概率的偏差。

这个电路的理想概率是 00、11 各 50%;有限采样的频率会波动。比较两次采样可以观察这种波动,单次增加采样量不保证每个频率都更接近理想值。

此处展示可复制请求与理论预期。FatQat 连接默认开启,先用 node scripts/setup-paper-tools.mjs fatqat-workbench 准备锁定依赖;接口和本地验证记录见 FatQat 使用说明。这条路径需要先按配置模型接入一个支持 Tool Calling 的模型,否则 Agent 不会调用计算 Tool。

直接运行开源算法示例

不需要模型密钥或量子云账户。基础方法先准备 NumPy、SciPy 和 Qiskit:

npm run capability:algorithms:setup -- --minimal

macOS / Linux 可直接查看方法、输入说明并运行默认 HHL 算例:

examples/quantum-algorithms/.venv/bin/python examples/quantum-algorithms/run.py --list
examples/quantum-algorithms/.venv/bin/python examples/quantum-algorithms/run.py --describe hhl
examples/quantum-algorithms/.venv/bin/python examples/quantum-algorithms/run.py --algorithm hhl

Windows PowerShell 使用对应解释器路径:

& examples/quantum-algorithms/.venv/Scripts/python.exe examples/quantum-algorithms/run.py --algorithm hhl

需要 QSP/QSVT 等方法时,运行 npm run capability:algorithms:setup -- --group pennylane;其他组为 gradients、tensor、chemistry,补装会保留已安装的其他组。不带参数的 npm run capability:algorithms:setup 仍准备全部依赖。完整环境含 PySCF,Windows 建议使用 WSL;已完成的数值验证范围是 macOS CPU。

自己的参数通过 JSON 文件和 --input 传入,结果可用 --output 保存。也可以在配置模型后,让 Agent 使用 quantum-algorithms 或具体方法 Skill 执行。完整参数、位序、方法差异与依赖组见算法示例说明。

从已有源码升级

按版本更新说明更新源码和项目依赖,再为要使用的计算能力运行一次原准备命令。Python 桥接会在原环境目录核验并同步锁定依赖,无需删除环境;算法示例可继续按组补装。

随后重启工作台并新建会话。已有 Skill、Tool 名称和参数保持有效;13 个分类索引仍可手动调用,Agent 自动任务改为直接选择 quantum-algorithms 或具体方法。需要恢复可选服务的完整工具范围时,使用默认 full 配置,详见能力选择与兼容说明。

按需开启其他入口

量子学习通安装

量子学习通安装

完成源码依赖安装后,在同一个 checkout 执行:

npm run learning:ui:setup

随后启动 Web 或 Desktop,从侧栏打开「量子学习通」。首次打开会启动本机数据库与课程服务,无需另装全局 PostgreSQL;模型请求使用 OpenQuantum 当前选择的模型。

安装和启动已在 macOS 验证;安装器依赖 /bin/sh,尚未适配普通 Windows 环境,Linux 也尚未完成验证。新 Git worktree 需要自己的学习应用安装。备份、迁移与平台状态见学习通集成说明。

微信、飞书与其他消息入口的配置

微信、飞书与其他消息入口

npm run cc-connect:setup
npm run cc-connect:feishu
npm run cc-connect:start

第一项平台需先按上游方式配置;可另开终端运行 npm run cc-connect:web 管理其他平台及凭据。Token 保存在 Git 忽略的本地配置中,完整步骤见消息接入说明。

部署方式与启动问题见部署与启动和故障排查。

使用与结果

一次任务跑通以后,你可以选择其他后端、调整计算规模,再带着结果继续研究。

选择合适的入口

学习或修改算法时,从可运行示例开始;需要既定输入输出的计算动作时,选择下面的专业工具。Trotter / qDrift、VQD、Qiskit 和本征求解的相近入口已有统一选择说明,原名称保留,具有不同物理假设或数值方法的实现仍分别提供。

Qiskit Gym、Quantum Hardware 和 FlagQuantum 默认关闭。需要这些服务时,可按训练、设备查询、编译或仿真等用途配置较小的工具范围;未选择时仍使用兼容旧配置的 full。当前会话可调用的工具取决于已启用连接、实际注册状态和所选范围。

本地计算与量子云

本地数值计算无需量子云账户。启用其他工具时,在「设置 → 量子组件 → MCP Server 连接」配置相应连接,重启工作台,再在任务中指定所需后端;默认开关见服务目录。

需要真实硬件时,按服务准备凭据、权限与额度。设备发现、真实任务提交和本地模拟的接入范围分别说明,不能用配置存在代替服务在线或任务成功。

可以连接哪些量子后端

可以连接哪些量子后端

OpenQuantum 为本地模拟、IBM Quantum、IonQ 和多家国内量子云保留明确的接入边界:先发现后端,再由使用者决定是否配置并启用任务接口。下表是集成范围,不是这些服务当前在线可用的证明。

后端当前能力凭据或使用条件
本地计算电路与噪声仿真、基态参考计算、量子态审计、纠错采样、优化与实验模拟;各有输入范围数值计算无需云凭据;计算前显式准备锁定依赖
IBM QuantumRuntime、AI Transpiler、硬件查询,可选真实任务提交与取消QISKIT_IBM_TOKEN,任务类 MCP Server 连接按需开启
IonQ硬件查询,可选真实任务提交、取消与成本估算IONQ_API_KEY,任务类 MCP Server 连接按需开启
本源量子云只读后端发现(FieldQKit);另经 QPanda3 Runtime MCP Server 查询悟空 QPU,并可选提交采样、期望值与批量任务ORIGIN_API_TOKEN 只读发现;QPANDA3_API_KEY 可选开启真机任务
夸父量子云凭据检查、后端发现、量子位筛选、拓扑与校准摘要QUAFU_API_TOKEN,只读
天衍量子云凭据检查、后端发现、量子位筛选、拓扑与校准摘要TIANYAN_API_TOKEN,只读
国盾量子云凭据检查、后端发现、量子位筛选、拓扑与校准摘要GUODUN_API_TOKEN,只读
腾讯量子云凭据检查、后端发现、量子位筛选、拓扑与校准摘要TENCENT_API_TOKEN,只读
FieldQuantum云端模拟后端发现FIELDQUANTUM_API_TOKEN,只读
逻辑比特量子云凭据检查、后端发现、量子位筛选、拓扑与校准摘要LOGICALQUBIT_API_TOKEN,只读

硬件任务和付费服务按需开启。后端发现类能力保持只读,适合先了解设备、拓扑和校准信息,再决定是否进入真实任务流程。

这里的“只读”仅指不改变云端/QPU 状态。本地 Python 计算桥接在调用前显式准备锁定环境; 计算 Tool 不再自动安装依赖。SDK 缓存和结果物化仍可能写入工作区,因此保留相应 workspace-write 合同。

计算参数与运行方式

在各工具支持的模型与输入范围内,你可以选择量子位数、电路长度、Hamiltonian 项数、采样量和迭代预算。可用参数与规模以具体工具接口为准,运行能力取决于所选算法、后端和计算资源;限定模型的参考案例不代表所有工具的适用范围。

主计算与精确对照分开:可以直接优化电路、生成 MBQC 模式、做对称性降维、分析 Lie 代数或运行张量算法。需要额外验证时,通过 referenceMode 选择自动、强制执行或跳过独立参考。完整参数、返回值和资源配置见本地计算说明。

本地核验的具体输入、版本和结果保留在各接入文档的验证记录中,便于复现。

更多可复制的计算任务

电路、基态、噪声、动力学与基准查询示例

先完成模型配置,再按所选能力准备固定依赖。以下本地计算无需量子云账户;使用 uv 的能力准备各自的固定 Python 环境,版本见相应说明,Dynamiqs 使用已安装的 JAX 后端。升级后重启工作台并新建会话。

能力准备命令
SQD 与 TeNPynpm run capability:paper-tools:setup -- sqd-chemistry tenpy-ground-state
Trotter / qDriftnpm run capability:hamiltonian:setup
Mitiq 误差缓解npm run capability:mitiq:setup
Dynamiqs、Clifft、OQuPy、Deltakitnpm run capability:unitary:setup
Bloqade Analognpm run capability:bloqade:setup
国内外厂商 SDK:可微分、编译、优化、光子与设备模型npm run capability:vendor-sdks:setup;17 项范围、许可与调用示例
公司与机构 SDK:编译、仿真、化学与资源估算npm run capability:sdk-expansion:setup 准备 14 个默认连接环境;20 项范围与可选入口
网络、控制、光学与云 SDKnpm run capability:sdk-gaps:setup 准备 7 个默认连接环境;15 项范围与可选入口
Clifft 记录采样与 qBraid 转换;QDMI 驱动查询npm run capability:interop:setup;QDMI 另运行 npm run capability:qdmi:setup 并启用连接,见接入说明
Metriq 公开基准查询已随源码提供,完成 npm ci 即可,无需 Python 或额外下载
想探索什么示例请求重点查看
演化精度与资源用 hamiltonian-simulation 从两量子位全零态出发,模拟 H = XX + 0.5 ZI 的无量纲演化 t=1;分别使用二阶 Trotter、4 步和 8 步,要求独立精确参考,返回末态并比较酉矩阵误差与电路资源。Pauli 字符从左到右为 q0、q1;步数与误差、资源的关系
电路互操作用 qBraid 把三量子位电路 H(0)、CX(0,2) 从 Qiskit 转为 Cirq,保留空闲 q1,并检查完整酉矩阵在忽略整体相位后是否一致。空闲量子位、位序、转换路径与实际参考状态
T 门干涉用 Clifft 从两量子位全零态出发执行 H(0)、T(0)、H(0)、CX(0,1),无噪声、4096 shots、seed=7;比较位串频数与密度矩阵参考。位串从左到右为 q0、q1;有限采样误差
分子基态用 SQD 计算键长 0.735 Å 的 H₂/STO-3G,使用默认合成样本,报告总能量、同基组 FCI 参考和能量差,并标明样本来源。样本覆盖与能量差;合成样本的结果不构成量子优势证据
多体基态用 TeNPy 计算四站点、自旋 1/2 的开放 Heisenberg 链,Jx=Jy=Jz=1,hx=hz=0。报告 DMRG 能量、精确对角化参考、能量差与纠缠熵,并注明 S=Pauli/2。Hamiltonian 约定、参考结果与收敛情况
噪声缓解效果用 Mitiq 对单量子位 H–RZ(0.7)–H 电路的 Z 期望值做 ZNE。门去极化概率 0.02,每个比较臂每次 8192 shots,重复 8 次、seed=7;比较原始与缓解后的误差和成本。经验偏差、方差和 RMSE;缓解结果也可能变差
纠错码片用 Deltakit 构建 5×3 码片的 Z 存储实验,3 轮、ToyNoise p=0.02、4096 shots、seed=718,返回含噪电路、逻辑失败数和 Wilson 区间。数据量子位尺寸与实际总量子位数;固定采样分母
驱动灵敏度用 Dynamiqs 从计算基态出发,比较驱动幅度 0.5 和 1,失谐 0、衰减率 0.1、时长 1、20 步;采用一致的无量纲单位,返回激发态人口与末态人口对驱动的梯度。自动微分与独立有限差分是否一致
环境记忆用 OQuPy 从 plus 态出发,tunneling=0、bias=0.4、alpha=0.1、cutoff=2、temperature=0、duration=0.5;分别用 steps=memorySteps=8 和 12,与零温纯退相干解析式比较。两组网格保持相同物理记忆时长;此算例不代表整个参数域收敛
公开设备基准查询 Metriq 中 provider 包含 origin 的记录,列出设备、测试时间、基准类型、原始参数和指标,并标明来源。历史数据的基准定义与实验条件;不等同于当前设备性能

只准备所需 SDK 时,运行 node scripts/setup-paper-tools.mjs <capability-id>,能力 ID 见对应接入表。准备环境与启用连接分别完成;云服务的账户、密钥和权限由用户设置。各 SDK 的平台支持与许可不同,安装包验证不表示所有可选 SDK 都已在三个平台运行。

其余论文方法也可按需安装;RandomMeas 随机测量另需 Julia 1.12.7。完整安装与输入范围列出了各项准备条件。

这些能力已运行本地数值或数据检查,并验证了真实 Harness 的调用和会话重读;端到端测试使用本地模型协议替身,未验证外部模型自主执行或真实 QPU。当前保持 L1,返回 scientificValidation=not_evaluated。模型约定、资源配置与验证记录见 Mitiq 接入说明和 Unitary 生态接入说明。

方法与结果可以继续复用

工作台保存任务的请求、工具调用和返回结果,便于查看过程并继续追问。你可以调整参数、选择其他已接入的后端,或把常用研究步骤写成 Skill,供后续任务按需读取。

在支持的能力中,计算结果附带精确参考、独立检查或统计误差信息。基态求解与量子信息审计还提供完整科学验收流程,连接输入、结果文件和会话来源,便于复核。

执行记录与科学验收的详细说明

科研工作台保留请求、Skill 加载、工具调用、权限状态与返回结果,便于追踪一次任务的执行过程。设置中的“已启用”表示配置策略;当前工具是否可调用、服务是否可达,需要查看对应运行证据。

运行完成与科学验收分别显示。具备完整验收流程的能力会把输入、结果文件、独立检查和会话记录连接起来,生成验收报告,列出通过、失败或尚未检查的项目。其他工具按各自范围报告数值结果和检查状态。

从计算结果、证据物化和独立检查,到结合规则与来源链的科学验收

图中展示已接入完整科学验收的能力如何形成证据;查看可编辑图源。

限定量子基态求解与量子信息审计提供完整科学验收流程;QUBO、电路等价性检查和量子纠错存储实验等能力按各自规则报告计算结果与检查。验证依据见能力声明、架构审计和固定量子能力 Benchmark。

候选库接入与回归证据说明新增五项入口、CleitonForge 编译回归样本及 qec-burst-scaling 局域爆发噪声实验;后两项属于开发证据。

常见问题

把你的量子能力接进来

让你的量子软件成为 Agent 可用的能力,让完整应用进入开放平台。 OpenQuantum 的 Agent-ready(面向智能体使用)扩展方式包括:用 Skill 描述工作方法,通过原生 Tool 或 MCP Server 接入计算程序。完整应用按其业务与数据边界独立集成,不必拆成单个 Tool;需要独立科学检查时,再增加 Validator 和相应证据流程。

OpenQuantum 的领域能力运行在 DeepSeek Harness 上,通用 Agent 运行、工具调度、模型连接与执行记录由 Harness 负责。

先确定用户需要解决的任务,再选择扩展方式:

需要增加什么放在哪里
领域知识、步骤、工具选择与结果解释Skill,可复用已有通用或量子 Tool
稳定的计算、查询或操作Tool,由原生 Tool Provider 或 Harness MCP Client 注册
有独立界面和任务流程的量子应用或教学产品按应用边界逐项集成,保留业务、数据、权限和计算后端职责;量子学习通是现有完整应用实例
独立的科学检查与验收Validator;需要最终验收时再组合 Acceptance Profile、证据物化与 central Acceptance Builder

现有 Skill、桥接实现和原生 Tool 可作为扩展参考。先读文档与架构入口,再按需要查阅贡献指南、扩展对象模型和模块地图。

接入面向实际问题的量子应用

OpenQuantum 的接入对象不止是底层 SDK、算法和计算服务,也包括面向明确用户与具体问题的完整应用。应用可以保留自己的交互界面、任务流程、数据管理和结果展示;需要 Agent 协作时,再通过明确的执行接口连接,而不是把所有产品都改写成对话工具。

例如,后续可以探索排程优化、分子与材料计算等场景的完整应用:让使用者提交实际问题、检查输入条件、查看计算结果与适用范围,而不是从单个算法开始搭建流程。这些是接入方向,不是已经交付的应用清单。

已有完整应用集成实例是量子学习通。其他量子应用需要逐项完成适配,明确数据权限、计算后端、运行成本和验证范围;界面接入、Agent 可调用与结果验证分别说明。应用是否使用真实 QPU、是否优于经典方法,应以各自的运行记录与对照结果为准。

架构与职责:了解扩展如何进入平台

OpenQuantum 架构:科研入口进入 Harness,Agent 读取 Skill,通过原生 Tool Provider 或 Harness MCP Client 使用工具,并连接模型服务和执行日志

这张图展示科研工作台的核心调用关系;查看可编辑图源。量子学习通的课程任务和数据沿用完整子应用的职责边界,详见应用集成说明。

在开发文档中,L3 表示具备可回放的完整科学验收流程。Validator 产生检查结果,Acceptance Profile 定义规则,只有 central Acceptance Builder 汇聚检查结果与来源链、推导最终验收状态。能力等级不代表每一次调用都已完成验收。

Skill 与 Tool 可独立存在。计算后端按任务需要选用,只有额外的选择、步骤或解释规则有价值时才增加 Skill。进程内、同语言且无需隔离的动作优先使用原生 Tool Provider;跨语言、独立进程或远程部署时使用 MCP Server,由 Harness MCP Client 注册其 Tool。

Harness 是通用 Agent Runtime,扩展通过 Cordis Plugin 装配。UI、模型连接、量子计算和科学判定各自保持职责边界。完整外部子应用的教学任务与数据归上游应用维护,其任务不自动获得 Harness Session、科研审批或科学验收语义。

能力接口目录

Skill 目录 · MCP 服务目录 · 原生量子 Tools

当前源码分发 154 个内置 Skill、90 个 MCP 服务连接、5 个原生量子 Tool。其中 66 个 Skill 来自 quantum-skills 的开源工作流适配,共用现有代码执行工具;其中 49 项提供可运行示例,覆盖 unitarylab_algorithms 的全部 39 个模块。83 个 MCP 服务使用 OpenQuantum 的本地桥接实现。Skill、Tool 和 MCP 连接分别统计。

当前配置共包含 281 个可配置 Tool 名称:257 个由 MCP 服务提供,18 个为 Harness 通用工具,6 个为平台原生工具(上面的 5 个量子动作及 1 个教学生成动作)。这是配置全集;bash / pwsh 按平台互斥,连接开关、环境和工具范围也会影响实际可调用集合。既有能力的逐项决定见治理记录,新增中性原子动力学见 Bloqade Analog。

内置 Skills:按研究方法查找工作流

内置 Skills

既有条目与治理情况见治理清单;相近入口及大型可选服务的专业工具范围见能力选择。

这 154 个 Skill 覆盖方法选择、计算实验、结果解释和平台诊断。其中 141 项可由 Agent 自动选择,13 个分类索引保留为用户手动导航;原名称和手动调用均可继续使用。点击名称即可查看完整的 SKILL.md;所需工具与连接分别配置。新增算法工作流的参数、安装与开源替换差异见运行说明。

下表按研究方法与用途介绍能力。各 Tool 提供的模型、参数和输入格式见计算参数与运行方式。

电路构建、变换与仿真
Skill研究方法与用途执行入口
qiskit-circuit-workbench量子电路分析、格式转换、转译比较与 Qiskit 文档查证qiskit、qiskit_docs
flagquantum-workbench第二家量子 MCP 电路工作台flagquantum;使用说明
tyxonq-workbench门电路仿真、态矢演化、量子噪声与采样分布分析tyxonq_local
pyzx-optimizationZX 重写、Clifford+T 优化与电路提取pyzx_local
compact-optimization线路优化与独立等价对照compact_local;使用说明
hamiltonian-simulationTrotter/qDrift 演化电路、态矢量与独立误差对照hamiltonian_local;使用说明
qcut-knitting门切割与期望值重建qcut_local;使用说明
graphix-mbqc电路到 MBQC 模式、资源图、自适应测量和纠正输出graphix_local
quantum-circuit-verification量子电路等价性验证、优化前后对照与全局相位差异判定qcec_local
clifft-samplingClifford+T 噪声采样、Stim 格式记录与 detector/observable 原始奇偶值clifft_local
qbraid-conversionQiskit/Cirq 酉电路转换、OpenQASM 2 导出与位序等价对照qbraid_local
量子态与测量
Skill研究方法与用途执行入口
quantum-information-audit量子态合法性检查、密度矩阵性质分析与纠缠诊断toqito_audit;支持完整科学验收流程
randomized-measurements局域随机测量、子区纯度估计与有限样本误差分析random_meas_local
基态、化学与优化方法
Skill研究方法与用途执行入口
quantum-ground-state变分量子本征求解(VQE)、基态能量估计与独立精确参考比较原生 solve_and_validate_ground_state;支持完整科学验收流程
sqd-chemistry量子化学的采样子空间对角化、测量频数后处理与电子基态能量分析sqd_local
tenpy-ground-state张量网络 DMRG 基态求解、磁性观测量与纠缠结构分析tenpy_local
flow-vqe流模型辅助的 VQE 参数学习、低能量态搜索与基线比较flow_vqe_local
openqarp-excited-statesVQD 激发态、残差与正交性openqarp_local;使用说明
cqlib-kernel角度编码核与 QSVMcqlib_kernel_local;使用说明
symmer-tapering指定 Pauli 对称性扇区的降比特与同扇区保谱检查symmer_local
paulie-algebraPauli 生成元的 Lie 代数分类、精确维数与可选闭包paulie_local
qpanda-qubo组合优化问题的 QUBO 建模、约束转换、经典求解与本地 QAOA 对照qpanda_qubo
误差缓解与量子纠错
Skill研究方法与用途执行入口
mitiq-error-mitigation量子误差缓解方法比较、采样预算规划与误差成本分析,涵盖 ZNE、REM、PEC、CDRmitiq_local;使用说明
qec-memory-experiment表面码存储实验、噪声采样、MWPM 译码与逻辑错误率分析qec_local
deltakit-qec表面码码片建模、噪声实验、采样与译码性能分析deltakit_local
ldpc-decoding二元校验矩阵的 BP+LSD 解码与 syndrome 一致性检查ldpc_local
开放系统动力学
Skill研究方法与用途执行入口
dynamiqs-dynamics开放系统 Lindblad 动力学、驱动参数扫描与自动微分灵敏度分析dynamiqs_local
oqupy-dynamics非马尔可夫开放系统动力学、环境记忆效应与 TEMPO 数值收敛分析oqupy_local
tjm-dynamics开放多体系统的张量跳跃轨迹模拟、耗散演化与参考结果比较tjm_local
实验模拟与硬件
Skill研究方法与用途执行入口
qmclaw-workbench超导量子比特调校实验设计、测量流程模拟与合成数据分析,覆盖 S21、Rabi、Ramsey、T₁ 等原生 list_qmclaw_experiments、simulate_qmclaw_experiment
fatqat-workbench量子电路与硬件原生门约束分析、transmon 泄漏及里德堡原子动力学fatqat_local;使用说明
bloqade-analog二维 Rydberg 阵列、分段线性脉冲、逐原子占据与末态概率bloqade_local
fieldqkit-hardware量子云设备发现、量子位与拓扑筛选、接入条件检查fieldqkit;只读设备发现
qdmi-device已配置 QDMI 驱动的设备、门集与耦合关系查询qdmi_local;默认关闭,需显式准备驱动
厂商 SDK 专业入口

新增能力均使用固定依赖;Superstaq 和 QoolQit 按需开启。版本、位序、许可与验证范围见厂商 SDK 接入。

Skill研究方法与用途执行入口
pennylane-differentiable用户电路的概率、Pauli 期望值和参数梯度。pennylane_local
deepquantum-differentiable基于 PyTorch 的电路概率、期望值和参数梯度。deepquantum_local
tensorcircuit-differentiable张量网络电路的概率、期望值和参数梯度。tensorcircuit_local
mindquantum-differentiable本地电路模拟、Pauli 期望值和参数梯度。mindquantum_local
pytket-compilation本地电路优化、门数比较与 OpenQASM 导出。pytket_local
ocean-optimization二值二次模型的本地穷举或模拟退火;不是量子退火硬件执行。ocean_local
kaiwu-qubo社区版符号 QUBO、约束罚项和 Ising 转换;不使用企业版或真机。kaiwu_local
pyquil-simulation本地 Quil 电路模拟,不提交 Rigetti 云作业。pyquil_local
spinqit-simulation量旋 SDK 的本地电路模拟,不连接设备。spinqit_local
qutrunk-simulation启科 SDK 的本地电路模拟,不连接设备。qutrunk_local
perceval-photonics用户 Fock 输入、分束器和移相网络的本地光子分布。perceval_local
iqm-circuit-workbenchIQM 原生门转译与本地模拟,不连接真实设备。iqm_local
alicebob-cat-circuits官方本地猫态量子比特模型与电路仿真。alicebob_local
pulser-dynamicsPasqal 全局脉冲、Rydberg 阵列与本地动力学。pulser_local
qoolqit-workbench无量纲 Rydberg 程序编译与本地计算;需审阅上游定制许可证。qoolqit_local
ionq-programs使用官方 SDK 将结构化电路转换为 IonQ QIS 程序;不提交云任务。ionq_local
superstaq-compilation本地程序序列化和可选远程编译;远程操作外发电路,需要账户,不执行 QPU 任务。superstaq_cloud
公司与机构 SDK 补充入口

接入范围、用户凭据配置与验证分层见补充接入说明。

Skill研究方法与用途执行入口
qsteed-compilationPyQuafu 电路编译到指定门集,保留全局相位与线路,不连接资源数据库。qsteed_local
quairkit-informationCPU 密度矩阵电路与去极化、振幅阻尼、相位阻尼通道。quairkit_local
qcompute-simulation使用百度 QCompute 本地模拟器计算电路概率。qcompute_local
qibo-simulation使用明确选定的 NumPy CPU 后端计算态矢量。qibo_local
qrisp-arithmetic本地 QuantumFloat 无符号模加法;需考虑 EPL-2.0 许可。qrisp_local
lightworks-photonics本地线性光学网络与 Fock 输入的输出概率。lightworks_local
braket-simulation显式 LocalSimulator 电路振幅与概率,不创建 AWS 云任务。braket_local
quri-parts-estimationQURI Parts 电路与 Qulacs 本地 Pauli 期望值。quri_parts_local
qdk-resource-estimation由电路和硬件假设估算物理量子位与运行时间。qdk_local
qualtran-resources算术 Bloq 的容错门资源;实验性 API,保留计数假设。qualtran_local
openfermion-mapping结构化费米算符到 Jordan-Wigner 或 Bravyi-Kitaev Pauli 项。openfermion_local
mqt-ddsim使用决策图模拟电路,返回指定计算基态概率。mqt_ddsim_local
mqt-qmap将电路映射到耦合图,返回物理线路及逻辑输入、输出映射。mqt_qmap_local
classiq-synthesis本地模型准备及可选云端综合;用户自行配置 Token 和服务权限。classiq_cloud
qctrl-workbench本地 Boulder Opal 控制图与已有 Boulder/Fire Opal 作业状态查询。qctrl_cloud
qua-programs本地生成 OPX 脉冲程序与配置,不连接 QOP 服务。qua_local
laboneq-control离线脉冲编译与 HDAWG 输出波形仿真,不执行设备程序。laboneq_local
qcarchive-query只读查询既有单点记录,返回分子、原子单位能量和计算来源。qcarchive_data
cudaq-simulation固定 qpp-cpu 后端的精确概率与采样;Linux 或 Apple Silicon macOS。cudaq_local
netqasm-network本地双节点 EPR 程序编译;仿真需用户自行准备有许可的 NetSquid 环境。netqasm_local
网络、控制、光学与云接口补充

实际动作、固定版本和鉴权设置见本批说明。

Skill研究方法与用途执行入口
simqn-networkSimQN 单链路的离散事件、随机损失与 Werner 衰减。simqn_local
qcover-optimizationQcover 按图分解评估给定 QAOA 参数的能量与相关量。qcover_local
vqnet-learningVQNet CPU 电路期望、概率与每个旋转参数的自动微分。vqnet_local
pychemiq-chemistrypyChemiQ 费米算符到 Jordan–Wigner Pauli 项,保留微小系数。pychemiq_local
qblox-schedulingQblox 方波排程和波形采样,不连接 HardwareAgent。qblox_local
qililab-controlQililab 将 I/Q 方波离线编译到 Qblox Q1ASM。qililab_local
guppy-programsGuppy/Selene 的中途测量、复位和经典条件反馈仿真。guppy_local
oqc-qatQAT 脉冲时序与复基带波形,不执行后端测量。qat_local
mrmustard-opticsMrMustard 高斯光学矩和截断 Fock 概率;上游已归档。mrmustard_local
merlin-learningMerLin 完整 Fock 概率、批量推断与相移梯度。merlin_local
mimiq-simulationMIMIQ Exaqt 本地态矢量和种子采样。mimiq_local
myqlm-simulationmyQLM PyLinalg 本地理想电路仿真。myqlm_local
aqt-workbenchAQT 原生门编译、离线采样与可选设备查询。aqt_local
oqc-cloudOQC 本地任务准备、查询及显式单次云提交。oqc_cloud
quantuminspire-cloudQuantum Inspire 分页设备类型与既有任务状态查询。quantuminspire_cloud
方法选型与平台支持
Skill研究方法与用途执行入口
quantum-sdk-advisor量子 SDK 选型、迁移比较与 PoC 技术路线规划知识型 Skill,按任务使用已有通用 Tool
platform-diagnostics工作台、工具与模型联调排障,形成可追溯的诊断报告Harness 通用 Tool 与本地诊断脚本
开源算法与后端工作流

66 个适配 Skill 共用现有执行工具;49 个算法示例覆盖原库的 39 个模块和指南新增方法。13 个分类索引保留为手动导航,53 个方法与入口可由 Agent 自动选择。

Skill研究方法与用途执行入口
quantum-guide-algorithmsalgorithms 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-guide-algorithms-cryptographyalgorithms/cryptography 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-discrete-log可逆 g^a y^b oracle、循环群 Fourier 采样与同余恢复已有 Harness bash / pwsh;discrete_log 开源示例
quantum-shor可逆模乘 oracle、QPE/连分数和因子验证已有 Harness bash / pwsh;shor 开源示例
quantum-simon二对一 XOR oracle、Hadamard 采样和 GF(2) 零空间恢复已有 Harness bash / pwsh;simon 开源示例
quantum-guide-algorithms-eigensolversalgorithms/eigensolvers 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-numpy-minimum-eigensolverNumPy 最小本征对,明确标记经典算法并报告残差。已有 Harness bash / pwsh;numpy_minimum_eigensolver 开源示例
quantum-numpy-eigensolverNumPy Hermitian 稠密本征求解,明确标记经典算法并报告特征残差。已有 Harness bash / pwsh;numpy_eigensolver 开源示例
quantum-vqd通过逐态重叠惩罚求激发态(VQD),报告能量与态间重叠已有 Harness bash / pwsh;vqd 开源示例
quantum-guide-algorithms-gradientsalgorithms/gradients 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-finite-differenceQiskit FiniteDiffEstimatorGradient,中心差分与显式 epsilon。已有 Harness bash / pwsh;finite_difference 开源示例
quantum-linear-combinationQiskit LinCombEstimatorGradient,实际生成线性组合导数电路。已有 Harness bash / pwsh;linear_combination 开源示例
quantum-parameter-shiftQiskit ParamShiftEstimatorGradient,RY 参数移位规则。已有 Harness bash / pwsh;parameter_shift 开源示例
quantum-qfiQiskit QFI/ReverseQGT,纯态量子 Fisher 信息已有 Harness bash / pwsh;qfi 开源示例
quantum-reverseQiskit ReverseEstimatorGradient,反向态矢量导数。已有 Harness bash / pwsh;reverse 开源示例
quantum-spsaQiskit SPSAEstimatorGradient,显式 epsilon、批量与随机种子已有 Harness bash / pwsh;spsa 开源示例
quantum-guide-algorithms-hamiltonian-simulationalgorithms/hamiltonian-simulation 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-cartan实对称 Hamiltonian 的 SO(N) 谱 Cartan 分解已有 Harness bash / pwsh;cartan 开源示例
quantum-qdrift使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;qdrift 开源示例
quantum-hamiltonian-qsp偶/奇 QSP 多项式通过 LCU 合成 exp(-iHt)已有 Harness bash / pwsh;hamiltonian_qsp 开源示例
quantum-taylor截断 Taylor 级数展开为 Pauli LCU,实际执行 PREPARE/SELECT/unprepare 并报告后选择概率已有 Harness bash / pwsh;taylor 开源示例
quantum-trotter使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;trotter 开源示例
quantum-guide-algorithms-linear-systemsalgorithms/linear-systems 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-aqc正定 Hermitian 系统的绝热线性求解路径、条件数相关 schedule 与分片幺正演化已有 Harness bash / pwsh;aqc 开源示例
quantum-hhlHermitian 非奇异 A、QPE、有符号倒数旋转、反 QPE 与后选择已有 Harness bash / pwsh;hhl 开源示例
quantum-lcu使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;lcu 开源示例
quantum-qsvt-qlsaHermitian 非奇异矩阵,PennyLane QSVT 和受控 U/U† 后选择已有 Harness bash / pwsh;qsvt_qlsa 开源示例
quantum-qft使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;qft 开源示例
quantum-qspQSP/QSVT 相位综合计算 cos(t x) 的有界偶次多项式已有 Harness bash / pwsh;qsp 开源示例
quantum-vqlsQiskit 参数电路与全局归一化残差 cost 的变分线性求解已有 Harness bash / pwsh;vqls 开源示例
quantum-guide-algorithms-primitivesalgorithms/primitives 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-amplitude-amplification使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;amplitude_amplification 开源示例
quantum-amplitude-estimation使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;amplitude_estimation 开源示例
quantum-grover使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;grover 开源示例
quantum-hadamard-test使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;hadamard_test 开源示例
quantum-hadamard-transform使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;hadamard_transform 开源示例
quantum-qpe使用 Qiskit 的显式量子电路,保留输入、方法参数、实际概率或态矢量已有 Harness bash / pwsh;qpe 开源示例
quantum-guide-algorithms-quantum-chemistryalgorithms/quantum-chemistry 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-molecular-dmrgPySCF 活性空间积分、Jordan-Wigner MPO 与 quimb 双站点 DMRG。使用开源态制备替换闭源 CVD已有 Harness bash / pwsh;molecular_dmrg 开源示例
quantum-qldpcHGP CSS 校验矩阵、GF(2) 秩、交换关系和 syndrome已有 Harness bash / pwsh;qldpc 开源示例
quantum-guide-algorithms-quantum-machine-learningalgorithms/quantum-machine-learning 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-cvqnn两模有限 Fock 空间的位移、压缩、旋转、Kerr 和分束器层已有 Harness bash / pwsh;cvqnn 开源示例
quantum-fermi-hubbard-vqe开放边界 Hubbard 链,Jordan-Wigner 与全 Fock 空间 VQE已有 Harness bash / pwsh;fermi_hubbard_vqe 开源示例
quantum-ising开放边界二维矩形 Ising 网格,quimb MPS 与二阶 Strang 演化已有 Harness bash / pwsh;ising 开源示例
quantum-qaoa无权 MaxCut 的交替 cost/mixer 电路与参数优化已有 Harness bash / pwsh;qaoa 开源示例
quantum-qcbm参数电路 Born 分布拟合目标概率,KL 目标与 total variation 对照。已有 Harness bash / pwsh;qcbm 开源示例
quantum-vqcRY 特征编码与参数电路二分类已有 Harness bash / pwsh;vqc 开源示例
quantum-vqe实 Pauli Hamiltonian、RY/RZ/CX ansatz 和 SciPy 优化已有 Harness bash / pwsh;vqe 开源示例
quantum-guide-algorithms-schrodingerizationalgorithms/schrodingerization 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-advection周期边界、常速一维平流,中心差分和显式薛定谔化电路已有 Harness bash / pwsh;advection 开源示例
quantum-heat-1d齐次一维热方程,周期或零 Dirichlet 边界已有 Harness bash / pwsh;heat_1d 开源示例
quantum-heat-2d齐次二维方形网格热方程,周期或零 Dirichlet 边界已有 Harness bash / pwsh;heat_2d 开源示例
quantum-guide-algorithms-searchalgorithms/search 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-glued-trees随机交替叶环连接的双树连续时间邻接矩阵量子行走已有 Harness bash / pwsh;glued_trees 开源示例
quantum-hidden-shift偶数位二次 bent 函数的 shifted/dual 相位 oracle已有 Harness bash / pwsh;hidden_shift 开源示例
quantum-guide-algorithms-state-preparationalgorithms/state-preparation 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-mottonenPennyLane Möttönen 均匀受控旋转态制备已有 Harness bash / pwsh;mottonen 开源示例
quantum-mpsSVD 分解、可选键截断、显式右规范化与 PennyLane MPSPrep已有 Harness bash / pwsh;mps 开源示例
quantum-multiplexerQiskit StatePreparation/Isometry 的均匀受控门合成已有 Harness bash / pwsh;multiplexer 开源示例
quantum-pauliPennyLane ArbitraryStatePreparation 的 Pauli 旋转优化已有 Harness bash / pwsh;pauli 开源示例
quantum-superpositionPennyLane Superposition 的计算基叠加与辅助位清零已有 Harness bash / pwsh;superposition 开源示例
quantum-algorithmsroot 分类、后端或迁移指引按任务组合已有 Skill 和通用 Tool
quantum-guide-simulatorssimulators 分类、后端或迁移指引手动分类导航;自动任务直接选择方法 Skill
quantum-guide-simulators-pennylanesimulators/pennylane 分类、后端或迁移指引按任务组合已有 Skill 和通用 Tool
quantum-guide-simulators-qiskitsimulators/qiskit 分类、后端或迁移指引按任务组合已有 Skill 和通用 Tool
quantum-guide-simulators-unitarylabsimulators/unitarylab 分类、后端或迁移指引按任务组合已有 Skill 和通用 Tool
MCP 服务目录:用途、默认开关与准备条件

MCP 服务目录

OpenQuantum 为 67 项计算与设备发现能力开发了本地 MCP 桥接,另直接接入 8 个上游 MCP 服务。下表按用途分组:本地桥接链接到仓库源码并保留上游来源,直接接入的服务明确标记为“上游服务”。

默认 Preset 共声明 90 个 MCP 服务连接:65 个默认开启(其中 Qiskit 两项可通过离线开关关闭),25 个按需启用。连接名对应配置中的 serverName;“默认开启”表示配置策略,使用前仍需准备依赖和必要凭据。

这些 MCP Server 都由本机以 stdio 方式启动,不是 OpenQuantum 提供的公共托管端点。其中一部分 Tool 在本地计算,另一部分再访问厂商文档或量子云;“本地启动 MCP Server”不代表所有数据处理都留在本地。

本地电路工作流
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
qiskit · Qiskit Circuits(上游服务)电路读取、分析、转译与 QASM/QPY 转换默认开启¹uvx;电路操作无需云凭据,首次启动可能下载依赖
flagquantum · FlagQuantum(上游服务)第二家量子 MCP 电路工作台默认关闭Python 3.12 + uv;本地计算、无需云凭据;范围
tyxonq_local · TyxonQ电路与噪声仿真默认关闭手动开启;显式准备较大的 Python 环境,无需云凭据
pyzx_local · PyZXZX 重写、Clifford+T 优化与电路提取默认开启uv;隔离 Python 3.12 环境;安装与范围
compact_local · Compact线路优化与独立等价对照默认开启Python 3.12 + uv;本地计算、无需云凭据;范围
hamiltonian_local · UnitaryLab MIT 算法适配Trotter/qDrift 哈密顿量演化默认开启显式运行 npm run capability:hamiltonian:setup;Qiskit/NumPy/SciPy 开放依赖;范围
qcut_local · QCut门切割与期望值重建默认开启Python 3.12 + uv;本地计算、无需云凭据;范围
graphix_local · Graphix电路到 MBQC 模式、资源图、自适应测量和纠正输出默认开启uv;隔离 Python 3.12 环境;安装与范围
qcec_local · MQT QCECunitary 电路等价性检查默认开启uv;本地运行,无需云凭据;不接受动态电路或任意文件路径
clifft_local · ClifftClifford+T 最终测量与 Stim 格式纠错记录采样默认开启uv;CPU 固定 shots,原始奇偶值需另行解码;安装与范围
qbraid_local · qBraidQiskit/Cirq 双向本地转换与可选完整酉矩阵对照默认开启uv;结构化酉电路,无云任务;安装与范围
量子态与测量
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
toqito_audit · toqito密度矩阵与纠缠指标计算、独立检查;可接物化验收链默认开启uv;本地运行,无需云凭据;完整调用会保存科研证据
random_meas_local · RandomMeas.jl局域随机测量与子区纯度估计默认开启Julia 1.12.7;先准备固定依赖;安装与范围,不连接云硬件
基态、化学与优化方法
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
sqd_local · Qiskit SQD分子与活性空间 SQD、可选 FCI 参照默认开启uv;安装与范围,不连接云硬件
tenpy_local · TeNPy有限 XYZ 链 DMRG 基态与精确参照默认开启uv;安装与范围,不连接云硬件
flow_vqe_local · Flow-VQEPauli Hamiltonian 的 flow 参数学习与随机搜索比较默认开启uv;安装与范围,不连接云硬件
openqarp_local · OpenQARPVQD 激发态、残差与正交性默认开启Python 3.12 + uv;本地计算、无需云凭据;范围
cqlib_kernel_local · cqlib-qml角度编码核与 QSVM默认关闭Python 3.12 + uv;本地计算、无需云凭据;首次构建需 Rust ≥1.89,固定 beta SDK;范围
symmer_local · Symmer指定 Pauli 对称性扇区的降比特与同扇区保谱检查默认开启uv;隔离 Python 3.12 环境;安装与范围
paulie_local · PauLiePauli 生成元的 Lie 代数分类、精确维数与可选闭包默认开启uv;隔离 Python 3.12 环境;安装与范围
qpanda_qubo · QPanda QUBOQUBO 编译、枚举复核、经典求解与可选本地 QAOA默认开启uv;本地 CPU 模拟器,无需本源云凭据
误差缓解与纠错
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
mitiq_local · MitiqZNE、REM、PEC、CDR 噪声实验与有限采样统计默认开启uv;隔离 Python 3.12 环境,能力目录 GPL-3.0-only;接入说明
qec_local · Stim + PyMatchingsurface-code memory 实验、MWPM 解码与逻辑错误率统计默认开启uv;本地运行,无需云凭据;用户选择 shots、seed 与噪声参数
deltakit_local · Deltakit纠错存储电路构建与本地噪声实验默认开启uv;ToyNoise、Stim、PyMatching;安装与范围
ldpc_local · BP+LSD二元校验矩阵的纠错解码与 syndrome 检查默认开启uv;安装与范围,不连接云硬件
开放系统动力学
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
dynamiqs_local · Dynamiqs驱动扫描、耗散动力学与自动微分默认开启uv、隔离 Python 3.12;安装与范围
oqupy_local · OQuPyOhmic spin-boson TEMPO默认开启uv;独立 NumPy 1.x 环境;安装与范围
tjm_local · MQT YAQS / TJM开放 Ising 链张量轨迹与 Lindblad 参照默认开启uv;安装与范围,不连接云硬件
实验模拟
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
fatqat_local · FatQat电路与硬件约束、超导和中性原子脉冲动力学默认开启显式准备锁定 Python 环境;数值计算本地运行,无云凭据或 QPU 操作
bloqade_local · Bloqade Analog自定义二维阵列与全局时变脉冲的本地 Rydberg 仿真默认开启Python 3.12 + uv;显式准备环境,无需云凭据;使用说明
国内外厂商 SDK
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
pennylane_local · pennylane用户电路的概率、Pauli 期望值和参数梯度。默认开启显式准备独立环境;版本与边界
deepquantum_local · deepquantum基于 PyTorch 的电路概率、期望值和参数梯度。默认开启显式准备独立环境;版本与边界
tensorcircuit_local · tensorcircuit张量网络电路的概率、期望值和参数梯度。默认开启显式准备独立环境;版本与边界
mindquantum_local · mindquantum本地电路模拟、Pauli 期望值和参数梯度。默认开启显式准备独立环境;版本与边界
pytket_local · pytket本地电路优化、门数比较与 OpenQASM 导出。默认开启显式准备独立环境;版本与边界
ocean_local · dimod + dwave-samplers二值二次模型的本地穷举或模拟退火;不是量子退火硬件执行。默认开启显式准备独立环境;版本与边界
kaiwu_local · kaiwu-community社区版符号 QUBO、约束罚项和 Ising 转换;不使用企业版或真机。默认开启显式准备独立环境;版本与边界
pyquil_local · pyquil本地 Quil 电路模拟,不提交 Rigetti 云作业。默认开启显式准备独立环境;版本与边界
spinqit_local · spinqit量旋 SDK 的本地电路模拟,不连接设备。默认开启显式准备独立环境;版本与边界
qutrunk_local · qutrunk启科 SDK 的本地电路模拟,不连接设备。默认开启显式准备独立环境;版本与边界
perceval_local · perceval-quandela用户 Fock 输入、分束器和移相网络的本地光子分布。默认开启显式准备独立环境;版本与边界
iqm_local · iqm-clientIQM 原生门转译与本地模拟,不连接真实设备。默认开启显式准备独立环境;版本与边界
alicebob_local · qiskit-alice-bob-provider官方本地猫态量子比特模型与电路仿真。默认开启显式准备独立环境;版本与边界
pulser_local · pulser-core + pulser-simulationPasqal 全局脉冲、Rydberg 阵列与本地动力学。默认开启显式准备独立环境;版本与边界
qoolqit_local · qoolqit无量纲 Rydberg 程序编译与本地计算;需审阅上游定制许可证。默认关闭显式准备独立环境;版本与边界
ionq_local · qiskit-ionq使用官方 SDK 将结构化电路转换为 IonQ QIS 程序;不提交云任务。默认开启显式准备独立环境;版本与边界
superstaq_cloud · qiskit-superstaq本地程序序列化和可选远程编译;远程操作外发电路,需要账户,不执行 QPU 任务。默认关闭显式准备独立环境;版本与边界
公司与机构 SDK 补充连接
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
qsteed_local · BAQISPyQuafu 电路编译到指定门集,保留全局相位与线路,不连接资源数据库。默认开启显式准备独立环境;版本、配置与范围
quairkit_local · QuAIRCPU 密度矩阵电路与去极化、振幅阻尼、相位阻尼通道。默认开启显式准备独立环境;版本、配置与范围
qcompute_local · Baidu使用百度 QCompute 本地模拟器计算电路概率。默认开启显式准备独立环境;版本、配置与范围
qibo_local · Qibo / TII / INFN使用明确选定的 NumPy CPU 后端计算态矢量。默认开启显式准备独立环境;版本、配置与范围
qrisp_local · Eclipse / Fraunhofer本地 QuantumFloat 无符号模加法;需考虑 EPL-2.0 许可。默认关闭显式准备独立环境;版本、配置与范围
lightworks_local · Aegiq本地线性光学网络与 Fock 输入的输出概率。默认开启显式准备独立环境;版本、配置与范围
braket_local · Amazon显式 LocalSimulator 电路振幅与概率,不创建 AWS 云任务。默认开启显式准备独立环境;版本、配置与范围
quri_parts_local · QunaSysQURI Parts 电路与 Qulacs 本地 Pauli 期望值。默认开启显式准备独立环境;版本、配置与范围
qdk_local · Microsoft由电路和硬件假设估算物理量子位与运行时间。默认开启显式准备独立环境;版本、配置与范围
qualtran_local · Google Quantum AI算术 Bloq 的容错门资源;实验性 API,保留计数假设。默认开启显式准备独立环境;版本、配置与范围
openfermion_local · Google Quantum AI结构化费米算符到 Jordan-Wigner 或 Bravyi-Kitaev Pauli 项。默认开启显式准备独立环境;版本、配置与范围
mqt_ddsim_local · TUM / MQT使用决策图模拟电路,返回指定计算基态概率。默认开启显式准备独立环境;版本、配置与范围
mqt_qmap_local · TUM / MQT将电路映射到耦合图,返回物理线路及逻辑输入、输出映射。默认开启显式准备独立环境;版本、配置与范围
classiq_cloud · Classiq本地模型准备及可选云端综合;用户自行配置 Token 和服务权限。默认关闭显式准备独立环境;版本、配置与范围
qctrl_cloud · Q-CTRL本地 Boulder Opal 控制图与已有 Boulder/Fire Opal 作业状态查询。默认关闭显式准备独立环境;版本、配置与范围
qua_local · Quantum Machines本地生成 OPX 脉冲程序与配置,不连接 QOP 服务。默认开启显式准备独立环境;版本、配置与范围
laboneq_local · Zurich Instruments离线脉冲编译与 HDAWG 输出波形仿真,不执行设备程序。默认开启显式准备独立环境;版本、配置与范围
qcarchive_data · MolSSI只读查询既有单点记录,返回分子、原子单位能量和计算来源。默认关闭显式准备独立环境;版本、配置与范围
cudaq_local · NVIDIA固定 qpp-cpu 后端的精确概率与采样;Linux 或 Apple Silicon macOS。默认关闭显式准备独立环境;版本、配置与范围
netqasm_local · QuTech本地双节点 EPR 程序编译;仿真需用户自行准备有许可的 NetSquid 环境。默认关闭显式准备独立环境;版本、配置与范围

固定版本、显式准备和凭据配置见SDK 补充接入说明。

网络、控制、光学与云接口补充
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
simqn_local · qnsSimQN 单链路的离散事件、随机损失与 Werner 衰减。默认关闭显式准备;版本、配置与边界
qcover_local · QcoverQcover 按图分解评估给定 QAOA 参数的能量与相关量。默认开启显式准备;版本、配置与边界
vqnet_local · pyvqnetVQNet CPU 电路期望、概率与每个旋转参数的自动微分。默认关闭显式准备;版本、配置与边界
pychemiq_local · pychemiqpyChemiQ 费米算符到 Jordan–Wigner Pauli 项,保留微小系数。默认开启显式准备;版本、配置与边界
qblox_local · qblox-schedulerQblox 方波排程和波形采样,不连接 HardwareAgent。默认开启显式准备;版本、配置与边界
qililab_local · qililabQililab 将 I/Q 方波离线编译到 Qblox Q1ASM。默认开启显式准备;版本、配置与边界
guppy_local · guppylangGuppy/Selene 的中途测量、复位和经典条件反馈仿真。默认开启显式准备;版本、配置与边界
qat_local · qat-compilerQAT 脉冲时序与复基带波形,不执行后端测量。默认开启显式准备;版本、配置与边界
mrmustard_local · mrmustardMrMustard 高斯光学矩和截断 Fock 概率;上游已归档。默认关闭显式准备;版本、配置与边界
merlin_local · merlinquantumMerLin 完整 Fock 概率、批量推断与相移梯度。默认开启显式准备;版本、配置与边界
mimiq_local · mimiq-exaqtMIMIQ Exaqt 本地态矢量和种子采样。默认关闭显式准备;版本、配置与边界
myqlm_local · myqlmmyQLM PyLinalg 本地理想电路仿真。默认关闭显式准备;版本、配置与边界
aqt_local · qiskit-aqt-providerAQT 原生门编译、离线采样与可选设备查询。默认关闭显式准备;版本、配置与边界
oqc_cloud · oqc-qcaas-clientOQC 本地任务准备、查询及显式单次云提交。默认关闭显式准备;版本、配置与边界
quantuminspire_cloud · quantuminspireQuantum Inspire 分页设备类型与既有任务状态查询。默认关闭显式准备;版本、配置与边界
资料与设备发现
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
qiskit_docs · Qiskit Docs(上游服务)Qiskit 文档搜索、页面读取和 IBM Quantum 错误码查询默认开启¹uvx;文档访问需要网络,无需云凭据
fieldqkit · FieldQKit凭据状态检查、国内量子云后端发现和筛选默认开启uv;发现对应云后端需要相应凭据;不提交或取消任务
qdmi_local · QDMI设备、门集与耦合的只读发现默认关闭显式准备固定驱动;官方示例不代表真实硬件;安装与范围
量子云任务
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
qiskit_ibm_runtime · IBM Runtime(上游服务)IBM 后端查询、任务提交、结果读取与取消默认关闭手动开启;uvx、IBM Token 与可用账户额度;任务操作可能产生费用
quantum_hardware · 社区硬件服务(上游服务)IBM / IonQ 设备查询、任务提交与取消、成本估算默认关闭先安装固定源码并配置 IBM Token;IonQ 操作另需相应 Key;真实任务需授权
qpanda_runtime · 本源运行时(上游服务)悟空 QPU 设备查询,采样、期望值、批量任务与任务管理默认关闭先安装固定源码并配置本源凭据;真实任务需要权限、额度与授权
专用转译与训练服务
MCP 服务 / 连接名能提供什么工具能力默认配置使用条件与边界
qiskit_ibm_transpiler · IBM Transpiler(上游服务)AI 电路路由、综合与混合转译默认关闭手动开启;uvx、IBM Token 与服务权限;调用 IBM 服务
qiskit_gym · Qiskit Gym(上游服务)强化学习电路综合、训练环境与模型管理默认关闭手动开启;uvx;训练、进程和模型文件操作有副作用

¹ 两项 Qiskit 服务在未设置 OPENQUANTUM_DISABLE_QISKIT_MCP=1 时默认开启。设置中心可以覆盖连接策略;修改 MCP 连接配置后需要重启 Harness。

本地桥接中的数值算法和 SDK 来自相应上游项目;OpenQuantum 负责桥接接口、输入范围、调用流程及适用的结果检查。本地计算环境在显式准备时安装;上游服务启动仍可能物化自身依赖,SDK 计算也可能创建缓存。完整调用副作用见能力合同。

启用与验证入口:设置中心 → MCP Server 连接 → 配置必要凭据 → 重启 Harness → 查看运行证据。quantum_hardware 和 qpanda_runtime 还需分别先运行 npm run mcp:quantum-hardware:setup、npm run mcp:qpanda-runtime:setup。完整 Tool 名称与副作用声明见能力合同;连接与凭据引用见 Agent Preset。

原生量子 Tools:动作与副作用

原生量子 Tools

OpenQuantum 提供以下 5 个原生量子动作,用于基态求解、调校实验模拟和研究资料查询。它们由本仓库的原生计算 Tool Provider、算法参考 Tool Provider和 Metriq 数据 Tool Provider在进程内注册,默认 Preset 已包含它们。这里单独统计量子领域动作;Harness 自带的文件、终端等通用 Tools 不计入。

原生 Tool做什么完整调用的边界
solve_and_validate_ground_state计算限定二量子位基态并执行独立检查;完整流程保存结果和会话证据后生成科学验收报告本地科研证据写入,workspace-write;不是通用分子求解或真机任务
list_qmclaw_experiments列出 QMClaw 的 13 类实验及支持范围只读目录查询,read-only;不连接仪器
simulate_qmclaw_experiment运行带 seed 的 QMClaw 合成数据实验只读计算,read-only;不连接 LabRAD/lqms,不写回真实校准参数
quantum_practices搜索和读取 66 份固定版本的算法参考指南,支持中文算法名;用于方法比较、假设核对与实验设计本地资料检索,read-only;不安装或执行 UnitaryLab 模拟器;使用与验证
metriq_benchmarks按厂商、设备、基准类型或文字检索 410 条去重后的公开记录,读取原始参数与指标固定本地快照,read-only;逐次返回来源与 CC-BY-4.0 署名;范围与验证

开发与验证

配置检查、数值回归与端到端验证
# 检查 Harness 组合配置
npm run harness:config

# 运行完整离线质量检查
npm run check

# macOS/Linux:用固定依赖运行本地数值回归与 Harness 接线验证
npm run capability:mitiq:live
npm run capability:unitary:live
npm run capability:candidates:live
npm run capability:hamiltonian:live
npm run capability:interop:live
npm run capability:algorithms:live
npm run capability:bloqade:live
npm run capability:vendor-sdks:live
npm run capability:sdk-expansion:live
npm run capability:sdk-gaps:live
npm run benchmark:candidate-regressions

# 配置模型后运行真实 Agent 端到端测试
npm run e2e:quantum-harness -- --provider openquantum-public
.agents/skills/          量子 Skill 与科学资源
examples/quantum-algorithms/  可修改的开源算法示例、输入说明与覆盖映射
runtime/openquantum/     Agent Preset、原生 Tool Provider、Harness MCP Client 声明和 Harness 界面扩展
src/settings/server/     设置中心的服务端配置边界
src/readiness/server/    当前 Harness Registry 的只读运行状态边界
scripts/                 启动、诊断和端到端测试
tests/                   平台集成测试
docs/                    架构、路线与生态文档

更完整的文档入口见 docs/README.md。

固定量子能力 Benchmark使用 MQT Bench 的 3 个固定电路案例与 manifest 做开发回归,属于开发与 CI 证据,不是 Skill 或 MCP 服务。

源码升级的固定版本、兼容性和验证记录见 2026-09-22 量子库更新及 2026-09-10 平台升级。应用安装包的变化另见v0.6.0 发布说明。

2026-09-24 的算法适配、本地互操作和治理证据分别记录源码接入、实际 SDK 计算与 Harness 会话验证;这些记录不代表新安装包发布、外部模型或真实硬件验收。

可选上游 Skill

OriginQ 官方 pyqpanda3 Skill 提供电路编程、算法模板、迁移与 QCloud 使用指导。它不计入上面的 154 个内置 Skill,也不会在首次启动时自动安装;运行 npm run skill:qpanda:setup 后,固定审阅版本才会进入项目 Skill 目录。安装这个 Skill 不会自动启用 qpanda_runtime,也不会赋予云任务权限。

长期发展规划

从使用已有能力,走向共同创造新能力。 我们将持续建设开放的量子 Agent 与应用平台,让专业方法、计算资源、完整应用、实验仪器和学习资源各有入口,并在适用范围内协作。下面是长期建设方向,不是当前交付清单;能力将通过逐项接入与验证交付。

平台基础

长期主线我们将持续建设什么
0 · 更好用的量子 Agent持续完善任务理解、方法选择、工具调用、结果解释与失败恢复,让用户从提出需求走向实际计算。以真实任务的完成质量、时间与成本衡量进步。
1 · Agent-ready 量子软件生态持续接入专业软件,完善执行接口、领域 Skill 与依赖准备,让工具能够被调用、方法能够被复用。保留适用条件与验证记录,让生态能力更容易进入实际任务。
2 · 量超智融合工作流持续接入本地 CPU、远程 GPU、HPC、量子模拟器与 QPU,探索由 Agent 组织的量子—经典混合计算。按任务的规模、精度、时间与预算选择资源,逐项验证后端接入、工作流编排与协同执行。
3 · 面向智能实验仪器的接口预留标准化设备接口,逐步连接支持程序控制的实验仪器,探索设备发现、实验控制、测量分析与反馈,让计算与真实实验相互衔接。

应用与教学

长期主线我们将持续建设什么
4 · 更多高质量课程建立从基础到前沿的知识地图,持续打造初、中、高阶段的课程,允许按基础和兴趣跨级学习,把概念讲解、动手实验与能力评估连起来。
5 · 面向实际问题的量子应用接入或共建围绕明确问题的完整应用,提供问题输入、计算流程和结果展示,不要求使用者自行编排底层工具。逐项说明所用后端、运行成本、适用范围与验证结果。

个性化与持续改进

长期主线我们将持续建设什么
6 · 个性化主动智能从学习与研究过程中理解每个人的基础、兴趣和目标,主动给出下一步该学什么、用哪个方法,并补齐缺失的前置知识,让课程与工具按人而变,而不是所有人读同一条路径。个性化依据哪些记录、存在哪里、如何关闭都由用户掌握。
7 · 可持续改进的科研能力探索从任务经验到方法与工具改进,再到改进研究过程本身的路径。以新任务对照、独立检查、完整成本和可回退版本检验改进,见下文的 RSI 愿景。

仪器接口方向将参考 Anthropic 的 Model Hardware Standard(MHS) 等探索,从模拟设备与合作实验逐步验证;实时控制与设备约束由相应驱动和控制系统落实。

面向 RSI:让研究改善研究自身

当前状态:平台已有方法、执行与部分科学检查基础,尚未实现 RSI 闭环。 改进提议、独立评估、版本接纳和跨轮收益仍需逐项建立与验证;架构与证据边界继续作为当前实现依据。

让研究不止产生答案,也能留下改善下一次研究的方法与工具。 我们希望探索面向量子科学的递归自我改进(Recursive Self-Improvement,RSI):系统发现自身局限,提出候选改进,经检验后用于后续任务;改进后的系统,又能更有效地产生和验证下一轮改进。

我们把这条探索路径区分为三个层次:

层次希望积累的变化
跨任务积累将经授权的任务经验整理为可复用方法、案例和失败边界,而不只保存聊天记录。
能力改进提出方法选择、工具实现或任务流程的候选变化,在新任务上验证是否改善质量、可靠性或成本。
递归自我改进改善实验设计、候选搜索和独立验证等“产生改进的方法”,并检验它是否提升下一轮改进的效率。

设想中的循环是:真实任务 → 候选改进 → 独立检查与新任务对照 → 授权纳入版本 → 下一轮研究。

例如,电路任务不仅可以产出一个优化后的电路,还可以产出更好的优化策略选择方法。候选策略需要经过独立等价性检查,并在未参与开发的电路上与旧版本比较;进一步改进寻找这些策略的实验过程,才触及递归性的核心。我们关心的是后续任务是否真的受益,而不是增加了多少 Skill、修改了多少代码,或是否换了一个更强的模型。

改进必须与未继承该改进的版本对照,在可比条件下报告基础模型、人工介入、改进与使用的总成本,并检查旧能力是否退化。候选系统不能自行放宽验收规则、删除失败证据或扩大权限;独立评估、用户授权、数据边界与版本回退应作为接纳改进的条件。社区贡献和人类指导可以参与其中,不应全部归为 AI 自主进步。

OpenQuantum 希望为这个方向提供量子专业工作环境:可执行的工具、可复用的方法、可检查的结果,以及其他科研 Agent 也能接入的开放接口。它不需要另造通用 Agent Runtime,也不要求首先训练新的基础模型。长期还希望探索与 CyberEinstein、PRAgent、RunThePaper 的协作,将研究问题、方法重建、证据资产与可执行量子能力连接起来;这是协作设想,不代表已有跨项目自动闭环。

更远的方向,是检验 AI 与量子能力能否相互促进:AI 改进算法、编译和实验方法,改进后的计算与实验能力再支持下一轮研究。是否带来净收益,需要在具体任务上计入制备、测量、纠错和数据传输等成本,不预设量子计算会加速大模型训练或带来无限自我提升。

我们最终希望看到的是:一次研究产生新结果,也留下帮助下一次研究成功的能力。 当前已交付能力及验证范围见核心能力目录。

一起建设 OpenQuantum

把你擅长的一件事,变成更多人可以使用的能力。 一个可复算的研究案例、一份经过检查的负结果、一项减少重复配置的修复,或一个让学习者动手的实验,都可以成为下一项工作的起点。

你想参与什么从这里开始
使用平台、理解现有能力文档总入口、部署与启动、故障排查
贡献 Skill、工具与科学检查开发与扩展、贡献指南
接入完整应用、建设课程与实验应用集成、量子学习通
报告问题、了解项目背景GitHub Issues、项目故事

贡献时注明来源、作者、许可证、适用条件和验证范围,仅分享已获授权的材料。私人会话与未发表数据不默认公开,凭据和密钥不得进入贡献内容。安全问题请按安全政策私密报告。

开始一次量子探索 · 接入你的方法与应用

OpenQuantum · 量子计算,就在指尖。

开源生态与致谢

OpenQuantum 的量子能力建立在开放科学与开源软件之上。我们维护领域 Skill、MCP 桥接、原生 Tool 和适用的科学检查;底层算法库、外部服务及应用基础保留各自的作者、项目名称与许可证。下面说明具体使用与适配关系。

平台与教学应用

使用或适配的项目在 OpenQuantum 中承担的职责
DeepSeek Harness科研工作台的 Agent 运行时与原生 Web UI,负责会话、模型调用、工具调度和执行记录
DSH Desktop桌面客户端基础;OpenQuantum 适配品牌和启动配置,复用科研工作台
CC Connect消息渠道桥接,将微信、飞书等渠道的请求送入科研工作台
OpenMAIC量子学习通的教学应用基础;保留完整界面、服务端与教学流程,适配 OpenQuantum 名称、主题和模型连接;教学范围与进度
计算工具、设备与资料:上游项目及适配关系

计算与分析工具

下表列出计算能力所用的上游项目。除直接接入的 Qiskit MCP Servers 与 FlagQuantum MCP 外,所列能力由 OpenQuantum 编写桥接或进行计算适配;具体工作流与调用入口见能力接口目录。

电路构建、变换与仿真

科研任务使用或适配的项目OpenQuantum 当前支持
电路构建与转译Qiskit MCP Servers创建、分析和转译电路,读写 QASM / QPY
门电路仿真TyxonQ电路的无噪声精确结果与含噪采样
ZX 电路优化PyZXClifford+T 电路的 ZX 重写与提取,返回前后 QASM、门数及可选等价性对照
线路优化Compact固定优化搜索、独立完整酉矩阵与导出电路对照;分列原生门和公共门集成本
电路切割QCut门切割、有限采样期望值重建与实际执行成本;自动切割使用对称 CZ 规范化
第二家电路工作台FlagQuantum MCP按需启用固定上游服务,提供电路分析、转换、仿真及参数操作
测量式量子计算Graphix电路转 MBQC 资源图及测量模式,模拟自适应测量和输出纠正,可选独立态矢比较
电路等价性验证MQT QCEC比较两份无测量的 OpenQASM 2 电路,区分严格等价、相位等价、不等价与不确定
Clifford+T 电路采样ClifftClifford+T 最终位串采样与可选密度矩阵参考;另支持 Stim 格式的中间测量、detector/observable 原始记录
Qiskit/Cirq 电路互转qBraid固定 QASM2 转换路径,保持空闲量子位与编号,可选完整酉矩阵对照

开源算法与工作流

使用或适配的项目在 OpenQuantum 中承担的职责
quantum-skills66 份指南的原生 Skill 适配,保留来源;方法可自动选择,纯分类索引供手动导航
unitarylab_algorithms39 个算法模块的开源工作流覆盖与 Trotter / qDrift 计算适配;保留 MIT 来源,逐项披露实现差异
Qiskit、PennyLane、quimb、PySCF、NumPy / SciPy49 个可执行示例使用的开放计算后端,按方法准备锁定依赖

适配说明与署名见覆盖表和算法示例 NOTICE。

量子态与测量

科研任务使用或适配的项目OpenQuantum 当前支持
量子态与纠缠审计toqito检查输入密度矩阵,计算纯度、部分转置与指定二分割的 negativity
随机测量与纯度估计RandomMeas.jl对已知 product / GHZ 态模拟局域 Haar 测量,估计子区纯度与有限样本误差

基态、化学与优化方法

科研任务使用或适配的项目OpenQuantum 当前支持
量子化学基态Qiskit SQD对分子与活性空间做采样子空间对角化,可选同一活性空间 Hamiltonian 的 FCI 参照
自旋链基态TeNPy对 XYZ 自旋链运行 DMRG,计算能量、磁化、纠缠熵与收敛信息
变分参数学习Flow-VQE对 Pauli Hamiltonian 训练 flow 模型,以无矩阵计算学习低能量电路参数
变分激发态OpenQARP复数态 VQD、独立能量残差与正交性检查、可选精确能谱
量子核分类cqlib-qml五文件角度编码与 QSVM 适配,固定 Rust SDK,保留训练核 jitter、测试集与经典基线
对称性降比特Symmer在指定 Pauli 对称性扇区投影 Hamiltonian,返回降维 Pauli Hamiltonian,可选同扇区能谱对照
电路生成元代数PauLiePauli 生成元的 Lie 分类、精确维数与可选闭包和矩阵检查,区分理想控制条件和硬件结论
组合优化QPanda QUBO将二值目标与线性等式约束编译为 QUBO,进行经典求解、枚举复核或可选本地 QAOA

误差缓解与量子纠错

科研任务使用或适配的项目OpenQuantum 当前支持
误差缓解Mitiq运行 ZNE、REM、PEC、CDR 本地噪声实验,比较相同采样预算下的误差与成本
表面码存储与解码Stim + PyMatchingStim 生成并采样旋转表面码存储电路,PyMatching 做 MWPM 解码,统计逻辑错误率
矩形表面码实验建模Deltakit构建矩形码片与 ToyNoise 含噪电路,运行 X / Z 存储实验并报告逻辑错误区间
二元校验矩阵解码ldpc / BP+LSD对给定校验矩阵和 syndrome 做 BP+LSD 解码,独立复核 syndrome 一致性

开放系统动力学

科研任务使用或适配的项目OpenQuantum 当前支持
马尔可夫动力学与灵敏度Dynamiqs求解受驱动耗散单量子位的 Lindblad 动力学,批量扫描驱动并计算末态人口梯度
非马尔可夫动力学OQuPy用 TEMPO 求解 Ohmic spin-boson 模型,检查时间步长与环境记忆截断的影响
多体开放系统轨迹MQT YAQS / TJM模拟开放 Ising 链的张量跳跃轨迹,可选与密度矩阵 Lindblad 演化比较

实验模拟

科研任务使用或适配的项目OpenQuantum 当前支持
超导测控流程模拟QMClaw适配其调校流程,本地生成 S21、Rabi、Ramsey、T₁ 等实验的合成数据
硬件约束与脉冲仿真FatQat本地电路、超导原生门与原子阵列约束检查,以及三能级 transmon 和里德堡链的参考模型动力学

设备发现与量子云

FieldQKit 提供国内量子云的凭据检查、只读设备发现、量子位筛选与拓扑查询。

QDMI 提供本地 C 驱动设备查询接口;OpenQuantum 适配只读元数据查询,官方示例驱动用于本地接口验证。

IBM Quantum、IonQ 和本源量子是可连接的云服务。任务提交分别由 IBM Runtime、社区 Quantum Hardware 服务和 QPanda3 Runtime 等任务接口提供,配置凭据并启用后可使用;FieldQKit 的当前接入范围是设备发现。

算法资料与公开基准

查询目的来源项目OpenQuantum 当前提供
查找算法说明与参考实现Quantum-Practices本地检索 66 份固定版本算法指南,保留来源链接
查看设备历史基准Metriq data查询 410 条去重历史记录,返回测试条件、原始指标、日期和来源,并保留模拟器标签

License

除明确单独许可的目录外,OpenQuantum 自有代码采用 MIT License,版权所有 © 2026 Xi Zhao。

Mitiq 误差缓解能力目录采用 GPL-3.0-only;该目录的 LICENSE 和 NOTICE 优先适用,详见发行边界。

Metriq 公开数据快照采用 CC-BY-4.0,保留原版 LICENSE、署名与转换说明,每次查询同时返回来源与署名。

DeepSeek Harness、DSH Desktop、OpenMAIC、FatQat、Qiskit MCP Servers、FieldQKit、Quantum Hardware MCP 和其他第三方组件沿用各自的许可证,详细来源见 THIRD_PARTY_NOTICES.md。

界面截图与示意图的版本、来源和适用范围见图片说明。