OSGKeyboard/CHANGELOG.md

Changelog

All notable changes to OSGKeyboard will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Added

• App Store download badges: official badges on bilingual READMEs (hero + Get sections) and the website, with China-store /cn/ links for Chinese and regionless App Store links for English. / App Store 下载徽章：中英文 README（顶部与获取区）与官网挂载官方徽章；中文链 /cn/，英文用无地区链接。
• Website SEO & AI discovery: richer meta/JSON-LD/FAQ, llms.txt, expanded sitemap, English landing, plus install / compare / Mac-dictation content pages. / 官网 SEO 与 AI 发现：强化 meta/JSON-LD/FAQ、llms.txt、sitemap，并新增英文落地页与安装 / 对比 / Mac 听写专题页。
• Context-aware polish safeguards: polish can use a redacted cursor-neighborhood snapshot for natural continuation, validates protected terms and identifiers, retries once, and falls back to a conservative local cleanup when needed. / 上下文润色护栏：润色可使用经截断脱敏的光标附近文字自然衔接，并校验受保护词与标识符；失败时重试一次，仍不合格则降级为本地保守清理。
• Pause-aware chunk polish: chunked ASR carries detected silence boundaries into the polish request while keeping previews and final output marker-free. / 分块停顿感知润色：分块 ASR 将检测到的静音边界传入润色请求，实时预览与最终输出均不会显示内部标记。
• True streaming cloud ASR: Bailian, Volcengine, and OpenAI Realtime use one utterance-level WebSocket with live partials; Volcengine enables official two-pass (enable_nonstream) so interim text stays on-screen while definite ASR feeds polish. / 真流式云端 ASR：百炼、火山与 OpenAI Realtime 按整句长连接推流并实时上屏；火山开启官方二遍识别（enable_nonstream），interim 仅上屏，definite 再送润色。
• Streaming ASR badge: settings ASR provider chip shows 【流式识别】 for Bailian, Volcengine, and OpenAI. / 流式识别标签：设置里 ASR 供应商对百炼、火山、OpenAI 显示【流式识别】。
• Fun polish styles: new subcategory with Flex Guide, Corp Speak, and DiBa Logic alongside Dating Coach. / 趣味润色风格：新增小分类，含装逼指南、大厂黑话、帝吧大神，并与直男癌拯救器同组。
• Xiaohongshu Sisters style: fun polish pack that rewrites drafts into sisterly RED note body with Light/Medium/Heavy hooks (轻安利 / 种草感 / 爆款感). / 小红书集美风格：趣味润色包，将草稿改写成姐妹向小红书笔记正文，并按轻安利 / 种草感 / 爆款感三档跳变。
• Delete day in History: each day header has a Delete action with confirmation to clear that day's transcripts only (iOS and Mac). / 历史按天删除：日期行右侧提供删除按钮，确认后仅清除当天记录（iOS 与 Mac）。
• Mac Settings translation target: polish-provider section includes “Polish then translate” with the same locale picker as Home / menu bar. / Mac 设置翻译目标：润色（LLM）分区新增「润色后翻译」，与首页 / 菜单栏同一套目标语言选择。

Fixed

• macOS menu-bar dictation delivery: menu-bar sessions now retain the external target app before the popover takes focus, use that app for polish context and local bias, and reactivate it before pasting. / macOS 菜单栏听写投递：菜单栏会话会在弹窗抢焦点前保留外部目标应用，并将其用于润色上下文与本地偏置，粘贴前重新激活目标应用。
• macOS recording and clipboard fallback: cancelling microphone preparation no longer lets an untracked button task restart recording; clipboard restoration waits longer, preserves newer third-party writes, clears an originally empty clipboard correctly, and Accessibility failures explain that the transcript remains available for manual paste. / macOS 录音与剪贴板降级：取消麦克风准备后，未跟踪的按钮任务不会再次启动录音；剪贴板恢复延长等待时间、保留第三方较新的写入、正确还原原本为空的剪贴板，并在辅助功能权限失败时明确提示可手动粘贴识别结果。
• Polish validator false positives: slash-form dates, fractions, and words such as and/or are no longer treated as hard-protected file paths; confirmed ordinal ASR repairs also stop polluting missing-number telemetry. / 润色校验误报：斜杠日期、分数及 and/or 等词不再被误判为文件路径硬违规；已确认的序号 ASR 修复也不再污染数字缺失遥测。
• Transient chunk loss: a failed middle ASR chunk now retries once with the same PCM before the serial worker advances, preventing brief network failures from silently removing several seconds of speech. / 瞬时分块丢字：中段 ASR 分块失败后会使用同一份 PCM 原地重试一次，再继续串行处理，避免短暂网络抖动静默丢失数秒语音。
• macOS Option release freeze: finishing a live snapshot stream no longer calls AsyncStream.Continuation.finish() while holding the recorder lock — the termination handler re-entered the same NSLock on the main thread and wedged the app when the hold-to-talk key was released. / macOS 松开 Option 卡死：结束实时 snapshot 流时不再在持有 recorder 锁的情况下调用 AsyncStream.Continuation.finish()；终止回调会在主线程重入同一把 NSLock，松开听写键时导致整个 App 无响应。
• macOS dictation HUD layout storm: the floating pill no longer reassigns its hosting view and forces a synchronous relayout on every view-model tick (~20×/s from the level timer); it uses a fixed panel size and lets SwiftUI refresh through @ObservedObject instead. / macOS 听写浮层布局风暴：悬浮胶囊不再在每次 view-model 更新时重建 hosting 视图并强制同步重排（音量定时器约 20 次/秒）；改为固定面板尺寸，由 SwiftUI @ObservedObject 驱动刷新。
• Polish never answers the transcript: fun styles (dating / flex / corp) could turn “你觉得这个包怎么样” into a reply such as “还行，挺顺眼的”. A top-priority “polish only, never answer” rule now sits in the global contract, every built-in style pack, the prompt safety boundary, and a router question guard that keeps question drafts as questions. / 润色不再代答转写内容：趣味风格（直男癌/装逼指南/大厂黑话）曾把「你觉得这个包怎么样」润色成「还行，挺顺眼的」。现已在全局契约、全部内置风格包、提示词安全边界与路由问句守卫四层加入最高优先级的「只润色、不作答」规则，问句必须仍是问句。

Changed

