QECTOR Quantum Error Correction

QECTOR Claude Plugin

为 Claude 提供经过验证的量子纠错。在你使用的每台机器上都能本地运行、结果确定，并有数学保证。

QECTOR 将已发布的 qector-decoder-v3==1.0.0 引擎与 Claude Code 和 Claude Desktop 集成，将二者打造成可用于生产的 QEC 工程环境。MCP 服务返回的每项纠正结果都会在离开进程前根据奇偶校验关系 H c = s (mod 2) 进行验证；每项声明都附带可由机器检查的溯源类别；默认配置不会发起任何网络请求。

4 个 MCP 服务 · 8 个稳定版工具 / 29 个研究工具 / 3 个管理工具 · 11 条命令 · 5 个 Agent · 28 个技能 · 默认零外联

最新版本 — v1.0.6 · 符合 Claude.ai 市场规范（启动器位于 scripts/，清单采用规范格式），适用于各种环境的 /qec-setup，以及确定性产物。请参阅 版本公告。

---

为什么发布 v1.0.6

1.0.6 版完善了 1.0.5 版开启的可移植性与合规性，并进一步实现了市场规范和通用安装配置。此次更新主要解决两个问题：现代操作系统不再通过可预测的命令名称提供 Python（macOS、Debian、Ubuntu 和 Fedora 提供 python3，但不提供裸命令 python；Windows 还有自己的解析器问题）；claude.ai 市场审核流程会拒绝在 bin/ 中附带可执行文件的插件。此版本彻底消除了这两类问题。

1. 每个构件都附带通用且合规的启动器。

• 插件压缩包、源代码分发包和 Desktop 捆绑包都包含 scripts/qector-python（POSIX sh）和 scripts/qector-python.cmd（Windows）。这些文件位于 scripts/ 而非 bin/：托管于 claude.ai 的插件不得附带 bin/ 可执行文件，因为这些文件会直接加入 PATH，却不会显示在管理员审核界面中。现在，验证器会对任何重新引入 bin/ 的构建直接报错。
• 解释器的选择依据明确规则，而非猜测。首先使用管理员指定的解释器，然后依次尝试 python3 和 python；在 Windows 上，py 启动器的优先级高于以上所有选项。
• 支持的版本范围会强制执行，而非仅作说明。只有 Python 3.9 到 3.13 可以运行，这与已发布的原生 wheel 矩阵一致；版本超出范围的机器会收到精确的修复指引，而不是遇到深层导入崩溃。
• 两种场景都支持优先指定解释器。将 QECTOR_PYTHON 设为解释器的绝对路径，所有启动器都会优先使用该路径，而不进行自动检测。

2. 市场配置采用规范格式。

plugin.json 和 marketplace.json 均仅使用有文档说明的字段，并通过相对路径引用同一代码仓库中的插件源；这是所有官方市场采用的格式，也是所有同步路径都能解析的唯一格式。Desktop MCPB 附带 win32 平台覆盖项，确保 Windows 始终选择 .cmd 启动器。

3. 安装配置适用于所有环境。

/qec-setup 会检测沙盒和远程环境（claude.ai 代码执行、Cowork、未检出项目的容器），并在找不到本地脚本时改用原生诊断，而不会就此中断；同时会如实说明实际使用了哪种路径。

平台支持

平台	安装方式	状态
Claude Code CLI	通过本地 stdio 使用市场插件	✅ Windows、macOS、Linux
Claude Desktop	单击安装 .mcpb 捆绑包	✅ Windows、macOS
Web、iOS、Android、Cowork	托管远程连接器（带 OAuth 的 Streamable HTTP）	🗺️ 规划于 1.1.x 推出
隔离网络和受限环境	本地 stdio，默认完全离线	✅

本地 stdio 从架构上无法连接 Web 或移动平台；托管连接器是为这些平台设计的接入方案，将于 1.1.x 推出。

安装

前置条件

要求	检查方法	预期结果
Python 3.9–3.13	python --version and py -3 --version (Windows)	推荐使用 3.11.x 或 3.12.x；有意拒绝 3.14+
pip	python -m pip --version	任意近期版本
Claude Code ≥2.0 或 Claude Desktop ≥0.10.0	claude --version	2.1.x / 1.34+

