# Windows与PC迁移

生成日期：2026-07-09

## 当前状态

- 主题说明：Windows与PC迁移 相关会话的长期二级汇编；原始会话记录仍是证据源。
- 来源记录数：4
- 时间范围：2026-06-30 至 2026-07-03
- 最新记录：[`26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md`](26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md)

## 最近结论摘录

- 生成迁移包 staging：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703`。
- 写入迁移指南：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703/MIGRATION_GUIDE.md`。
- 写入 Windows PowerShell 辅助脚本：
- `scripts/Restore-CodexPortable.ps1`
- `scripts/PrivateVoice-PC-Preflight.ps1`

## 核心事实补录

### 2026-06-30 2026-06-30-Windows预览版.md

```text
- 基线 tag: `v2.1.38-build20260629.2014-diagnostic`
- 基线 commit: `9d4f977`
- 新分支: `codex/windows-preview-2.1.38`
- 新 worktree: `/Users/ar/Projects/PrivateVoice/.worktrees/windows-preview-2.1.38`
## 已完成事项
- 从 `2.1.38` tag 创建隔离 Windows preview worktree。
- 运行 Windows cgo 交叉编译，确认项目可以生成 Windows x64 可执行文件。
```

```text
- 从 `2.1.38` tag 创建隔离 Windows preview worktree。
- 运行 Windows cgo 交叉编译，确认项目可以生成 Windows x64 可执行文件。
- 新增稳定脚本 `privatevoice.src/scripts/build-windows-preview.sh`，生成完整 Windows preview 目录和 zip。
- 新增 `privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1`，打进预览包，用于 Windows 真机启动 App、提示完成一次听写，并收集进程、日志、配置和 QA 结果。
- 增强 `QA-WINDOWS-PREVIEW.ps1`：脚本会自动创建并打开 Notepad 目标文件 `qa-target.txt`，要求测试者把识别结果输入并保存，然后采集 `qa-target-dictation-text.txt` 作为上屏证据。
- 新增 `privatevoice.src/scripts/verify-windows-qa-evidence.sh`，用于验证 Windows 返回的 `qa-evidence-*.zip` 是否同时证明启动、引擎就绪、录音、识别、上屏和 Windows 系统信息。
- 增强 `QA-WINDOWS-PREVIEW.ps1`：收集 WebView2 Runtime 注册表信息到 `webview2-runtime.txt`，收集音频端点清单到 `audio-endpoints.txt`，帮助定位 Windows 启动或录音失败原因。
- Windows preview 包含:
  - `PrivateVoice Dictation.exe`
```

```text
- Commit: `abdb22f7391d4128a4f89d8b668781061aedf86d`
- Tag: `v2.1.38-build20260629.2014-windows-preview`
- QA update commit: `58c6b963b81e07765d29cda9410399e9644c886f`
- QA update tag: `v2.1.38-build20260629.2014-windows-preview-qa`
- QA target text commit: `ac31349b32d89b2798cd20224fcdede91d6bfe05`
- QA target text tag: `v2.1.38-build20260629.2014-windows-preview-qa-target`
- Evidence verifier commit: `fdc5c43b2cf8ebc3d67099cfba9936c838281561`
- Evidence verifier tag: `v2.1.38-build20260629.2014-windows-preview-evidence-verifier`
- Runtime preflight commit: `913b25529de9fb28fe9d212cc13492430db5a7c6`
- Runtime preflight tag: `v2.1.38-build20260629.2014-windows-preview-preflight`
```

### 2026-07-01 2026-07-01-Windows动效打包.md

```text
为 Windows 原生 overlay 视觉升级后的版本生成新的可分发预览包，供用户在 PC 上验证新的炫彩动态指示效果。
## 当前起点
- 分支：`codex/x-asr-experiment-2.1.29`
- 打包前源码 commit：`2ba1056c56435f8d98110eca18dba90dc344de66`
- 版本升级：`2.1.38` -> `2.1.39`
- build 升级：`20260629.2014` -> `20260701.2356`
```

```text
- 打包前源码 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 和更轻的视觉层次。
```

```text
- 增加光谱过渡、柱条 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。
## 核心事实 / 变更快照
```

### 2026-07-01 2026-07-01-Windows合并.md