• Layered bilingual polish prompts: transcripts are sent once as user data; stable Chinese/English core rules, style policies, dictionaries, and runtime context now have explicit responsibilities for better consistency and provider prefix caching. / 分层双语润色提示词：转写仅作为用户消息发送一次；稳定的中英文核心规则、风格策略、词典和运行时上下文职责明确，提升一致性并支持服务商前缀缓存。
• Two-tier short polish skip: ultra-short (≤4 CJK) still skips the LLM; 5–10 CJK now skips only low-value acks/closings (e.g. “好的我知道了”), while questions and contentful shorts still polish. / 两级短句跳过润色：≤4 字仍跳过 LLM；5–10 字仅对低价值确认/收束语跳过（如「好的我知道了」），问句与有内容短句仍走润色。
• ABE polish routing: fun styles and daily chat use a local information-density gate, prompt hard-brakes, and style-specific degrade (e.g. DiBa without an opponent quote falls back to chat cleanup) without a second LLM call. / ABE 润色路由：趣味风格与日常聊天增加本地信息密度闸、提示词硬刹车与风格专属降级（如帝吧无对方原话时降级日常清理），不增加第二次 LLM 调用。
• Practical polish prompts: Light Clean / Structured / Formal / Daily Chat share a “transcript-only, not a chatbot” boundary; Structured gains active itemization, light semantic reorder, and paragraphing hard rules inspired by high-readability polish patterns. / 实用润色提示词：轻度清理 / 清晰结构 / 正式表达 / 日常聊天统一「只整理转写、非聊天助手」边界；清晰结构加强积极分项、轻度语义重排与分段硬规则，提升长口述可读性。
• RED Note keeps the draft's audience: the Xiaohongshu style no longer opens with 姐妹们/集美们 or adds comment CTAs unless the draft already addresses a group, and a positive draft can no longer be rewritten with an 避雷-style hook. / 小红书不再擅自加受众：除非原文本身在对一群人说话，否则不再添加「姐妹们/集美们」开场与评论区互动话术；正面体验也不会被写成「真诚避雷」式钩子。
• Style-specific forbidden-items chapters: every built-in polish prompt now has a dedicated # 禁止事项 section modeled on Daily Chat—no interlocutor replies, no answering question drafts—with per-style bans (e.g. dating must not turn asks into verdicts; flex/corp must not answer as the other party; XHS must not invent product claims). / 风格专属禁止事项：全部内置润色提示词均新增「# 禁止事项」章节，结构对齐日常聊天（禁接话、禁代答问句），并按风格补充专属禁令（如直男癌不得把征求意见改成评价；装逼/黑话不得替对方作答；小红书不得编造功效细节）。
• Settings hierarchy: voice-session options join Daily, while ASR and LLM configuration links sit directly below the transcription-mode choices; General and About remain secondary pages. / 设置层级：语音会话选项并入「日常」，ASR 与 LLM 配置入口紧跟转写模式选择；通用与关于保留为二级页。
• Transcription option rows: local and cloud choices now use the same text-first list-row style as the rest of Settings, without leading icons. / 转写选项行：本地与云端选项移除前置图标，统一采用设置页的文字优先列表样式。
• Simplified style cards and summaries: polish-style cards drop decorative badges, and speech-configuration summaries show only the active engine or provider/model without redundant status prefixes. / 简化风格卡与摘要：润色风格卡移除装饰图标；语音配置摘要仅显示引擎或服务商/模型，不再附加冗余状态前缀。
• Mac polish style grid: cards drop decorative icons and use a denser adaptive grid (about three columns at the default window; two when narrower, four+ when wider). / Mac 润色风格网格：卡片去掉装饰图标，并以更密的自适应网格排布（默认窗口约三列；变窄两列、变宽四列及以上）。
• OpenAI ASR default: cloud OpenAI ASR defaults to gpt-realtime-whisper for streaming; batch transcription remains the fallback. / OpenAI ASR 默认：云端 OpenAI ASR 默认 gpt-realtime-whisper 走流式；批处理转写仍作降级。
• Dating Coach prompt: spoken WeChat first with clever lines only as seasoning; refreshed examples to reduce copywriting AI tone. / 直男癌拯救器提示词：以口语微信为主、巧思仅作点缀；刷新示例以降低文案式 AI 腔。
• Unified card-page layout: Settings, polish styles, and related detail pages now share 20-point page margins, section labels, and card chrome. / 统一卡片页面布局：设置、润色风格及相关详情页共用 20 点页面留白、分组标题和卡片外观。

Fixed

• Daily-chat short replies: chat polish forbids interlocutor-style continuations on ultra-short drafts (e.g. “嗯” no longer becomes “嗯，我在呢”). / 日常聊天短句接话：日常润色禁止对极短草稿做对方口吻续写（如「嗯」不再变成「嗯，我在呢」）。
• Card corner consistency: the seven-day chart and shared usage cards now use the same continuous 20-point corners as the other Home cards; shared Settings cards also clip child backgrounds to their border shape. / 卡片圆角一致性：最近 7 天图表及共享统计卡改用与首页其他卡片一致的连续 20 点圆角；共享设置卡片也会将子视图背景裁切到边框形状。
• PiP mic spin-up drop: on record press, open capture and the utterance gate before waiting for audio proof, and keep ~3 s of idle preroll so speech during mic warm-up is not discarded. / PiP 开麦丢音：按下录音后先启动采集并打开 utterance gate，再等待音频证明；空闲 preroll 约 3 秒，避免麦克风预热期间的语音被丢掉。
• Empty preMerge wipe: final-chunk preMerge that returns empty text no longer removes a prior good segment; ASR pipeline failures also recover via partial snapshot instead of clearing it. / 空 preMerge 抹字：末块 preMerge 若识别为空，不再删除已有有效片段；流水线失败时改用 partial 快照恢复，而不再清空兜底。
• History day label alignment: date headers line up with the history card's left edge like Settings section labels. / 历史日期对齐：日期标题与下方卡片左边缘对齐，与设置页分组标题一致。

[1.0.1] - 2026-07-27

Fixed

• Onboarding Done stuck: finishing step 6 no longer wraps the route change in an animation transaction; MainAppRoot force-swaps view identity so Settings replay cannot freeze on the last page. / 引导完成卡住：第六步完成不再包进动画事务；MainAppRoot 强制切换视图身份，避免从设置重走引导后停在最后一页。
• PiP closed loop: activate a playback audio session before creating AVPictureInPictureController, never treat “armed but inactive” as success, and restore playback audio after releasing the mic between utterances so Home hostReady matches a real PiP window. / PiP 闭环：在创建画中画控制器前先激活 playback 音频会话，不再把「已武装但未激活」当成功，并在句间释麦后恢复 playback，使首页就绪状态与真实 PiP 窗口一致。
• Onboarding after reinstall: fresh installs clear the durable Keychain onboarding flag via a container install identity so delete-and-reinstall shows the welcome flow again. / 重装后引导：通过容器安装身份在全新安装时清除 Keychain 引导标记，删除重装后会再次显示欢迎流程。
• Cloud engine footer: Home / preview status lines name the configured ASR provider and model instead of the polish LLM. / 云端引擎文案：首页与预览状态行显示已配置的 ASR 服务商与模型，而不再显示润色 LLM。
• PiP Flow handoff: wait for the PiP host view, distinguish real start failures, and stop pointing users at a non-existent Settings toggle; cold-start / keyboard copy now match Picture in Picture keep-alive. / PiP Flow 交接：等待 PiP Host 就绪、区分真实启动失败，并不再引导不存在的系统设置开关；冷启动与键盘文案对齐画中画保活。
• PiP start reliability: restore unconditional startPictureInPicture retries, live positiveInfinity time range, DisplayImmediately sample buffers, and arm auto-inline PiP for background; Home status footer uses a bottom inset so the adaptive preview field shrinks instead of sitting under the tab dock. / PiP 启动可靠性：恢复无条件 startPictureInPicture 重试、直播 positiveInfinity 时间范围、DisplayImmediately 帧，并武装后台自动画中画；首页状态行改为 bottom inset，由自适应输入框让位，避免被 Tab 遮挡。
• PiP / Live Activity exclusivity: Picture in Picture sessions no longer start or refresh Live Activities. / PiP / 灵动岛互斥：画中画会话不再启动或刷新灵动岛 Live Activity。
• Flow tail ASR drop: after mic stop, iOS Flow now uses a longer silence drain (350 ms), a fixed 150 ms post-roll, expanded final-chunk ASR recovery, and a partial transcript guard so weak trailing syllables are less likely to disappear from the result. / Flow 尾音识别丢失：松手后 iOS Flow 采用更长的静音排空（350 ms）、固定 150 ms 尾音保留、增强末块 ASR 恢复与 partial 兜底，降低弱尾音从结果中消失的概率。
• Flow batch ASR fallback: when pipelined chunk output is clearly shorter than the live partial, the host re-transcribes the full utterance PCM captured during recording (Mac-style safety net). / Flow 整句 ASR 兜底：流水线拼接结果明显短于实时 partial 时，主 App 对录音期间累积的整段 PCM 重新识别（对齐 Mac 双保险）。

