open-standards/wai/wai-quantum/docs/README.zh-CN.md
Transaction Science 000379329d
All checks were successful
wai-audit collector and player integration / does this change touch it (push) Successful in 17s
WAI operation catalogue / does this change touch it (push) Successful in 18s
wai-quantum contract / does this change touch it (push) Successful in 22s
wai-quantum clippy / does this change touch it (push) Successful in 17s
wai-quantum pulse and dynamics / does this change touch it (push) Successful in 36s
wai-quantum error correction and mitigation / does this change touch it (push) Successful in 25s
wai-quantum for Python / does this change touch it (push) Successful in 28s
wai-quantum extension points / does this change touch it (push) Successful in 22s
wai-quantum variational and algorithm library / does this change touch it (push) Successful in 17s
wai-quantum service / does this change touch it (push) Successful in 14s
wai-quantum studio and desktop / does this change touch it (push) Successful in 14s
wai-sink-android native sink library / does this change touch it (push) Successful in 1m11s
wai-sink-swift native sink package / does this change touch it (push) Successful in 1m9s
wai-quantum views in agent hosts / does this change touch it (push) Successful in 1m14s
wai-quantum verdicts and repairs / does this change touch it (push) Successful in 1m24s
WAI Studio / does this change touch it (push) Successful in 23s
wai-quantum docs, course and locales / does this change touch it (push) Successful in 3m57s
wai-quantum-landscape-fpga reference design / does this change touch it (push) Successful in 3m43s
wai-quantum OpenQASM reader / does this change touch it (push) Successful in 3m43s
wai-quantum editors / does this change touch it (push) Successful in 4m0s
wai-quantum resource estimation / does this change touch it (push) Successful in 3m50s
wai-quantum other formats / does this change touch it (push) Successful in 3m49s
wai-quantum command line / does this change touch it (push) Successful in 4m9s
wai-quantum for JavaScript / does this change touch it (push) Successful in 3m48s
wai-quantum service / service energy · linux packages (push) Successful in 3m18s
WAI breaking changes and the conformance runner / WAI breaking · does this change touch WAI (push) Successful in 21s
WAI examples / WAI examples · does this change touch them (push) Successful in 20s
wai-quantum landscape energy to solution / does this change touch it (push) Successful in 16s
wai-quantum energy-landscape jobs / does this change touch it (push) Successful in 21s
wai-quantum landscape stage 0, the sampler against the exact law / does this change touch it (push) Successful in 22s
wai-quantum contract / the policy is linked, and the deprecations page reads (push) Successful in 12s
wai-quantum wasmQ / does this change touch it (push) Successful in 10s
wai-quantum pulse and dynamics / the same bits · linux-arm64 (push) Successful in 3m13s
wai-quantum-landscape-fpga reference design / the board's code on the board's processor's architecture · linux-arm64, release (push) Successful in 2m5s
wai-quantum variational and algorithm library / parameters, gradients, optimisers, VQE, QAOA and builders · linux-arm64, release (push) Successful in 3m23s
wai-audit collector and player integration / collector · linux (push) Successful in 3m42s
wai-quantum pulse and dynamics / reader, simulator and pulse jobs · linux, release (push) Successful in 3m4s
repository checks / lockfiles, advisories, tests in CI, workflow hygiene, spec and section references, public text (push) Successful in 7m14s
wai-quantum pulse and dynamics / reader, simulator and pulse jobs under wasm32-wasip2 (wasmtime) (push) Successful in 2m12s
wai-quantum extension points / the registry and the example · linux-arm64 (push) Successful in 6m37s
wai-sink-android native sink library / the JNI layer and the platform-free half on the host JVM · linux-arm64 (push) Successful in 5m40s
wai-quantum clippy / clippy, warnings denied, every feature set · linux (push) Successful in 6m27s
wai-quantum extension points / the registry under wasm32-wasip2 (wasmtime) (push) Successful in 3m19s
wai-quantum contract / API compatibility · linux (push) Successful in 8m39s
wai-quantum error correction and mitigation / codes, decoders, texts and mitigation · linux, release (push) Successful in 5m38s
wai-quantum variational and algorithm library / parameters, gradients, optimisers, VQE, QAOA and builders · linux, release (push) Successful in 5m37s
wai-quantum verdicts and repairs / the intent set and the verdict under wasm32-wasip2 (wasmtime) (push) Successful in 1m24s
WAI Studio / the catalogue's actions, the unit tests and the core · linux (push) Successful in 1m6s
wai-quantum contract / schemas and the committed tool lists · linux (push) Successful in 11m16s
wai-quantum extension points / the registry and the example · linux (push) Successful in 7m39s
wai-quantum docs, course and locales / the Studio's words in every locale · linux (push) Successful in 13s
WAI examples / WAI examples · android-app · linux-arm64 (push) Successful in 9m53s
wai-quantum views in agent hosts / views · a scripted host (push) Successful in 5m13s
wai-quantum verdicts and repairs / verdicts, repairs and the intent set · linux (push) Successful in 4m44s
wai-quantum docs, course and locales / the course and the command line's languages · linux (push) Successful in 3m34s
WAI operation catalogue / the catalogue and every door · linux (push) Successful in 14m21s
wai-quantum OpenQASM reader / reader and corpus · linux (push) Successful in 2m57s
wai-quantum views in agent hosts / views · the page and its engine (push) Successful in 7m15s
wai-quantum OpenQASM reader / corpus under wasm32-wasip2 (wasmtime) (push) Successful in 1m35s
wai-quantum studio and desktop / studio · browser (push) Successful in 9m40s
wai-quantum service / service · linux (push) Successful in 10m12s
wai-quantum energy-landscape jobs / the same bits · linux-arm64 (push) Successful in 13m45s
wai-quantum for Python / python · linux (push) Successful in 13m45s
wai-quantum other formats / the set under wasm32-wasip2 (wasmtime) (push) Successful in 3m34s
WAI breaking changes and the conformance runner / WAI breaking · wire, record and API against main · linux (push) Successful in 3m59s
wai-quantum studio and desktop / desktop app · linux (push) Successful in 12m41s
wai-quantum editors / editors · linux (push) Successful in 6m15s
wai-quantum other formats / readers, writers and the set · linux (push) Successful in 6m3s
wai-quantum pulse and dynamics / the same bits · macos (push) Successful in 1m18s
wai-audit collector and player integration / collector, player integration and the browser end to end · macos (push) Successful in 2m25s
wai-quantum landscape energy to solution / the small tier, to the byte · linux (push) Successful in 2m52s
WAI breaking changes and the conformance runner / WAI breaking and conform · their tests, and the independent verifiers through wai conform · linux (push) Successful in 6m56s
wai-quantum landscape stage 0, the sampler against the exact law / the small tier, to the byte · linux (push) Successful in 1m3s
wai-quantum resource estimation / estimation and calibration · linux, release (push) Successful in 8m37s
wai-quantum wasmQ / the reference modules rebuild to their modules of record · linux (push) Successful in 45s
wai-quantum for JavaScript / javascript · linux (push) Successful in 9m31s
wai-quantum for Python / python · macos (push) Successful in 3m21s
wai-quantum wasmQ / interpreter and vectors under wasm32-wasip2 (wasmtime) (push) Successful in 3m18s
wai-quantum editors / editors · macos (push) Successful in 1m48s
wai-quantum wasmQ / profile, engines, reference modules, adversarial, vectors · linux (push) Successful in 5m34s
wai-quantum energy-landscape jobs / native against WebAssembly, over many seeds (push) Successful in 6m51s
wai-quantum studio and desktop / desktop app · macos (push) Successful in 5m53s
wai-quantum service / service · macos (push) Successful in 7m45s
wai-quantum command line / command line · macos (push) Successful in 2m45s
wai-quantum landscape energy to solution / the small tier, to the byte · macos (push) Successful in 1m46s
wai-sink-android native sink library / every ABI, the AAR, and the instrumented tests in a headless emulator · macos (push) Successful in 7m56s
wai-quantum landscape stage 0, the sampler against the exact law / the small tier, to the byte · macos (push) Successful in 25s
WAI Studio / Studio in Chromium and Firefox · macos (push) Successful in 9m9s
wai-quantum wasmQ / profile, engines, reference modules, adversarial, vectors · macos (push) Successful in 2m35s
wai-quantum docs, course and locales / every command and snippet in the docs · linux (push) Successful in 25m27s
WAI Studio / Studio in WebKit · linux (push) Successful in 28m15s
wai-sink-swift native sink package / libwai slices, desktop tests, simulator tests · macos (push) Successful in 13m50s
wai-quantum energy-landscape jobs / the same bits · macos (push) Successful in 7m29s
wai-quantum energy-landscape jobs / the module under wasm32-wasip2 (wasmtime) (push) Successful in 18m45s
wai-quantum command line / command line · linux (push) Successful in 27m39s
wai-quantum energy-landscape jobs / reader, kernels, answers and the stated result · linux, release (push) Successful in 24m11s
WAI examples / WAI examples · the archive, the readiness check, the browser and Apple · macos (push) Successful in 15m21s
WAI examples / WAI examples · portable · linux (push) Successful in 28m38s
wai-quantum-landscape-fpga reference design / the member against the model of the logic, and the logic against the model · linux, release (push) Successful in 37m27s
wai-quantum studio and desktop / desktop app · windows (push) Successful in 15m6s
wai-quantum: Stage 0 of the landscape emulator, run as registered: its data, its document and its CI job
The test registered in 382d96830, run at the registered seeds: the open energy-landscape emulator's sampling
kernel (a classical sampler emulating the cells of a planned processor) against the exact Boltzmann law over
every one of 3^10 to 3^12 states, 24 cells of eight landscapes at three temperatures, 1,048,576 samples a cell,
one sample a chain.

