掌声 VoxPalm 0.1.0 公开测试版 2 · Public Beta 2

English version below.

中文

掌声 VoxPalm 的第二个公开测试版。按住无线麦或遥控器上的键说话，松手后文字就出现在光标所在的地方。还在开发中，会有不顺手和出错的地方，欢迎到 Issues 反馈。

这一版更新了什么

• 老系统也能直接用内置转写：whisper.cpp 已经内置在掌声里，macOS 14、15 不用再装 Homebrew 和命令行工具。第一次用时到「设置 › 语音」的 whisper.cpp 卡片点「下载」，下一个语音模型就行：Apple 芯片的 Mac 默认「均衡」（574 MB），Intel 芯片的 Mac 默认「小」（190 MB）。下载时有进度，可以取消，中断后可在这次运行内点「重试」尝试续传（退出掌声后需重新下载）；下完核对文件，之后转写完全在这台 Mac 上，不联网。
• whisper.cpp 转出的中文标点统一成全角。
• 安装包里不再残留编译时的开发者本机路径。

这一版能做什么

• 按住说话，松手出字：按住控制设备上的键说话，松手后字贴进按键那一刻光标所在的输入框；也可以设成按一下开始、再按一下结束。按下就开始录，长按成立才算数，短按自动丢掉，不吞第一个字。
• 只贴进对的地方：换了窗口、光标不在输入框里、焦点在密码框时都不贴，字留在剪贴板，浮窗提示按 ⌘V。可以设成说完自动按回车发送，只在输入框里有字时才按。
• 两种出字方式：内置转写在这台 Mac 上转，声音不上传；macOS 26 以上用系统转写，说话时浮窗里边说边出字，更老的系统用内置的 whisper.cpp。也可以选「外部输入法」，掌声替你按住输入法的语音键（微信输入法已实测）。
• 控制和收音分开选：用遥控器或键盘操作，用另一支麦收音。选的麦当按键用时会被静音的（比如 DJI Mic 2），录音自动改用 Mac 麦克风。
• 一个键多种用法：每个键的单击、双击、长按，可以设成按住说话、快捷键、一段文字、媒体键、打开 App。还有「AI 编程」预设：上下键切 Claude、Codex 的对话，确认键长按说话、单击发送；「做完直接开始说话」「说完自动按回车发送」可以按键单独勾选。
• 照着示意图设键：设置里画着设备的示意图，按一下实物上的键，图上对应的键会亮；平时按键时，屏幕下方弹一张小卡片，写着这一下做了什么。
• 第一次用有引导：6 步带你打开权限、选设备、设说话键，当场试说一句。

下载和第一次打开

1. 下载下面的 VoxPalm-0.1.0-beta.2.zip，解压后把「掌声」拖进「应用程序」文件夹（装过测试版 1 的直接替换，设置会保留）。
2. 这一版还没有经过苹果公证（开发者账号还在申请），第一次双击会提示无法验证开发者，先点「完成」。
3. 打开「系统设置 › 隐私与安全性」，拉到最下面，在「已阻止“掌声”」旁边点「仍要打开」，输入开机密码后再点一次「仍要打开」。之后就能正常打开了。
4. 跟着引导打开「输入监控」「辅助功能」「麦克风」三个权限，选控制设备和收音设备，再按一下想用来说话的键。
5. macOS 14、15：菜单栏面板会提示「还没下载语音模型」，到「设置 › 语音」点「下载」，下好就能说话出字。

系统要求

• macOS 14 以上，Apple 芯片和 Intel 芯片的 Mac 都能用。
• 内置转写：macOS 26 以上用系统自带的转写，不用另装东西；macOS 14、15 用内置的 whisper.cpp，第一次用时在「设置 › 语音」里下载语音模型。模型从 Hugging Face 上 whisper.cpp 官方的仓库下载，连不上时自动换国内镜像 hf-mirror.com。
• 也可以不用内置转写，改用「外部输入法」：掌声替你按住输入法的语音键（微信输入法已实测）。

设备

