Release Notes#

这个页面汇总 UnifiedQuantum 的版本变化、升级时值得优先关注的调整，以及更完整的版本变化记录。

先看什么#

当前建议先看哪个版本#

如果你是从较早版本直接升级，先看 v0.0.5。

这是目前最新的正式发布。它一方面补齐了上一轮 CLI / 打包相关改动后的几个实际使用问题，另一方面也把发布链路里会影响安装体验的可选依赖边界进一步收紧。

升级时最值得先确认的是：

  • uniqc CLI 在位置参数后跟选项的常见写法现在已经稳定可用

  • QASM 到 OriginIR 的转换会保留 MEASURE，uniqc simulate 也能直接吃 QASM

  • uniqc task show、uniqc result、uniqc config profile list 这些命令的展示行为更接近期望

  • PyPI 包元数据不再携带 TorchQuantum 的 Git 依赖；只有真的使用对应后端时才需要额外安装

如果你是从更早版本直接升级，v0.0.4 仍然值得补读，因为它是第一个明显包含结构性调整的版本：

  • CLI 名称从 uniq 调整为 uniqc

  • Python 包名从 uniq 调整为 uniqc

  • 任务缓存统一迁移到 SQLite

  • 文档和 API 入口做过一轮整顿

这些变化并不只是内部清理，对已有脚本、命令和缓存位置都可能有影响。

版本解读#

v0.0.5#

这是一次以“把上一轮结构调整真正打磨到可发布可安装”为目标的发布。

这版最明显的用户侧收益有四类：

  • CLI 参数解析恢复为更自然的调用方式，不再容易把位置参数后的选项误判成子命令

  • QASM / OriginIR / dummy / 结果展示这条链路上的几个实用 bug 被补齐，CLI 日常使用更顺手

  • TorchQuantum 相关依赖改成真正按需，基础安装不会再因为发布元数据或导入链过早触发可选依赖而变脆

  • 文档与回归测试一起补上，发布链路更接近“改完就能发、发了就能装”

如果你已经在用 v0.0.4 或 v0.0.4.post1，升级到这版时建议优先复核：

  • 你是否有把 QASM 先转 OriginIR 再模拟的临时绕路脚本

  • 你是否在脚本里手工处理 task show / result 的输出结构

  • 你是否因为 TorchQuantum / qutip 缺失而遇到过“明明没用那个功能却导入失败”的情况

v0.0.4.post1#

这个版本是一次紧急性质更强的补丁发布，重点是修复 wheel 构建绑定错误 Python 解释器导致的 ABI 不匹配问题。

如果你之前遇到过“能装上 wheel，但导入扩展模块时 ABI / Python 版本不匹配”的现象，优先确认自己是否已经越过这一版。

v0.0.4#

这是一次带有明显结构调整的发布。升级时最值得先检查的是命令名、导入路径和任务缓存相关脚本。

升级时建议优先检查：

  • 你的命令行调用是否还在使用 uniq

  • 代码导入路径是否仍引用旧包名

  • 是否有依赖旧任务缓存行为的本地脚本

v0.0.3#

这个版本主要修正发布链路里的版本识别问题。日常使用层面的变化不大，但和打包、CI、版本展示相关。

v0.0.1#

这个版本主要修复了 QASM parser 对 if 的误判问题。

具体版本变化参考#

下面这部分会在文档构建时根据仓库里的 tag、提交标题和文件变化自动整理，适合用来查某个版本具体包含了哪些提交和改动范围。

详细变更记录（自动整理）#

这一节会在文档构建时根据当前仓库的 git tag、提交标题与变更文件路径整理生成。 这里主要提供可核对的版本变化记录；兼容性判断和升级建议以上面的说明为准。

版本总览#

版本

日期

标题

v0.0.5

2026-04-21

Merge pull request #17 from TMYTiMidlY/fix/cli-and-torchquantum-packaging

v0.0.4.post1

2026-04-21

Merge pull request #16 from TMYTiMidlY/fix/wheel-abi-mismatch

v0.0.4

2026-04-19

Merge pull request #6 from TMYTiMidlY/main

v0.0.3

2026-04-18

Merge pull request #1 from IAI-USTC-Quantum/fix/setuptools-scm-versioning

v0.0.1

2026-04-18

fix: correct false positive in QASM parser ‘if’ check