- The CPU reference passes all 24 cells, and so does the ideal sampler drawing from the exact law. Pearson's
  p-values for the reference run from 0.03 to 0.97, the divergence's from 0.07 to 0.96.
- Each negative control fails all 24 cells, by a wide margin in every one, as registered: every cell drawn at
  once from the old state by 65 to 39,958 times the excess the threshold allows (least on the dense
  ferromagnet), a field plus noise thresholded by 295 to 3,920, a three-colour cell by 455 to 45,195. The
  registered predictions of the last two, from their exact laws, are within a few percent of what came out.
- GPU members, on every first-version cell: through Metal and through WebGPU on the build host, and through
  WebGPU on Vulkan on a Linux server's integrated GPU, every one of 1,048,576 chains in each of 18 cells is the
  reference's; the coloured WebGPU kernel on both hosts, whose chains are its own on sparse couplings, passes all
  18. Not run here, so not certified by this: the CUDA member and the Vulkan members on its host, whose sign-in
  asks for a person, and the WebGPU member on the software Vulkan driver, left out of the Linux server's run. The
  nightly GPU workflow now runs the small tier through every member on its host. The FPGA member is not run and its board was not touched: it stays certified only by its
  hardware run of 2026-11-06.
- Mixing: each sample is its own chain's state after K sweeps (16 to 512), chosen before any sampling so that the
  exact law is within N chi2 <= 1 of the target; one long chain a cell gives the integrated autocorrelation times
  of the energy, the magnetisation, its size and the cells not at 0, and K against the longest. The dense
  ferromagnet at its coldest has a magnetisation time of 479 sweeps against K = 16: one chain rarely crosses
  between its ordered states, and the exact law shows the independent chains hold them in balance.