设备	状态
DJI Mic 2（发射器蓝牙直连 Mac）	已实测：录制键、连接键、电源键单击，按键和收音可以同时用；做不了双击，它的麦没声音时录音自动改用 Mac 麦克风
DJI Mic Mini	待实测
系统媒体键、键盘按键	可以当控制键
小米蓝牙遥控器、Siri Remote、翻页笔、脚踏板	还没逐台实测，可以先用设置里的「学键」试试

已知限制

• 没有公证，第一次打开要按上面的步骤放行。
• 还没有自动更新，新版本要回这里下载。
• DJI Mic 2 同时当按键和麦时，它的麦有时会被静音，这时录音自动改用 Mac 自带麦克风。
• 内置的 whisper.cpp 只在 macOS 27、Apple 芯片的 Mac 上实测过（手动把转写引擎设成 whisper.cpp）；macOS 14、15 和 Intel Mac 还没在真机上试过，遇到问题请反馈。
• 界面目前只有简体中文。

许可

主程序按 GPL-3.0-only 开源。这个安装包是用仓库 main 的 c99fad1 编的，也就是标签 v0.1.0-beta.2 指向的提交。这个安装包是官方版，另外带了闭源的 DJI 设备适配模块，免费使用。内置的 whisper.cpp 按 MIT 许可，见 THIRD-PARTY-NOTICES.md。名字和图标等品牌素材见 BRAND-LICENSE.md。

---

English

The second public beta of VoxPalm (掌声). Hold a key on a wireless mic or a remote and speak; when you let go, the text appears where your cursor is. It is still under development, so expect rough edges and bugs, and please report them in Issues.

The app's interface is in Simplified Chinese only for now, so the Chinese labels you will see on screen are given in parentheses below.

What's new in this release

• Built-in transcription now works on older systems too: whisper.cpp is built into VoxPalm, so macOS 14 and 15 no longer need Homebrew or command-line tools. The first time, open Settings (设置) › Voice (语音) and click Download (下载) on the whisper.cpp card to get a speech model: Balanced (均衡, 574 MB) by default on Apple silicon Macs, Small (小, 190 MB) on Intel Macs. The download shows progress and can be cancelled. Retry (重试) can resume an interrupted download within the current app session; after you quit VoxPalm, it starts over. The file is checked before use, and transcription then runs entirely on this Mac without going online.
• Chinese punctuation from whisper.cpp is now always full-width.
• The package no longer contains leftover local developer paths from the build.

What this release can do

• Hold to talk, release to type: hold a key on your control device and speak; when you let go, the text is pasted into the text field that had the cursor when you pressed the key. A key can also be set to start on one press and stop on the next. Recording starts the moment you press, but only counts once the press becomes a long press, and short presses are thrown away, so the first word is never cut off.
• Pastes only where it should: if you switched windows, the cursor is not in a text field, or the focus is in a password field, nothing is pasted; the text stays on the clipboard and the overlay tells you to press ⌘V. You can also have it press Return for you when you finish, which only happens when the text field has text in it.
• Two ways to get text: built-in transcription runs on this Mac and your voice is not uploaded; on macOS 26 and later it uses the system speech engine and shows the words in the overlay as you speak, and on older systems it uses the built-in whisper.cpp. Or choose External input method (外部输入法): VoxPalm holds your input method's voice key for you (tested with WeChat Input Method).
• Separate control and recording devices: control with a remote or the keyboard, record with another mic. If the selected mic gets muted while it is being used as a button (for example DJI Mic 2), recording switches to the Mac's microphone automatically.
• Several actions per key: the single press, double press and long press of each key can each be set to push-to-talk, a keyboard shortcut, a piece of text, a media key or opening an app. There is also an AI coding (AI 编程) preset: use the up and down keys to switch conversations in Claude and Codex, hold the confirm key to talk, and press it once to send. Start talking after an action (做完直接开始说话) and send when you finish (说完自动按回车发送) can be enabled separately for each key.
• Set up keys on a diagram: Settings show a diagram of your device; press a key on the real device and the matching key lights up. In daily use, each key press brings up a small card at the bottom of the screen saying what that press did.
• Guided first run: six steps to turn on permissions, pick devices, set your talk key and try a sentence on the spot.

Download and first launch

