perceval-photonics SKILL.md skillA

perceval-photonics from xi-zhao/openquantum is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add xi-zhao/openquantum/perceval-photonics@git:20261012.5ce3b3e

Pins git:20261012.5ce3b3e in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
xi-zhao/openquantum
Path
.agents/skills/perceval-photonics/SKILL.md
Versions recorded
2
Latest version
git:20261012.5ce3b3e, committed Oct 12, 2026
First version recorded
Sep 27, 2026
Size
2,603 bytes
Repository stars
71
License
MIT

用 Quandela Perceval 在本地计算用户指定 Fock 输入、分束器和相移器网络的光子输出概率,解释模式顺序、HOM 干涉和适用边界。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Perceval 线性光学

<!-- BEGIN NATIVE SDK ACCESS -->
## 原生 SDK 路径

本能力同时支持 **Perceval 的原生公开 API**。用户需要 任意光学网络、Fock 输入、processor、sampler、噪声与损耗 时,由 Agent 在固定依赖环境中编写和运行任务代码,不限于下文便捷 Tool 的预设模型。

使用 `node scripts/sdk-access.mjs inspect perceval-photonics` 定位环境,按[完整 SDK 工作流](../quantum-sdk-workbench/references/workflow.md)执行。模块导航:`perceval`;导航不是 API 白名单。

下文关于模型、门集、输入与预算的限制描述便捷 Tool 的合同;原生 SDK 另受上游版本、可选依赖、宿主资源与用户授权约束。已禁用或被拒绝的动作不能借代码路径绕过。执行状态和科研验收分别报告。
<!-- END NATIVE SDK ACCESS -->

适用于无损、不可区分光子的被动线性光学干涉。Agent 经 Harness 调用 `perceval_local` 的 `simulate_perceval_photonics`;Skill 解释输入和结果,Tool 执行真实 Perceval SLOS 计算。

- `inputOccupation[i]` 是模式 i 的非负整数光子数;真空输入允许。`operations` 按时间顺序应用。
- `BS` 接受两个有序、不同模式;可非相邻。`angleRad` 是 θ,采用 `BS.H(θ)`,矩阵为 `[[cos(θ/2),sin(θ/2)],[sin(θ/2),-cos(θ/2)]]`,θ=π/2 为平衡分束器。适配层通过 SDK `PERM` 显式路由并还原模式。
- `PS` 接受一个模式,以 `exp(i*angleRad)` 改变振幅。所有角度是 rad。
- 输出 `outcomes` 包含固定总光子数下每个 Fock 输出;`occupation[i]` 对应输入模式 i。`unitary[row][column]` 是 `[real,imag]`,输入列到输出行。检查 `totalProbability` 接近 1。
- 先用双光子 HOM 或单光子网络检查角度与模式约定,再分析多光子永久式干涉。只有概率,无采样、损耗、探测器噪声或后选择。
- 规模由调用方选择;Fock 空间组合增长,使用独立的 `execution` 设定资源约束。不得用本地理想概率推断设备保真度。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add xi-zhao/openquantum/perceval-photonics@sha256:b7473806e802d33a