Changed

• Unified navigation icons: iPhone History and Personal Dictionary tabs now use the same SF Symbols as the Mac and iPad sidebars. / 统一导航图标：iPhone 的历史记录与个性词库 Tab 现使用与 Mac、iPad 侧边栏一致的 SF Symbols。
• Mac header actions: personal-word and polish-style add buttons now match the adjacent search field height and use a consistent capsule shape. / Mac 页头操作：添加个性词与添加润色风格按钮现与相邻搜索框等高，并统一使用胶囊外形。
• Responsive Mac polish styles: replace fixed full-width style rows with iOS-aligned adaptive cards that reflow with the window width. / Mac 润色风格响应式布局：将固定通栏列表改为对齐 iOS 的自适应卡片，并随窗口宽度自动重排。
• Mac MLX tail drain: streaming capture now uses the shared FlowUtteranceEndCoordinator (silence drain + post-roll) instead of an inline poll loop. / Mac MLX 尾音排空：流式采集改用 Shared 层 FlowUtteranceEndCoordinator（静音排空 + post-roll），替代内联轮询循环。
• Default Flow keep-alive: new installs default to Picture in Picture instead of Dynamic Island. / 默认 Flow 保活：新安装默认使用画中画，不再默认灵动岛。

Added

• Mac personal words: add custom dictionary terms on macOS with automatic recognition-alias generation and iCloud sync. / Mac 个性词：可在 macOS 添加自定义词条，自动生成识别别名并通过 iCloud 同步。
• Polish style packs: choose a complete writing personality from the new iOS tab or Mac sidebar, create custom prompts, and sync selections and custom styles through iCloud. / 润色风格包：可在 iOS 新 Tab 或 Mac 侧栏选择完整写作人格、创建自定义提示词，并通过 iCloud 同步选择与自定义风格。
• PiP Flow keep-alive: Settings → Voice session lets you choose Picture in Picture (default) or Dynamic Island — a live waveform PiP keeps the host alive with the mic released between utterances; closing PiP ends the session. / PiP Flow 保活：设置 → 语音会话可选 画中画（默认）或 灵动岛 — 实时波形 PiP 保活、句间释麦；关闭 PiP 即结束会话。
• Mac MLX streaming ASR: local dictation uses Qwen3-ASR via mlx-audio-swift with overlay partial preview, tail drain, vocabulary prompt, and polish-before-insert. / Mac MLX 流式 ASR：本地听写改用 mlx-audio-swift 的 Qwen3-ASR，支持浮层 partial 预览、尾部截断、词库 prompt 与润色后再插入。

Changed

• Privacy-safe Flow timeout: new sessions default to a 5-minute inactivity window, with new 1-minute and 5-minute options in Settings; previous 30-/10-minute product defaults migrate once. / 更安全的 Flow 超时：新会话默认在无活动 5 分钟后结束，设置中新增 1 分钟与 5 分钟选项；旧的 30/10 分钟产品默认会一次性迁移到 5 分钟。
• Cloud ASR privacy disclosure: permission prompts and the bundled privacy policy now explain that audio stays on-device by default and is sent to the configured speech provider only after cloud recognition is enabled. / 云端 ASR 隐私说明：权限弹窗与内置隐私政策现明确说明音频默认在设备端处理，仅在启用云端识别后发送至用户配置的语音服务商。
• Mac local ASR engine: removed Sherpa offline CLI; default model is Qwen3 MLX 0.6B 4-bit (1.7B optional download). / Mac 本地 ASR 引擎：移除 Sherpa offline CLI；默认模型改为 Qwen3 MLX 0.6B 4-bit（1.7B 可选下载）。
• Landing competitor matrix: compare Typeless / Superwhisper / Openless / OSGKeyboard on open source, pricing, on-device ASR, BYOK, and platforms (incl. honest Windows gap). / 落地页竞品对照：对比 Typeless / Superwhisper / Openless / OSGKeyboard 的开源、付费、本地识别、BYOK 与平台（含暂无 Windows）。
• Voluntary support tip: Settings (top of the page) includes an optional ¥28 Consumable in-app tip (StoreKit 2). All features stay free — no paywall or unlock. / 自愿打赏：设置页顶部新增可选 ¥28 消耗型应用内打赏（StoreKit 2）。全功能仍免费，无付费墙或功能解锁。
• iOS appearance preference: Settings → Preferences adds System / Light / Dark (iPhone + iPad), matching the Mac control. / iOS 外观偏好：设置 → 偏好设置新增跟随系统 / 浅色 / 深色（iPhone 与 iPad），与 Mac 一致。
• DEBUG demo seed URL: osgkeyboard://seed-demo fills Home stats, History, and Dictionary with placeholder data and turns iCloud sync off (script: scripts/seed_demo_data.py). / DEBUG 演示数据：osgkeyboard://seed-demo 填充首页统计、历史与词库占位数据并关闭 iCloud 同步（脚本：scripts/seed_demo_data.py）。

Changed