1. Download VoxPalm-0.1.0-beta.2.zip below, unzip it and drag the app (shown as 掌声) into your Applications folder. If you installed Public Beta 1, just replace it; your settings are kept.
2. This build is not notarized by Apple yet (the developer account is still being approved). The first time you double-click it, macOS says it cannot verify the developer; click Done.
3. Open System Settings › Privacy & Security, scroll to the bottom, click Open Anyway next to the message that 掌声 was blocked, enter your login password, then click Open Anyway once more. From then on it opens normally.
4. Follow the guide to turn on the Input Monitoring, Accessibility and Microphone permissions, pick a control device and a recording device, then press the key you want to talk with.
5. On macOS 14 and 15, the menu bar panel says the speech model has not been downloaded yet (还没下载语音模型); go to Settings (设置) › Voice (语音), click Download (下载), and you can start talking once it finishes.

System requirements

• macOS 14 or later, on Apple silicon and Intel Macs.
• Built-in transcription: on macOS 26 and later it uses the system speech engine, with nothing else to install; on macOS 14 and 15 it uses the built-in whisper.cpp, and you download a speech model in Settings (设置) › Voice (语音) the first time. Models come from whisper.cpp's official repository on Hugging Face, with the hf-mirror.com mirror as an automatic fallback when Hugging Face cannot be reached.
• You can also skip built-in transcription and use External input method (外部输入法) instead: VoxPalm holds your input method's voice key for you (tested with WeChat Input Method).

Devices

Device	Status
DJI Mic 2 (transmitter connected to the Mac directly over Bluetooth)	Tested: single presses of the record, link and power buttons; the buttons and the mic work at the same time; no double press; when its mic is silent, recording switches to the Mac's microphone
DJI Mic Mini	Not tested yet
System media keys, keyboard keys	Work as control keys
Xiaomi Bluetooth remote, Siri Remote, presentation clickers, foot pedals	Not tested one by one yet; try Learn key (学键) in Settings

Known limitations

• Not notarized, so you have to allow it with the steps above the first time.
• No auto-update yet; download new versions from this page.
• When DJI Mic 2 is used as both buttons and mic, its mic is sometimes muted; recording then switches to the Mac's built-in microphone.
• The built-in whisper.cpp has only been tested on macOS 27 on an Apple silicon Mac (with the transcription engine set to whisper.cpp by hand); it has not been tried on real macOS 14, 15 or Intel Macs yet, so please report any problems.
• The interface is in Simplified Chinese only for now.

License

The main app is open source under GPL-3.0-only. This package was built from commit c99fad1 on main, which is the commit the tag v0.1.0-beta.2 points to. It is the official build and also includes the closed-source DJI device adapter, free to use. The built-in whisper.cpp is under the MIT license; see THIRD-PARTY-NOTICES.md. Brand assets such as the name and icon are covered by BRAND-LICENSE.md.

---

安装包校验码 / Package checksum (SHA-256)：b2cefb7708cade35203fd3460dda2d0e4bac38fac902f87c5fa10aca61d9d075

掌声 VoxPalm 0.1.0 公开测试版 1 · Public Beta 1

English version below.

中文

测试版 1 的安装包已经撤下：包里还残留着编译时的开发者本机路径。请下载测试版 2，它包含这一版的全部功能，还内置了 whisper.cpp。

掌声 VoxPalm 的第一个公开测试版，给愿意尝鲜的人用。按住无线麦或遥控器上的键说话，松手后文字就出现在光标所在的地方。还在开发中，会有不顺手和出错的地方，欢迎到 Issues 反馈。

这一版能做什么

