Ghost Pepper：1.4k Stars本地语音转文字

项目概述

Ghost Pepper是一款macOS上的本地语音转文字工具，核心特点是100%本地运行，不依赖任何云端API。用户只需按住Control键说话，松开后即可自动将语音转录为文字并粘贴到任意文本框中。

官方Slogan： “100% local hold-to-talk speech-to-text for macOS. Hold Control to record, release to transcribe and paste. No cloud APIs, no data leaves your machine.”

核心特性

1. Hold-to-Talk操作

按住Control键录音，松开自动转录并粘贴到焦点文本框。操作直觉，无需点击按钮。

2. 100%本地运行

所有模型在Apple Silicon本地运行，没有任何数据离开你的电脑。语音转录和清理完全离线完成。

3. Smart Cleanup

使用本地LLM（Qwen3.5）自动清理转录内容：

• 移除填充词（“uh”、“um"等）
• 处理自我纠正
• 格式化输出

4. 菜单栏应用

常驻菜单栏，无Dock图标，更轻量。默认开机自启动。

5. 完全可定制

• 可编辑cleanup prompt
• 可选择麦克风
• 可开关各项功能

技术架构

整体架构

用户按住Control
    ↓
麦克风录音（本地Whisper模型）
    ↓
语音→文字转录
    ↓
本地LLM清理（Qwen3.5）
    ↓
模拟按键粘贴到焦点文本框

语音识别模型

Ghost Pepper使用WhisperKit作为语音识别引擎，支持多种模型：

Cleanup模型

使用Qwen3.5系列进行语音清理：

技术栈

• 语音识别：WhisperKit (argmaxinc)
• LLM推理：LLM.swift (eastriverlee)
• 模型托管：Hugging Face
• 自动更新：Sparkle
• 开发框架：Swift + Xcode

安装与使用

方式一：下载DMG（推荐）

1. 下载GhostPepper.dmg
2. 打开DMG，将Ghost Pepper拖到Applications
3. 首次启动时授予麦克风和辅助功能权限
4. 按住Control键说话

方式二：从源码构建

# 克隆仓库
git clone https://github.com/matthartman/ghost-pepper.git

# 进入项目目录
cd ghost-pepper

# 用Xcode打开
open GhostPepper.xcodeproj

# 在Xcode中构建并运行 (Cmd+R)

权限说明

Cleanup工作流程

Ghost Pepper的Smart Cleanup功能通过本地LLM提升转录质量：

原始转录（Whisper输出）

uh i think we should um maybe go with the the first option
but actually um let me reconsider the second one is is better

Cleanup后（Qwen3.5输出）

I think we should go with the first option,
but actually let me reconsider - the second one is better.

自定义Cleanup Prompt

用户可编辑cleanup prompt来自定义清理行为：

沉默词移除

Remove all filler words: "uh", "um", "ah", "er"

格式化

Convert to clean prose with proper punctuation.
Break into logical paragraphs.

语气标准化

Maintain the speaker's casual tone but remove all disfluencies.

与同类产品对比

Ghost Pepper的独特之处：

1. 最直觉的操作：Hold-to-Talk比点击录音更自然
2. 本地LLM Cleanup：转录质量远超原生Whisper输出
3. 完全隐私保护：没有任何数据上传

企业部署

Ghost Pepper需要辅助功能权限来实现全局快捷键和模拟按键。企业环境可通过MDM（Jamf、Kandji、Mosaic等）预置：

PPPC Privacy Preferences Policy Control配置

配置示例

<key>com.apple.security.accessibility</key>
<dict>
    <key>Identifier</key>
    <string>com.github.matthartman.ghostpepper</string>
    <key>IdentifierType</key>
    <string>bundleID</string>
    <key>Persona</key>
    <string>Accessibility</string>
</dict>

开发者贡献

Ghost Pepper是一个开源项目，欢迎开发者贡献。贡献者包括：

版本历史

• v2.0.1 (Apr 7, 2026): 修复麦克风权限问题
• v2.0.0 (Apr 5, 2026): 新增Pepper Chat语音助手功能
• v1.x: 初始版本发布

项目结构

ghost-pepper/
├── GhostPepper/           # 主应用
│   ├── App/              # 应用入口
│   ├── Views/            # SwiftUI视图
│   ├── Models/           # 数据模型
│   ├── Services/         # 核心服务（录音、转录、粘贴）
│   └── Utilities/         # 工具类
├── GhostPepperTests/      # 测试
├── CleanupModelProbe/     # 模型探针工具
├── docs/                  # 文档
├── scripts/               # 构建脚本
└── project.yml           # XcodeGen配置

使用场景

1. 程序员编码

# 不用打字，直接说出代码
Hold Control: "def calculate_fibonacci(n):
    if n <= 1:
        return n
    return calculate_fibonacci(n-1) + calculate_fibonacci(n-2)"

# 自动粘贴到编辑器

2. 写作助手

Hold Control: "The key insight is that local-first AI
represents a fundamental shift in how we think about
privacy and computation."

# 自动粘贴到写作应用

3. 会议记录

Hold Control: "Action items: first, review the PR
by Friday. Second, schedule the team sync for next
week. Third, update the documentation."

# 快速记录，无需打断思路

总结

Ghost Pepper代表了本地AI应用的一个优秀范例：

1. 隐私优先：100%本地运行，数据从不离开设备
2. 直觉交互：Hold-to-Talk比点击录音更自然
3. 质量保证：本地LLM Cleanup提升转录可读性
4. 轻量高效：菜单栏应用，资源占用低
5. 开源透明：代码完全可见，社区共建

适用人群：

• ✅ 隐私敏感用户（医疗、法律、金融）
• ✅ 程序员（快速记录代码思路）
• ✅ 作家/写手（不打断思路的语音输入）
• ✅ 企业用户（支持MDM部署）

项目地址：

本文基于Ghost Pepper项目编写，发布时间：2026-04-08