上手指南 · 大概 5 分钟

看到字真的发出去了,才算装好。

开权限、连手柄、练两轮。App 第一次打开会带你按这个顺序走,这页是同一套步骤的文字版。

开始之前

  • 一台 macOS 13 或更新版本的 Mac
  • 已经下载装好 JoyHarness。安装包过了 Apple 公证,双击就能打开
  • 至少一只有电的 Nintendo Switch Joy-Con
  • 一个能用快捷键叫起来的语音输入工具(豆包、Typeless 这类都行)
  • 先去那个工具的设置里,把启动快捷键改成 fn —— JoyHarness 只负责把 fn 发出去,谁来接是那个工具自己的事

步骤 1

允许「辅助功能」

这是 macOS 里「允许一个 App 替你按键」的开关。不开它,手柄按了也没反应。JoyHarness 不要「输入监控」权限,也不监听你的键盘。

辅助功能替你按下你配的那些快捷键

步骤 2

连上任意一只 Joy-Con

  1. 打开「系统设置 → 蓝牙」。
  2. 按住手柄侧面滑轨上的小圆钮,直到指示灯来回闪,然后在设备列表里点「连接」。连上时手柄会震一下。
  3. 回到 JoyHarness,看连接页上有没有手柄的名字和电量,「按键响应」那一栏是不是绿色的「可以用了」。

一只就够。 左手柄或者右手柄,单独一只就能走完整套;连一对只是多几个键可用,不是前提。

JoyHarness 连接页面,显示左手柄已连接、电量和常用按键
连接页上同时能看到电量、常用按键,以及现在按下去有没有反应。

步骤 3

在练习对话里练两轮

引导的最后一步是一段练习对话,只有当前要按的键起作用,说的话不用和示例一字不差。

  1. 第一轮:X 把光标放进输入框,ZR 说一句(按一下开始,再按一下结束),A 发出去。
  2. 第二轮:+ 粘贴,按住 B 删掉多余的一截,按住 A 换行(震一下就松手),再说一句,发出去。

练完之后,在任何输入框里都是这一套。

练习对话的第一轮:输入框里是刚说的一句话,手柄上 A 键亮起,提示按一下发出去
每一步的说明贴在输入框上方,眼睛不用离开正在打字的地方。

想边说边出字的话,长按 + 会发出 ⌥ A,进豆包的连续听写。

右手柄上最常用的三个键

ZR 按一下fn · 开始说话
+ 按住⌥ A · 豆包连续听写
A 按一下↩ · 发出去
JoyHarness 按键页面,显示右手柄每个键现在绑的是什么
按键页一次看一只手柄。每个键可以只干一件事,也可以按一下和按住分别干两件事。想改哪个,点哪个。

看到这三样,才算装好

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