• 按住说话，松手出字：按住控制设备上的键说话，松手后字贴进按键那一刻光标所在的输入框；也可以设成按一下开始、再按一下结束。按下就开始录，长按成立才算数，短按自动丢掉，不吞第一个字。
• 只贴进对的地方：换了窗口、光标不在输入框里、焦点在密码框时都不贴，字留在剪贴板，浮窗提示按 ⌘V。可以设成说完自动按回车发送，只在输入框里有字时才按。
• 两种出字方式：内置转写在这台 Mac 上转，声音不上传；macOS 26 以上用系统转写，说话时浮窗里边说边出字。也可以选「外部输入法」，掌声替你按住输入法的语音键（微信输入法已实测）。
• 控制和收音分开选：用遥控器或键盘操作，用另一支麦收音。选的麦当按键用时会被静音的（比如 DJI Mic 2），录音自动改用 Mac 麦克风。
• 一个键多种用法：每个键的单击、双击、长按，可以设成按住说话、快捷键、一段文字、媒体键、打开 App。还有「AI 编程」预设：上下键切 Claude、Codex 的对话，确认键长按说话、单击发送；「做完直接开始说话」「说完自动按回车发送」可以按键单独勾选。
• 照着示意图设键：设置里画着设备的示意图，按一下实物上的键，图上对应的键会亮；平时按键时，屏幕下方弹一张小卡片，写着这一下做了什么。
• 第一次用有引导：6 步带你打开权限、选设备、设说话键，当场试说一句。

下载和第一次打开

1. 本版安装包已撤下，请改为下载测试版 2，并按测试版 2 的说明安装。以下保留本版发布时的安装步骤和系统要求，供查阅。
2. 这一版还没有经过苹果公证（开发者账号还在申请），第一次双击会提示无法验证开发者，先点「完成」。
3. 打开「系统设置 › 隐私与安全性」，拉到最下面，在「已阻止“掌声”」旁边点「仍要打开」，输入开机密码后再点一次「仍要打开」。之后就能正常打开了。
4. 跟着引导打开「输入监控」「辅助功能」「麦克风」三个权限，选控制设备和收音设备，再按一下想用来说话的键。

系统要求

• macOS 14 以上，Apple 芯片和 Intel 芯片的 Mac 都能用。
• 内置转写：macOS 26 以上用系统自带的转写，不用另装东西。macOS 14、15 暂时要先装 whisper.cpp（brew install whisper-cpp）并下载一个模型文件，再到「设置 › 语音」里选上；以后的版本会内置。
• 也可以不用内置转写，改用「外部输入法」：掌声替你按住输入法的语音键（微信输入法已实测）。

设备

设备	状态
DJI Mic 2（发射器蓝牙直连 Mac）	已实测：录制键、连接键、电源键单击，按键和收音可以同时用；做不了双击，它的麦没声音时录音自动改用 Mac 麦克风
DJI Mic Mini	待实测
系统媒体键、键盘按键	可以当控制键
小米蓝牙遥控器、Siri Remote、翻页笔、脚踏板	还没逐台实测，可以先用设置里的「学键」试试

已知限制

• 没有公证，第一次打开要按上面的步骤放行。
• 还没有自动更新，新版本要回这里下载。
• DJI Mic 2 同时当按键和麦时，它的麦有时会被静音，这时录音自动改用 Mac 自带麦克风。
• 界面目前只有简体中文。

许可

主程序按 GPL-3.0-only 开源。这个安装包是用仓库 main 的 a09af34 编的，比标签 v0.1.0-beta.1 只多了一处只影响调试版的改动。这个安装包是官方版，另外带了闭源的 DJI 设备适配模块，免费使用。名字和图标等品牌素材见 BRAND-LICENSE.md。

---

English

The Public Beta 1 download has been withdrawn: the package still contained leftover local developer paths from the build. Please get Public Beta 2, which includes everything in this release plus built-in whisper.cpp.

The first public beta of VoxPalm (掌声), for people who like to try things early. Hold a key on a wireless mic or a remote and speak; when you let go, the text appears where your cursor is. It is still under development, so expect rough edges and bugs, and please report them in Issues.

The app's interface is in Simplified Chinese only for now, so the Chinese labels you will see on screen are given in parentheses below.

What this release can do

