AgenBoard 是面向 iPhone 的开源第三方输入法键盘。内置 librime （雾凇拼音） 实现 Rime 全套中文输入能力，同时集成 AI 流式语音输入；支持 Apple 系统语音识别、火山引擎豆包双向流式语音识别两大语音方案。
重要说明：项目仅开放源代码，没有提供 App Store 上架版本、预签名安装包。需要开发者使用 Xcode 在 Apple Silicon Mac 上自行编译部署到 iOS 设备；部分跨 App 跳转能力依赖非公开 iOS API ，系统更新后存在失效风险，无法通过 App Store 审核。
iOS 第三方键盘受系统沙盒限制：录音、语音识别任务交由主 App 执行，键盘扩展通过 App Group 通信，借助画中画维持后台录音，识别完成再把文本回填输入框；键盘扩展本身不会发起任何网络请求。
核心功能
1. 完整 Rime 中州韵输入（内置雾凇拼音）
- 底层搭载 librime ，默认使用雾凇拼音词库；
- 候选分页、用户词频学习、联想 emoji 、英文、数字符号、光标拖动；
- Rime 全部配置、学习用户词典可以导出导入 ZIP 数据包，实现配置备份迁移。
2. 双引擎语音输入闭环
点击键盘麦克风按钮即可录音，停止录音返回识别结果自动回填输入框，两种识别后端可选：
- Apple Speech 系统识别： iOS26 使用设备本地 SpeechAnalyzer ；旧版本由 iOS 系统决定是否联网。热词上限最多 100 条。
- 火山豆包双向流式语音识别 2.0： WebSocket 流式传输 16kHz 单声道 PCM 音频，一边说话一边实时预览，停止录音后二遍重识别产出终稿；支持最多 5000 条请求级热词；提供「自然听写」、「低延迟短句」两种工作模式。
豆包方案使用用户自己的火山 API‑Key ，音频数据流直接和火山引擎通信，不经过项目维护者的中转服务器。 API 密钥保存在 iOS 本机钥匙串，仅在用户主动勾选导出时才会写入导出包。
3. 热词与快捷短语
- 热词开关启用 / 禁用，提升专有名词识别正确率；
- 主 App 内维护自定义快捷短语库，键盘界面快速调用输出；
4. 完整数据导入导出
识别历史、热词库、快捷短语、 Rime 全部配置与用户学习词频，可以打包导出 ZIP ；支持完整替换或者智能合并导入，方便备份、多机迁移。录音文件、 API 密钥默认不会导出，需要用户手动勾选才会一并导出。
5. 隐私设计要点
- 项目维护者不运营任何后端服务器，不收集录音、转写文本、用户密钥；
- 录音和识别历史默认保存在本机设备，可以手动删除；
- 网络请求只发生在选择豆包云端识别时，音频直接发送火山引擎； Apple 识别交由 iOS 系统处理。
编译与部署
编译环境
- Apple Silicon Mac ，安装 Xcode 26.4+
- 目标设备 iOS17.0 及以上
# 拉取并校验 Rime 预编译词库数据
./scripts/fetch-rime-data.sh
# 编译模拟器版本（无需开发者账号）
xcodebuild \
-project AgenBoard.xcodeproj \
-scheme AgenBoard \
-destination 'generic/platform=iOS Simulator' \
CODE_SIGNING_ALLOWED=NO \
build真机安装：
- 在 Xcode 分别对
AgenBoard主 App 、AgenBoardKeyboard键盘扩展，选择你自己的 Apple 开发 Team ； - 编译并安装到 iPhone ；
- iPhone 系统设置 → 通用 → 键盘 → 添加新键盘，选择 AgenBoard ；
- 进入 AgenBoard 键盘设置，开启允许完全访问（ AppGroup 数据通信必需）；
- 打开 AgenBoard 主 App ，完成权限授予，配置语音识别服务。
可选配置豆包语音识别：在主 App 识别服务页面填入自己火山引擎 API Key 与资源 ID ，执行连接测试。