• Landing section copy: interactive pill-tab differentiator explorer (elevated detail stage; BYOK absorbed) plus competitor matrix and section bands; titles →「开源，尽是不同」/「开箱可用，只要三步」。 / 落地页文案：差异区改为胶囊 Tab + 抬升详情台（BYOK 并入）；含竞品对照与分区底色带；标题含「开源，尽是不同」「开箱可用，只要三步」。
• Unified welcome slogan: iPad Home now reuses the iOS onboarding brand line, and macOS onboarding shows the same “Speak it. It’s typed.” welcome slogan. / 统一欢迎口号：iPad 首页复用 iOS 引导页品牌句，macOS 引导页也显示同一句「开口即文字。」欢迎口号。
• GitHub Pages landing: redesign as a commercial product page with zh/en, light/dark, brand mark, scroll motion, and App Store screenshots; emphasizes free, cross-platform, open source, privacy, and BYOK. / GitHub Pages 落地页：改版为商业产品页，支持中英与日夜模式、品牌标、滚动动效与 App Store 截图；突出免费、跨端、开源、隐私与 BYOK。
• Landing hero device family: Mac + iPad + iPhone nested in one mockup cluster (no outer card stroke); screens swap with language/theme. / 落地页 Hero 设备组：Mac、iPad、iPhone 叠放在同一组设备框内（无外卡片描边）；截图随语言/主题切换。
• Landing hero polish: replace CSS device frames with the marketing composite; full-bleed pale-green hero wash (no side gaps / no radial gradient); Mac story shots sit on transparent chrome. / 落地页 Hero 抛光：设备框改为营销合成图；首屏淡绿单色通栏（无两侧留白 / 无径向渐变）；Mac 故事截图去卡片底。

Fixed

• Permission pre-prompt CTA: onboarding / Home buttons use Next instead of Allow before the system microphone and speech dialogs (App Store 5.1.1(iv)). / 权限引导按钮：系统麦克风与语音识别弹窗前的引导/首页按钮改为「下一步」，不再使用「允许」（App Store 5.1.1(iv)）。
• Model download for China networks: add the hf-mirror.com mirror as the mainland-China-first source (bypasses the flaky HF Xet backend), drop the dead ModelScope link, and correct the model file list; add automatic resume-on-drop retry with cross-mirror fallback and a manual "Download source" picker in Settings. / 国内网络模型下载：新增 hf-mirror.com 镜像并在中国大陆优先（绕开不稳定的 HF Xet 后端），删除失效的 ModelScope 链接并修正模型文件清单；下载中断自动断点续传重试并在镜像间回退，设置里新增手动「下载源」选择。
• iPad sidebar brand mark: use the template OSGLogoWide mark with accent tint so the logo stays visible in the split-view sidebar. / iPad 侧栏品牌标：改用可着色的 OSGLogoWide，保证分栏侧栏始终显示 logo。

[0.5.3] - 2026-07-11

Added

• Shared 7-day usage chart on iOS Home: iPhone and iPad Home now show the same trailing-7-day dictation chart as macOS, via a shared UsageStatsCluster. / iOS 首页共享近 7 天统计图：iPhone / iPad 首页与 macOS 共用 UsageStatsCluster，展示近 7 天听写字数柱状图。
• macOS dictation overlay: a bottom-centered floating pill appears for any recording path (global hotkey, menu bar, or main window) — shows listening / transcribing state, a stronger live waveform, a one-line live transcript preview (partials when chunked ASR runs), front-app name, and a stop control, then briefly confirms success before fading out without stealing focus. / macOS 听写浮层：任意录音路径（全局热键、菜单栏或主窗口）都会在屏幕底部居中出现胶囊浮层——显示聆听 / 识别状态、更强的实时波形、单行转写预览（分块识别时显示 partial）、前台应用名与停止按钮，成功后短暂确认再淡出，且不抢前台焦点。
• macOS Option-key picker: Settings → Input lets you choose Left / Right / Either Option as the hold-to-talk key, so the shortcut can avoid conflicts with other apps. / macOS Option 键选择：设置 → 输入与快捷键可选择左 / 右 / 任一 Option 作为按住听写键，避免与其他应用冲突。

Changed

• Shared home stats UI: 7-day chart, stat tiles, and surface chrome live in OSGKeyboardShared (UsageStatsCluster / UsageStatCard / SevenDayUsageChart); Mac Dashboard and iOS Home (phone stacked / iPad split) both consume them. Localization keys moved from mac.stat.* to stat.*. / 共享首页统计 UI：近 7 天图表、统计卡与表面壳迁入 OSGKeyboardShared（UsageStatsCluster / UsageStatCard / SevenDayUsageChart）；Mac Dashboard 与 iOS 首页（手机上下叠 / iPad 左右分栏）共用。文案 key 由 mac.stat.* 改为 stat.*。
• Removed temporary Flow DEBUG panels: the on-screen App Group / session debug text boxes on Home and the keyboard extension are gone now that the orange-mic investigation is closed. / 移除临时 Flow DEBUG 面板：橙色麦克风排查结束后，首页与键盘扩展上的 App Group / 会话调试文本框已去掉。
• macOS local ASR catalog: removed offline Paraformer; SenseVoice / Qwen3 0.6B / Qwen3 1.7B now show Fastest / Most balanced / Best quality badges (users still on Paraformer migrate to Qwen3 0.6B). / macOS 本地 ASR 目录：移除 offline Paraformer；SenseVoice / Qwen3 0.6B / Qwen3 1.7B 分别标注速度最快 / 最平衡 / 质量最好（仍选 Paraformer 的用户迁移到 Qwen3 0.6B）。
• macOS visual system: full-app redesign around the brand line “Speak it. It’s typed.” / 「开口即文字。」— grouped sidebar, restrained accent selection, asymmetric Home stats (chars as hero), unified page headers, quieter status footer, and clearer dark-mode card elevation. / macOS 视觉体系：围绕品牌句「开口即文字。」/ “Speak it. It’s typed.” 做全 App 设计升级——侧栏分组、克制的选中态、首页不对称统计（字数主卡）、统一页头、降权状态栏，以及更清晰的暗色卡片层次。
• macOS Home stat cards: the hero word-count card is now a full-width horizontal bar sized to its content (icon + label + big number) instead of a tall card stretched to match its neighbors, removing the large dead space below the number; the "Recent" list was removed from Home since it duplicated the History page. / macOS 首页统计卡：字数主卡改为按内容自适应高度的满宽横条（图标+标题+大数字），不再被拉伸到与相邻卡片等高、留出大片空白；首页底部与历史页重复的「最近」列表已移除。
• macOS page margins: Home / History / Dictionary / Settings share pageHorizontalInset on titles and scroll content; ScrollViews / Forms stay full-bleed so the scrollbar sits on the window edge, while cards stay aligned with the page title. Settings keeps native grouped Form for control layout. / macOS 页边距：首页 / 历史 / 词库 / 设置在标题与滚动内容上共用 pageHorizontalInset；ScrollView / Form 通栏使滚动条贴窗口右缘，卡片仍与页标题对齐。设置保留原生分组 Form 以保证控件排版。

Fixed

