# 2026-06-07 X-ASR 实验分支与回滚基线

## 目的

为 X-ASR 效果实验创建独立开发线，同时固定 2.1.28 App Store 上传包的可回滚基线。实验失败时不得覆盖已验证的 2.1.28 上架包源码与 tag。

## 已冻结基线

- App Store 上传包版本：`2.1.28`
- App Store 上传包 build：`20260605.0353`
- 发布 tag：`v2.1.28-build20260605.0353-appstore-upload`
- 源码 commit：`82ce4aa571dfa74032d4697984cc932257cfa35b`
- 回滚分支：`codex/freeze-2.1.28-appstore-20260605.0353`
- 上传包 SHA256：`2d0e4fa7b79b70cc771086bbb124329fd4bb923849061f441d03b7391074d4cc`

上传包路径：

```text
/Users/ar/Desktop/PrivateVoice-26.0604上架/02-上传包/PrivateVoice-Dictation-2.1.28-build20260605.0353-universal-macappstore.pkg
```

## 实验分支

- 分支：`codex/x-asr-experiment-2.1.29`
- 分支起点：`793682b82812d3e89adcc354dd8b844af094ce13`
- 用途：只做 X-ASR 技术 spike、模型接入验证、性能/体积评估和必要的实验构建。

## 回滚方式

回到已上传 2.1.28 源码基线：

```bash
git switch codex/freeze-2.1.28-appstore-20260605.0353
```

或直接回到发布 tag：

```bash
git switch --detach v2.1.28-build20260605.0353-appstore-upload
```

## 今晚新版本门禁

- 如果实验要生成可给用户测试的包，版本必须递增到 `2.1.29`。
- 每次可分发包必须使用新的 `YYYYMMDD.HHMM` build 编号。
- 打包前必须提交所有会影响构建的源码改动。
- 新包必须生成 `.dmg`、SHA256、manifest、QA 记录和 release tag。
- 不得把实验包混称为 App Store 正式包；未通过 QA 前只称为实验/候选测试包。
- Mac App Store 构建必须检查 `ITSAppUsesNonExemptEncryption=false`、Bundle ID、entitlements、category、universal 架构和 quarantine。

## 当前注意事项

创建实验分支时，工作区已经存在若干历史 release 文件、构建产物和计划文档改动。它们不属于 2.1.28 已冻结源码基线；后续进入正式 2.1.29 打包前，必须只提交本轮有意纳入的源码、配置和文档。