UnifiedQuantum 0.1.0 — 发布验证报告¶

结论¶

RELEASE WITH KNOWN GAPS。 所有本地强制验证项通过；缺口均为外部原因且有文档记录，维护者已确认接受。仓库根目录的 RELEASE_EXECUTION_PLAN_0.1.0.md / RELEASE_REPORT_0.1.0.md 是本报告的完整执行计划与证据存档。

候选¶

分支：main（领先 origin/main 10 个提交）
验证基线 commit：a49d106
Tag：v0.1.0（验证时版本元数据为 0.0.17.post2.dev26，维护者按弃用政策选择 v0.1.0 作为移除版本号）
环境：Linux x86_64，Python 3.12.3，Node 24.18.0，uv 0.12.1
仓库根目录无旧版本遗留的 RELEASE_REPORT_* / RELEASE_EXECUTION_PLAN_* 产物

验证结果¶

领域	结果
默认测试套件	2488 passed, 220 skipped, 0 failed（212s）
`uniqc_cpp` C++ 依赖	导入正常，`StatevectorSimulator` / `DensityOperatorSimulator` 可用
best-practices 发布门禁	示例 12 pass / 0 fail；Sphinx 构建 rc=0、0 警告
CLI	17 组 help（含 `python -m uniqc.cli`）全部正常；Bell 工作流（circuit/simulate/submit/dry-run/backend）行为与文档一致
AI hints	`--ai-hint`、`always-ai-hint on/off`、`UNIQC_AI_HINTS=1` 三条路径全部验证
文档-软件对齐	程序化检查通过：console script、`[quark]` gating、CLI 命令存在性、无旧 import 路径推荐、无 `python -m uniqc`、无幽灵 `workflow` 命令
Gateway 前端	`npm ci` + `npm run build` 通过
Gateway API	`/api/health` `/api/version` `/api/backends` `/api/tasks` 全部 200；chip-backed `dummy:<platform>:<backend>` 未混入可枚举后端；根路径伺服构建产物
云平台发现	Quark（5）/ TianYan（15）/ LogicalQubit（5）实时发现通过
Dry-run	`quark:Baihua`、`tianyan:tianyan176`、`logicalqubit:QZ02`、`dummy:originq:WK_C180`（拓扑合法比特对）全部通过
Calibration/QEM/XEB	默认套件 + best-practices 09/10 示例通过

已知缺口（外部原因，不阻塞发布）¶

OriginQ 实时发现上游故障：pyqpanda3 0.4.1（PyPI 最新，已核实）的 QCloudService.backends() 直接抛 RuntimeError: value is not array (which is 3)（用原始 SDK 裸调用复现，在本项目代码之下）。本地自动回退 stale 缓存（7 个后端可用）；chip-display --update 对 Quark/TianYan 实测正常，确认为 OriginQ 特异问题。
IBM token 失效：IBM Quantum 返回 “Unable to retrieve instances”，属凭据问题；stale 缓存（3 个后端）回退可用。
真实量子任务未提交：本轮未获配额授权，--real-cloud-test 变体未运行；维护者已明确接受该缺口。
Gateway 视觉覆盖：验证环境无 Playwright/浏览器，以 HTTP + 构建产物检查代替。

行为确认（非缺陷）¶

dummy:originq:WK_C180 dry-run 对 CNOT(0,1) 报 “Unsupported topology” 是预期行为（该芯片无 0–1 耦合边）；换耦合对 (0,9) 即通过。对应 feat(adapters): dry-run validates circuit qubits against chip data。