量子计算，就在指尖
_{Quantum computing, right at your fingertips.}

从桌面客户端、网页到微信，用一句话连接量子算法、工具与云端后端

桌面客户端 · 快速开始 · 量子能力 · 扩展开发 · 架构 · 项目故事 · 参与贡献

打开桌面客户端或网页，或者把 OpenQuantum 接入微信、飞书，你就可以用一句话开始一项量子任务。让 Agent 分析量子电路、查询量子云后端、运行算法，再把结果和完整过程交还给你。

这就是 OpenQuantum，一个开源的量子 Agent 工作台。它把原本散落在代码、文档、云平台和设备接口里的量子能力，放进同一个看得见、用得上的入口。

你可以直接使用已经集成的 Qiskit、FieldQKit、本源量子（OriginQ / QPanda）和量子算法能力。自己的方法和工作流可以做成 Skill，设备与数据源可以由 MCP Server 暴露为 Tool，再经 Harness MCP Client 注册，模型则通过 Provider Route 接入。普通用户可以从自然语言开始，研究机构可以组织科研工作流，量子公司也可以在这套基础上继续开发自己的产品。

OpenQuantum 基于 DeepSeek Harness 构建。Harness 提供会话、工具调度、权限、持久化和执行轨迹，OpenQuantum 在上面组织量子工具、算法 Skill、科学验收和更适合量子工作的产品界面。五分钟版本见架构总览。

OpenQuantum 的第一版，是在 DeepSeek Harness 发布后的三天里做出来的。它从一个很直接的想法开始，把散落在不同仓库、云平台和文档里的量子工具放进同一个工作台，让用户可以直接使用，也让研究机构和量子公司可以继续接入自己的能力。

桌面客户端

OpenQuantum 现在提供 macOS 和 Windows 桌面客户端。它把完整的量子 Agent 工作台放进原生桌面窗口，并提供系统托盘、原生终端和桌面通知；你在客户端里使用的仍然是同一套 OpenQuantum Session、量子 Skill、Tool Provider、模型设置和科学验收。

桌面客户端基于社区开源的 DSH Desktop 适配。OpenQuantum 只接入桌面宿主，不复制 Harness Runtime，也不维护另一套会话和科研状态。

从源码安装

当前发布方式是从 OpenQuantum 仓库启动客户端，不是下载 .dmg 或 .exe 安装包。请先安装 Git 和 Node.js 24，然后执行：

git clone https://github.com/xi-zhao/openQuantum.git
cd openQuantum
npm ci --include=dev
npm run desktop:verify-install
npm run desktop

首次启动会准备 Desktop profile，并可能继续下载 Electron 运行文件；终端出现这类提示时保持窗口开启即可。客户端打开后，在“设置 → 模型”中配置 Provider。要使用内置 Qiskit 等量子工具，还需要安装 uv / uvx。

如果希望通过本地 .env 提供模型配置，macOS 终端运行 cp .env.example .env，Windows PowerShell 运行 Copy-Item .env.example .env，再填写所需值；直接使用设置中心时不需要创建 .env。

不要使用 npm install -g dsh-plugin-desktop 或 npx dsh-plugin-desktop 代替上面的命令：那会启动上游默认客户端，不会加载 OpenQuantum Agent Preset、Skill Provider、Tool Provider 和科学验收组合。OpenQuantum 品牌安装包仍属于后续发布工作。

Web 与 Desktop 共用 .openquantum/dsh 中的本地状态，请先停止 npm run dev 再切换到桌面客户端。

让微信成为量子计算的入口

量子计算过去常常从安装 SDK、配置环境和翻文档开始。OpenQuantum 希望把入口往前推一步。配置好消息渠道后，你可以直接在微信或飞书里发出一条消息，让同一个 OpenQuantum Agent 去调用量子工具。

你在微信里提出问题
  → OpenQuantum 判断应该使用哪个 Skill
  → DeepSeek Harness 调用原生或由 MCP Server 暴露的 Tool
  → 结果回到对话，完整执行轨迹留在工作台

你可以让它检查一段 OpenQASM 电路，比较不同转译方案，查询 IBM Quantum、IonQ 或国内量子云后端，也可以运行 OpenQuantum 已验收的量子基态算法。需要真实硬件或付费服务时，再由使用者配置对应凭据并明确开启。