开发中变更#

  • 说明：这一节展示自最新 tag 之后、当前 HEAD 上尚未形成新版本的变更。

  • 对比区间：v0.0.5..HEAD

  • 提交数：23

  • 变更文件数：35

提交类型统计#

类型

数量

merge

10

docs

6

fix

3

feat

2

ci

1

refactor

1

变更区域#

  • uniqc/test: 13 个文件

  • uniqc/task: 5 个文件

  • docs: 4 个文件

  • .github: 2 个文件

  • uniqc/cli: 2 个文件

  • CLAUDE.md: 1 个文件

  • README.md: 1 个文件

  • concept_unified_platforms.png: 1 个文件

  • pyproject.toml: 1 个文件

  • pytest.ini: 1 个文件

  • uniqc/backend_cache.py: 1 个文件

  • uniqc/backend_info.py: 1 个文件

  • uniqc/backend_registry.py: 1 个文件

  • uniqc/config.py: 1 个文件

提交列表#

  • 6f37156 docs: polish release notes and fix tag docs deploy

  • 340efe7 ci: allow docs deploys from release tags

  • bba1dc8 docs: add comprehensive OriginIR language specification

  • 16f8367 Merge pull request #18 from Agony5757/docs/originir-spec

  • b3d3247 refactor: remove mock imports from tests, use real dependencies

  • 04a0f54 fix(ci): remove bash-specific 2>/dev/null for Windows compatibility

  • 1bee233 fix: add dill>=0.4.1 constraint to prevent qiskit compatibility issue

  • b7f5728 Merge pull request #21 from yowakkojay/fix/dill-version-constraint

  • d0a389e Merge pull request #19 from Agony5757/refactor/remove-test-mocks

  • 5e4ee2a docs: enhance design philosophy section with AI-native positioning and concept diagram

  • d87395b Merge pull request #22 from IAI-USTC-Quantum/docs/add-banner-to-readme

  • 66ae427 docs: fix markdown table separator in design philosophy section

  • a520587 Merge pull request #23 from IAI-USTC-Quantum/docs/design-philosophy-table-fix

  • 33cf085 docs: remove design philosophy table from README

  • 57ca19e Merge pull request #24 from IAI-USTC-Quantum/docs/remove-design-philosophy-table

  • 65e3358 feat: install docs, OriginQ submit qubit count, backend registry and IBM adapter

  • 37e52b5 Merge pull request #25 from Agony5757/feature/originq-submit-chip-info

  • 0ebf1c0 docs: make uv primary install method, add Tsinghua mirror guidance

  • 3235fad Merge pull request #26 from Agony5757/docs/uv-install-recommended

  • 0a66087 feat: enrich backend metadata with fidelity, coherence, and topology data

  • 6cc81bd Merge pull request #27 from Agony5757/feat/backend-fidelity-chip-info

  • 7cec9a6 fix: IBM adapter uses correct Target API, update docs and dev setup

  • 2615fb9 Merge pull request #28 from Agony5757/fix/backend-fidelity-ibm-target

v0.0.5#

  • 发布日期：2026-04-21

  • 发布标题：Merge pull request #17 from TMYTiMidlY/fix/cli-and-torchquantum-packaging

  • 补充说明：fix: 修复 CLI 参数解析并移除 TorchQuantum 的 PyPI Git 依赖

  • 对比区间：v0.0.4.post1..v0.0.5

  • 提交数：11

  • 变更文件数：37

提交类型统计#

类型

数量

other

5

fix

3

merge

2

docs

1

变更区域#

  • uniqc/test: 11 个文件

  • uniqc/cli: 8 个文件

  • examples: 5 个文件

  • uniqc/algorithmics: 2 个文件

  • uniqc/simulator: 2 个文件

  • uniqc/task: 2 个文件

  • README.md: 1 个文件

  • codecov.yml: 1 个文件

  • pyproject.toml: 1 个文件

  • uniqc/config.py: 1 个文件

  • uniqc/originir: 1 个文件

  • uniqc/pytorch: 1 个文件

  • uniqc/qasm: 1 个文件