• Spurious "Voice is ready" overlay: a healthy in-app Flow session no longer flashes the cold-start overlay after dictation. Keyboard mic presses wait when the session is still alive (including preparingSession / single-frame hostNotReady races); only a truly dead host opens startflow. The host silences overlay when already ready or busy. Proactive auto-launch is disabled. / 误弹「语音已就绪」：App 内健康 Flow 会话在听写后不再闪冷启动浮层。键盘在会话仍存活时（含 preparingSession / 单帧 hostNotReady 竞态）只等待；仅宿主真正死亡才打开 startflow。主 App 在已就绪或忙碌时静默忽略浮层。已关闭被动自动拉起。
• Cold-start overlay recursion crash: dismissing the ready overlay while an utterance is already recording no longer recurses refreshHostReady → reconcile → dismiss on the main thread until stack overflow (EXC_BAD_ACCESS). Handoff flags are cleared before any refresh. / 冷启动浮层递归崩溃：就绪浮层仍在时若已开始录音，不再在主线程上递归 refreshHostReady → reconcile → dismiss 直至栈溢出（EXC_BAD_ACCESS）；交接标志会在任何 refresh 之前先清除。
• macOS Qwen3 “language” garbage transcript: Sherpa Qwen3 results that still include the model scaffold (language Chinese<asr_text>…) are now stripped to the spoken text; incomplete outputs that stop at the bare word language are treated as empty instead of being inserted. / macOS Qwen3「language」乱码转写：Sherpa Qwen3 结果若仍带模型脚手架（language Chinese<asr_text>…）会剥到真实口语文案；不完整输出停在单词 language 时按空结果处理，不再插入。
• macOS local ASR silence garbage output: dictating with no speech (silence) on a Sherpa-backed local model (SenseVoice/Qwen3/Paraformer) no longer inserts the raw JSON result line ({"lang": "", "emotion": "", ...}) as the transcript — it now correctly reports "no speech recognized". / macOS 本地识别静音乱码：使用 Sherpa 本地模型（SenseVoice/Qwen3/Paraformer）听写时若未检测到语音，不再把原始 JSON 结果行（{"lang": "", "emotion": "", ...}）当作转写文本插入，现在会正确提示「没有识别到语音」。
• Force-quit mic release: on termination the host app now synchronously stops AVAudioEngine, deactivates AVAudioSession, and ends Live Activities (Dynamic Island + Lock Screen) in applicationWillTerminate, reducing “microphone in use” errors after reopening. / 强杀麦克风释放：进程终止时在 applicationWillTerminate 内同步停止 AVAudioEngine、释放 AVAudioSession 并结束 Live Activity（灵动岛 + 锁屏），降低强杀后重开提示麦克风被占用的概率。

[0.5.2] - 2026-07-09

Added

• macOS local ASR models: the desktop app ships a bundled model catalog with one-click download of Sherpa Qwen3 (hotwords) and SenseVoice models, plus a shared model storage directory; downloads show a circular progress ring with pause / resume, and each row has inline Download / Delete actions. / macOS 本地 ASR 模型：桌面 App 内置模型目录，可一键下载 Sherpa Qwen3（热词）与 SenseVoice 模型，并共用同一模型存储目录；下载显示带暂停 / 继续的环形进度，每行提供内联的下载 / 删除操作。
• Shared model directory for MLX: Qwen3-ASR MLX now uses a fixed subfolder inside the shared model storage — drop converted weights into the folder opened by "Open folder"; no per-model directory picker. / MLX 共用模型目录：Qwen3-ASR MLX 改用共享模型存储中的固定子目录——把转换好的权重放入「打开目录」指向的文件夹即可，不再逐模型选目录。
• iCloud sync hardening: per-field settings merge (appSettings.v2), per-device usage statistics (G-Counter), tombstoned dictionary/history merge, and a low-risk Sync Now action in Settings. / iCloud 同步加固：设置按字段合并（appSettings.v2）、统计按设备 G-Counter 累计、词库/历史带墓碑合并，并在设置中新增低风险的立即同步操作。

Changed

• API key sync: cloud provider API keys now replicate through iCloud Keychain when settings sync is on — never through iCloud KVS JSON. / API 密钥同步：开启设置同步后，云端服务商 API 密钥改由 iCloud 钥匙串复制，不再写入 iCloud KVS JSON。
• Speech history cap: synced history limit is 300 entries (aligned with the sync payload). / 语音历史上限：可同步历史上限为 300 条（与同步载荷一致）。
• macOS app name: the built product is now OSGKeyboard.app (was OSGKeyboardMac.app); Dock, About, and Finder all read OSGKeyboard. / macOS 应用名称：编译产物改为 OSGKeyboard.app（原 OSGKeyboardMac.app）；Dock、关于窗口与 Finder 均显示 OSGKeyboard。
• macOS local recognition label: the Settings entry is now simply "Local Recognition" and no longer names a specific model. / macOS 本地识别标签：设置项改为「本地识别」，不再绑定具体模型名称。

Fixed

• macOS menu-bar icon in light mode: the status-bar icon now follows the system menu-bar appearance, so forcing the app into Light while the system is Dark no longer renders an unreadable dark icon; a refreshed status mark is used. / macOS 菜单栏图标（浅色模式）：状态栏图标改为跟随系统菜单栏外观，App 强制浅色而系统为深色时不再出现看不清的深色图标；并更新了状态栏图标。
• macOS light-mode sidebar: restored the native translucent sidebar material so the light appearance matches system apps (e.g. System Settings, Notes) instead of a flat grey fill. / macOS 浅色侧边栏：恢复原生半透明侧栏材质，浅色外观与系统应用（如系统设置、备忘录）一致，不再是扁平灰底。
• Settings sync wiping API keys: pulling a legacy settings blob without API key fields no longer deletes local Keychain entries. / 设置同步清空 API 密钥：拉取不含 API 密钥字段的旧版设置包时，不再删除本地 Keychain 项。
• Cross-device settings conflicts: changing different settings on two devices no longer lets one device's full blob overwrite the other's unrelated fields. / 跨设备设置冲突：两台设备分别修改不同设置项时，不再因整包覆盖而冲掉对方未改动的字段。
• Usage statistics under-counting: offline usage on multiple devices now sums correctly instead of taking per-field max(). / 使用统计少计：多设备离线各自累计后合并为求和，不再对总量取 max()。
• Dictionary/history resurrection: deletes and "clear all" on one device propagate via tombstones so older remote entries cannot come back. / 词库/历史复活：单设备删除或清空会通过墓碑传播，远端旧条目无法复活。
• Flow false-ready mic state: the keyboard mic now stays orange until the host app publishes a real ready contract (capture engine live + polling idle), not merely a fresh heartbeat; green tap-to-talk and jump-to-host behavior share the same MicVoiceAvailability gate, and orphaned stopped signals self-heal instead of hanging until timeout. / Flow 伪就绪麦克风状态：键盘麦克风在主 App 发布真实就绪合约（音频引擎在跑且轮询空闲）之前保持橙色，不再仅凭心跳误判；绿色「点按说话」与跳转主 App 共用同一 MicVoiceAvailability 闸门，孤立的 stopped 信号会自愈而不再长时间卡住。
• Flow mic stuck orange after ready: a single stale cross-process heartbeat read no longer flips a healthy session into a sticky "session ended" error that forced the mic orange. The "session ended" hint now fires only when the (heartbeat-independent) session contract truly drops; a brief read jitter is smoothed by a ready grace window, and a lingering expired hint auto-recovers to green once the host is ready again. / 就绪后麦克风卡橙色：单次跨进程心跳读数抖动不再把健康会话打成粘滞的「会话已结束」错误、强制麦克风变橙。「会话已结束」提示现仅在（不依赖心跳的）会话合约真正失效时触发；短暂读数抖动由就绪宽限期平滑，遗留的过期提示会在宿主重新就绪后自动恢复为绿色。
• Orphaned Live Activity after force-quit: force-quitting the app no longer leaves a stale OSGKeyboard status stuck on the Lock Screen / Dynamic Island. The staleDate is now ~45s (refreshed by the heartbeat while the session is alive) so the system reclaims a dead session's island on its own, and every app foreground now sweeps leftover Live Activities before trying to (re)start a session — so even a start that later fails (e.g. mic proof timeout) still clears the zombie island. / 强杀后遗留 Live Activity：强制退出 App 不再在锁屏 / 灵动岛留下无法消失的 OSGKeyboard 状态。staleDate 缩短为约 45 秒（会话存活期间由心跳持续刷新），系统会自动回收已死会话的灵动岛；且每次 App 回到前台都会先清扫遗留的 Live Activity 再尝试（重新）启动会话——即便本次启动随后失败（如麦克风就绪超时），也不会留下僵尸灵动岛。

