专为 iOS 18+ 打造的个人离线/云端润色语音输入法：
- 长按说话 (Hold-to-talk)：iOS 自定义键盘长按图标/按钮说话，松开插入文本，支持左滑取消。
- 端侧离线识别：集成 sherpa-onnx + SenseVoiceSmall INT8（支持 中 / 英 / 粤 / 日 / 韩 混合识别）。
- 本地输入风格：内置只纠错、代码、自然润色和结构化提示词；可创建仅存本机的自定义整理风格。
- 繁简输出转换：支持简体中文、香港繁体等输出字体无缝转换。
- 多段异步并行：松开立即提交，无需等待识别完成即可连续录制下一段，系统自动按说话顺序依次插入。
- 主 App 与键盘分离架构：主 App 统一管理麦克风、SenseVoice 模型与云端 API，通过环回 TCP Bridge (
127.0.0.1:52741-52743) 为键盘扩展提供响应，免 App Group，支持个人免费 Team 签名。
| 组件 | 作用 |
|---|---|
VoicePolishApp |
iOS 主应用，负责麦克风录音、SenseVoice 离线识别、云端润色 API、Bridge 服务 |
Keyboard |
iOS 键盘扩展，负责长按录音 UI、模式/繁简单选切换、左滑取消与文本插入 |
Shared |
通讯协议、数据快照、ASR/润色核心管道、繁简转换器 |
Vendor/SherpaOnnxPackage |
本地 SPM 包，封装 sherpa-onnx 与 onnxruntime xcframeworks |
- 松开麦克风后立即入队提交，无需等待上一段识别或润色完成，可随时按住开始下一段录制。
- 本地 SenseVoice 识别按 FIFO 严格串行（并发 1）；云端 LLM 润色最多 并发 2。
- 云端响应时间即使颠倒，最终文本也会严格按说话顺序交付插入。
- 左滑取消仅丢弃当前正在录制的段落，已提交的任务保留并依次处理。
- 每段结果会保存到本机语音历史；键盘保留最近结果，可在宿主文本框拒绝插入时重新插入或复制。
| 模式 | 键盘短标签 | 说明 |
|---|---|---|
| 只纠错 | 纠错 | 仅修正 ASR 错别字与标点符号，保留原始口语风格，不回答问题 |
| Coding | 代码 | 整理编程口语意图，保留标识符、路径与代码 Token |
| 润色词句 (默认) | 润色 | 口头语整理、标点规范、语序微调 |
| 问 LLM | 问答 | 将语音识别结果作为问题或指令执行，仅输出最终结果（如“请用英语输出『你多久回来一次』” → 输出 How often do you come back?）。若云端失败，自动回退到本地识别原文 |
循环切换说明：点击键盘右侧 2×2 模式按钮单选切换；再次点击当前已选模式可关闭润色。
- Xcode 16+ (或 Xcode-beta) 及 iOS 18+ SDK
- XcodeGen (
brew install xcodegen) - Apple Developer 个人 Team ID（在
project.yml中配置）
cd voice-polish-keyboard
# 1. 生成项目并编译安装到连接的 iPhone
./scripts/install_device.sh
# 2. 解锁 iPhone 后，启动主应用
xcrun devicectl device process launch --device <device-id> com.voicepolish.app可选：从 Mac 本地预置模型文件到手机：
./scripts/seed_model_to_device.sh- 解锁手机并打开 粤英语音键盘 主应用。
- 在主应用中下载或加载 SenseVoice 模型（~230 MB）。
- 允许麦克风权限，点击 启动语音会话。
- 手机 设置 > 通用 > 键盘 > 键盘，添加 粤英语音键盘 并开启 允许完全访问。
- （可选）在主应用设置中填入 OpenAI 兼容 API Key，并选择所需的润色模式。
所有已提交段落均会保留。本地识别按录音顺序串行处理，云端润色即使先后返回顺序不同，最终文本仍按说话顺序交付。
若需要彻底重置会话（麦克风、桥接与后台状态）：
- 打开主应用
- 点击 停止语音会话，再点击 启动语音会话
注意：主界面的“清除”按钮仅用于清空展示视图中的最近识别/润色结果文本。
xcodegen generate
# 运行 iOS 单元测试
xcodebuild -project VoicePolishKeyboard.xcodeproj -scheme VoicePolishApp \
-destination 'platform=iOS Simulator,name=iPhone 16' test