# 2026-07-01 Windows 动效打包

## 用户目标

为 Windows 原生 overlay 视觉升级后的版本生成新的可分发预览包，供用户在 PC 上验证新的炫彩动态指示效果。

## 当前起点

- 分支：`codex/x-asr-experiment-2.1.29`
- 打包前源码 commit：`2ba1056c56435f8d98110eca18dba90dc344de66`
- 版本升级：`2.1.38` -> `2.1.39`
- build 升级：`20260629.2014` -> `20260701.2356`

## 已完成事项

- Windows overlay 视觉升级落在 `privatevoice.src/internal/overlay/overlay_windows.go`：
  - 胶囊背景透明度降低。
  - 柱条从 5 根扩展到 11 根。
  - 增加光谱过渡、柱条 glow 和更轻的视觉层次。
- 更新版本/build：
  - `privatevoice.src/app.go`
  - `privatevoice.src/scripts/build-windows-preview.sh`
  - `CHANGELOG.md`
  - `CODEGRAPH.md`
- 创建源码固定点 commit：`2ba1056` `Polish Windows overlay preview`
- 生成 Windows 预览 zip、SHA256、release manifest，并创建 release tag。

## 核心事实 / 变更快照

- 版本：`2.1.39`
- build：`20260701.2356`
- 发布类型：`验收候选包`
- 平台：`Windows amd64 preview`
- release tag：`v2.1.39-build20260701.2356-windows-preview`

## 验证结论

执行并通过：

```bash
git diff --check
GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./...
./scripts/build-windows-preview.sh
unzip -t /Users/ar/Projects/PrivateVoice/privatevoice.src/build/windows-preview/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-amd64-preview.zip
shasum -a 256 /Users/ar/Projects/PrivateVoice/privatevoice.src/build/windows-preview/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-amd64-preview.zip
```

已知非阻断项：

- 前端 build 仍有既有 Svelte accessibility warnings：`UpdateDialog.svelte`、`ToggleSwitch.svelte`
- `npm install` 仍提示既有 `6 vulnerabilities (3 moderate, 3 high)`

## 交付产物

- 归档目录：
  `/Users/ar/Projects/PrivateVoice/Release/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-preview`
- zip：
  `/Users/ar/Projects/PrivateVoice/Release/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-preview/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-amd64-preview.zip`
- SHA256：
  `ffaccdc0a161a3ec67bb558f8b202bc56cf61190aaa378b485d192a867582055`
- manifest：
  `/Users/ar/Projects/PrivateVoice/Release/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-preview/RELEASE_MANIFEST.md`

## 可复用命令 / Runbook

用途：重新生成当前 Windows 预览候选包并核对 zip 完整性。

前置条件：

- 工作目录：`/Users/ar/Projects/PrivateVoice/privatevoice.src`
- 已安装：`go`、`npm`、`x86_64-w64-mingw32-gcc`、`x86_64-w64-mingw32-g++`

设置命令：

```bash
cd /Users/ar/Projects/PrivateVoice/privatevoice.src
./scripts/build-windows-preview.sh
unzip -t ./build/windows-preview/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-amd64-preview.zip
shasum -a 256 ./build/windows-preview/PrivateVoice-Dictation-2.1.39-build20260701.2356-windows-amd64-preview.zip
```

验证步骤：

- `build/windows-preview/` 下出现新的目录和 zip。
- `unzip -t` 输出 `No errors detected in compressed data`。

清理 / 恢复命令：

```bash
rm -rf /Users/ar/Projects/PrivateVoice/privatevoice.src/build/windows-preview
```

搜索关键词：

- `build-windows-preview.sh`
- `2.1.39`
- `20260701.2356`
- `windows overlay preview`