如何在macOS上快速部署voice-input-src？从安装到使用的完整指南

如何在macOS上快速部署voice-input-src？从安装到使用的完整指南

【免费下载链接】voice-input-src项目地址: https://gitcode.com/gh_mirrors/vo/voice-input-src

voice-input-src是一款专为macOS设计的菜单 bar 语音输入法应用，支持按住Fn键录音并实时转录文字到当前输入框，特别优化了中英文混杂场景的识别准确率。本指南将帮助你在macOS 14+系统上从安装到熟练使用的全过程，让语音输入变得简单高效。

📋 准备工作：系统与环境要求

在开始部署前，请确保你的设备满足以下条件：

• 操作系统：macOS 14 或更高版本
• 权限：需要系统辅助功能权限（用于全局监听Fn键）
• 网络：若使用LLM优化功能，需确保网络连接正常

⚡ 一键安装：两种简单方法

方法1：通过源码构建（适合开发者）

1. 克隆仓库
   打开终端，执行以下命令获取项目源码：

   git clone https://gitcode.com/gh_mirrors/vo/voice-input-src cd voice-input-src

2. 编译安装
   项目提供了便捷的Makefile，直接运行安装命令：

   make install

   构建完成后，应用将自动安装到/Applications目录。

方法2：下载预编译版本（推荐普通用户）

访问项目分发页面获取已签名的.appbundle：
Dist
下载后将voice-input.app拖入/Applications文件夹即可。

🔧 基础配置：首次使用必看

授予系统权限

1. 启动应用后，菜单栏会出现语音输入图标
2. 系统会提示"无法打开"，需在「系统设置 > 隐私与安全性」中允许应用运行
3. 授予以下权限：
   • 辅助功能（用于监听Fn键和注入文本）
   • 麦克风（用于录音）

设置默认语言

应用默认语言为简体中文（zh-CN），你可以通过菜单栏切换：
「语言设置」> 选择英语/简体中文/繁体中文/日语/韩语
（语言偏好会保存在UserDefaults中，下次启动自动生效）

🚀 核心功能使用指南

基础语音输入流程

1. 开始录音：按住键盘上的「Fn」键（不要松开）
2. 说话内容：直接说出需要输入的文字（支持中英文混杂）
3. 结束输入：松开Fn键，转录文本会自动粘贴到当前输入框

💡 技巧：录音时屏幕底部会显示实时波形和转录文字，确保环境安静可提高识别准确率。

LLM优化功能配置（提升识别精度）

1. 在菜单栏打开「LLM Refinement」>「Settings」
2. 填写配置信息：
   • API Base URL：OpenAI兼容接口地址
   • API Key：你的API密钥（支持完全清空）
   • Model：选择使用的模型（如gpt-3.5-turbo）
3. 点击「Test」验证连接，成功后「Save」保存设置

启用后，松开Fn键会显示「Refining...」状态，LLM将自动修正识别错误（如"配森"→"Python"）。

🛠️ 高级技巧：让输入更高效

输入法自动切换

应用会智能检测当前输入法：

• 当使用中文/日文/韩文输入法时，会临时切换到ABC键盘粘贴文本
• 粘贴完成后自动恢复原输入法，避免快捷键冲突

悬浮窗显示调整

录音时的悬浮窗具有以下特性：

• 弹性宽度（160-560px），随文字长度自动调整
• 5根竖条波形动画，实时反映音量大小
• 平滑入场/退场动画，提升视觉体验

❓ 常见问题解决

Q：Fn键按下无反应？

A：检查「系统设置 > 辅助功能」中是否已授予权限，或重启应用尝试。

Q：转录文本未粘贴到输入框？

A：确保当前窗口处于激活状态，或尝试关闭其他可能拦截剪贴板的应用。

Q：LLM优化不生效？

A：检查API配置是否正确，网络是否通畅，或查看应用日志排查问题。

📚 更多资源

• 项目源码：README.md
• 中文说明：README_CN.md
• 构建命令：通过Makefile支持build/run/install/clean等操作

通过以上步骤，你已掌握voice-input-src的完整部署和使用方法。无论是日常办公还是内容创作，这款工具都能帮你大幅提升输入效率，体验语音转文字的便捷！

【免费下载链接】voice-input-src项目地址: https://gitcode.com/gh_mirrors/vo/voice-input-src