【免费下载链接】vocalinuxFree, open-source, 100% offline voice dictation for Linux. Speak and type anywhere via whisper.cpp, Whisper VOSK engines, GPU-accelerated, works on X11 Wayland!项目地址https://gitcode.com/gh_mirrors/vo/vocalinux点击查看免费下载Vocalinux 是一款免费开源、100% 离线的 Linux 语音听写工具说完话文字直接出现在当前聚焦的窗口里。本文带你从架构视角拆解它的完整数据流——麦克风采集 → VAD 语音分段 → 语音引擎转写 → 命令后处理 → 键盘文本注入看清一句话是如何一步步敲进屏幕的。 先鸟瞰全局听写数据流一图流官方架构文档 docs/ARCHITECTURE.md 用五步概括了核心数据流麦克风 (PortAudio / PipeWire) ↓ audio/capture.py · audio/pipewire.py (单声道 16 kHz PCM) ↓ recognition_manager.py · VAD 分段 (Silero 神经 VAD / 振幅 VAD) ↓ 有界分段队列 (maxsize32) ↓ 识别 worker → 语音引擎 (whisper.cpp / Whisper / VOSK …) → 命令解析 ↓ post_processor.py 后处理脚本 → TextInjector 注入文本入口 src/vocalinux/main.py 负责组装配置管理器、识别管理器、托盘 UI、D-Bus 服务与文本注入器音频与识别的实际工作全部运行在 GTK 事件循环之外的独立线程里——这就是你说话时界面从不卡顿的原因。 第一步麦克风采集——音频流的源头音频采集由 src/vocalinux/audio/capture.py 与 src/vocalinux/audio/pipewire.py 承担提供两种采集源PortAudioCaptureSource默认采集源经 ALSA / PulseAudio 读取麦克风PipeWireCaptureSource面向 PipeWire 系统的专用源自行拉起pw-record两者遵守统一契约输出单声道、16 kHz、int16 PCM数据每块 1024 个采样见 capture.py#L33。采集源只管设备 → PCM不做任何听写逻辑。输入设备选择与麦克风测试可在设置面板中直接完成在 recognition_manager.py#L3580-L3679 中_record_audio()录音循环持续读取这些数据块交给下一级的 VAD 判断。 第二步VAD 语音活动检测——听清你何时开口、何时停顿连续音频必须被切分成一句话一个片段这正是 VADVoice Activity Detection的职责首选Silero 神经 VAD。当onnxruntime可用时silero_vad.py#L19-L20 每 512 个采样约 32 ms输出一次语音概率模型文件随包内置于 data/silero_vad.onnx回退振幅阈值 VAD。缺少 ONNX 运行环境时自动退化为简单的 RMS 振幅阈值判断影响分段体验的参数麦克风灵敏度 1–5、静音停止时长等都集中在 Dictation 设置页完整的一句话被切出后会压入一个有界队列recognition_manager.py#L3352最多 32 个片段。这个缓冲把采集线程与识别线程解耦开引擎还在处理上一段时你可以继续说下一句。 第三步语音引擎转写——把声音变成字识别 worker 从队列取出片段按当前选中的引擎分发转写。common_types.SpeechEngine 定义了运行时可检查的引擎契约管理器用引擎名分发表调用各引擎的转写方法详见 ARCHITECTURE.md Speech engines 一节。Vocalinux 支持多引擎在 Speech Model 面板里一键切换引擎适用场景whisper.cpp默认最佳默认项支持 AMD / Intel / NVIDIA 的 Vulkan GPU 加速WhisperOpenAIPyTorch 路径适合 NVIDIA/CUDAFaster Whisper偏 CPU 友好CTranslate2 / INT8VOSK低内存、轻量足迹ParakeetCPU 推理NeMo ASR25 种欧洲语言Remote API可选转写卸载到你自建的服务器模型下载一次即可之后语音转写完全离线完成管理器还持有一把模型锁保护引擎加载、转写与清理过程不被并发破坏。✂️ 第四步后处理——语音命令与自定义脚本转写结果不会直接飞向键盘先经过两道精加工语音命令解析command_processor.py#L39-L63 把口述短语替换成标点与动作——period →.、new line → 换行、new paragraph → 分段配合 delete that 还能删掉上一句后处理脚本若在post_processing.script_path配置了可执行脚本post_processor.py#L15-L44 会把文本从 stdin 传入、把 stdout 收回。所有片段由单个 worker 串行消费严格保证文字按你说出的顺序落键⌨️ 第五步文本注入——让文字落进当前窗口最后一步由 text_injector.py#L1646-L1670 完成TextInjector先探测桌面环境X11 还是 Wayland再选择合适的打字工具环境注入路径X11xdotool 模拟按键 / 剪贴板粘贴Waylandwtype、ydotool、IBus 或 Remote Desktop Portal效果就是无论焦点在编辑器、浏览器还是终端文字都像亲手敲出来一样进入输入框触发方式在同一页设置里配置新安装默认Push-to-Talk按住 Right Alt 说话、松开结束由 keyboard_shortcuts.py#L51-L57 管理也可切换双击触发的 Toggle 模式或通过 D-Bus 服务 dbus_service.py 用全局快捷键远程控制启停。 幕后线程如何分工数据流能不打架地运转靠的是清晰的线程职责划分ARCHITECTURE.md Threads and state ownership 一节GTK 主线程只碰控件、托盘与对话框UI 状态更新经GLib.idle_add调度回主循环音频采集线程读麦克风、跑 VAD、把完成片段入队识别 worker消费分段队列执行转写并触发回调后处理 worker单个 worker 串行执行脚本 文本注入保序不乱内置日志查看器能让你亲眼看到整条流水线Silero VAD 加载、Vulkan GPU 探测、whisper.cpp 模型初始化全部有据可查 想深挖源码从这里入手模块路径职责应用入口main.py组装配置、识别、托盘、D-Bus 与注入音频采集audio/capture.pyPortAudio 采集源16 kHz 单声道 PCMVAD 检测speech_recognition/silero_vad.pySilero 神经 VAD 封装核心调度speech_recognition/recognition_manager.py分段、队列、引擎分发、模型锁语音命令speech_recognition/command_processor.pynew line、period 等命令解析文本注入text_injection/text_injector.pyX11 / Wayland 多后端打字架构总览docs/ARCHITECTURE.md模块地图、数据流与线程模型 一句话总结Vocalinux 的架构本质是一条流水线式、线程隔离的数据流麦克风捕获 16 kHz 单声道音频Silero VAD 把它切成语句分段队列缓冲采集与识别两端选定的语音引擎默认 whisper.cpp完全离线地转写成文字再经语音命令与脚本后处理最终由 xdotool、IBus 或 Wayland Portal 注入当前窗口。每一环都有明确的属主环与环之间靠队列和锁衔接——所以你能一边说话、系统一边处理而文字永远按你开口的顺序落到键盘上。赞分享【免费下载链接】vocalinuxFree, open-source, 100% offline voice dictation for Linux. Speak and type anywhere via whisper.cpp, Whisper VOSK engines, GPU-accelerated, works on X11 Wayland!项目地址https://gitcode.com/gh_mirrors/vo/vocalinux点击查看免费下载相关推荐ClawX 语音听写Voice Dictation技术解析从麦克风录音到 OpenAI 兼容端点转录的完整实现ClawX 语音听写Voice Dictation技术解析从麦克风录音到 OpenAI 兼容端点转录的完整实现 导读 本文围绕 ClawX 桌面应用中的语人工智能AI 应用桌面应用交互助手AI AgentGUI 自动化任务调度浏览器控制AIRI 语音转写接入 CometAPI从 API Key 配置到麦克风实时听写全指南AIRI 语音转写接入 CometAPI从 API Key 配置到麦克风实时听写全指南 CometAPI 是一个提供统一模型网关与凭据管理的云端服务AIRI人工智能AI 应用大模型AI Agent交互助手语音数字人后端前端桌面应用移动开发GUI 自动化MCP 服务终极SDL语音交互指南从麦克风录音到语音控制的完整实战教程终极SDL语音交互指南从麦克风录音到语音控制的完整实战教程 Simple DirectMedia LayerSDL是一款强大的跨平台多媒体库它为开发者提音视频游戏开发图形学跨平台上一篇xiaobei 上游借鉴分析Twitter/X 发布互动规则落地与 smart-search 分类源指南升级下一篇WordPress双因素认证插件Two-Factor提升网站安全的终极指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考