QECTOR Claude Plugin

📖 概述

QECTOR Claude Plugin 是 QECTOR 量子纠错（QEC）工程与研究环境面向 Claude Code 和 Claude Desktop 的官方集成。它基于 qector-decoder-v3 构建，在 10 个码族和 5 个 MWPM/BP-OSD 后端上以数学方式强制执行 $H c \equiv s \pmod 2$，确保企业和学术量子研究具备故障关闭（fail-closed）完整性。

零出网 · 严格数学 · 故障关闭 插件 100% 在本地运行，绝不上传 QEC 仿真遥测数据到云端。

本仓库是 QECTOR Decoder Workbench 桌面应用（Windows / Linux）的无应用插件伴侣。两个 v1.0.1 工作台版本均与此插件完全兼容——请参阅工作台兼容性一节。

Related MCP server: Qwen3-Coder MCP Server

🚀 快速开始

1. 克隆并安装

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin
python -m pip install -r requirements.txt
python scripts/qector_runtime_check.py

2. Claude Desktop GUI 安装程序（Windows）

立即在 Claude Desktop 设置中将 QECTOR 注册为一级扩展：

.\scripts\install_windows_connector.cmd

（PowerShell 等价版本随附于 scripts/install_windows_connector.ps1。Linux 和 macOS 使用 .claude-desktop-extension/ 中的 Claude Desktop 扩展。）

3. Claude Code 市场集成

claude plugin marketplace add GuillaumeLessard/qector-claude-plugin
claude plugin install qector@qector-tools

4. 可选：引导式系统设置（含安全批准）

python scripts/qector_system_setup.py --check-only   # read-only audit, no changes
python scripts/qector_system_setup.py --confirm      # execute after user approval

📥 下载

v1.0.2 发布资源（位于 dist/ 中，每个均带 .sha256 sidecar 文件）：

要求： Python 3.9+（已在 Python 3.12 上测试）、qector-decoder-v3==1.0.0、 mcp==1.26.0、numpy>=1.26,<2.3、cryptography>=48.0.1,<50。所有依赖均按已发布的 wheel 约束锁定于 requirements.txt 中。

🧩 生态系统

🤖 MCP 服务器（37 个工具）

两个本地 stdio Model Context Protocol 服务器基于 qector-decoder-v3 核心运行：

qector-library 工具： list_code_families, list_decoders, get_license_info, decode_syndrome, decode_single, threshold_sweep, build_code_from_matrix, compat_report

wilson_ci, wilson_table, logical_coset_score, dem_inspect, dem_collapse_parallel, code_family_info, code_export_matrices, code_logicals_inspect, code_distance_check, pymatching_compat_check, sinter_decoder_list, qiskit_plugin_check, hardware_probe, license_active_check, env_block, compat_report, workbench_probe, artifacts_sha256, artifact_metadata_check, decode_faithfulness_check, hot_path_microbench, stim_circuit_probe, sinter_task_template, workload_hash, theorem_lookup, glossary_lookup, reproduction_command_lookup, system_setup, configure_claude_desktop

💬 命令（13 个斜杠命令）

🎭 智能体（5 个专业角色）

🛠️ 技能（28 个领域原语）

qector-core, qector-architecture, qector-math-foundations, qector-codes-builder, qector-bp-osd, qector-two-stage-css, qector-space-time, qector-decoders-deep-dive, qector-dem-pipeline, qector-sinter, qector-ler-methodology, qector-pymatching-compat, qector-batch-decoding, qector-orchestration, qector-reproducibility, qector-testing-strategy, qector-deployment, qector-release-engineering, qector-licensing, qector-services, qector-glossary, qector-educator, qector-researcher, qector-developer, qector-sysadmin, qector-hardware-engineer, qector-roadmap, qector-workbench

🏗️ 架构

┌──────────────────────────────────────────────────────────┐
│                 QECTOR Claude Plugin v1.0.2               │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────────┐ │
│  │ 13 Commands │  │  5 Agents    │  │  28 Skills       │ │
│  └──────┬──────┘  └──────┬───────┘  └────────┬─────────┘ │
│         └────────────────┼───────────────────┘           │
│                          ▼                              │
│  ┌─────────────────────────────────────────────┐        │
│  │  qector-library MCP (8 tools)   stdio only  │        │
│  │  qector-bench   MCP (29 tools)  stdio only  │        │
│  └──────────────────────────┬──────────────────┘        │
│                             │                           │
│              ┌──────────────▼──────────────┐            │
│              │  qector-decoder-v3 1.0.0     │            │
│              │  (Rust/PyO3 engine, local)   │            │
│              └─────────────────────────────┘            │
└──────────────────────────────────────────────────────────┘

Claude Desktop 扩展 —— 一个完全集成的自定义连接器（manifest_version: 0.3，位于 .claude-desktop-extension/），可在 Claude Desktop → 设置 → 连接器中直接显示原生 UI 控件、文档和 QECTOR 图标。

🛡️ 核心工程准则

1. 数学严格性 —— 每一次综合征解码都必须验证 $H c \equiv s \pmod 2$。近似值一律拒绝。

2. 零出网安全 —— 操作 100% 在本地运行。插件绝不上传 QEC 仿真遥测数据到云端，从而保护专有硬件 IP。

3. 故障关闭设计 —— 矩阵维度不匹配、无法识别的码族或无效的距离请求会立即引发确定性错误，而不是静默破坏量子态。

4. 统计严谨性 —— 所有 LER 阈值扫描都包含精确的 Wilson 95% 二项分数区间。没有边界的点估计一律拒绝。

数学权威依据是 QECTOR Decoder v3 参考手册 v1.0.0（DOI：10.5281/zenodo.21941046）；插件以全部 16 个定理、27 章和 5 个附录为依据。

🤖 工作台兼容性

官方 QECTOR Decoder Workbench 桌面应用——Windows（qector-decoder-workbench-windows，便携式 .exe）和 Linux（qector-decoder-workbench-linux，AppImage）两个 v1.0.1 版本——与本插件完全兼容：

• 两个工作台版本都捆绑了本插件锁定的同一个 qector-decoder-v3 1.0.0 后端（qector-decoder-v3==1.0.0）——版本完全一致。

• 可以使用工作台的 85 工具 --mcp 服务器、本插件的两个 stdio MCP 服务器，或同时使用全部三者——每种传输都仅限本地，零网络出网。

• 插件的 workbench_probe 工具可以检测正在运行的工作台，并报告其版本、工具数量和 MCP 协议状态。

• 工作台产物（导出文件、基准测试报告、存档 sidecar 文件）由插件的 artifacts_sha256 / artifact_metadata_check 工具验证。

📋 系统要求

📚 文档

📄 许可证

专有、源代码可用的软件。版权所有 (c) 2026 Guillaume Lessard 和 iD01t Productions。参见 LICENSE.md。

底层 qector-decoder-v3 后端单独授权：

• ✅ 免费用于个人、学术、教育和非商业研究

• 💼 商业用途（公司研发、SaaS、托管 API、OEM、再分发）需要付费许可证

• 🔄 提供 60 天商业评估，可抵扣许可证费用

🤝 支持与联系