面向 macOS 的菜单栏语音 + AI 输入助手。
- 菜单栏常驻，聚焦输入框后就能直接触发，不需要切回主窗口。
- 默认围绕中文短语音输入设计，链路短，行为边界明确。
- 支持本地 ASR 服务，使用
FunASR，模型下载和状态管理都在应用内完成。 OpenAI Chat Completions兼容接口即可接入 AI 润色，不锁死单一服务商。- LLM 配置不完整或调用失败时直接报错，不会把半成品文本偷偷注入出去。
- 注入失败时会保留本次文本预览，用户可以从菜单栏手动复制，而不是丢结果。
- 可在关于页开启自动检查更新，或手动触发 Sparkle 应用内更新检查。
- 启动应用后打开设置页。
- 在
语音识别中选择识别引擎。默认推荐本地FunASR；如果选择本地模式，先下载模型。 - 在
AI 配置中填写Base URL、API Key、Model；若服务支持 OpenAI 兼容/models，也可从自动获取的列表中选择模型。 - 授予麦克风权限和辅助功能权限。
- 设置全局快捷键。
- 在任意应用中聚焦一个可输入文本的位置。
- 按一次全局快捷键开始录音。
- 说完后再按一次快捷键结束录音。
- Typoless 会依次完成降噪、识别、AI 润色，并把最终文本写回当前应用。
- 如果本次写入失败，菜单栏会保留一段截断预览，点击即可复制完整文本。
- 如需更新，可在关于页勾选
自动检查更新或点击检查更新；新版本会通过应用内更新流程下载并安装。
- 本地优先。Typoless 把本地
FunASR离线识别作为默认主链路，模型外置、状态可见、缺失可提示、下载可管理。 - 后端可替换。LLM 只要求
OpenAI Chat Completions兼容，ASR 也支持在本地FunASR、腾讯云、阿里云、火山引擎、科大讯飞之间手动切换。 - 失败策略更保守。LLM 失败时不注入 ASR 原文，注入失败时也不会自动污染剪贴板，而是把恢复入口留给用户主动点击。
- 工程化程度更高。仓库内已经包含资源校验、模型下载、HUD 反馈、签名、公证、DMG 打包脚本，不是只停在“能调通一次接口”的 demo 状态。
- 更关注中文输入闭环。当前的降噪、识别、润色和注入边界都围绕中文短语音输入来收敛，而不是一个大而全的平台。
- 应用形态是菜单栏助手，不是 macOS 系统级输入法。
- 当前交互是单一全局快捷键，按一次开始录音，再按一次结束录音。
- 单次录音上限为
60 秒，极短录音会静默取消。 - 本地识别默认使用
FunASR，云端识别支持腾讯云、阿里云、火山引擎、科大讯飞。 - AI 润色仅支持
OpenAI Chat Completions兼容接口。 - 不支持实时流式识别、自定义 Prompt、高级采样参数或音频历史保存。
app/ macOS 客户端与 XcodeGen 工程定义
docs/ PRD、TDD、验证与设计文档
scripts/ 资源准备、构建、签名相关脚本
依赖环境：
- macOS 14+
- Xcode 16+
xcodegen
准备资源：
./scripts/setup-rnnoise.sh
./scripts/setup-funasr.sh如需重新打包或签名本地 FunASR runtime，可使用：
./scripts/bundle-funasr-runtime.sh
./scripts/sign-funasr-runtime.sh生成工程并构建：
cd app
xcodegen generate
xcodebuild build -project Typoless.xcodeproj -scheme Typoless -destination 'platform=macOS'如需演练正式分发链路，相关辅助脚本位于：
./scripts/ci/import-apple-signing-assets.sh
./scripts/ci/sign-macos-app.sh
./scripts/ci/create-sparkle-archive.sh
./scripts/ci/generate-sparkle-appcast.sh
./scripts/ci/create-dmg.sh
./scripts/ci/notarize-macos-file.sh
./scripts/ci/verify-macos-release.sh为避免升级后麦克风与辅助功能权限丢失，正式发布必须保持相同的 bundle id 与相同的 APPLE_SIGNING_IDENTITY；一旦签名身份发生变化，macOS 可能将其视为新应用并要求重新授权。
应用真实版本号由 v* tag 推导。本地构建会优先使用当前分支最近可达的 vX.Y.Z tag；只有在仓库没有可解析 tag 时，才回退到 app/project.yml 里的默认值。正式发布时，release workflow 会把当前 tag 同步为 App 的 MARKETING_VERSION 与 CFBundleVersion，不再需要手动修改工程版本。发布流程还会生成 Sparkle 所需的 .zip 更新包与 updates/appcast.xml。
如需发布可被应用内自动更新识别的正式版本，必须在 CI 中配置 SPARKLE_PRIVATE_KEY secret。其值应为 Sparkle generate_keys -x 导出的私钥文件内容；若缺失，release workflow 会直接失败，避免发布出 GitHub Release 已生成但 updates/appcast.xml 仍为空的版本。
若轮换了 SUPublicEDKey / SPARKLE_PRIVATE_KEY，已安装旧版本将无法直接通过应用内更新信任新签名，用户需要先手动安装一次新版本，之后才能继续使用新的自动更新链路。
公证支持两种方式：
App Store Connect API KeyApple ID + app-specific password