提交列表#

  • fc1466c fix: scope simulation dependency checks by backend

  • 054560a docs: align simulation check docs and flags

  • d672e71 Merge pull request #15 from TMYTiMidlY/fix/simulation-check-scope

  • 94dcf08 fix: unify CLI parsing and torchquantum packaging fallback

  • 6980ba0 Fix eager imports for optional simulator deps

  • 52b65af Fix test mocks that poison uniqc_cpp imports

  • 666cf82 Polish Copilot follow-up fixes

  • ff8dc2c Preserve measurements when parsing OriginIR

  • b9f78b3 Relax Codecov patch threshold

  • b2fdbd0 fix(cli): resolve 4 CLI/parser bugs around QASM, results, and profiles

  • 9a188b3 Merge pull request #17 from TMYTiMidlY/fix/cli-and-torchquantum-packaging

v0.0.4.post1#

  • 发布日期：2026-04-21

  • 发布标题：Merge pull request #16 from TMYTiMidlY/fix/wheel-abi-mismatch

  • 补充说明：修复 wheel 构建绑定错误 Python 解释器导致的 ABI 不匹配

  • 对比区间：v0.0.4..v0.0.4.post1

  • 提交数：18

  • 变更文件数：50

提交类型统计#

类型

数量

merge

6

fix

5

docs

2

test

2

chore

1

feat

1

refactor

1

变更区域#

  • uniqc/test: 10 个文件

  • docs: 8 个文件

  • examples: 7 个文件

  • uniqc/algorithmics: 6 个文件

  • .github: 5 个文件

  • scripts: 2 个文件

  • uniqc/pytorch: 2 个文件

  • uniqc/simulator: 2 个文件

  • .gitignore: 1 个文件

  • CLAUDE.md: 1 个文件

  • CONTRIBUTING.md: 1 个文件

  • README.md: 1 个文件

  • pyproject.toml: 1 个文件

  • setup.py: 1 个文件

  • uniqc/cli: 1 个文件

  • uniqc/transpiler: 1 个文件

提交列表#

  • edb676d fix: remove duplicate release trigger from pypi-publish workflow

  • 92d0113 Merge pull request #7 from Agony5757/fix/pypi-publish-duplicate-trigger

  • 7d81b06 refactor: remove –no-cpp option and require C++ build

  • ebd7356 Merge pull request #8 from Agony5757/refactor/remove-no-cpp

  • b5becb6 fix: resolve issue #9 - documentation and code consistency fixes

  • ed88afb test: add tests for CLI, transpiler, simulator, and test runner

  • 65157dd Merge pull request #10 from Agony5757/fix/issue-9-doc-code-consistency

  • 28d6e08 feat: add TorchQuantum backend and variational quantum algorithms

  • 523177f fix: resolve CI build failures

  • f8168ea fix: exclude qiskit transpiler tests from CI (dill serialization conflict)

  • 9af1aa8 Merge pull request #11 from Agony5757/feature/torchquantum-backend

  • 71c3d29 docs: add release notes page

  • 98bbab2 docs: document release notes maintenance

  • 68ec0dc Merge pull request #12 from TMYTiMidlY/docs/release-notes-page

  • 214192f fix: bind wheel builds to the active Python interpreter

  • 8278631 test: validate wheel ABI tags in CI

  • 54d7065 chore: clarify wheel ABI validation errors

  • 60a838e Merge pull request #16 from TMYTiMidlY/fix/wheel-abi-mismatch

v0.0.4#

  • 发布日期：2026-04-19

  • 发布标题：Merge pull request #6 from TMYTiMidlY/main

  • 补充说明：refactor!: 任务缓存统一迁至 SQLite + 重命名 uniq → uniqc + 文档整顿

  • 对比区间：v0.0.3..v0.0.4

  • 提交数：11

  • 变更文件数：792

提交类型统计#

类型

数量

docs

5

refactor

3

merge

2

chore

1