[0.5.0] - 2026-07-07

Added

• iCloud settings sync: engine, language, polish, and Flow preferences now stay in sync across your devices via iCloud (key-value store); a new "Sync settings via iCloud" toggle in Settings controls it. API keys stay on each device and are never uploaded. / iCloud 设置同步：引擎、语言、润色与 Flow 偏好现可通过 iCloud（键值存储）在多设备间自动同步；设置中新增「通过 iCloud 同步设置」开关控制此功能。API 密钥仅保留在各自设备本地，绝不上传。

Changed

• Cold-start return guidance: the handoff screen now points to the bottom Home indicator with a left-to-right swipe animation (instead of the misleading "swipe up"), auto-dismisses once you switch back to your previous app, and closes on a tap anywhere; a "Return to [App]" link is still offered when available. / 冷启动返回引导：交接页改为指向底部横条并配左向右滑动动画（不再是易误解的「向上滑」），切换回上一个 App 后自动消失，点按任意处即可关闭；可用时仍保留「返回 [App]」文本按钮。
• Voice session handoff robustness: hardened the keyboard→app cold-start flow, including a clearer "Voice session disconnected" hint when the host session drops. / 语音会话交接健壮性：强化键盘→主 App 的冷启动链路，宿主会话断开时给出更清晰的「语音会话已断开」提示。

Fixed

• Local ASR route-change crash: dictating with the on-device engine no longer terminates the app with Failed to create tap due to format mismatch. On-device SpeechAnalyzer warmup reconfigures the shared audio session, which triggers a route change; the tap was reinstalled with a stale hardware format (48 kHz) that no longer matched the live node (24 kHz). The tap now binds to the node's live format (installTap(format: nil)) and the downsampling converter rebuilds itself from the actual buffer format, so route churn is handled without crashing. / 本地识别路由切换崩溃：使用端侧引擎听写不再以 Failed to create tap due to format mismatch 崩溃退出。端侧 SpeechAnalyzer 预热会重配共享音频会话并触发路由变化，此前重装 tap 时用了过期的硬件采样率（48 kHz），与真实节点（24 kHz）不匹配。现在 tap 绑定节点实时格式（installTap(format: nil)），降采样转换器按实际缓冲区格式自适应重建，路由抖动不再导致崩溃。
• ASR fallback warning showed raw key: the weak-network / missing-key fallback hint displayed its localization key (e.g. flow.warning.polishDegraded) instead of the translated sentence. These keys live in the Shared.strings table but were looked up via the main-app Localizable table; they are now resolved through SharedL10n. / ASR 兜底提示显示变量名：弱网 / 缺少密钥的兜底提示此前显示本地化键名（如 flow.warning.polishDegraded）而非译文。这些键位于 Shared.strings，却被按主 App 的 Localizable 表查找；现改为经 SharedL10n 解析。
• Flow multi-utterance recognition: the second (and later) dictation in a session no longer returns "no speech". The session-long downsampling AVAudioConverter was being permanently locked by an .endOfStream tail-flush, starving every utterance after the first (both on-device and cloud). Trailing speech is still preserved by the live drain loop. Also added recovery from mediaServicesWereReset. / Flow 连续多句识别：同一会话内第二句及之后不再提示「未识别到语音」。此前会话级降采样 AVAudioConverter 被尾音冲刷的 .endOfStream 永久锁死，导致首句之后每句都拿不到音频（端侧与云端均受影响）。尾音仍由实时排空环节保留。并新增媒体服务重置（mediaServicesWereReset）后的自愈重建。
• Local ASR diagnostics: add chunk-level SpeechAnalyzer logs and a settings switch to bypass the custom language model, so local recognition failures can be isolated between Apple assets, CLM attachment, and empty analyzer results. / 本地识别诊断：新增 SpeechAnalyzer 分块级日志，并在设置中加入跳过自定义语言模型的诊断开关，用于区分 Apple 端侧资源、自定义语言模型挂载、以及分析器空结果三类问题。

[0.4.1] - 2026-07-06

Added

• Flow Live Activity: Dynamic Island shows the OSGKeyboard brand mark during an active voice session (ActivityKit widget extension). / Flow 灵动岛 Live Activity：语音会话期间在灵动岛显示 OSGKeyboard 品牌标识（ActivityKit 小组件扩展）。
• Xiaomi MiMo cloud provider: preset for the cloud engine with mimo-v2.5 polish via api.xiaomimimo.com (on-device ASR, same pipeline as other online providers). / 小米 MiMo 云端引擎：云端引擎新增预设，经 api.xiaomimimo.com 使用 mimo-v2.5 润色（端侧 ASR，与其他在线服务相同管线）。
• Flow session policy (A): on-demand session start from the keyboard; inactivity-based expiry (10m–24h, default 12h) reset after each utterance; handoff auto-starts recording. / Flow 会话策略（A）：键盘按需启动会话；无活动超时（10 分钟–24 小时，默认 12 小时）每句结束后重置；交接完成后自动开始录音。
• Skip app switch (B+C): settings toggle (default on) plus cold-start overlay with swipe-back guidance and optional “Return to [App]” alert. / 跳过应用切换（B+C）：设置开关（默认开）+ 冷启动极简页（右滑引导 + 可选「返回 [App]」弹窗）。
• Host return whitelist (C+D): HostAppURLRegistry with 20 high-frequency host apps; sourceApplication capture on startflow. / 宿主回跳白名单（C+D）：HostAppURLRegistry 覆盖 20 个高频宿主 App；startflow 时记录 sourceApplication。

Changed

• Keyboard language label: PrimaryLanguage set to mis so Settings no longer shows a misleading “English” subtitle under OSGKeyboard. / 键盘语言标签：PrimaryLanguage 设为 mis，系统设置中 OSGKeyboard 下不再显示误导性的「英文」副标题。
• Flow ASR pipelining: shorter first chunk (2.5s) and 5s follow-ups so short utterances start on-device recognition while still recording; session-level ASR warmup and format cache reuse; live partials mirrored to the keyboard transcript line. / Flow ASR 流水线：首块 2.5 秒、后续 5 秒，短句录音期间即开始端侧识别；会话级 ASR 预热与格式缓存复用；实时 partial 同步到键盘转写行。
• Flow tail drain: after mic stop, capture drains trailing PCM (silence-detected, capped) before finishing the ASR stream; host finalize awaits drain; short final chunks re-transcribed with prior overlap; stitcher safe fallback when overlap merge would drop content. / Flow 尾音排空：停止录音后先排空尾部 PCM（静音检测 + 上限）再结束 ASR 流；主 App finalize 等待排空；过短末块与上一块 overlap 合并重识别；拼接误删时回退为安全合并。