```text
## 核心事实 / 变更快照
- 新增固定点 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`。
```

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

### 2026-07-03 26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md

```text
- 生成迁移包 staging：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703`。
- 写入迁移指南：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703/MIGRATION_GUIDE.md`。
- 写入 Windows PowerShell 辅助脚本：
  - `scripts/Restore-CodexPortable.ps1`
  - `scripts/PrivateVoice-PC-Preflight.ps1`
  - `scripts/New-WindowsStabilityBranch.ps1`
- 复制可迁移 Codex 内容：
  - `~/.codex/AGENTS.md`
  - `~/.codex/rules/`
```

```text
- `config.windows.template.toml`
- 对打包 skills 执行本地静态扫描：`SAFE` 138 个、`CAUTION` 27 个、`DO_NOT_INSTALL` 17 个；非 `SAFE` skills 已从可恢复目录移除，名单见 `manifests/skillspector-excluded-skills.tsv`。
- 复制 `PrivateVoice` 项目副本，保留 `03-O` Git 根、源码、治理文档、`.codebase-memory/` 共享产物和 `C2.builds` 候选包。
- 项目台账 `02-P/进度地图.md` 已追加本轮迁移包记录。
## 核心事实 / 变更快照
- 变更对象：Windows PC 迁移交付包和恢复流程。
- 事实来源：
  - 迁移包目录：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703`
```

```text
## 核心事实 / 变更快照
- 变更对象：Windows PC 迁移交付包和恢复流程。
- 事实来源：
  - 迁移包目录：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703`
  - 项目入口：`/Users/ar/Projects/PrivateVoice/AGENTS.md`
  - 活跃台账：`/Users/ar/Projects/PrivateVoice/02-P/进度地图.md`
  - Git 根：`/Users/ar/Projects/PrivateVoice/03-O`
- 当前项目事实：
```

## 来源索引

- 2026-06-30 [`2026-06-30-Windows预览版.md`](2026-06-30-Windows预览版.md)
- 2026-07-01 [`2026-07-01-Windows动效打包.md`](2026-07-01-Windows动效打包.md)
- 2026-07-01 [`2026-07-01-Windows合并.md`](2026-07-01-Windows合并.md)
- 2026-07-03 [`26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md`](26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md)

## 时间线

### 2026-06-30 2026-06-30-Windows预览版.md

- 原始标题：2026-06-30 Windows 预览版
- 从 `2.1.38` tag 创建隔离 Windows preview worktree。
- 运行 Windows cgo 交叉编译，确认项目可以生成 Windows x64 可执行文件。
- 新增稳定脚本 `privatevoice.src/scripts/build-windows-preview.sh`，生成完整 Windows preview 目录和 zip。
- 新增 `privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1`，打进预览包，用于 Windows 真机启动 App、提示完成一次听写，并收集进程、日志、配置和 QA 结果。
- 增强 `QA-WINDOWS-PREVIEW.ps1`：脚本会自动创建并打开 Notepad 目标文件 `qa-target.txt`，要求测试者把识别结果输入并保存，然后采集 `qa-target-dictation-text.txt` 作为上屏证据。

### 2026-07-01 2026-07-01-Windows动效打包.md

- 原始标题：2026-07-01 Windows 动效打包
- Windows overlay 视觉升级落在 `privatevoice.src/internal/overlay/overlay_windows.go`：
- 胶囊背景透明度降低。
- 柱条从 5 根扩展到 11 根。
- 增加光谱过渡、柱条 glow 和更轻的视觉层次。
- 更新版本/build：

### 2026-07-01 2026-07-01-Windows合并.md

- 原始标题：2026-07-01 Windows 合并
- 确认 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`

### 2026-07-03 26.0703-PrivateVoice.PC迁移-迁移包与Windows指引.md

- 原始标题：PrivateVoice PC 迁移包与 Windows 指引
- 生成迁移包 staging：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703`。
- 写入迁移指南：`/Users/ar/Documents/Codex.Labs/技术实验室/PrivateVoice-PC-Migration-20260703/MIGRATION_GUIDE.md`。
- 写入 Windows PowerShell 辅助脚本：
- `scripts/Restore-CodexPortable.ps1`
- `scripts/PrivateVoice-PC-Preflight.ps1`