路径中带空格的 Python（例如 Anthropic Skills and agents）现在也能正常使用 — v1.0.6 中的 Desktop 扩展会直接使用 python（不再使用 ${__dirname} 启动器），Code 插件则使用 scripts/qector-python。如果仍然看到 Server disconnected，请设置 QECTOR_PYTHON（参见故障排除）。

选项 A — Claude Code（marketplace，30 秒）

# 1. Add the marketplace (once)
claude plugin marketplace add GuillaumeLessard/qector-claude-plugin

# 2. Install the plugin
claude plugin install qector@qector-tools
# When prompted for Python interpreter: leave empty for auto-resolve,
# or paste an absolute path like C:\Program Files\Python311\python.exe

# 3. Verify
claude plugin list                          # → qector@qector-tools 1.0.6 enabled
claude plugin validate . --strict           # → ✔ Validation passed
python scripts/qector_runtime_check.py      # → status: ok, mcp 1.29.0

选项 B — Claude Desktop（单击安装）

通过界面安装（推荐）：

1. 从发布页面下载 qector-claude-desktop-1.0.6.mcpb。
2. Claude Desktop → Settings → Extensions → Advanced settings → Install Extension → 选择 .mcpb → Enable。
3. 完全退出 Claude Desktop（系统托盘 → Quit）并重新打开 — 扩展需要完整重启才能加载包含 8 个工具的安全配置。

通过脚本安装（效果相同，且可审计）：

python scripts/configure_claude_desktop.py --check-only   # preview, no changes
python scripts/configure_claude_desktop.py --confirm      # writes claude_desktop_config.json + installs extension
# Restart Desktop afterwards

验证 Desktop：

• C:\Users\<you>\AppData\Roaming\Claude\claude_desktop_config.json 中包含 qector-library（如果你使用了脚本），且 extensions-installations.json 中包含 ant.dir.gh.guillaumelessard.qector。
• C:\Users\<you>\AppData\Local\Claude\logs\mcp.log 显示 QECTOR Server started and connected → initialize → tools/list → result（没有 Server disconnected）。

选项 C — 从源代码安装（可审计，可离线使用）

git clone https://github.com/GuillaumeLessard/qector-claude-plugin.git
cd qector-claude-plugin

# Install for every Python you use (Windows has both 3.11 and 3.12 via py launcher)
python -m pip install -r requirements.txt          # → numpy 2.2.6, mcp 1.29.0, qector 1.0.0
py -3 -m pip install -r requirements.txt           # ← do this too if py -3 exists

# Verify
python scripts/qector_runtime_check.py             # → status: ok, failures: []
python scripts/qector_system_setup.py --check-only # → dry_run_pending_approval
python scripts/qector_system_setup.py --confirm    # → ready, theorem_1_faithful: true

故障排除

症状	原因	解决方法
Server disconnected / Unable to connect to extension server	某个 Python 环境中安装了旧版 mcp 1.26.0，或已安装的扩展中缺少 scripts/，或旧版本无法处理带空格的路径	py -3 -m pip show mcp 和 python -m pip show mcp 的版本都必须是 ≥1.28.1 — 对每个环境运行 py -3 -m pip install -r requirements.txt --upgrade。重新运行 python scripts/configure_claude_desktop.py --confirm（现在会正确复制启动器），并完全重启 Desktop。如果仍然失败，请将扩展的 Python interpreter 字段设为 C:\Program Files\Python311\python.exe（或 C:\Program Files\Python312\python.exe）。
No Python 3.9-3.13 interpreter found	python 未添加到 PATH，或只有 3.14 可用	从 python.org 安装 Python 3.11/3.12，和/或设置 QECTOR_PYTHON=C:\Program Files\Python311\python.exe（环境变量或扩展的解释器字段）。
This extension may not work until all requirements are met	Desktop 版本 <0.10.0，或缺少 Python	更新 Desktop（≥0.10.0，当前的 1.34+ 即可），并确保为 Desktop 实际使用的 Python 安装了 mcp/qector（Windows 上使用 py -3）。
qector-decoder-v3 not found	pip 安装到了错误的 Python 环境	运行 python -m pip install -r requirements.txt 并且 py -3 -m pip install -r requirements.txt — 分别使用 * -m pip show qector-decoder-v3 检查。

QECTOR 功能概览

