From e86df221fa8f9d6796fb7fe59020767d7c806fac Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Sun, 14 Jun 2026 20:57:40 +0800
Subject: [PATCH] Fix X-ASR hold pre-capture

---
 CHANGELOG.md |   50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 50 insertions(+), 0 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 02bb800..30508e8 100755
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,55 @@
 # Changelog
 
+## v2.1.31 (2026-06-14)
+
+### X-ASR 实验修复
+
+- **X-ASR 首字保护**：hold 模式在按下热键时立即开始预采集音频，确认不是组合键后再显示浮窗并进入正式录音，降低“你看看”等短句首字丢失概率。
+- **组合键与短按隔离**：预采集阶段检测到组合键或用户过早松开热键时会丢弃音频，不进入识别流程。
+- **X-ASR 开头上下文 padding**：X-ASR streaming session 首次接收音频时补 250ms 前置静音，提升贴近开头的短音节稳定性。
+- **取消路径加固**：Escape 取消会停止实时字幕 session，并阻止同一次按住手势在 debounce 后重新启动录音；引擎不可用时仍允许已有录音释放/取消清理完成。
+- **隔离范围**：首字保护能力仅由 X-ASR streaming engine 启用；SenseVoice、Qwen3-ASR、Moonshine、Parakeet 不启用预采集路径。
+
+### 构建
+
+- build: `20260614.2056`
+- 说明: 本版本为 X-ASR 首字/尾字稳定性实验测试包，不是 App Store 正式上传包。
+
+---
+
+## v2.1.30 (2026-06-07)
+
+### X-ASR 实验修复
+
+- **X-ASR 尾句保护**：最终识别前追加 1.5 秒静音 padding，并保留 decode 过程中的最后一个非空结果，减少松开热键时最后一句丢失的问题。
+- **录音中实时字幕**：X-ASR 录音时复用现有动态浮窗显示小号实时字幕；松开热键后浮窗切到“识别中/完成”，最终文本仍按原流程粘贴到目标 App。
+- **流式 session 接口**：新增 streaming engine/session 抽象，当前只由 X-ASR 使用；SenseVoice、Qwen3-ASR、Moonshine、Parakeet 行为保持不变。
+- **录音增量读取**：Recorder 支持安全读取新增 PCM 样本，用于低延迟字幕，不影响最终录音样本收集。
+- **macOS 上屏安全同步**：同步正式上架线的剪贴板校验与代际保护，降低关闭“保留到剪贴板”时误粘旧内容的风险。
+
+### 构建
+
+- build: `20260613.2201`
+- 说明: 本版本为 X-ASR 实时字幕与尾句修复实验候选包，不是 App Store 正式上传包。
+
+---
+
+## v2.1.29 (2026-06-07)
+
+### 实验候选包
+
+- **X-ASR 960ms 实验模型**：新增 `x-asr-zh-en-960ms` 实验模型 profile，用于评估中英混输和未来“边说边出字”方向。
+- **macOS X-ASR streaming backend**：在 macOS 下接入 sherpa-onnx `OnlineRecognizer`，先复用现有“一段录音 -> 最终文本”听写流程验证模型效果，不改 live partial 上屏链路。
+- **本地模型安装脚本**：新增 `scripts/install-x-asr-zh-en-960ms.sh`，只下载 Hugging Face `chunk-960ms-model` 所需四个文件，不把大模型放入 git。
+- **回滚保护**：已创建 `codex/freeze-2.1.28-appstore-20260605.0353`，指向已上传成功的 2.1.28 App Store 源码基线。
+
+### 构建
+
+- build: `20260607.0147`
+- 说明: 本版本为 X-ASR 技术实验候选包，不是 App Store 正式上传包。
+
+---
+
 ## v2.1.28 (2026-06-04)
 
 ### 发布冻结

--
Gitblit v1.9.3