# 官方扩展:`ext/quantum` 实现路线图 | | | |---|---| | 状态 | **Q0–Q7 完结 · Q8a/Q8b 完结 · Q8c 待做** | | 日期 | 2026-08-28 · 2026-11-08 手册闭环 | | **锁定设计** | [design/ext-quantum.md](../design/ext-quantum.md) | | 相关 | [ext-cli.md](../design/ext-cli.md) · [ext-abi.md](../design/ext-abi.md) · [stdlib-math.md](../design/stdlib-math.md) · [view.md](../design/view.md) | | 安装 | `marqdo ext add quantum`(`quantum` / `量子`) | 本文只跟踪**实现阶段**。作者面、模拟语义、view 可视化、分期以设计文为准。 --- ## 1. 目标回顾(一句) **可运行的量子电路文档**:表声明门序列 → ABI 模拟概率/采样 → view 内嵌电路/概率 SVG;文档跑通即公式约定成立。 --- ## 2. 落地阶段 | 阶段 | 内容 | 状态 | |------|------|------| | **Q0** | CATALOG + `plugins/quantum` ping + L1 `ensure_plugin` | **done** | | **Q1** | 态向量;I/X/H/CX;`simulate` / `probabilities`;贝尔态 gold | **done** | | **Q2** | Y/Z/S/T/R\* /CZ/SWAP;`run seed=`;中英 API | **done** | | **Q3** | `steps=` 电路表;`draw` 轨线 SVG;view `record_plot` 或值识别 | **done** | | **Q4** | 概率条 / 布洛赫;`matches_matrix`;examples + 用户文档 | **done** | | **Q5** | 教学噪声 + barrier/measure/append/state — [ext-quantum-q5.md](../design/ext-quantum-q5.md) | **done(最小)** | | **Q5.5** | `amplitude_damping` 轨迹 — [ext-quantum-q5.5.md](../design/ext-quantum-q5.5.md) | **done** | | **Q6** | 公式/`matrix=` 自定义门 + `apply` — [ext-quantum-custom-gate.md](../design/ext-quantum-custom-gate.md) | **done** | | **Q7a** | 密度矩阵 / Kronecker / 部分迹 / Hermitian 谱 / Schmidt / Pauli 期望 / 纯度·保真度 — [ext-quantum-q7.md](../design/ext-quantum-q7.md) | **done** | | **Q7b** | 高级 SVG:hinton / city / density / paulivec / qsphere / multibloch | **done** | | **Q7c** | 纠缠示例 + 用户文档 / skill 摘要 | **done** | | **Q8a** | 电路 SVG:标签 gutter + dark/light/bw 门族分色 — [ext-quantum-viz-style.md](../design/ext-quantum-viz-style.md) | **done** | | **Q8b** | probs / bloch / heatmap 共用令牌 | **done** (probs/bloch;heatmap → Q8c) | | **Q8c** | 高级态图(hinton/city/…)换肤 | **pending** | 验收金样:既有 `tests/ext/quantum-*-smoke.mq.md`;Q7:`quantum-linalg-smoke`、`quantum-viz-advanced-smoke`。示例:`examples/quantum-bell/`、`examples/quantum-entanglement/`。 --- 2026-11-08:双语 index 已补完整实验、开发路线与真实契约;新增手册源示例的双后端测试。使用与开发从[根入口](../../ext/quantum/index.mq.md)开始,修改动机见[手册优化记录](../design/ext-quantum-handbook.md)。 ## 3. 已收敛的原开放点 | 原疑问 | 锁定结论(见设计文) | |--------|----------------------| | 并进 math? | **否**,独立 `ext/quantum` | | 电路表 | **要做**(Q3),与方法链等价 | | view 图 | 自绘 SVG;优先 `host_query("record_plot")`;不依赖 web | | 自由函数面 | 普通函数供 `call`,对象方法保留作者链;共用既有 ABI,见[手册修正](../design/ext-quantum-handbook.md) | --- ## 4. 与其它文档 | 文档 | 关系 | |------|------| | [design/ext-quantum.md](../design/ext-quantum.md) | **真理** | | [stdlib-math.md](../design/stdlib-math.md) | 公式/作图精神对照;实现分离 | | [ext-web.md](../design/ext-web.md) | 同属官方 ext + ABI + `ext add` 模板 | | [view.md](../design/view.md) | 结构卡 + Execution 内嵌 SVG |