# 更新日志

本文件记录面向发布的版本变更，实际发布状态以 npm registry 为准。历史提交细节以 Git 记录为准。

## [0.1.2] - 2026-10-24

### 调整

- 麦克风启动时使用强调色空心圆从右向左移动；真实预热完成后，原位切换为红色实心圆和录音计时，明确区分等待与录音。
- 默认 F8 状态栏精简为 11 列，录音计时使用 `M:SS`；移除冗余文案及尾部占位，各阶段快捷键位置保持一致。
- 动画仅在交互式终端运行，不增加预热时长，不影响录音就绪判断；同步更新使用说明与测试。

### 修复

- 处理 Pi 状态栏对连续空格的压缩，避免动画及状态切换导致布局跳动。

## [0.1.1] - 2026-10-24

### 调整

- 语音进度统一显示在状态栏：使用小符号和主题色，录音时显示从设备就绪开始的时长与停止操作，启动/识别/整理共用轻量动画。
- 移除聊天框上方重复的正常进度、转写预览和成功 VAD 裁剪提示；保留无有效人声、异常和主动自检结果，详细诊断仍通过 `/voice-status` 查看。
- 新增状态栏虚拟时钟测试，覆盖计时、动画、主题切换、重复刷新去重和会话关闭后的定时器清理。
- 精简 Example 配置，仅保留 API Key、快捷键、口语整理开关及模型；示例开启 `mimo-v2.6-flash` 整理，高级选项移至配置说明。
- 保持已有配置兼容：缺失字段使用默认值，不覆盖用户配置；自动生成配置的口语整理仍默认关闭。

### 修复

- 录音累计收到 1 秒音频后才显示就绪，使用同一录音进程完成预热；停止后先裁掉预热段，再进行检测、回放或识别，预热音频不上传。
- 录音计时和时长限制从预热完成后开始，补充预热边界及裁剪测试。

## [0.1.0] - 2026-10-16

以 `pi-mimo-voice-input` 为包名的首个版本。

### 新增

- Ubuntu/Linux 和 macOS 语音输入、本地录音自检与设备/电平诊断；默认使用 F8 开始或停止录音。
- 本地 Silero v5 CPU/WASM 人声检测、无语音过滤及静音裁剪，支持开关和检测阈值配置。
- Ubuntu PulseAudio 私有 WebRTC 录音源，提供高通、降噪及数字增益，不修改系统默认设备或硬件增益。
- 可选 MiMo API 口语整理，支持 Flash/Pro 模型、独立超时和失败保留原文；`/voice-raw` 可恢复最近一次整理前的完整转写。
- 离线单元/集成测试、真实 Silero 离线测试、显式在线整理验证脚本，以及实际 npm 包内容与入口加载测试。
- MIT 许可证文件、分主题文档和发布检查清单。

### 调整

- 项目及 npm 包名由 `pi-mimo-voice-zh` 改为 `pi-mimo-voice-input`，明确定位为 Pi 的 MiMo 语音输入扩展；更新安装命令、配置示例文件名及包元数据。旧配置路径 `~/.pi/mimo-voice-zh.json` 保持兼容，切换安装来源时需先移除旧声明。
- 运行时代码集中到 `src/`，保留根目录 `index.ts` 为稳定扩展入口；无凭据配置示例移至 `examples/`，测试辅助文件移至 `test/support/`。
- README 聚焦安装、配置与使用；录音排查、文本整理和开发发布说明拆分到 `docs/`。
- npm 发布采用文件白名单，不再包含开发脚本和测试；`prepack` 自动运行离线测试，并显式指定公共 npm registry 和公开访问级别。
- 识别结果追加到草稿，不覆盖已有内容、不自动发送；整理结果允许自然改写，发送前需人工复核。

### 修复

- 等到 WAV 写入完整 PCM 帧后才提示“可以说话”，避免麦克风启动延迟导致漏字；启动超时与重复操作不会遗留录音进程。
- 加强退出、重载、录音/回放异常、WebRTC 初始化竞态及 VAD/网络请求取消时的资源清理。

### 安全与隐私

- ASR HTTP 错误仅显示状态及固定提示，不读取或回显服务端错误正文；网络及无效 JSON 异常不回显原始信息。
- ASR 与文本整理请求均拒绝 HTTP 重定向，避免自定义凭据头被带到重定向目标。
- 扩充本地配置、环境文件、认证文件、私钥和证书的 Git 忽略规则；配置示例保持空 Key。
- 发布测试验证包内文件白名单和示例凭据，防止测试夹具、开发脚本或本地配置被意外打包。

### 移除

- 未接入当前扩展的旧 Codex 清洗链路，包括共享服务、Unix socket IPC、保守编辑协议及其专属测试。
- 本分支不提供 AI 回复语音播放；无需安装、登录 Codex 或启动后台清洗服务。

## [0.0.5] - 2026-07-25

原包名 `pi-mimo-voice-zh` 的上游基线版本；本仓库后续语音输入、自检、VAD、WebRTC 和 MiMo 口语整理改动统一整理于 `0.1.0`。