- CHANGELOG.md:v2.8.0 条目(中英双语); - README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明); - doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制); - skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/ require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过); - 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
6.0 KiB
Executable File
markup, title, description, import
| markup | title | description | import | ||
|---|---|---|---|---|---|
| occlusion | ext/quantum/simulate | Quantum simulation skill — amplitudes, probabilities, noisy shots. |
|
Simulation — choose the observable before choosing the execution path.
What are the amplitudes? Use simulate (noise: no); returns list of maps with re, im.
Need a state for tensor/fidelity work? Use state (noise: no); returns quantum_state with qubits, dim, amplitudes.
What are the exact basis weights? Use probabilities (noise: no); returns basis label → probability.
What would repeated readout produce? Use run (noise: yes); returns qubits, shots, seed, counts, measure; noise when set.
Attach one teaching noise channel Use noise (noise: later in run); returns new circuit.
Noise is bitflip, depolarizing or amplitude_damping, with probability in [0,1]. It acts after each unitary on that operation's participating wires. Attaching noise replaces the previous channel; it does not append a gate or change the ideal state. This is a teaching trajectory model, not a hardware backend. Measurement marks select sampled wires without collapsing ideal amplitudes.
A complete noise experiment
First create a circuit through the circuit module. The ideal state after X is one. Full bit-flip noise after X makes every sampled outcome zero; exact probabilities still describe one. Repeating run with the same circuit, seed and shots is deterministic for this simulator version.
marqdo call ext/quantum/circuit/index.mq.md new qubits=1 --effects plugin --session handbook --toget qc --json
marqdo call ext/quantum/circuit/index.mq.md x 'circuit=$qc' --effects plugin --session handbook --toget qc --json
marqdo call ext/quantum/simulate/index.mq.md noise 'circuit=$qc' 'kind="bitflip"' p=1 --effects plugin --session handbook --toget noisy --json
marqdo call ext/quantum/simulate/index.mq.md probabilities 'circuit=$noisy' --effects plugin --session handbook --json
marqdo call ext/quantum/simulate/index.mq.md run 'circuit=$noisy' shots=32 seed=7 --effects plugin --session handbook --json
Development route
Put new readouts here rather than duplicating circuit construction. Numerical evolution and seeded sampling live in plugins/quantum/src/sim.rs; exports live in src/lib.rs beside it. Preserve ideal/noisy separation in both language trees and validate tests/ext/quantum-noise-smoke.mq.md plus amplitude-damping golds. For entanglement go to state; for mixed states use density, which currently describes ideal evolution.
simulate
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | circuit to evolve |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | amplitude list |
Use circuit as the inputs for this operation.
Return ideal state-vector amplitudes for circuit as re/im entries. Noise
channels attached to the circuit are ignored here.
We Load the native plugin required by this operation. Return Return ideal state-vector amplitudes for circuit as re/im entries. Noise channels attached to the circuit are ignored here..
state
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | circuit to evolve |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | ideal state |
Use circuit as the inputs for this operation.
Same ideal amplitudes as simulate for circuit, packaged as the plugin state
object. Prefer this when later fidelity or density tools expect a state handle.
We Load the native plugin required by this operation. Return Same ideal amplitudes as simulate for circuit, packaged as the plugin state object. Prefer this when later fidelity or density tools expect a state handle..
probabilities
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | circuit to read |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | probability map |
Use circuit as the inputs for this operation.
Map basis label to probability for the ideal state of circuit. Labels use
qubit 0 as the rightmost bit. Noise is ignored.
We Load the native plugin required by this operation. Return Map basis label to probability for the ideal state of circuit. Labels use qubit 0 as the rightmost bit. Noise is ignored..
run
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| circuit | any | required | circuit to sample |
| shots | number | 1024 | sample count |
| seed | number | 1 | RNG seed |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | counts or shot result |
Use circuit, shots=1024, seed=1 as the inputs for this operation.
Sample computational-basis outcomes from circuit. Defaults are shots=1024
and seed=1 so replays are deterministic. Teaching noise is applied when set.
We Load the native plugin required by this operation.
Return [Sample computational-basis outcomes from circuit. Defaults are shots=1024 and seed=1 so replays are deterministic. Teaching noise is applied when set.](quantum_run(circuit=circuit, shots=shots, seed=seed)).
noise
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
| kind | text | required | noise family name |
| p | number | required | strength in the unit interval |
| circuit | any | required | circuit to annotate |
| 返回 | 类型 | 说明 |
|---|---|---|
| result | any | circuit with noise metadata |
Use kind, p, circuit as the inputs for this operation.
Attach teaching noise of kind kind with strength p on circuit. Ideal
simulate and probability tools ignore it. Keep p small unless demonstrating
decoherence. Supported kinds include bitflip, depolarizing, and amplitude_damping.
We Load the native plugin required by this operation.
Return [Attach teaching noise of kind kind with strength p on circuit](quantum_noise(circuit=circuit, kind=kind, p=p)).