v0.1.9

v0.1.9

App 图标与 README logo

• App 图标（白底 VIME logo，Finder/⌘I 显示）
• README 标题下透明底 logo

v0.1.8

v0.1.8

云端 ASR 与 LLM 配置分离

• 设置窗口配置区拆为「云端 ASR 配置」「LLM 配置（润色/翻译）」两个独立区，各含 Base URL / API Key / Model（编辑即保存）
• 云端 ASR 转写模型（如 whisper-1）与 LLM 模型（如 deepseek-chat）可分别配置，支持不同厂商端点
• 未填云端 ASR 配置时自动回退使用 LLM 配置；凭据成对回退，避免跨源混配
• 引擎 start 协议新增 asr_options 会话覆盖（base_url/api_key/model/language）

v0.1.7

VIME v0.1.7 —— LLM/云端 API 配置入口 + 诊断区滚动。

本次更新

• LLM / 云端 API 配置区（设置窗口）：Base URL / API Key（安全输入）/ Model 三字段，编辑/失焦/关窗即保存——云端 ASR（asr_openai）与润色/翻译（post_polish/post_translate）均使用该配置
• 诊断区与模型日志滚动：长日志在固定区域内滚动，不再挤占其它控件；模型下载日志自动滚到底
• 修复：模型区按钮此前未显示（控件未挂载）的问题

配置示例

• 润色/翻译：Base URL https://api.deepseek.com/v1，Model deepseek-chat
• 云端 ASR：OpenAI 兼容转写端点
• 配置仅存本机（API Key 明文存 UserDefaults，仅本地使用；Keychain 为后续改进项）

安装

1. 下载解压 VIME-v0.1.7-macos.zip，VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键 VIME.app → 打开
3. 设置 → 填 LLM 配置 → 选中云端 ASR 或勾选润色/翻译 → 按住热键说话

v0.1.6

VIME v0.1.6 —— 修复快捷键无法触发的问题（根因已定位）。

根因

绑定 ⌘/⇧/⌃ 等修饰键本身作为按住说话键时，按键判定把目标键自己也算进了「其它修饰位」排除集——判定条件自相矛盾（要求含 ⌘ 又要求不含 ⌘），导致按下永不触发、松开却每次都触发。本次修复排除集逻辑（去掉目标位自己），Command / Shift / Control / Fn 绑定均可正常触发；同时保留防误触（Option 绑定下 Cmd+Option 不触发等）。

本次更新

• 修复 Command/Shift/Control/Fn 作为按住说话键时按下无法触发的问题
• 诊断区新增「最近按键事件」详情（事件类型/keyCode/flags 原始值/判定结果，最近 5 条）——按一次即可看到真实事件数据
• 修复「幽灵松开」：无按下记录的松开事件不再触发（press/release 成对保护）
• 补充 9 条回归测试（Command/Shift/Control 触发、防误触对称方向、成对边界）

安装

1. 下载解压 VIME-v0.1.6-macos.zip，VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键 VIME.app → 打开
3. 设置 → 确认热键为你的 ⌘（或重新录制）→ 按住说话

v0.1.5

VIME v0.1.5 —— 诊断模式开关 + 一键复制。

本次更新

• 诊断模式开关：设置 → 诊断区顶部「诊断模式」勾选框（默认关闭，持久化）。开启后实时刷新热键/麦克风/引擎数据；关闭时停止刷新、显示提示
• 点击即复制：开启诊断模式后，点击诊断区任意位置一键复制完整诊断文本到剪贴板（显示 1s「已复制」反馈）；关闭模式不写剪贴板

安装

1. 下载解压 VIME-v0.1.5-macos.zip，VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键 VIME.app → 打开
3. 排查语音输入问题：设置 → 勾选「诊断模式」→ 按住说话观察字段，点击复制后发我

v0.1.4

VIME v0.1.4 —— 诊断面板：一眼定位语音输入断在哪一环。

本次更新

• 设置 → 诊断：实时显示
  • 热键监听状态与最近按键事件（区分「系统没投递事件=权限问题」vs「投递了但没匹配=重新录制」）
  • 触发日志（press/release/被拒/录音失败/超时，带时间戳）
  • 麦克风累计采集字节数（按住说话时是否在增长）
  • 引擎日志尾部 + partial/final/result/error 事件尾部
  • 1 秒自动刷新，关闭设置窗口停止

用诊断排查「无法语音输入」

1. 打开设置 → 诊断区，按住说话键，观察：
2. 「最近任意按键」是否变化 → 不变 = 输入监控/辅助功能权限问题；变化但「press」不变 = 绑定未匹配（重新录制快捷键）
3. 「累计字节」是否增长 → 不涨 = 麦克风权限/输入设备问题；涨但无 partial = 引擎/ASR 问题
4. 「事件尾部」出现 partial = 识别正常；error = 按提示处理（如模型未下载）

安装

1. 下载解压 VIME-v0.1.4-macos.zip，VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键 VIME.app → 打开
3. 首次启动自动暂存引擎；授权麦克风与辅助功能

