上手指南 · 约 5 分钟

第一次真实发送成功,才算准备好。

按下面的顺序完成权限、连接和真实输入测试。不要只停在“手柄已连接”,整条语音工作流通过才算完成配置。

开始前准备

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

步骤 1

允许辅助功能

辅助功能用于把 Joy-Con 操作发送为你配置的快捷键。JoyHarness 不申请输入监控权限。

辅助功能执行你配置的系统快捷键

步骤 2

连接任意一只 Joy-Con

  1. 打开“系统设置 → 蓝牙”。
  2. 让 Joy-Con 进入配对状态,并在设备列表中完成连接。
  3. 回到 JoyHarness,确认连接页显示手柄名称和电量,并且「按键响应」一栏是绿色的「正在响应」。

一只就够。 左手柄或右手柄都能独立完成整套语音工作流;连接一对只是增加可用按键,并非前提。

JoyHarness 连接页面显示左右 Joy-Con 已连接
连接页同时显示电量、后台服务和按键响应状态。

步骤 3

亲自跑通一次语音输入

  1. 打开任意文本输入框,让光标保持聚焦。
  2. 按一下右手柄 ZR,它会发出 fn,启动你的语音输入工具。
  3. 说一句完整的话,确认整理后的文字出现在输入框中。
  4. 按一下 A,确认发送或换行行为符合当前应用预期。

需要边说边出文字时,长按 + 触发 ⌥ A,进入豆包连续听写。

默认右手柄语音按键

ZR 单击fn · 启动语音输入
+ 长按⌥ A · 豆包连续听写
A 单击 · 确认发送
JoyHarness 右 Joy-Con 按键映射页面
按键页一次显示一只手柄。每个按键可以只做一件事,也可以按一下和按住分别做不同的事。

看到这三个结果,配置才算完成

  • 连接页显示 Joy-Con 已连接,「按键响应」是「正在响应」
  • ZR 后,语音工具能在真实输入框中生成文字
  • A 后,当前应用正确执行确认发送或换行