[0.4.0] - 2026-07-05

Added

• Custom ASR language model: on-device SFCustomLanguageModelData bias model (computer/IT terms + curated AI/tech brands) prepared via CustomLanguageModelManager and applied to DictationTranscriber for Chinese dictation; compiled LM/Vocab shared through the App Group. / 自定义语音识别语言模型：端侧 SFCustomLanguageModelData 偏置模型（计算机术语 + 精选 AI/科技品牌词），通过 CustomLanguageModelManager 在设备上准备并挂载到 DictationTranscriber 用于中文听写；编译后的 LM/Vocab 经 App Group 共享。
• Cursor navigation: keyboard drag pad (CursorDragPad / CursorNavigation) for precise caret movement. / 光标导航：键盘拖动手势区（CursorDragPad / CursorNavigation），精确移动光标。
• Key sound feedback: KeyboardSoundFeedback plays system key clicks on input. / 按键音反馈：KeyboardSoundFeedback 在输入时播放系统按键音。
• Personal dictionary tooling: DictionaryAliasGenerator and PersonalDictionaryEntrySheet for managing custom terms and aliases. / 个人词库工具：DictionaryAliasGenerator 与 PersonalDictionaryEntrySheet，用于管理自定义词条与别名。
• Transcript post-processing: TranscriptPostProcessor quality gate on the shared ASR path. / 转写后处理：共享 ASR 链路上的 TranscriptPostProcessor 质量校验。

Changed

• Tab bar visibility: TabBarVisibility centralizes show/hide handling; retired PageHeaderRow / PageHeaderConfirmButton. / 标签栏可见性：TabBarVisibility 统一管理显隐；移除 PageHeaderRow / PageHeaderConfirmButton。

Removed

• DictionaryLearner: replaced by the new dictionary tooling. / DictionaryLearner：由新的词库工具取代。

Security

• DeepSeek key handling: move the hardcoded API key out of PreconfiguredKeys.swift into a gitignored PreconfiguredKeys.local.swift (seeded from .example by generate-xcodeproj.sh). / DeepSeek 密钥处理：将硬编码 API 密钥移出 PreconfiguredKeys.swift，改为 gitignore 的 PreconfiguredKeys.local.swift（由 generate-xcodeproj.sh 从 .example 生成）。

[0.3.6] - 2026-07-05

Changed

• ASR polish pipeline: global output contract (no new emojis, punctuation, structure at every intensity), TranscriptPostProcessor quality gate, ultra-short utterances skip LLM, removed Off polish tier (legacy off migrates to Medium), preceding-text context in keyboard polish path.

[0.3.4] - 2026-07-04

Added

• Home usage statistics: new home-screen stats card showing cumulative dictation time, dictation characters, translation characters, and personal-dictionary entry count.

Changed

• Local engine polish path: local mode now uses the built-in DeepSeek polish path by default, removing the separate "Cloud polish after ASR" toggle and user-facing DeepSeek API key setup.
• Provider API keys: cloud-provider API keys are isolated per provider in Keychain, so switching providers no longer reuses the previous vendor's key.
• Translation availability: translation settings are visible for both local and cloud engines.
• DeepSeek provider visibility: DeepSeek is reserved for the local engine's built-in path and is no longer shown as a cloud-provider picker option.

Fixed

• Home stats rendering: the stats card gradient background now uses a View-backed background compatible with SwiftUI's type system.
• Usage statistics imports: the usage statistics store now imports the shared module required for translation-state checks.

[0.3.0] - 2026-06-24

Added

• Post-polish translation for cloud and local engines: target-language picker in Settings / onboarding, TranslationChip on the keyboard top bar, and PolishMode.translate in PolishingService.
• Preconfigured DeepSeek key (PreconfiguredKeys) for local-engine cloud polish without round-tripping the Settings API card.

Changed

• Local-engine translation is gated on cloud polish: the translation row and LLM step are hidden/disabled until "Cloud polish after ASR" is enabled; turning polish off clears a stale translation target.
• Local-engine LLM endpoint pinning: when the pipeline routes through DeepSeek, base URL and model come from the DeepSeek preset instead of the user's cloud-provider settings (fixes DeepSeek key + Qwen URL 401s).

Fixed

• Translation chip always visible when the engine can run cloud LLM (cloud always; local when cloud polish is on) — no longer hidden when target is "不翻译".
• Keyboard translation menu first item shows "不翻译"; chip label when off stays "翻译".
• Translation toggle race: 2.5s protect window after chip writes, Darwin config notification, host finalize re-reads App Group; turning off cloud polish no longer clears saved translation target.

[0.2.1] - 2026-06-24

Removed

• Qwen3 CoreML on-device ASR stack (rolled back from v0.2.0). Deleted the vendored Qwen3Speech SPM package, the Qwen3ASRService, the ModelManager / OnDeviceModelWarmup / OnDeviceModelsView / DownloadConfirmSheet UI and downloaders, the OnDeviceModel and OnDeviceModelStatus shared models, and the corresponding LocalASRBackend.qwen3ASR enum case. Removed the Qwen3ASRServiceProvider registration in OSGKeyboardApp, the ModelScope/HuggingFace mirror picker, and the Qwen3Speech SPM package declaration from project.yml. No more model download / loading / warm-up code paths or UI state.

Changed

• Local engine narrows to iOS ASR. The on-device engine is now exclusively iOS 26 SpeechAnalyzer + DictationTranscriber (with SFSpeechRecognizer as the pre-26 fallback). The previous .qwen3ASR backend has been removed; LocalASRBackend retains a single .speechAnalyzer case so the next non-iOS backend can slot in without touching every call site.
• Local engine is genuinely local by default. When the user picks "local" and leaves the new polish toggle off, the transcript is inserted at the cursor as-is — no cloud LLM round-trip.
• DeepSeek preset defaults to deepseek-v4-flash. The DeepSeek LLMProvider.presets entry's defaultModel was bumped from deepseek-chat; existing users keep their saved model name until they re-pick the preset.

Added

• Cloud polish toggle for the local engine. Settings → On-device models → "Cloud polish after ASR". When enabled, the local-engine transcript is routed through the user's configured cloud LLM (DeepSeek by default) via the existing PolishingService + LLMClient chain. When disabled, the local engine is ASR-only. The toggle is a plain Bool (ProviderConfig.localModeCloudPolishEnabled) and persists in the App Group so the keyboard extension can honour it during live dictation.
• DeepSeek API key path for the local polish flow. SettingsView reveals the providerSection / apiSection cards when the polish toggle is on so the user can paste a DeepSeek key into the existing Keychain-bound field. PolishingService short-circuits with a new PolishError.missingAPIKey and surfaces a localised "fill in your DeepSeek key" warning when the toggle is on but the Keychain is empty. The raw transcript is still inserted (no data loss).
• iOS 26 SpeechAnalyzer + DictationTranscriber is now the documented local ASR path. The pre-v0.2.0 code already supported this; v0.2.1 makes it the default and only on-device backend and adds a "Built-in" badge on the local-engine card so users see there's nothing to download.

