DJI Mic Command

把 DJI 无线麦克风接收器上的连接键变成 macOS 的右 Command 键。适合配合闪电说、Typeless 等语音输入工具，把麦克风拿在手里，用一个实体按键开始/停止语音识别。

Turn the DJI Wireless Mic receiver button into the macOS Right Command key. It is designed for voice input apps such as Shandianshuo and Typeless, especially when you prefer holding the mic in your hand instead of clipping it on your collar.

下载 / Download

推荐直接下载：

• DJI-Mic-Command.zip
• 或在 GitHub Releases 页面下载最新版本

解压后会看到：

• DJI Mic Command Installer.app：双击安装
• DJI Mic Command Uninstaller.app：双击卸载
• README.md：离线说明

用途 / What It Does

DJI Wireless Mic Rx 接收器会把连接键上报为音量键。这个工具用 macOS 自带的 hidutil，只针对 DJI 接收器做设备级映射：

• DJI 连接键 -> 右 Command
• DJI 音量键原始行为会被替换，不再调系统音量
• 不改普通键盘、鼠标或其他设备
• 不读取麦克风音频内容
• 不联网

This tool uses the built-in macOS hidutil command to map only the DJI receiver's consumer-key event to Right Command. It does not record audio, does not connect to the internet, and does not remap your normal keyboard.

适用场景 / Use Cases

• 闪电说：把开始/停止录音快捷键设置成右 Command
• Typeless：把语音输入触发键设置成右 Command
• 其他支持自定义快捷键的听写、转写、AI 输入工具

核心使用方式：

1. 手持 DJI 麦克风。
2. 打开语音输入工具。
3. 按一下 DJI 连接键开始。
4. 再按一下 DJI 连接键停止。

这个项目的前提很明确：有些人不喜欢把麦克风夹在领子上，手持麦克风更自然，也更像一个随身语音遥控器。

兼容性 / Compatibility

当前已测试设备：

• Product: Wireless Mic Rx
• VendorID: 0x2ca3
• ProductID: 0x4011
• macOS: Apple Silicon Mac, macOS 15

如果你的 DJI 接收器型号不同，可能需要重新捕捉 VendorID/ProductID 或按键 usage。仓库里保留了 dji-mic-mapper 的源码，可用于调试 HID 事件。

安装 / Install

1. 下载并解压 DJI-Mic-Command.zip。
2. 双击 DJI Mic Command Installer.app。
3. 如果 macOS 提示无法验证开发者，右键点击 App，选择“打开”。
4. 插上 DJI 接收器。
5. 在闪电说、Typeless 或其他工具里，把快捷键设置为右 Command。

安装后会创建当前用户的 LaunchAgent：

~/Library/LaunchAgents/com.dji-mic-command.right-command.plist

它会在登录后自动运行，并且每 30 秒重新应用一次映射。这样重启、重新登录、拔插接收器后，映射也会自动恢复。

卸载 / Uninstall

双击：

DJI Mic Command Uninstaller.app

它会停止 LaunchAgent、清除 DJI 接收器映射，并删除本项目写入的用户目录文件。

安全软件说明 / Security Notes

这个工具没有 Apple Developer ID 公证，所以 macOS 或安全软件可能会提示拦截。

如果你使用 360、腾讯电脑管家、CleanMyMac、Little Snitch 或其他安全软件，允许以下行为：

• 运行 /usr/bin/hidutil
• 运行 /bin/launchctl
• 在当前用户目录创建：
  • ~/Library/LaunchAgents/com.dji-mic-command.right-command.plist
  • ~/Library/Application Support/DJI Mic Command/apply-map-quiet.sh

它不需要这些权限：

• 不需要麦克风权限
• 不需要辅助功能权限
• 不需要网络权限
• 不需要管理员密码

源码结构 / Project Layout

DJI-Mic-Command.zip                  # 可直接分发的安装包
DJI Mic Command/                     # 解压后的 App 包
share/                               # App 打包源目录
apply-map-quiet.sh                   # 静默应用映射
install-hidutil-map.sh               # 手动安装映射
uninstall-hidutil-map.sh             # 手动清除映射
status.sh                            # 检查本机状态
dji_mic_mapper.c                     # HID 事件监听/调试工具源码
build.sh                             # 编译调试工具

开源许可 / License

MIT License. See LICENSE.