仓库结构¶
目标¶
本仓库用于实现 QOS / UQCI 的参考开源框架，并为仓库原生规范、机器可读工件与可运行参考实现提供统一组织方式。
顶层目录¶
- src/qos_uqci/ 核心 Python 包
- schemas/ JSON Schema
- examples/ 示例程序
- tests/ 测试
- docs/ 规范与说明文档
src/qos_uqci/ 推荐模块¶
- ir.py 统一 IR 定义
- ops.py GateOp / PulseOp / MeasureOp / SweepOp
- devicespec.py DeviceSpec 模型
- calset.py CalSet 模型
- bundle.py Manifest / Bundle / IO
- driver.py UQCIDriver 抽象接口
- result.py RunResult / ValidationReport / ExecutionPlan
- errors.py 标准错误
- lowering.py UQCI lowering 规则
- openqasm_bridge.py OpenQASM 兼容桥
- cli.py 命令行入口
backends/¶
- base.py
- mock_superconducting/
- mock_neutral_atom/
- optional: mock_ion_trap/
tests/¶
- test_models.py
- test_bundle_io.py
- test_openqasm_export.py
- test_mock_superconducting.py
- test_mock_neutral_atom.py
原则¶
- canonical core 与 backend-specific code 必须分离
- Schema 与 Python typed model 要一一对应
- 示例程序必须可运行
- 测试覆盖 bundle -> bridge -> backend -> result 这一条主链路