Soundcore Manager（安克录音豆）
soundcore Work（安克 AI 录音豆 / D3200）本地管理 App，基于逆向出的设备协议（见 PROTOCOL.md）用 Flutter 实现，脱离飞书 App 独立使用：BLE 配对连接、录音管理、AI 实时/批量转写、Wi‑Fi SoftAP 批量导出。
支持平台
| 平台 | 状态 |
|---|---|
| Android | BLE 扫描 / GATT |
| iOS | BLE 扫描 / GATT |
| macOS | BLE 扫描 / GATT（需 Bluetooth entitlement） |
功能
- 首页：浏览本地与设备端录音，下拉刷新、长按批量选择；点开详情阅读全文、翻译、播放、分享或重命名
- 录音详情：实时转写与保存后的文本使用同一详情页；返回首页不停止录音，暂停后保留当前页面。向上滚动可阅读旧内容，点「最新内容」恢复跟随
- 设备：电量（耳机 + 充电盒）、录音控制、配对绑定 / 解绑、恢复出厂设置
- 设置：选择 Apple 设备端或 Soniox、准备语言、自动转写、API Key 管理与诊断日志
- 扫描：首页顶部按钮触发底部弹窗（非独立 Tab）搜索并连接 BLE 设备
- Wi‑Fi 批量导出：SoftAP 直连 + AES 解密，导出文件本地播放
- iPhone 操作按钮：从锁屏或其他 App 打开本应用，并让已绑定的 D3200 立即开始录音
配置 iPhone 操作按钮
安装并至少连接一次录音豆后，在支持操作按钮的 iPhone 上打开：
- 设置 → 操作按钮 → 快捷指令。
- 选择 安克录音豆 → Start Recording。
- 长按操作按钮。App 会打开；如果录音豆暂时离线，会先自动重连再开始录音。
录音已经进行时再次运行快捷指令只会回到当前实时会话，不会重复发送开始命令。若 30 秒内找不到已绑定设备，请唤醒并靠近录音豆后重试。
项目结构
lib/
├── ai/ # Soniox STT（实时流式 + 批量文件）
├── audio/ # Ogg/Opus 封装、Opus→PCM 解码
├── ble/ # 扫描广播解析、GATT 服务、离线文件拉取、实时音频流
├── crypto/ # 设备端 ECDH / AES 会话加解密
├── protocol/ # 帧格式、命令字、数据模型
├── state/ # Provider 状态：设备连接、录音、转写、导出目录、App 设置
├── theme/ # 主题与配色
├── ui/ # 首页 / 设备 / 设置页面与组件
└── wifi/ # SoftAP 连接与批量导出服务
运行
# macOS（推荐用脚本） ./scripts/debug-mac.sh # flutter run -d macos --debug ./scripts/debug-mac.sh --build-only # 仅构建 debug .app ./scripts/debug-mac.sh --open # 构建 debug .app 并打开 # 其他平台 flutter run -d ios flutter run -d android
构建
# macOS release + DMG → dist/soundcore-manager-<version>-macos.dmg ./scripts/build-dmg.sh ./scripts/build-dmg.sh --open # 构建后在 Finder 中显示 DMG ./scripts/build-dmg.sh --skip-build # 打包已有的 Release .app # iOS 真机安装（Xcode 签名） ./scripts/install-ios.sh flutter build ios flutter build apk # 或 appbundle
测试
flutter test覆盖协议帧编解码、设备加解密、Opus/Ogg 处理、导出目录、STT 数据模型等核心逻辑（test/）。
说明
- Apple 设备端处理（iOS 26+，取决于设备和语言）：D3200 实时音频与已保存录音可在 iPhone 上转写；支持实时单向翻译及已有转写文本的翻译。实时录音语言在设置中选择；已有录音可在转写或重新转写时选择语言，并按提示下载资源。Apple 处理失败不会自动切换到云端。面对面双向交流使用 Soniox。
- Soniox 转写（可选）：实时或批量生成转写。
- 实时路径：BLE Opus → PCM16 → 对应服务商 WebSocket STT。
- 批量路径：通过 Soniox 异步 Files API 上传 Ogg 文件。
- Key 配置：
export SONIOX_API_KEY=…后重启 App，或在设置页粘贴保存。
- Wi‑Fi SoftAP 批量导出 + 解密：BLE 连接后先做 ECDH 握手（
0x2E/0x01）生成会话密钥；导出时打开设备 SoftAP → 加入 → WebSocket 拉取，每 160 字节分片用1A07头（soundcored3200magic）中的单文件密钥做 AES‑CTR 解密。导出文件保存在Documents/AnkerRecorder/exports下，命名为{fileId}.opus（握手失败则为.opus.bin）。本地播放使用just_audio播放已导出文件。 - 设备协议细节（服务/特征 UUID、命令字、加密流程等）见
PROTOCOL.md。 - 请保持蓝牙开启；旧版 Android 扫描需授予定位权限。
- 录音进行中修改处理服务、模式或语言，将在下次录音生效。已有 Soniox 配置会保留；支持 Apple 处理且未配置 Soniox 的新设置优先选择 Apple。