Fixed

• Two Swift 6 strict-concurrency issues in LiveDictationController and FlowSessionManager (the weak [weak self] capture inside await MainActor.run { } blocks) that were blocking xcodebuild clean builds under SWIFT_STRICT_CONCURRENCY=complete. The detached-task closure now re-captures the weak reference under @MainActor isolation.
• OpenSourceLicensesView no longer lists the deleted speech-swift, swift-transformers, qwen3-asr-coreml, or qwen3-asr-upstream entries; only Google Material Icons remains.

[0.2.0] - 2026-06-22

Added

• Local engine with on-device Qwen models: Optional Qwen3-ASR 0.6B speech recognition and Qwen3.5-0.8B text polish, fully offline after download.
• On-device model management: Download, progress, delete, and readiness status in Settings; mirror auto-selection between ModelScope and Hugging Face with fallback.
• Engine picker: Choose between local (on-device ASR + polish) and cloud (ASR + user-configured LLM polish).
• Flow session dictation: TypeWhisper-style continuous capture in the host app with keyboard handoff via App Group.
• Open-source licenses screen for bundled third-party components.

Changed

• Settings simplified: Merged language and model sections; cloud mode always enables polish (removed off/transcribe mode picker).
• Keyboard UI: Local/cloud engine badges replace the mode menu; shows model-not-downloaded guidance when the local stack is incomplete.
• iPhone only: Set TARGETED_DEVICE_FAMILY to "1" for both targets; portrait-only orientations.
• Keyboard preview always dark: Preview injects the dark palette regardless of app theme.
• Docs consistency: README/README.zh aligned to the iOS 26+ capability set.

Fixed

• ModelScope download progress: Progress now tracks byte counts instead of jumping to 50% after the first file.
• Light/Dark mode consistency for shared button/card modifiers via @Environment(\.themePalette).

[0.1.2] - 2026-06-20

Fixed

• Light/Dark mode consistency: cardSurface(), primaryButton(), secondaryButton(), and pillChip() view modifiers in Theme.swift now use ViewModifier structs that read from @Environment(\.themePalette). Previously they used hardcoded dark Palette constants, causing cards and buttons to always render in dark mode even when the main App was in light mode.
• TestFlight error 90474 (Invalid bundle): Added UIRequiresFullScreen: true and all four UISupportedInterfaceOrientations values to Info.plist via project.yml. The app targets iPhone + iPad (TARGETED_DEVICE_FAMILY: "1,2"), and Apple requires all four orientations for iPad multitasking; setting UIRequiresFullScreen opts out of slide-over/split-view while still satisfying the validator.
• Keyboard Preview cycling: The "Tap the disc to cycle states" prompt now actually works. KeyboardPreviewStub gained an onTap closure wired to cyclePhase() in KeyboardPreviewSheet, which rotates .idle → .recording → .processing → .idle with animation. Sample transcript text is shown during the .recording phase.

Added

• Dynamic ASR locale picker: Settings now loads the full list of supported locales from SFSpeechRecognizer.supportedLocales() on appear (off the main thread). Each locale shows an on-device badge (iPhone icon) when the device supports on-device recognition for that language — giving users confidence about which locales avoid sending audio to the cloud. A static fallback list is shown while the async load is in progress.
• Speech.framework linked to the main App target in project.yml (needed by the new dynamic locale loader in SettingsView).

Changed

• pillChip(foreground:) signature changed from foreground: Color = Palette.textSecondary to foreground: Color? = nil; callers that pass an explicit color are unaffected.

Note: v0.1.1 polish — this is a small follow-up to v0.1.0 focused on review-driven cleanup (theme follow-up, ASR robustness, debug-print hygiene, docs). No features are removed.

Fixed

• PrivacyInfo.xcprivacy audited for honesty: removed the three undeclared NSPrivacyAccessedAPIType entries (FileTimestamp / DiskSpace / SystemBootTime) the project doesn't actually use, and added ActiveKeyboards (reason DDA9.1) to the keyboard extension's manifest because advanceToNextInputMode() is in the tap path. The main App now declares only UserDefaults (reason CA92.1), which is the only Required Reason API it touches.
• Theme follows system appearance: main App now renders a true light palette in light mode via ThemedRoot + EnvironmentKey<ThemePalette>. The keyboard extension deliberately stays dark (Apple's default) and now uses a transparent .background(Color.clear) so the system UI chrome shows through.
• Speech Recognition permission requested on first press: added NSSpeechRecognitionUsageDescription to both targets' Info.plist and an explicit SFSpeechRecognizer.requestAuthorization call inside pressBegan(). Without these, speech authorization could remain .denied and recognition would fail silently.
• ASRService emits a DEBUG warning when on-device recognition isn't supported, so it's obvious during dev that the request fell back to cloud.
• App Group fallback behaviour:
  • In DEBUG, a missing App Group now fatalErrors with a precise remediation message (was a soft print + .standard fallback, which desynced the keyboard extension from the main App).
  • In release, the fallback is preserved but logged via NSLog.
• KeyboardViewController.loadPersistedLocale self-check (DEBUG only) prints the active provider / baseURL / masked API key / mode / locale, so the keyboard extension's view of the App Group is visible in the device console.
• KeyboardViewController.handleFinalTranscript typed-error routing: LLMError.noAPIKey (401) and LLMError.http(429) now surface as red, explicit error messages instead of silently inserting the raw transcript. Network / timeout errors still fall back to the raw transcript + error badge (no data loss).
• PolishingService timeout raised from 12 s to 15 s to align with LLMClient's URL request timeout. Previously the polisher would race the network call and discard a successful response that arrived in the 12–15 s window.
• DEBUG print cleanup: the four 🔥 [OSGKeyboardApp] … instrumentation prints in OSGKeyboardApp.init() and root views are now wrapped in #if DEBUG.

Added

• "Test connection" button in APISettingsCard: fires a single polish("ping") round-trip and surfaces success or the typed LLM error inline. Helps the user confirm the App Group + key are working without leaving the main App.
• 5 new unit tests in OSGKeyboardTests: App Group cross-process persistence, 401 / 429 / timeout / noAPIKey catch paths, and mode = .off short-circuit.

Changed

• README + README.zh.md: replaced <OWNER> placeholder with hkgood and aligned capability statements to the implemented iOS 26 path.

Known limitations

• The keyboard does not work in password fields (iOS limitation).
• Microphone requires "Allow Full Access" to be enabled in iOS Settings.
• Whisper.cpp / on-device LLM polish is intentionally out of scope for v1 (cloud-only).

[0.1.0] - 2026-06-17

Added

• First public pre-release.