# 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、提交标题和文件变化自动整理，适合用来查某个版本具体包含了哪些提交和改动范围。

```{include} _generated/strict_history.md
```