变更区域#

  • UniqcCpp: 508 个文件

  • docs: 71 个文件

  • uniqc/test: 66 个文件

  • examples: 27 个文件

  • uniqc/algorithmics: 26 个文件

  • uniqc/task: 13 个文件

  • uniqc/circuit_builder: 11 个文件

  • uniqc/cli: 10 个文件

  • uniqc/simulator: 9 个文件

  • uniqc/transpiler: 6 个文件

  • UniqCpp: 5 个文件

  • uniqc/analyzer: 4 个文件

  • uniqc/pytorch: 4 个文件

  • uniqc/qasm: 4 个文件

  • .github: 3 个文件

  • uniq: 3 个文件

  • uniqc/originir: 3 个文件

  • .gitignore: 1 个文件

  • .gitmodules: 1 个文件

  • CLAUDE.md: 1 个文件

  • CMakeLists.txt: 1 个文件

  • README.md: 1 个文件

  • banner_uniqc.png: 1 个文件

  • pyproject.toml: 1 个文件

  • pytest.ini: 1 个文件

  • setup.py: 1 个文件

  • stubgen.py: 1 个文件

  • uniqc/__init__.py: 1 个文件

  • uniqc/__main__.py: 1 个文件

  • uniqc/backend.py: 1 个文件

  • uniqc/circuit_adapter.py: 1 个文件

  • uniqc/config.py: 1 个文件

  • uniqc/exceptions.py: 1 个文件

  • uniqc/network_utils.py: 1 个文件

  • uniqc/task_manager.py: 1 个文件

  • uniqc/version.py: 1 个文件

提交列表#

  • 68e6ac6 docs: add banner to README.md

  • aa48271 Merge pull request #2 from IAI-USTC-Quantum/docs/add-banner-to-readme

  • d56689a refactor: unify task cache on SQLite; polish README and CLI

  • cb26368 refactor: rename CLI binary from uniq to uniqc

  • ae0e226 refactor!: rename package uniq -> uniqc; purge qpanda-lite residue

  • 7856839 docs: clean up rename residues and tighten sphinx config

  • e2ff258 docs: reconcile design docs with current implementation

  • 566f27d docs: fix rendering bugs in index and docstrings

  • be0d3f2 docs: regenerate API reference via sphinx-apidoc, stop tracking generated rst

  • 6b1f908 chore: clean up dead version macro, BOM, and misleading README comment

  • 999ab59 Merge pull request #6 from TMYTiMidlY/main

v0.0.3#

  • 发布日期：2026-04-18

  • 发布标题：Merge pull request #1 from IAI-USTC-Quantum/fix/setuptools-scm-versioning

  • 补充说明：fix: correct setuptools_scm version detection in CI workflows

  • 对比区间：v0.0.1..v0.0.3

  • 提交数：2

  • 变更文件数：4

提交类型统计#

类型

数量

fix

1

merge

1

变更区域#

  • .github: 2 个文件

  • .gitignore: 1 个文件

  • uniq: 1 个文件

提交列表#

  • 9059921 fix: correct setuptools_scm version detection in CI workflows

  • d977728 Merge pull request #1 from IAI-USTC-Quantum/fix/setuptools-scm-versioning

v0.0.1#

  • 发布日期：2026-04-18

  • 发布标题：fix: correct false positive in QASM parser ‘if’ check

  • 补充说明：The parser used substring match (‘if’ in qasm) which triggered on “Unified” in “UnifiedQuantum” within auto-generated comments. Changed comment to use “uniq” and added TODO for proper regex-based check.

  • 对比区间：repo start -> v0.0.1

  • 提交数：6

  • 变更文件数：805

提交类型统计#

类型

数量

fix

5

other

1

变更区域#

  • UniqCpp: 510 个文件

  • uniq: 165 个文件

  • docs: 78 个文件

  • examples: 33 个文件

  • .github: 5 个文件

  • .gitattributes: 1 个文件

  • .gitignore: 1 个文件

  • .gitmodules: 1 个文件

  • .pre-commit-config.yaml: 1 个文件

  • CLAUDE.md: 1 个文件

  • CMakeLists.txt: 1 个文件

  • CODE_OF_CONDUCT.md: 1 个文件

  • CONTRIBUTING.md: 1 个文件

  • LICENSE: 1 个文件

  • README.md: 1 个文件

  • pyproject.toml: 1 个文件

  • pytest.ini: 1 个文件

  • setup.py: 1 个文件

  • stubgen.py: 1 个文件

提交列表#

  • a9761ed Initial commit: UnifiedQuantum migrated from QPanda-lite

  • ce17725 fix: use explicit dependencies in ‘all’ extra

  • ad11537 fix: mark QASM tests as xfail due to unsupported if statements

  • 856f589 fix: disable setuptools_scm local scheme to avoid invalid wheel filename

  • 9c0106b fix: use API token for PyPI publishing to support first release

  • 5215648 fix: correct false positive in QASM parser ‘if’ check