# 2026-07-01 Windows 合并

## 用户目标

用户在独立会话 / worktree `019f14bc-a4d1-7861-b045-40bcf1593bb1` 完成 PC 版开发并测试通过，希望把 PC 版与当前主代码分支合并。

## 当前起点

- 主 worktree: `/Users/ar/Projects/PrivateVoice`
- 目标分支: `codex/x-asr-experiment-2.1.29`
- 合并前目标 HEAD: `9d4f977026bbb4516f8cc97f715c0dc28bf2a13f`
- PC worktree: `/Users/ar/Projects/PrivateVoice/.worktrees/windows-preview-2.1.38`
- PC 分支: `codex/windows-preview-2.1.38`
- PC 分支 HEAD: `5b5cba7030b7f4dd519868fe310bb4fce893bf91`

## 已完成事项

- 确认 PC 分支从当前基线 `9d4f977` 分叉，包含 6 个 Windows preview 提交。
- 合并前先把当前 worktree 已完成验证的性能诊断 / 尾音保护改动单独提交，避免与 Windows 合并混在一个提交里。
- 使用正常 merge commit 合入 `codex/windows-preview-2.1.38`，保留 PC 分支历史。
- 没有处理合并前已存在的无关 dirty files / release 删除状态。

## 核心事实 / 变更快照

- 新增固定点 1: `2547282` `Add slow recognition diagnostics`
  - 增加 `PERF slow_recognition` 慢识别诊断日志。
  - SenseVoice 尾音保护为 100ms。
  - X-ASR 尾音保护保持 300ms。
  - 其他 macOS sherpa 离线模型不走新增尾音保护。
- 新增固定点 2: `3803f09` `Merge Windows preview build`
  - 合入 Windows preview 支持、Windows build capabilities、Windows QA 脚本、Windows preview 构建脚本、`CODEGRAPH.md`。
  - Windows preview 当前只支持 SenseVoice；其他模型保持可见但禁用。
  - Windows preview 包仍是 unsigned zip / 技术预览，不是正式安装器。
- PC 真实验收来源:
  - 2026-07-01 用户在真实 Windows 11 PC 上反馈“测试通过了完全正常”。
  - 详见 `/Users/ar/Projects/PrivateVoice/.codex-sessionhistory/2026-06-30-Windows预览版.md`。

## 文件变更

性能诊断提交涉及：

- `privatevoice.src/app.go`
- `privatevoice.src/app_live_caption_test.go`
- `privatevoice.src/internal/engine/engine_darwin.go`
- `privatevoice.src/internal/engine/engine_darwin_test.go`
- `privatevoice.src/internal/engine/engine_linux.go`
- `privatevoice.src/internal/engine/engine_windows.go`
- `privatevoice.src/internal/engine/release_tail.go`
- `privatevoice.src/system_load_darwin.go`
- `privatevoice.src/system_load_other.go`

Windows 合并提交涉及：

- `CHANGELOG.md`
- `CODEGRAPH.md`
- `privatevoice.src/frontend/src/components/settings/LanguagePage.svelte`
- `privatevoice.src/frontend/src/lib/i18n/en.json`
- `privatevoice.src/frontend/src/lib/i18n/zh.json`
- `privatevoice.src/internal/model/build_capabilities.go`
- `privatevoice.src/internal/model/build_capabilities_default.go`
- `privatevoice.src/internal/model/build_capabilities_monterey.go`
- `privatevoice.src/internal/model/build_capabilities_windows.go`
- `privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1`
- `privatevoice.src/scripts/RUN-WINDOWS-QA.cmd`
- `privatevoice.src/scripts/build-windows-preview.sh`
- `privatevoice.src/scripts/verify-windows-qa-evidence.sh`
- `privatevoice.src/services/engine_service.go`
- `privatevoice.src/services/engine_service_qwen3_default_test.go`
- `privatevoice.src/services/engine_service_windows_test.go`

## 验证结论

执行并通过：

```bash
npm --prefix frontend run build
go test ./...
bash -n scripts/build-windows-preview.sh scripts/verify-windows-qa-evidence.sh
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.38-build20260629.2014-windows-amd64-preview.zip
git diff --check 9d4f977..HEAD
```

验证备注：

- `npm --prefix frontend run build` 通过，但仍有既有 Svelte accessibility warnings。
- `go test ./...` 通过，但仍有既有 macOS linker version warnings。
- `./scripts/build-windows-preview.sh` 生成本地 Windows preview zip:
  `/Users/ar/Projects/PrivateVoice/privatevoice.src/build/windows-preview/PrivateVoice-Dictation-2.1.38-build20260629.2014-windows-amd64-preview.zip`
- `unzip -t` 确认 zip 内 `PrivateVoice Dictation.exe`、QA 脚本、DLL 和 README 均无压缩错误。

## 未决问题

- 当前主 worktree 在合并前已有大量无关 dirty files，例如 `.gitignore`、项目文档、README 以及旧 Release 目录删除状态；本轮未修改、未提交、未回滚这些内容。
- Windows preview 仍未签名，不是正式 Windows 安装器。
- `npm install` / build 输出提示 6 个 npm audit vulnerabilities，本轮未处理。

## 后续建议

- 如果要把 Windows preview 作为正式 PC 版本继续推进，下一步应单独开任务处理签名、安装器、SmartScreen 体验和正式 QA evidence 回收。
- 如果要从当前分支继续打 macOS 包，先确认当前无关 dirty files 是否属于预期，避免把 release 删除状态带进发布流程。