v0.1.3

VIME v0.1.3 —— 自定义快捷键 + 热键修复。

本次更新

• 自定义快捷键：设置 →「设置快捷键…」按下任意组合即绑定（支持纯修饰键如 ⌥、组合键如 ⇧⌘D），Esc 取消；「恢复默认」回到左 Option
• 热键监听状态可见：设置窗口显示「监听：正常 / 需要辅助功能权限」（红色提示），授权后回到前台自动恢复监听，无需重启
• 修复：纯修饰键误触（Cmd+Option 组合不再触发录音）；组合键按住自动重复不再重复触发；修复「无法触发快捷键」场景的引导与自恢复

若仍无法触发快捷键

1. 状态栏菜单「授权辅助功能…」跳系统设置开启 VIME 辅助功能权限
2. 打开「系统设置 → 隐私与安全性 → 输入监控」，确认 VIME 已开启（部分 macOS 版本键盘事件监听需要该权限）
3. 回到 VIME 前台即自动生效；设置窗口会显示「监听：正常」

安装

1. 下载并解压 VIME-v0.1.3-macos.zip，将 VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键 VIME.app → 打开
3. 首次启动自动暂存引擎；授权麦克风与辅助功能

v0.1.2

VIME v0.1.2 —— 修复下载版引擎挂起问题。

本次更新

• 修复：从浏览器下载并解压后，内嵌引擎二进制被系统打上隔离/provenance 标记，直接运行会在 dyld 启动阶段挂起（表现为「已损坏」或打开后无响应）。现在首次启动会把引擎暂存到 ~/Library/Application Support/VIME/engine 并从暂存副本运行（新副本无隔离标记，干净可用）
• 修复发布包 zip 破坏代码签名封印的问题（改用 ditto 打包，保留符号链接）
• --no-bundle-engine 保留纯壳构建

安装（重要）

1. 下载并解压 VIME-v0.1.2-macos.zip，将 VIME.app 拖入「应用程序」
2. 首次打开若提示「无法验证开发者」：右键点击 VIME.app → 打开，再点「打开」（或 系统设置 → 隐私与安全性 → 仍要打开）——ad-hoc 签名应用的标准步骤
3. 首次启动会自动暂存引擎（约 150MB，APFS 秒级复制），之后正常使用
4. 授权麦克风与辅助功能；需要本地 ASR 时在「设置…」→「下载本地模型」

里程碑

M1 引擎骨架与插件链 · M2 本地 ASR 流式 · M3 Swift 壳 · M4 联调收口 —— 全部完成

v0.1.1

VIME v0.1.1 —— 引擎内嵌打包版：解压即用，无需仓库目录。

本次更新

• 引擎随 .app 内嵌（Contents/Resources/engine，自包含 CPython + 依赖 venv，含 sherpa-onnx 本地 ASR）
• 移除「需在仓库目录运行」限制：直接打开 VIME.app 即自动拉起内嵌引擎
• --no-bundle-engine 保留纯壳构建（开发用）

功能（同 v0.1.0）

• 按住 Option 说话，悬浮窗实时转写，松手注入任意应用光标处
• 本地 ASR（sherpa-onnx Paraformer + Silero VAD 流式分段，离线可用）
• 云端 ASR 可选（OpenAI 兼容端点）
• 润色 / 翻译后处理插件链，设置窗口一键配置
• 菜单栏设置：热键预设 / ASR 引擎 / 模型一键下载 / 权限引导

安装

1. 下载并解压 VIME-v0.1.1-macos.zip，将 VIME.app 拖入「应用程序」
2. 首次启动授权麦克风与辅助功能
3. 需要本地 ASR：状态栏「设置…」→「下载本地模型」（约 80MB）

里程碑

M1 引擎骨架与插件链 · M2 本地 ASR 流式 · M3 Swift 壳 · M4 联调收口 —— 全部完成

v0.1.0

VIME v0.1.0 —— 首个可用版本：高度插件化的 macOS 语音输入法。

功能

• 按住 Option 说话，悬浮窗实时转写，松手注入任意应用光标处
• 本地 ASR（sherpa-onnx Paraformer + Silero VAD 流式分段，离线可用）
• 云端 ASR 可选（OpenAI 兼容端点）
• 润色 / 翻译后处理插件链，设置窗口一键配置
• 菜单栏设置：热键预设 / ASR 引擎 / 模型一键下载 / 权限引导

安装

1. 下载并解压 VIME-v0.1.0-macos.zip，将 VIME.app 拖入「应用程序」
2. 首次启动授权麦克风与辅助功能
3. 需要本地 ASR：先下载模型（设置 → 下载本地模型，或终端 cd engine && uv run vime model download）

注意：当前版本引擎未随 .app 打包，需在仓库目录下运行（README「快速开始」）。v0.2 将打包引擎。

里程碑

M1 引擎骨架与插件链 · M2 本地 ASR 流式 · M3 Swift 壳 · M4 联调收口 —— 全部完成