手机负责提出问题，OpenQuantum 负责连接工具，DeepSeek Harness 负责把整个过程可靠地跑起来。

量子计算，就在指尖。

从一个真实任务开始

下面是一段 OpenQuantum 的实际运行记录。Agent 完成了一次二量子位基态任务，先用 VQE 求解，再用独立计算检查结果。任务结果、工具调用和科学验收都保留在同一条轨迹里。

_{真实运行画面　从任务结果到独立科学检查}

近期能力升级：从能调用到能复核

这一轮不是简单增加几个量子 SDK，而是补齐了四条可运行、可检查、可失败的能力纵切，并建立一套固定 benchmark。 运行时由 Agent Preset 并列组合 Skill 与 Tool Provider：Skill 说明问题和边界，Agent 调用 Tool；Tool 由原生 Tool Plugin 注册，或由 MCP Server 暴露后经 Harness MCP Client 注册。需要科学验收时，Validator 产生 observations，Acceptance Profile 定义规则，central Acceptance Builder 汇聚 Profile、observations 和 provenance 推导 Acceptance。eval 和 benchmark 只属于开发与发布证据，不进入用户运行链。

这些结果证明的是固定输入下的本地执行与计算级 observations，不自动证明量子优势、QEC threshold 或真实硬件性能。 新增能力在 Result Package 和 Session Event Log 来源链没有物化时会明确保留 provenance.not_checked，不会把工具成功写成最终科学验收通过。目前量子基态与量子信息审计是两条完整 L3 纵切。

已集成的量子工具与能力

这里既有 Qiskit 提供的官方 MCP Server，也有 FieldQKit、Quantum Hardware MCP 等社区项目，还有本源量子（OriginQ / QPanda）的官方运行时 MCP Server、编程 Skill 与本地 QUBO Tool，以及 OpenQuantum 自己维护的算法 Skill、Tool Provider、Scientific Validator 和固定 benchmark。每一项都写明了来源、集成方式、默认配置和执行位置，方便使用，也方便后续维护和扩展。

第三方组件保留原项目的版权与许可证。对应的版本、来源和 OpenQuantum 集成内容记录在 THIRD_PARTY_NOTICES.md。

量子 Skill、MCP Server 连接与安全凭据	从用户请求追溯到 MCP-exposed Tool 结果

可以连接哪些量子后端

OpenQuantum 已经为本地模拟、IBM Quantum、IonQ 和多家国内量子云准备了入口。每个平台当前可以做什么、需要什么凭据，都可以在这里直接看到。

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

国产量子云正在从“只读发现”走向“真机执行”：本源量子（OriginQ）官方的 QPanda3 Runtime MCP Server 已经接入，默认关闭。运行 npm run mcp:qpanda-runtime:setup 检出固定审阅提交，在设置中心配置 QPANDA3_API_KEY 并手动开启后，即可连接悟空真机。完整的本源生态候选与取舍见 量子能力清单。

每一步，都看得见

做量子任务时，一个结果往往不够。OpenQuantum 会把用户请求、Skill 加载、工具调用、权限状态和返回结果连成一条清晰的执行轨迹。

使用者可以知道 Agent 调用了什么，开发者也可以沿着这条轨迹定位模型、工具、权限和外部服务中的问题。对科研工作来说，这份过程记录和最终数字一样重要。

运行完成之后，还有科学验收

OpenQuantum 把任务运行和科学验收分开显示。quantum-ground-state 是一个小而完整的参考能力，它在固定扇区内运行二量子位无噪声 statevector VQE，再用独立程序检查能量、态矢、收敛轨迹和数值残差。

当前已有两条完整 L3 科学验收纵切：明确限定的二量子位实 Pauli Hamiltonian，以及有界密度矩阵的量子信息审计。QUBO、电路等价性验证和 QEC memory 实验目前具备计算级独立 observations，但在结果文件和 Session Event Log 来源链没有物化时不会自行升级成最终 Acceptance。这个分层展示了一项量子能力怎样从计算、证据一路走到可复核结论，也为社区开发更丰富的 Skill、Tool Provider 和 Validator 提供了可以直接参考的起点。

快速开始

准备 Git、Node.js 24，以及用于启动 Qiskit 工具的 uv / uvx。

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

浏览器打开 http://127.0.0.1:3000。

