OpenQuantum

OpenQuantum 是一个开源的量子科研 Agent 工作台，让研究者从自然语言提出任务，经由真实工具执行，走向有依据、可追溯的结果。 你可以从桌面、网页或配置好的微信、飞书入口使用它，也可以接入自己的模型、算法和科研工作流。

一项量子任务，往往要跨过 SDK 文档、计算脚本、运行环境和云端接口。得到一个数字之后，还要回答：用了什么输入和方法？工具是否真的执行？结果通过了哪些检查？

OpenQuantum 把这些环节组织在同一个工作台里：Agent 理解任务，量子工具负责计算，执行轨迹记录过程；具备完整科学验收流程的能力，再用独立检查和结构化证据支持结论。研究者可以把注意力放回问题本身，团队也能把方法、工具和检查规则一起留在代码仓库中。

它基于 DeepSeek Harness 构建：Harness 负责通用 Agent 运行机制，OpenQuantum 聚焦量子领域的工作方法、工具接入和科学证据。架构总览解释了两者的清晰分工。

先体验一个本地量子任务 → 快速开始　｜　把自己的能力接进来 → 贡献指南

当前以源码分发，适合本地试用与二次开发。真实硬件和付费任务入口默认关闭；已有完整科学验收流程的能力是限定的量子基态求解与量子信息审计，不代表所有任务都已实现科学验收。

为什么是 OpenQuantum

更容易开始一项量子任务

从检查电路、构建 QUBO，到模拟量子纠错实验，已接入的工具可以由 Agent 在对话中调用。桌面、Web 与消息渠道复用同一套领域能力；换一个入口，不需要另写一套算法和工作方法。模型地址与凭据由使用者配置，依赖和权限要求在能力目录中明确说明。

让结果有据可查

一次工具调用是否完成，与一个科学结论是否成立，是两件事。OpenQuantum 保留执行轨迹，并在完整验收能力中把输入、结果文件、独立检查与来源链连起来。你可以查看结果，也可以追问它是怎样得到的、哪些条件仍然没有验证。

让方法成为团队可以复用的能力

把领域经验写成 Skill，把确定性操作接成 Tool，把检查规则留在 Validator 和验收合同中。团队可以在同一个仓库里审查、版本化和扩展这些内容；模型或使用入口的变化，不需要重新定义科学规则。这里的复用依靠开放代码与明确接口，不依赖一个专有的插件市场。

团队复用指代码与工作流复用；当前本地部署不是面向不受信任用户的多租户托管服务。

从一个真实任务开始

以仓库内固定的二量子位 Pauli Hamiltonian为例，OpenQuantum 在指定粒子扇区内运行无噪声 VQE，再用独立闭式计算作为参考。下面的数值来自这一个有界案例，任务结果、工具调用和科学验收可以沿同一条轨迹复核。

这个案例展示的是从输入、工具执行到科学证据的完整路径，不是通用分子求解、量子优势或真实硬件性能的证明。你可以用 npm run demo:quantum-ground-state 先运行同类本地参考流程；模型驱动的完整 Harness 验收需要另行配置模型。

模型由你选择

OpenQuantum 不把量子能力绑定到一个模型。你可以在设置中心管理模型服务地址、凭据引用与模型标识，由 Harness 的 Model Provider Route 接入；领域工具与科学验收规则保持独立。支持的协议以当前 Harness Adapter 为准，具体服务是否可用需要实测。

2026-09-05 的一轮受控网关测试，以 10 个模型标识为固定分母：

严格通过的网关模型标识为 kimi-k3、deepseek-v4-pro、deepseek-v4-flash 和 glm-5.1。这是一次固定案例的兼容性记录，不是默认模型清单、模型能力排名或其他服务商的兼容承诺；网关别名也不能证明底层模型身份。权限、输出格式与预算限制分别记录在脱敏验收摘要中。

服务地址和真实密钥由使用者在本地配置；仓库不附带本次测试网关地址、密钥或账户信息。

快速开始

准备 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 和量子云凭据都可以从设置中心管理。量子组件默认先展示当前 Model、Skill、Tool Registry 的只读运行证据，再把 MCP Server 连接、Skill 加载策略和安全凭据分栏配置；“配置已启用”不会被当成“当前已就绪”。密钥保存在本地环境或 DeepSeek Harness 凭据库中，项目配置只保留凭据引用。

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

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

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

还没有配置模型时，也可以先运行无需模型密钥、无需云端 QPU 的本地量子示例：

npm run demo:quantum-ground-state

安装好 uv 后，可以单独检查 Qiskit 接入；首次运行可能下载依赖：

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 可从源码启动 macOS 和 Windows 桌面客户端，提供系统托盘、原生终端和桌面通知。桌面窗口使用同一套 Session、量子能力、模型设置和科学验收；当前不提供 OpenQuantum 品牌的 .dmg 或 .exe 安装包。

桌面客户端基于社区开源的 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 再切换到桌面客户端。

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

手机可以成为发起任务的入口。配置好消息渠道和运行环境后，你可以在微信或飞书中提出请求，由 OpenQuantum 调用已启用的量子工具，执行记录仍可在工作台中查看。

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

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

消息渠道通过 CC Connect 和标准 ACP 接入 Harness，复用已有的工具与科学规则，不另建一套执行系统。

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

先按科研问题选择能力，再看它的使用条件和证据范围。已有能力覆盖以下任务，具体来源与默认开关见后面的集成目录。

目前量子基态与量子信息审计具备两条完整 L3 科学验收流程。其他能力的计算级检查与最终科学验收分开记录；缺少结果文件和 Session 来源链时，保留 provenance.not_checked。固定版本、测试与能力等级见架构审计。

已集成的量子工具与能力

Qiskit、FieldQKit、QPanda、QMClaw 与 OpenQuantum 自有能力按各自职责接入。目录里的“连接配置开启”只表示加载策略，不保证当前环境、凭据或外部服务已经就绪；首次使用前请在设置中心查看运行证据。