- quantum-conformance/landscape/stage0/: full/results.json, full/devices-build-host.json,
  full/devices-linux-server.json, small/results.json and small/report.md, README.md, reproduce.sh (both
  registrations, the small tier to its digest and both documents; --full, the full tier). Rebuilt to the byte on
  arm64 macOS and x86_64 Linux.
- wai-quantum/docs/landscape-stage0.md: the document, rendered from the data; listed in the docs check and the
  docs index.
- tests/landscape_stage0.rs: the small tier to the byte, the rule as registered on both tiers, the GPU members'
  chains, the documents as their data rendered.
- .github/workflows/wai-quantum-landscape-stage0.yml: the tests (13, pinned) and reproduce.sh on linux and macos.
  wai-quantum-landscape-devices.yml: a nightly step holding every member on its host to the small tier.
- landscape_stage0 devices --only PREFIX: run a subset of the members a host finds.
- extensions/quantum-landscape.md section 7.4 and quantum-landscape-2.md section 6: informative pointers.
- PREREGISTRATION.md, Changes after registration: none to the test; one note on a threshold's last binary place.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-11 14:10:29 -05:00

57 lines
6.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!-- 机器辅助翻译(machine-assisted translation):在对外推广之前,须由熟练的读者审校。 -->
# WAI Quantum 文档
> 本文为机器辅助翻译,尚待熟练的读者审校。英文原文:[README.md](README.md)。
这些页面上的每条命令和每段代码都在 CI 中运行,其输出会与真实输出或其回执对照检查(见下文)。无法运行某段代码的页面会说明原因。
## 从这里开始
- **学习**:[量子线路课程](../course/README.md),从第一个线路开始,经过叠加、纠缠、干涉、标准算法、噪声及其缓解、纠错和容错,直到资源估算。每道练习都由引擎检查。课程可以在 Studio 中和命令行上(`wai-quantum learn`)运行,有英文版和简体中文版。旁边还有 *Quantum, reconsidered*,一门关于干涉与学习的七模块课程,在浏览器中运行,地址为 <https://wai.transaction.science/quantum-learn>。
- **命令行**:[`wai-quantum`](../../wai-quantum-cli/README.zh-CN.md):运行、检查、绘制、编译和估算程序,验证回执,并把这些工具提供给智能体。
- **在浏览器和桌面上**:[Studio](../../quantum-studio/README.zh-CN.md) 和[桌面应用](../../wai-quantum-desktop/README.md)。
- **在 Python 中**:[`wai_quantum`](../../wai-quantum-py/README.zh-CN.md)。
## 引擎及其参考页面
- [crate 本身](../README.zh-CN.md):模拟器、运行层、研究工具和回执。
- [判定](verdicts.md):引擎对一个答案检查到了什么程度,意图,以及修复。
- [编译器](compiler.md):各遍处理、ε 预算和证书。
- [资源估算](estimate.md):估算中的每个数字及其假设。
- [已发表架构的重新估算](published-architectures.md):用这些估算器重算已发表的资源估算,给出每处差异及其原因。
- [读取器的诊断](qasm-diagnostics.md),以及[它如何处理每种构造](qasm-feature-matrix.md)。
- [其他格式](formats.md):按配置文件读写的 QIR 和 jeff,每次转换都经过检查。
- [作业层的拒绝代码](job-refusals.md)。
- [纠错与误差缓解](qec.md):码及其经过认证的距离、解码器、阈值,以及作业中的误差缓解。
- [脉冲与动力学](pulse.md):读入为帧上时序的脉冲程序,在主方程下积分并给出误差上界,在每个平台上比特一致,以及其回执所绑定的内容。
- [能量景观作业](landscape.md):对三态变量给出能量,在沉降模型的经典模拟器上运行,规模小时检查每一种排列,焦耳按定价给出,并在同一实例上以相同预算运行经典方法。
- [求解能耗](landscape-energy-to-solution.md):该模拟器与调优后的模拟退火、并行回火、禁忌搜索及精确求解器的对比,以 99% 概率达到最低能量的代价计;操作数为计数,主机的秒数与焦耳为实测,定价焦耳单列。
- [第 0 阶段:采样器对照精确分布](landscape-stage0.md):该模拟器的采样核在 3¹⁰ 至 3¹² 个状态上与玻尔兹曼分布逐一对照,阈值在运行前登记;理想采样器必须通过,错误的内核必须失败,CPU 与 GPU 成员皆然。
- [变分算法与算法库](variational.md):作业的参数、带舍入误差界的精确梯度、优化器、变分本征求解器、QAOA,以及相位估计、振幅估计、加法器和 QSVT 的程序,每个都对照参考加以检查。
## 其他入口
- [作业服务](../../wai-quantum-service/README.md),通过 HTTP 和 MCP:[自行运行](../../wai-quantum-service/docs/self-host.md)、作为[批处理调度器的资源](../../wai-quantum-service/docs/scheduler.md),以及[结果的来源记录了什么](../../wai-quantum-service/docs/provenance.md)。
- 智能体宿主中的视图:[其中的引擎](../../wai-quantum-views/README.md)。
- 答案视图层,一个草案扩展:[它的规范](../../extensions/quantum-answers.md)。
- [编辑器](../../tools/wai-quantum-editor/README.md):语言服务器、调试器和格式化工具。
- [你自己的硬件](../../wai-quantum-qpu/bring-your-own-quantum.md),以及[提供方 crate](../../wai-quantum-qpu/README.md)。
- [工作台的规格](../../wai-quantum-cli/discover/README.md)。
- 面向智能体:[Agent Skill](../../wai-quantum-cli/skills/wai-quantum/SKILL.md) 和 [`llms.txt`](../../wai-quantum-cli/docs/llms.txt),由服务器自身的工具列表生成。
## 版本之间的变化
- 变更日志:[`wai/CHANGELOG.md`](../../CHANGELOG.md)。
- 什么是稳定的、稳定多久、变更如何宣布,包括每种文档的模式:[版本策略](../VERSIONING.md)。
- 每个已弃用的项目、弃用它的版本及其替代:[弃用页面](../DEPRECATIONS.md)。
## 其他语言
英文:[本索引](README.md)、[命令行的 README](../../wai-quantum-cli/README.md)、[Studio 的 README](../../quantum-studio/README.md)、[Python 包的 README](../../wai-quantum-py/README.md)、[crate 的 README](../README.md)。
简体中文版有:这些页面、课程、Studio 的界面,以及命令行自身的文字(`--lang zh-CN`,或依 `LANG` 的设置)。每一份都是机器辅助翻译,均已注明,尚待熟练的读者审校。
## 这些页面如何检查
`wai/tools/quantum-docs/check_docs.py` 读取其 `docs.json` 中列出的每个页面。它在一个临时目录中、用从这份检出构建的命令行运行每个标记为 `runnable` 的 shell 代码块,针对这个包运行 Python 代码块,构建 Rust 代码块,并要求每个显示的输出与真实输出一致。它用 `wai-quantum verify` 验证代码块写出的每一份回执。无法在这里运行的代码块(需要账户、需要一个不会返回的服务器,或需要仓库中没有的数据)会在其信息字符串中说明,而且其中的命令仍须是确实存在的命令和标志。正文中的每个 `wai-quantum …` 都必须是真实的命令,每个相对链接都必须指向存在的文件,页面所示的每个依赖都必须是本仓库的版本能够满足的。译文必须与其英文页面包含相同的代码。`.github/workflows/wai-quantum-docs.yml` 运行它,同时运行课程的测试和语言区域检查。