开始之前
- 一台 macOS 13 或更新版本的 Mac
- 已经下载装好 JoyHarness。安装包过了 Apple 公证,双击就能打开
- 至少一只有电的 Nintendo Switch Joy-Con
- 一个能用快捷键叫起来的语音输入工具(豆包、Typeless 这类都行)
- 先去那个工具的设置里,把启动快捷键改成 fn —— JoyHarness 只负责把 fn 发出去,谁来接是那个工具自己的事
步骤 1
允许「辅助功能」
这是 macOS 里「允许一个 App 替你按键」的开关。不开它,手柄按了也没反应。JoyHarness 不要「输入监控」权限,也不监听你的键盘。
辅助功能替你按下你配的那些快捷键
步骤 2
连上任意一只 Joy-Con
- 打开「系统设置 → 蓝牙」。
- 按住手柄侧面滑轨上的小圆钮,直到指示灯来回闪,然后在设备列表里点「连接」。连上时手柄会震一下。
- 回到 JoyHarness,看连接页上有没有手柄的名字和电量,「按键响应」那一栏是不是绿色的「可以用了」。
一只就够。 左手柄或者右手柄,单独一只就能走完整套;连一对只是多几个键可用,不是前提。

步骤 3
在练习对话里练两轮
引导的最后一步是一段练习对话,只有当前要按的键起作用,说的话不用和示例一字不差。
- 第一轮:X 把光标放进输入框,ZR 说一句(按一下开始,再按一下结束),A 发出去。
- 第二轮:+ 粘贴,按住 B 删掉多余的一截,按住 A 换行(震一下就松手),再说一句,发出去。
练完之后,在任何输入框里都是这一套。

想边说边出字的话,长按 + 会发出 ⌥ A,进豆包的连续听写。
右手柄上最常用的三个键
ZR 按一下fn · 开始说话
+ 按住⌥ A · 豆包连续听写
A 按一下↩ · 发出去

看到这三样,才算装好
- 连接页显示手柄已连接,「按键响应」是「可以用了」
- 按 ZR 之后,语音输入真的在框里打出了字
- 按 A 之后,当前这个 App 真的发送了,或者正确换了行