• Hold to talk, release to type: hold a key on your control device and speak; when you let go, the text is pasted into the text field that had the cursor when you pressed the key. A key can also be set to start on one press and stop on the next. Recording starts the moment you press, but only counts once the press becomes a long press, and short presses are thrown away, so the first word is never cut off.
• Pastes only where it should: if you switched windows, the cursor is not in a text field, or the focus is in a password field, nothing is pasted; the text stays on the clipboard and the overlay tells you to press ⌘V. You can also have it press Return for you when you finish, which only happens when the text field has text in it.
• Two ways to get text: built-in transcription runs on this Mac and your voice is not uploaded; on macOS 26 and later it uses the system speech engine and shows the words in the overlay as you speak. Or choose External input method (外部输入法): VoxPalm holds your input method's voice key for you (tested with WeChat Input Method).
• Separate control and recording devices: control with a remote or the keyboard, record with another mic. If the selected mic gets muted while it is being used as a button (for example DJI Mic 2), recording switches to the Mac's microphone automatically.
• Several actions per key: the single press, double press and long press of each key can each be set to push-to-talk, a keyboard shortcut, a piece of text, a media key or opening an app. There is also an AI coding (AI 编程) preset: use the up and down keys to switch conversations in Claude and Codex, hold the confirm key to talk, and press it once to send. Start talking after an action (做完直接开始说话) and send when you finish (说完自动按回车发送) can be enabled separately for each key.
• Set up keys on a diagram: Settings show a diagram of your device; press a key on the real device and the matching key lights up. In daily use, each key press brings up a small card at the bottom of the screen saying what that press did.
• Guided first run: six steps to turn on permissions, pick devices, set your talk key and try a sentence on the spot.

Download and first launch

1. This download has been withdrawn. Get Public Beta 2 and follow its installation instructions instead. The original steps and requirements below are kept for reference.
2. This build is not notarized by Apple yet (the developer account is still being approved). The first time you double-click it, macOS says it cannot verify the developer; click Done.
3. Open System Settings › Privacy & Security, scroll to the bottom, click Open Anyway next to the message that 掌声 was blocked, enter your login password, then click Open Anyway once more. From then on it opens normally.
4. Follow the guide to turn on the Input Monitoring, Accessibility and Microphone permissions, pick a control device and a recording device, then press the key you want to talk with.

System requirements

• macOS 14 or later, on Apple silicon and Intel Macs.
• Built-in transcription: on macOS 26 and later it uses the system speech engine, with nothing else to install. On macOS 14 and 15 you currently need to install whisper.cpp (brew install whisper-cpp), download a model file and select it in Settings (设置) › Voice (语音); a later version will include it.
• You can also skip built-in transcription and use External input method (外部输入法) instead: VoxPalm holds your input method's voice key for you (tested with WeChat Input Method).

Devices

Device	Status
DJI Mic 2 (transmitter connected to the Mac directly over Bluetooth)	Tested: single presses of the record, link and power buttons; the buttons and the mic work at the same time; no double press; when its mic is silent, recording switches to the Mac's microphone
DJI Mic Mini	Not tested yet
System media keys, keyboard keys	Work as control keys
Xiaomi Bluetooth remote, Siri Remote, presentation clickers, foot pedals	Not tested one by one yet; try Learn key (学键) in Settings

Known limitations

• Not notarized, so you have to allow it with the steps above the first time.
• No auto-update yet; download new versions from this page.
• When DJI Mic 2 is used as both buttons and mic, its mic is sometimes muted; recording then switches to the Mac's built-in microphone.
• The interface is in Simplified Chinese only for now.

License

The main app is open source under GPL-3.0-only. This package was built from commit a09af34 on main, which differs from the tag v0.1.0-beta.1 only by one change that affects debug builds. It is the official build and also includes the closed-source DJI device adapter, free to use. Brand assets such as the name and icon are covered by BRAND-LICENSE.md.

---

SHA-256：e88e8821e2ee29287ad985b28bb17072c8c288eee23f3a01dcc1e9db5745b8d9

2026-10-22 重新上传过一次安装包：去掉了程序里残留的一条开发者本机路径，功能没有变化。之前下载的那份也能照常使用，只是校验码不同。

The package was re-uploaded once on 2026-10-22 to remove a leftover local developer path from the app; nothing else changed. A copy downloaded earlier still works, it just has a different checksum.

2026-10-22 撤下了安装包：重新上传的那份里仍有编译时留下的本机路径（在调试符号里，第一次没查出来），测试版 2 起打包时会去掉。已经下载的那份照常能用。

The package was withdrawn on 2026-10-22: the re-uploaded copy still contained local build paths (in the debug symbols, missed the first time); packages from Public Beta 2 on strip them. A copy you already downloaded keeps working.