b894f1bbc5
The course's documents join the version contract. The course as kept and as served (wai.quantum.course/1) and each exercise (wai.quantum.exercise/1) move from course/schema/ to the crate's schemas/, named and versioned as the rest; a check, a lesson as served and a hint are wai.quantum.course-check/1, and a check now names its engine beside its schema; the command line's progress file is wai.quantum.learn-progress/1. The engine's test holds the course, every exercise, every lesson in each locale and a check and hint of some to them; the learn test holds the progress file; the contract workflow requires both, and the eval and lease tests, by name, and runs when the answer and eval sets its tests read change. The docs runner reads every page the branches added: the error-correction page, the version policy, the deprecations page, the service's self-hosting, scheduler and provenance pages, and the views' README. Each block the other branches wrote either runs or says why it cannot (a sweep fixture added), and the job service it starts keeps its store in its scratch. The crate's README names wai-quantum 0.7. The Chinese READMEs hold the English pages' code again: the sections for error correction, sets and sweeps, the service's dry runs, the scheduler, scoring a model, the answer layer, views and versions are translated, and the compile pages name the gate set basis. The command line's Chinese words cover task, qec, eval and version, and submit as it reads now. The documentation index links the policy, the deprecations, the error-correction page and the service's pages in both languages. The policy lists every schema file and says the answer layer is a draft outside its promise. The 0.7.0 heading names what the four branches bring. The views page bundles the Studio components that now read their words through the locale module; build-views.mjs gives it the English words alone, so no other language's words reach a host. The result parts the Studio and the views share read their words through it too, so the Studio's result pane stays translated, its English unchanged. Co-Authored-By: Claude Opus 5.5 <[email protected]>
4.7 KiB
4.7 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 本身：模拟器、运行层、研究工具和回执。
- 判定：引擎对一个答案检查到了什么程度，意图，以及修复。
- 编译器：各遍处理、ε 预算和证书。
- 资源估算：估算中的每个数字及其假设。
- 读取器的诊断，以及它如何处理每种构造。
- 作业层的拒绝代码。
- 纠错与误差缓解：码及其经过认证的距离、解码器、阈值，以及作业中的误差缓解。
其他入口
- 作业服务，通过 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 运行它，同时运行课程的测试和语言区域检查。