OpenQuantum (openquantum-web-branding)

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

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

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

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

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

你可以直接使用已经集成的 Qiskit、FieldQKit、本源量子（OriginQ / QPanda）和量子算法能力，也可以把自己的设备、数据、方法和模型做成 Skill 或 MCP，交给同一个 Agent 调用。普通用户可以从自然语言开始，研究机构可以组织科研工作流，量子公司也可以在这套基础上继续开发自己的产品。

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

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

桌面客户端

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

桌面客户端基于社区开源的 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 preset、Skill、MCP 和科学验收组合。OpenQuantum 品牌安装包仍属于后续发布工作。

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

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

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

你在微信里提出问题
  → OpenQuantum 判断应该使用哪个 Skill
  → DeepSeek Harness 调用 Qiskit、量子算法或云端 MCP
  → 结果回到对话，完整执行轨迹留在工作台

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

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

量子计算，就在指尖。

从一个真实任务开始

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

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

已集成的量子工具与能力

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

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

量子组件、Skill、MCP 与安全凭据	从用户请求追溯到 MCP 工具结果

可以连接哪些量子后端

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

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

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

每一步，都看得见

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

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

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

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

当前的科学边界是明确限定的二量子位实 Pauli Hamiltonian。这个例子展示了一项量子能力怎样从计算、证据一路走到可复核的结论，也为社区开发更丰富的算法 Skill 和 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、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、MCP 和科学验收能力。

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

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

把你的量子能力接进来

OpenQuantum 沿用 DeepSeek Harness 的原生扩展方式。Skill、MCP 和 Validator 各自解决一类清楚的问题，也可以组合成一项完整的量子能力。

接入一个新后端，通常从 MCP 开始，再用 Skill 说明适用场景。涉及科学结论时，可以继续加入 Validator 和测试。每一层都有现成示例，开发者可以只做自己需要的部分，也可以完成一条从工具到科研验收的完整链路。

开发说明见 CONTRIBUTING.md，目录和配置权威见仓库地图，架构边界见 ARCHITECTURE_AUDIT.md，生态规划见 QUANTUM_CAPABILITY_CATALOG.md。

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

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

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

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

一起建设 OpenQuantum

当前版本已经包含桌面客户端、Web 工作台、微信/飞书等消息入口、Harness 执行轨迹、量子 Skill 与 MCP、模型与凭据设置，以及量子基态的独立科学验收。真实硬件和付费服务由使用者按需配置与开启。

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

如果你想贡献代码、Skill、MCP、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。