模型地址、模型密钥、MCP Server 连接、Skill 和量子云凭据都可以从设置中心管理。密钥保存在本地环境或 DeepSeek Harness 凭据库中，项目配置只保留凭据引用。

如果不用设置中心，而是通过本地环境文件配置模型，macOS 终端运行 cp .env.example .env，Windows PowerShell 运行 Copy-Item .env.example .env，再填写需要的值。

也可以直接打开桌面客户端

请按桌面客户端中的完整源码安装流程执行。客户端能力、状态共享边界与故障检查见部署与启动。

还没有配置模型时，也可以先运行本地量子示例。

npm run demo:quantum-ground-state
npm run mcp:qiskit:probe

把量子计算带进微信、飞书和更多消息平台

OpenQuantum 集成了 CC Connect。它通过标准 ACP 连接 DeepSeek Harness，让手机里的对话直接通向 OpenQuantum 已有的 Skill Provider、Tool Provider 和科学验收流程。

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

# 在另一个终端打开本地管理后台，继续管理消息平台及其凭据
npm run cc-connect:web

飞书也可以替换为微信、钉钉、企业微信、Slack、Telegram、Discord、QQ 等 CC Connect 支持的平台。第一项平台需要先按上游方式完成配置，服务才会启动。消息平台的 Token 只保存在被 Git 忽略的 CC Connect 本地配置中。详细说明见消息渠道接入。

Linux 用户也可以让容器通过 host network 在本机回环地址运行。Harness 不允许监听 0.0.0.0，因此这不是远程服务器暴露方式。

cp .env.example .env
docker compose up --build

更完整的启动方式见部署与启动。模型 Provider、MCP Server 与 Harness MCP Client 连接、凭据或 Harness 遇到问题时，可以从故障排查快速找到对应入口。

把你的量子能力接进来

OpenQuantum 沿用 DeepSeek Harness 的“一切皆 Plugin”装配方式：可组合能力统一通过 Cordis Plugin 进入 Runtime、获得依赖并随 scope 回收；但 Plugin 只是装配机制，产品职责按下面六组理解：

因此，“一切皆 Plugin”回答能力怎样进入 DSH；Skill、Tool、MCP Server、Validator 等名称回答能力负责什么。 Scientific Validator 或领域算法可以是 Plugin 内部的普通模块，不需要为了形式统一而各自成为 Plugin。

接入新后端时，先定义 Agent 真正需要的最小 Tool surface，再决定由原生 Tool Plugin 注册，还是由 MCP Server 暴露并经 Harness MCP Client 注册；然后用 Skill 说明适用场景。涉及科学主张时，再增加 Validator、Acceptance Profile、Materializer 和测试，由 central Acceptance Builder 唯一推导最终状态。开发者可以只实现需要的部分，也可以完成从 Tool 到科研验收的完整链路。

先读文档与架构入口，再按任务进入贡献指南、 扩展对象模型、模块地图或 架构审计。

# 检查 Harness 组合配置
npm run harness:config

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

# 配置模型后运行真实 Agent 端到端测试
npm run e2e:quantum-harness -- --provider openquantum-public

.agents/skills/          量子 Skill 与科学资源
runtime/openquantum/     Agent Preset、Harness MCP Client 声明和 Harness 界面扩展
src/settings/server/     设置中心的服务端配置边界
scripts/                 启动、诊断和端到端测试
tests/                   平台集成测试
docs/                    架构、路线与生态文档

一起建设 OpenQuantum

当前版本已经包含桌面客户端、Web 工作台、微信/飞书等消息入口、Harness 执行轨迹、量子 Skill、Tool Provider、模型与凭据设置，以及基态求解、量子信息审计、受约束 QUBO、电路等价性验证、QEC memory 实验和固定 benchmark。真实硬件和付费服务由使用者按需配置与开启。

我们希望 OpenQuantum 成为一块开放的底板。量子公司可以在这里接入设备和服务，高校实验室可以沉淀自己的科研流程，算法团队和工具作者也可以把新的方法交给更多人使用。

如果你想贡献代码、Skill、Tool Provider、Validator、文档或案例，欢迎阅读 CONTRIBUTING.md。安全问题可以按照 SECURITY.md 提供的方式私密报告。

License

OpenQuantum 自有代码采用 MIT License，版权所有 © 2026 Xi Zhao。

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