2026-06-29 性能日志

用户目标

用户当前使用 V2.1.37 (build 20260629.0059)，反馈每次识别后等待时间变长。用户同意先加入精确性能日志，不先盲改识别或粘贴逻辑。

已完成事项

• 确认当前问题排查方向：先把录音停止、尾部等待、模型识别、后处理、等待热键释放、macOS 粘贴链路拆成可观测耗时段。
• 在主识别流水线加入 PERF 前缀日志。
• 在 macOS 剪贴板粘贴链路加入 PERF paste_clipboard_done 内部耗时日志。
• 运行 gofmt。
• 运行 go test ./...，测试通过；存在当前环境下的 macOS 链接版本 warning，但无测试失败。
• 运行 git diff --check，通过。
• 用户确认生成诊断 DMG 后，递增到 2.1.38 (build 20260629.2014)。
• 已创建源码 commit 9d4f977026bbb4516f8cc97f715c0dc28bf2a13f。
• 已创建本地 tag v2.1.38-build20260629.2014-diagnostic。
• 已生成 arm64 本地诊断 DMG，并通过 hdiutil verify。

关键决策

• 本轮只加诊断日志，不改变录音、识别、尾部保护、粘贴、UI 文案和版本号。
• 日志不额外记录音频内容；仅记录采样数、音频时长、文本 rune 数和分段耗时。
• 日志统一使用 PERF 前缀，便于从 app.log 中筛选。
• 本轮诊断包是本地诊断候选包，不是 App Store 上传包；最低系统版本为 macOS 14.0。

文件变更

• /Users/ar/Projects/PrivateVoice/privatevoice.src/app.go
• 新增识别流水线 PERF 日志。
• 记录 release tail wait、stop audio、voice activity check、recognize、postprocess、history、hotkey release wait、paste、pipeline total 等耗时。
• /Users/ar/Projects/PrivateVoice/privatevoice.src/internal/input/paste_darwin.go
• 新增 macOS 粘贴内部 PERF paste_clipboard_done 日志。
• 记录辅助权限检查、剪贴板快照、写剪贴板、剪贴板校验、Cmd+V 和总耗时。
• /Users/ar/Projects/PrivateVoice/privatevoice.src/build/darwin/Info.plist
• 更新版本为 2.1.38，build 为 20260629.2014。
• /Users/ar/Projects/PrivateVoice/privatevoice.src/frontend/package.json
• 更新版本为 2.1.38。
• /Users/ar/Projects/PrivateVoice/privatevoice.src/frontend/package-lock.json
• 更新版本为 2.1.38。
• /Users/ar/Projects/PrivateVoice/CHANGELOG.md
• 新增 v2.1.38 性能诊断包说明。
• /Users/ar/Projects/PrivateVoice/Release/PrivateVoice-Dictation-2.1.38-build20260629.2014-diagnostic/
• 新增诊断 DMG、SHA256SUMS.txt 和 RELEASE_MANIFEST.md。

未决问题

• 需要用户安装并使用诊断包几天，复现慢感后再读取 PERF 日志判断慢在尾部等待、模型识别还是粘贴链路。
• 项目未找到 CODEGRAPH.md，本轮未做 CODEGRAPH 更新；manifest 已记录该事实。

后续建议

• 用户安装诊断 DMG 后，先复现 3-5 句短句和 2-3 句长句。
• 重点检查 PERF pipeline_done total_ms、PERF recognize_done recognize_ms、PERF paste_done paste_ms、PERF paste_clipboard_done verify_ms。
• 如果主要慢在尾部等待，可评估把 SenseVoice 的 defaultReleaseTailDelay 从 300ms 降到更小值，同时回归“首字/尾字不丢”。