edit | blame | history | raw

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

验证结论

执行并通过：

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 删除状态带进发布流程。