桌面应用人工智能语音本地部署【免费下载链接】VoiceInkThe best open-source alternative to Superwhisper Wispr Flow. Voice-to-text app for macOS with no subscription项目地址https://gitcode.com/GitHub_Trending/vo/VoiceInk点击查看免费下载VoiceInk 是一款面向 macOS 的原生语音转文字应用致力于把语音几乎即时地转换为文本并以 100% 离线处理为隐私底线被官方定位为 Superwhisper 与 Wispr Flow 的开源替代方案。本文以仓库根目录的 README.md 为主线完整梳理 VoiceInk 的功能特性、获取与安装方式、从源码构建的完整流程含签名、Entitlements 与发布机制并深入到 Makefile、BUILDING.md、scripts/release.sh 等仓库文件帮助你在读完本文后既能快速上手使用也能独立完成本地构建、甚至理解其发布与更新体系。项目定位macOS 上的开源语音转文字方案VoiceInk 由开发者 Pax 在投入 5 个月开发后开源GPL v3定位是面向 macOS 的最高效、隐私优先的语音转文字解决方案。README 中明确的核心主张包括99% 准确率的本地 AI 转写、100% 离线处理数据不离开设备、按应用/URL 自动切换预设配置的智能模式Modes以及内置 AI 助手与个人词典训练能力。说明README 中99% 准确率属于官方宣传口径实际准确率会随环境音、口音与所选模型不同而波动读者应结合自身场景验证。从仓库目录结构看这是一个规模不小的 Swift 工程代码按App、Core、DesignSystem、Features、Infrastructure等模块组织其中Features下分列了 Recording、Transcription、Modes、Dictionary、Enhancement、History、ModelLibrary、Onboarding、Licensing、Assistant、AudioImport、Dashboard、Settings 等子模块基本与 README 的功能清单一一对应。核心功能特性一览README 列出了 8 项核心特性下面逐一展开并给出仓库中的对应实现入口便于深入研读。1. 精准转写Accurate Transcription本地 AI 模型将语音转写为文本宣称几乎即时完成。仓库中模型能力分布在 Features/ModelLibrary/State 与 Infrastructure/Providers/Transcription 两处Whisper基于 whisper.cppWhisperTranscriptionService.swift、LibWhisper.swiftTranscribeCpp本地 GGUF 转写模型OfflineTranscribeCppService.swiftFluidAudioParakeet 模型FluidAudioTranscriptionService.swift云端供应商AssemblyAI、Deepgram、OpenAI 兼容接口等CloudTranscriptionService.swift。此外Resources/models 下已附带ggml-silero-v5.1.2.binVAD 语音活动检测模型用于录音时的人声起止检测。2. 隐私优先Privacy FirstREADME 强调 100% 离线处理、数据不出设备。支撑这一承诺的本地推理链路包括 Whisper/TranscribeCpp 的本地执行以及应用沙箱配置VoiceInk.entitlements 与 VoiceInk.local.entitlements 均关闭了 App Sandboxcom.apple.security.app-sandbox false仅按需开放麦克风audio-input、屏幕录制screen-capture、Apple Eventsapple-events与网络客户端/服务端权限。网络权限的存在主要是为了云端转写与自动更新纯本地场景下数据不会外发。3. 智能模式Modes应用感知是 VoiceInk 的特色它会根据当前所在应用或浏览器 URL 自动套用预配置的转写设置。对应实现模式配置模型ModeConfig.swift、ModeRuntimeConfiguration.swift触发词/触发应用检测ModeTriggerWordDetectionService.swift、TriggerInstalledApps.swift前置模板库StarterModeFactory.swift、TriggerTemplateCatalog.swift。4. 上下文感知Context Aware智能 AI 会理解屏幕内容并自适应上下文例如结合当前网页 URL 或屏幕画面提高转写/增强质量。实现入口ActiveWindowService.swift、BrowserURLService.swift、ScreenCaptureService.swift、SelectedTextService.swift。Info.plist 中的NSAppleEventsUsageDescription与NSScreenCaptureUsageDescription正是为这些能力申请的权限说明。5. 全局快捷键Global Shortcuts支持可配置的键盘/鼠标快捷键实现快速录音与按讲push-to-talk。实现位于 Features/ShortcutsShortcutMonitor.swift、ShortcutStore.swift依赖 sindresorhus 的KeyboardShortcuts库。6. 个人词典Personal Dictionary可训练 AI 理解你的专属术语、行业词汇并支持智能文本替换。实现位于 Features/DictionaryDictionaryService.swift、WordReplacementService.swift以及 Auto Learn 自动学习体系AutoLearnService.swift 等后者还支持通过本地 CLI 进行审查。7. 智能模式切换Smart Modes针对不同写作风格与上下文可即时切换由 AI 驱动的增强模式。相关实现见 Features/EnhancementAIEnhancementService.swift、PromptTemplates.swift、FillerWordManager.swift。8. AI 助手AI Assistant内置类似 ChatGPT 的语音对话助手。实现见 Features/AssistantAssistantChatService.swift、AssistantSession.swift。系统要求根据 README 与 BUILDING.md使用与构建的最低要求均为macOS 15.0 或更高版本源码构建还需要 Xcode含 Command Line Tools与 Git。获取与安装通过 Homebrew 安装README 提供了 cask 安装方式brew install --cask voiceink这是获取编译版最快的方式安装后可自动获得后续更新。从官网下载官方下载渠道提供带免费试用的最新版本购买许可License用于支持持续开发并解锁自动更新、优先支持Discord 与邮件及后续新功能。仓库中的 appcast.xml 即为 Sparkle 更新源目前最新条目为版本 2.21sparkle:shortVersionString为2.21sparkle:minimumSystemVersion为15.0其更新说明涵盖 Parakeet Ultra、OpenRouter 转写模型、GPT-6 Luna/Sol 增强模型、自定义 AI 增强模型 ID、双击录音快捷键等新能力。从源码构建作为开源项目你也可以自行构建详见下文。从源码构建完整实战指南README 将构建细节指向 BUILDING.md而真正的执行逻辑在 Makefile 中。下面按 Makefile 目标逐一拆解。前置检查make check / make healthcheckmake check验证三个必备工具是否存在缺一即退出gitxcodebuild需要安装 Xcodeswift准备 Whisper 框架make whispermake whisper会在~/VoiceInk-Dependencies下准备whisper.xcframework创建~/VoiceInk-Dependencies目录若whisper.cpp不存在则克隆并执行其build-xcframework.sh脚本构建通用框架已存在则git pull更新产物路径为~/VoiceInk-Dependencies/whisper.cpp/build-apple/whisper.xcframework。make setup只是whisper的别名封装并在完成后提示 Xcode 工程需引用该框架路径。一键本地构建make local这是 BUILDING.md 推荐的本地构建入口git clone VoiceInk 仓库地址 cd VoiceInk make local open ~/Downloads/VoiceInk.appmake local的完整行为对照 Makefile 的local目标先执行check与setup即确认工具链并准备 whisper.xcframework清空本地 DerivedData 目录.local-build签名身份自动检测调用security find-identity -v -p codesigning查找Apple Development身份。若恰好找到 1 个则使用该身份若找到多个则提示设置LOCAL_CODESIGN_IDENTITY并回退到 ad-hoc 签名若没有找到直接使用 ad-hoc 签名CODE_SIGNING_REQUIREDNO以Release 配置执行xcodebuild关键参数xcodebuild -project VoiceInk.xcodeproj -scheme VoiceInk -configuration Release \ -derivedDataPath $(CURDIR)/.local-build \ -xcconfig LocalBuild.xcconfig \ CODE_SIGN_IDENTITY$SIGNING_IDENTITY \ CODE_SIGNING_REQUIRED$SIGNING_REQUIRED \ CODE_SIGNING_ALLOWEDYES \ DEVELOPMENT_TEAM \ CODE_SIGN_ENTITLEMENTS$(CURDIR)/VoiceInk/VoiceInk.local.entitlements \ SWIFT_ACTIVE_COMPILATION_CONDITIONS$(inherited) LOCAL_BUILD将产物VoiceInk.app复制到~/Downloads并用xattr -cr清除扩展属性去除 quarantine 标记。指定签名身份本地构建默认使用唯一的 Apple Development 身份也可显式指定# 使用指定身份SHA 或名称 make local LOCAL_CODESIGN_IDENTITYSHA or name # 强制 ad-hoc 签名 make local LOCAL_CODESIGN_IDENTITY-本地构建的已知限制BUILDING.md 与 Makefile 的local目标输出都明确提示无 iCloud 词典同步正式版依赖VoiceInk.entitlements中的 CloudKit/iCloud 能力无自动更新需重新拉取代码并重建ad-hoc 签名在重建后可能需要重新授予 macOS 权限麦克风、屏幕录制等。其他常用目标目标作用make build以 Debug 配置构建CODE_SIGN_IDENTITY不产出可分发的签名应用make dev构建并启动VoiceInk Dev.appRUN_APP_NAMEVoiceInk Devmake run启动~/Downloads/VoiceInk.app未找到时在 Xcode DerivedData 中搜索make release生成签名、公证后的发布包见下节可传NOTESrelease-notes/版本.html指定更新说明make release-setup将 Apple 公证凭据存入 Keychainnotarytool使用的 profilemake clean删除~/VoiceInk-Dependenciesmake help列出全部目标用 Xcode 构建make setup open VoiceInk.xcodeproj选择VoiceInkschemeRun 会构建VoiceInk Dev.appArchive 使用 Release 配置。注意LOCAL_BUILD编译条件仅在make local下生效正常 Xcode 构建不会引入。本地构建的配置与 EntitlementsLocalBuild.xcconfig 专为本地构建设计要点如下CODE_SIGN_IDENTITY - CODE_SIGN_STYLE Manual DEVELOPMENT_TEAM PROVISIONING_PROFILE_SPECIFIER SWIFT_ACTIVE_COMPILATION_CONDITIONS $(inherited) LOCAL_BUILD默认 ad-hoc 签名make local在检测到 Apple Development 身份时会覆盖LOCAL_BUILD编译条件供 Swift 代码用#if LOCAL_BUILD分支处理本地构建差异。从源码看该标志在 App/VoiceInk.swift、LicenseViewModel.swift、KeychainService.swift、OnboardingCoordinator.swift 等文件中均有使用主要影响许可校验、Keychain 访问与 iCloud 初始化等行为。本地与正式版的 Entitlements 差异非常明显VoiceInk.local.entitlements仅含麦克风、屏幕录制、Apple Events、网络客户端/服务端、关闭库校验等基础能力不含iCloud/CloudKitVoiceInk.entitlements额外包含com.apple.developer.aps-environment推送、iCloud.com.prakashjoshipax.VoiceInkCloudKit 容器、keychain-access-groupscom.prakashjoshipax.VoiceInk的钥匙串访问组以及两个mach-lookup临时例外与 Sparkle 安装器服务相关。发布与自动更新流程make release若你计划发布自己的版本仓库提供了完整的自动化发布脚本 scripts/release.sh。其流水线为归档xcodebuild archiveRelease 配置产物VoiceInk.xcarchive导出按 release/ExportOptions.plist 导出 Developer ID 签名的VoiceInk.app一致性校验核对 Bundle IDcom.prakashjoshipax.VoiceInk、Sparkle 更新源 URL、最低系统版本15.0与数值型构建号签名与公证codesign --verify --deep --strict验证notarytool submit提交并stapler staple公证打包 DMG基于 release/dmg/layout.conf含背景图、窗口位置、图标布局参数与 release/dmg/background.tiff、release/dmg/volume-icon.icns 生成 DMG随后对 DMG 签名与公证并通过hdiutil verify 挂载校验内容生成 Appcast使用 Sparkle 的generate_appcast生成 appcast.xml用sign_update校验 EdDSA 签名并用xmllint逐字段比对版本号、URL、长度与签名最后输出 DMG 的 SHA-256。脚本常用参数scripts/release.sh --help可查看完整说明make release # 全流程发布默认 release-notes/版本.html make release NOTESrelease-notes/2.21.html scripts/release.sh --app /path/to/VoiceInk.app --notes /path/to/notes.html --skip-notarization --allow-dirty关键环境变量均有默认值VOICEINK_DEVELOPER_IDENTITYDeveloper ID 身份名、VOICEINK_NOTARY_PROFILE公证 Keychain profile、VOICEINK_RELEASE_BASE_URL下载 URL 前缀、VOICEINK_RELEASE_OUTPUT_ROOT输出目录、VOICEINK_WHISPER_FRAMEWORKwhisper.xcframework 路径等。注意脚本默认要求 Git 工作区干净可加--allow-dirty跳过且不会自动提交、打 tag 或创建 GitHub release。仓库源码结构导航App应用入口VoiceInk.swift、菜单栏、窗口管理、快捷键/快捷指令App Intents、启动项、通知与更新Core转写引擎错误类型、录音状态、AI 增强输出过滤等核心类型Features上述全部业务功能转写、模式、词典、增强、历史、模型库、引导、许可、助手等Infrastructure底层支撑——录音与音频设备、供应商实现转写/增强、持久化与迁移、系统集成剪贴板、光标粘贴、媒体控制、屏幕捕获、隐私混淆、备份/导入导出DesignSystem主题、组件与布局AppTheme、FlowLayout、Markdown 渲染等VoiceInkRefineXPC本地增强推理的 XPC 服务与 Shared/VoiceInkRefineXPCProtocol.swift 及客户端 VoiceInkRefineXPCClient.swift 配套。许可证、贡献与致谢许可证GNU GPL v3详见 LICENSE贡献方式项目当前不接受 Pull Request但欢迎 fork 自用或通过 issue 报告 bug、建议功能、改进文档详见 CONTRIBUTING.md 与 CODE_OF_CONDUCT.md核心转写技术whisper.cppOpenAI Whisper 的高性能推理实现、FluidAudio用于 Parakeet 模型、TranscribeCpp for Swift本地 GGUF 转写模型、SenseVoice SmallFunAudioLLM / 阿里的多语言模型关键依赖Sparkle自动更新、KeyboardShortcuts可配置快捷键、LaunchAtLogin登录自启、MediaRemoteAdapter录音时控制媒体播放、Zip压缩解压、SelectedTextKit获取选中文本、Swift Atomics线程安全原子操作。小结VoiceInk 的价值在于把本地、隐私优先的语音转文字体验做成了完整可用的 macOS 应用并开源了从功能实现到发布流水线的全套代码。对普通用户可经 Homebrew 一行安装体验对开发者则可通过make local快速本地构建通过LOCAL_BUILD编译条件、两套 Entitlements 与make release发布脚本理解一个 macOS 商业级应用在签名、公证、自动更新上的工程化实践。若要在离线、隐私敏感场景下搭建自己的语音输入方案VoiceInk 是一个可以直接上手、深度定制的开源起点。赞分享桌面应用人工智能语音本地部署【免费下载链接】VoiceInkThe best open-source alternative to Superwhisper Wispr Flow. Voice-to-text app for macOS with no subscription项目地址https://gitcode.com/GitHub_Trending/vo/VoiceInk点击查看免费下载相关推荐REHex跨平台编译教程在Windows、Linux、macOS上构建REHexREHex跨平台编译教程在Windows、Linux、macOS上构建REHex REHex是一款强大的跨平台十六进制编辑器专为逆向工程和数据分析设计。本教开发工具逆向工程桌面应用MarkText 中文指南跨平台开源 Markdown 编辑器的核心功能、安装方式与源码构建全解析MarkText 中文指南跨平台开源 Markdown 编辑器的核心功能、安装方式与源码构建全解析 本篇技术指南以 MarkText 项目的中文官方文档 d桌面应用富文本FluidVoice 使用与源码构建全指南macOS 本地优先的语音转文字与端侧 AI 增强方案FluidVoice 使用与源码构建全指南macOS 本地优先的语音转文字与端侧 AI 增强方案 导读 FluidVoice 是一个基于 GPLv3 开源的语音音频AI 应用桌面应用上一篇FreeTube 0.25.3 代码解读隐私视频客户端的 9 个未来方向下一篇设计版本控制终极指南掌握6大工具提升团队协作效率创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考