# 更新日志

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

## [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`。