The line at the top of this page pins the label git:20261012.5ce3b3e, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_jrgttzp2xpgkxsgz.svg)](https://markdownregistry.com/a/art_jrgttzp2xpgkxsgz)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Sep 27, 2026 and Oct 12, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261012.5ce3b3e latest2026-10-12 5ce3b3e 2,603 BA view · diff
git:20260927.3f344ad2026-09-27 3f344ad 1,764 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2603 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

xi-zhao/openquantum · 71 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_jrgttzp2xpgkxsgz
GET https://markdownregistry.com/api/v1/resolve?ref=xi-zhao/openquantum/perceval-photonics
GET https://markdownregistry.com/api/v1/blob/b7473806e802d33a9403935340d4648543593dd35103b8c7a1e0cd0b7356626e

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from xi-zhao/openquantum

fixture-capability SKILL.md skill
xi-zhao/openquantum · .agents/skill-contracts/test/fixtures/capabilities/fixture-capability/SKILL.md · Contract fixture used only by the OpenQuantum Skill Contract tests.
git:20260814.132b3b6 · audit B · 71 stars
alicebob-cat-circuits SKILL.md skill
xi-zhao/openquantum · .agents/skills/alicebob-cat-circuits/SKILL.md · 用 Alice & Bob 的真实本地 Qiskit provider 构建物理或逻辑猫量子位噪声电路模型,返回调度转译后的采样和明确模型参数。
git:20261012.5ce3b3e · audit A · 71 stars
aqt-workbench SKILL.md skill
xi-zhao/openquantum · .agents/skills/aqt-workbench/SKILL.md · 官方离子阱后端本地编译与仿真,以及用户鉴权后的设备查询。
git:20261012.5ce3b3e · audit A · 71 stars
arc-rydberg SKILL.md skill
xi-zhao/openquantum · .agents/skills/arc-rydberg/SKILL.md · 使用 ARC Rydberg 的原生公开 API 完成原子、能级、跃迁矩阵元、寿命、Stark 图与相互作用,支持用户自定义模型、程序与结果文件。
git:20261013.efe0949 · audit A · 71 stars
bloqade-analog SKILL.md skill
xi-zhao/openquantum · .agents/skills/bloqade-analog/SKILL.md · 用 QuEra Bloqade Analog 在本地模拟二维 Rydberg 原子阵列的全局时变脉冲,返回逐原子占据、末态振幅、位串概率和明确单位。
git:20261012.5ce3b3e · audit A · 71 stars
braket-simulation SKILL.md skill
xi-zhao/openquantum · .agents/skills/braket-simulation/SKILL.md · 使用 Amazon Braket LocalSimulator 在本地计算结构化量子电路的精确数值振幅与概率。
git:20261012.5ce3b3e · audit A · 71 stars
catalyst-compilation SKILL.md skill
xi-zhao/openquantum · .agents/skills/catalyst-compilation/SKILL.md · 使用 PennyLane Catalyst 的原生公开 API 完成qjit、混合程序、QNode、控制流、编译配置与梯度,支持用户自定义模型、程序与结果文件。
git:20261013.efe0949 · audit A · 71 stars
chromobius-decoding SKILL.md skill
xi-zhao/openquantum · .agents/skills/chromobius-decoding/SKILL.md · 使用 Chromobius 的原生公开 API 对带颜色和基标注的 Stim detector error model 解码,比较预测与实际逻辑 observable 翻转;用于色码解码、样本分析和可复核小规模实验。
git:20261026.f44a0b2 · audit A · 71 stars
classiq-synthesis SKILL.md skill
xi-zhao/openquantum · .agents/skills/classiq-synthesis/SKILL.md · 使用 Classiq 官方 SDK 构建结构化 Qmod 模型,或通过用户自行配置的凭据调用远程综合;区分模型准备、云端综合和量子执行。
git:20261012.5ce3b3e · audit A · 71 stars
clifft-sampling SKILL.md skill
xi-zhao/openquantum · .agents/skills/clifft-sampling/SKILL.md · 用固定 Clifft 对 Clifford+T 电路做带噪采样或 Stim 格式的纠错记录采样,按活跃宽度控制成本,可选最终测量密度矩阵参考。
git:20261012.5ce3b3e · audit A · 71 stars
compact-optimization SKILL.md skill
xi-zhao/openquantum · .agents/skills/compact-optimization/SKILL.md · 用固定 Compact 执行线路优化与独立等价对照,解释输入语义、独立数值对照、成本与科学边界。
git:20261012.5ce3b3e · audit A · 71 stars
cqlib-kernel SKILL.md skill
xi-zhao/openquantum · .agents/skills/cqlib-kernel/SKILL.md · 用固定 cqlib-qml 执行角度编码核与 QSVM,解释输入语义、独立数值对照、成本与科学边界。
git:20261012.5ce3b3e · audit A · 71 stars

Every file in xi-zhao/openquantum

Browse by kind, by grade A, or by owner.