MCP 服务	用途	工具	默认状态
qector-library	冻结的稳定解码接口，每个结果都经过验证	8	✅ 已启用
qector-research	临时研究和证据工具	29	需明确选择启用
qector-admin	需要双重确认的特权本地操作	3	需明确选择启用
qector-desktop-mcp	Claude Desktop 安全配置文件适配器	8	✅ 在 Desktop 上启用

除服务外，还有：11 个斜杠命令，用于设置、事实、定理、复现、阈值扫描、Wilson 区间、探测器错误模型、代码检查、基准测试、sinter 模板和验证； 5 个专用 Agent（研究员、开发者、验证员、系统管理员、硬件工程师）；以及 28 项技能，涵盖数学基础、架构、BP OSD、两阶段 CSS、时空码、解码器深入分析、DEM 流水线、LER 方法、pymatching 兼容性、批量解码、可复现性、测试策略、部署、发布工程、许可、教育和运维。

构建产物与完整性

构建器具有确定性：固定时间戳让每次重建都能得到完全相同的位，因此以下哈希值将始终保持稳定。

构建产物	SHA-256
dist/qector-claude-plugin-1.0.6.zip	46ae976105d9813ef615985f30fe23cd76cf2ca11d63ee5de86758e4402903c5
dist/qector-claude-plugin-source-1.0.6.zip	4370c322b9e2fa083f841ee7a15e1468b6f991702db56d4779bd8ddb530def11
dist/qector-claude-desktop-1.0.6.mcpb	fbf9bb9a1254d4867093279a07b715041862f8c9ce71aff1201409b6cccc616c

每个构建产物的旁置文件、合并的 SHA256SUMS、SPDX 2.3 SBOM，以及将每个文件与其发布提交和运行时固定版本绑定的来源记录，均位于 dist/ 下。server.json 中的 MCP Registry 描述符与 Desktop 软件包逐字节一致。

系统要求

组件	要求
Python	3.9 至 3.13，由随附的启动器强制执行
平台	Windows、macOS、Linux
后端引擎	qector-decoder-v3==1.0.0，原生 Rust / PyO3 轮子
MCP 运行时	mcp>=1.28.1,<2
科学计算栈	numpy>=1.26,<2.3、cryptography>=48.0.1,<50
网络	默认不使用；有一项需明确触发的 PyPI 新鲜度检查
GPU	至多为可选；未发布可移植的性能声明

安全与隐私

默认安装通过本地 stdio 仅公开 8 个稳定工具。研究和管理服务需要主动启用，特权操作要求每次调用都确认，而且每个进程都会强制执行各自的调用预算，因此失控的 Agent 会触及上限，而不是拖垮你的机器。会话钩子除了工具名称和时间戳外不会持久化任何信息。完整的信任边界、风险分类、扫描器指南和安全建议立场详见 SECURITY.md，网络策略详见 PRIVACY.md。

文档

文档	路径
用户手册	docs/User_Manual.md
MCP API 参考	MCP_API.md
v1.0.6 版本公告	RELEASE_BODY_v1.0.6.md
发布说明	RELEASE_NOTES_v1.0.6.md
更新日志	CHANGELOG.md
Desktop 设置	CLAUDE_DESKTOP.md
验证关卡	RELEASE_VALIDATION.md

开发

python -m unittest discover -s tests -v     # mathematical + protocol suite
python scripts/validate_source.py           # source structure gate
python scripts/validate_plugin_bundle.py    # built bundle gate
python scripts/release_validate.py          # metadata cross check, zero deps
python scripts/build_release.py --all       # deterministic artifacts

CI 会在每次推送到 main 时执行相同的关卡。使用 v* 打标签还会自动构建所有构建产物、发布 GitHub 版本，并更新 MCP Registry 条目。

许可证

专有软件。版权所有 © 2026 Guillaume Lessard / iD01t Productions。详见 LICENSE.md。qector-decoder-v3 后端可免费用于个人、学术、教育和非商业研究；商业用途需从 qector.store/pricing 获取许可证。

联系方式

网站 https://www.qector.store · 许可 [email protected] · 支持 [email protected] · 安全问题披露 [email protected]（私密）

QECTOR Claude 插件 v1.0.6
基于 qector-decoder-v3 v1.0.0 构建 · Rust / PyO3 核心
每次校正均通过 H c = s (mod 2) 验证