90b6f02bfa
docs/variational.md describes each call on every surface, every block of it run by the documentation check: a job's parameters, the gradient methods and what the rounding bound counts, the optimisers and the digest chain, the variational eigensolver, QAOA, and the builders with their references. The crate, command-line and service READMEs (and their translations) gain the library, the feature matrix says what a float or angle input now is, the agent docs are regenerated, and wai/CHANGELOG.md acknowledges the one breaking change, engine::schema::FILES growing to 23. Co-Authored-By: Claude Opus 5.5 <[email protected]>
5.2 KiB
5.2 KiB
WAI Quantum 文档
本文为机器辅助翻译，尚待熟练的读者审校。英文原文：README.md。
这些页面上的每条命令和每段代码都在 CI 中运行，其输出会与真实输出或其回执对照检查（见下文）。无法运行某段代码的页面会说明原因。
从这里开始
- 学习：量子线路课程，从第一个线路开始，经过叠加、纠缠、干涉、标准算法、噪声及其缓解、纠错和容错，直到资源估算。每道练习都由引擎检查。课程可以在 Studio 中和命令行上（
wai-quantum learn）运行，有英文版和简体中文版。旁边还有 Quantum, reconsidered，一门关于干涉与学习的七模块课程，在浏览器中运行，地址为 https://wai.transaction.science/quantum-learn。 - 命令行：
wai-quantum：运行、检查、绘制、编译和估算程序，验证回执，并把这些工具提供给智能体。 - 在浏览器和桌面上：Studio 和桌面应用。
- 在 Python 中：
wai_quantum。
引擎及其参考页面
- crate 本身：模拟器、运行层、研究工具和回执。
- 判定：引擎对一个答案检查到了什么程度，意图，以及修复。
- 编译器：各遍处理、ε 预算和证书。
- 资源估算：估算中的每个数字及其假设。
- 读取器的诊断，以及它如何处理每种构造。
- 其他格式：按配置文件读写的 QIR 和 jeff，每次转换都经过检查。
- 作业层的拒绝代码。
- 纠错与误差缓解：码及其经过认证的距离、解码器、阈值，以及作业中的误差缓解。
- 脉冲与动力学：读入为帧上时序的脉冲程序，在主方程下积分并给出误差上界，在每个平台上比特一致，以及其回执所绑定的内容。
- 变分算法与算法库：作业的参数、带舍入误差界的精确梯度、优化器、变分本征求解器、QAOA，以及相位估计、振幅估计、加法器和 QSVT 的程序，每个都对照参考加以检查。
其他入口
- 作业服务，通过 HTTP 和 MCP：自行运行、作为批处理调度器的资源，以及结果的来源记录了什么。
- 智能体宿主中的视图：其中的引擎。
- 答案视图层，一个草案扩展：它的规范。
- 编辑器：语言服务器、调试器和格式化工具。
- 你自己的硬件，以及提供方 crate。
- 工作台的规格。
- 面向智能体：Agent Skill 和
llms.txt，由服务器自身的工具列表生成。
版本之间的变化
- 变更日志：
wai/CHANGELOG.md。 - 什么是稳定的、稳定多久、变更如何宣布，包括每种文档的模式：版本策略。
- 每个已弃用的项目、弃用它的版本及其替代：弃用页面。
其他语言
英文：本索引、命令行的 README、Studio 的 README、Python 包的 README、crate 的 README。
简体中文版有：这些页面、课程、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 运行它，同时运行课程的测试和语言区域检查。