Guru
免费 · 开源 · LGPL-3.0

用你已有的 iPhone 当 Anki 遥控器

扫码 10 秒把 iPhone 和 Anki Desktop 配对,然后在沙发上、跑步机上、任何地方按 显示答案 / 重来 / 困难 / 良好 / 简单。把廉价 8BitDo 手柄和手机配对,它就能通过 Guru 驱动桌面版 Anki——不用 Contanki,不用 Karabiner,也不用来回切模式。

下载于App Store 在 AnkiWeb 查看
iPhone showing the Show Answer button while a MacBook in the background runs Anki — connected wirelessly

配置(3 步,大约 1 分钟)

  1. 在 Mac 上: 打开 Anki, 选择 工具 → 插件 → 下载插件…, 输入这个代码:
    1196082853
    重启 Anki。第一次启动时 macOS 会弹「允许传入连接吗?」——点 允许。
  2. 在 iPhone 上: 从 App Store 安装 Guru。
  3. 配对:
    • 在 Anki 里: 工具 → 连接手机(Flashcard Guru Remote)…——会显示一个二维码。
    • 在 Guru 里: 设置 → Anki 遥控器 → 配对 Mac——扫码即可。
    搞定。在 Mac 上打开任意牌组,iPhone 立即接管。

真实配置截图

按这些截图里的流程走：先在 Anki Desktop 里安装插件并重启，再打开二维码配对窗口，最后用 Guru 扫码连接。

Anki 工具菜单中选中插件
1 打开 Anki 插件管理

在 Mac 上打开 Anki，选择 工具 → 插件。

Anki 插件窗口中点击下载插件并输入代码 (1) Anki 插件窗口中点击下载插件并输入代码 (2)
2 输入插件代码

点击 下载插件…，输入 1196082853，然后确认。

Anki 插件安装成功提示
3 重启 Anki

安装成功后重启 Anki，Flashcard Guru Remote 会出现在工具菜单里。

Anki 工具菜单中选中连接手机 (1) Anki 工具菜单中选中连接手机 (2)
4 在 Mac 上显示二维码

重新打开 Anki，选择 工具 → 连接手机（Flashcard Guru Remote）…。

Guru 设置页面中的 Anki Remote 入口
5 在 iPhone 打开 Anki Remote

在 Guru 中进入 设置 → Anki Remote。

Guru Anki Remote 页面中的 Pair with Mac
6 与 Mac 配对

点击 Pair with Mac，扫描 Mac 上的二维码，连接完成。

可遥控的操作

显示答案翻当前卡片。
重来 / 困难 / 良好 / 简单完整四档评分。
重放音频适用于有媒体的牌组。
撤销回退上一次评分。

硬件手柄支持

把手柄插到 iPhone 上(USB-C 或蓝牙),Guru 把按键转发给 Anki Desktop:

游戏手柄(MFi)

  • A → 良好 · B → 重来 · X → 困难 · Y → 简单
  • R1 → 显示答案 · L1 → 重放 · Options → 撤销

键盘模式(8BitDo Zero 2 / micro / 外接键盘)

  • 1 / 2 / 3 / 4 → 重来 / 困难 / 良好 / 简单
  • Space → 显示答案 · R → 重放 · Z 或 U → 撤销

Guru 读取 Apple 的 GCExtendedGamepad profile——8BitDo Zero 2 在 Mac 模式(A+START)下、Micro 在 S mode 下都会暴露这个 profile;同时 Guru 也监听 GCKeyboard 的 1–4、Space、R 和 Z/U 键,所以改键到这些按键的手柄同样能用。(AnkiMobile 也能在手柄模式下配合数字十字键使用同样的手柄;这里的区别是 Mac 上什么都不用配置。)第一次用手柄?看 Contanki 配置指南 了解怎么用手柄控制桌面版 Anki,或者看 在 Mac 上连接 Anki 遥控器。

最好的 Anki 遥控器:哪种方案适合你?

并不存在唯一的「最好的 Anki 遥控器」——只有四种各有取舍的方案,哪种胜出取决于你在哪里复习。下面对比手机遥控、游戏手柄、廉价 8BitDo 手柄和专用硬件遥控器在纯打分场景下的表现:

方案价格适用范围最适合
你的 iPhone(Guru)免费手机 → Anki Desktop,走 Wi-Fi随时随地复习——还能驱动 8BitDo 手柄,Mac 上什么都不用装
游戏手柄 + Contanki已有手柄则免费仅限 Anki Desktop完整桌面控制:鼠标、菜单、逐屏按键映射
8BitDo 手柄,键盘模式~$20任意设备,包括 iPhone 和 iPad最便宜的口袋遥控器
专用遥控器(StudyRemote & 同类)~$30–40任何能读取 Bluetooth 键盘的设备单一用途的小工具,无需任何配置

每种方案映射的都是同一组按键——重来 / 困难 / 良好 / 简单 加上 显示答案——所以按价格和复习场景来选,而不是功能。已经有手柄了?先用免费的 桌面版 Contanki,或者直接在这里把手机当遥控器用。

隐私

  • 仅限局域网。 配对令牌从不离开你本地的 Wi-Fi。插件会拒绝来自非私网 IP 的连接作为安全检查。
  • 无遥测。 没有分析、没有远程日志、不上传你的牌组或卡片。
  • 随时可撤销。 在 Anki 配对对话框里「忘记」这台 iPhone,令牌立即失效。

常见问题

这个能配合 AnkiMobile(官方 iOS Anki app)使用吗?
不能。这是 Guru 的伴侣——我们独立的 iOS 卡片应用。插件通过 WebSocket 和 Guru 通信,不和 AnkiMobile 通信。
为什么不像 StudyRemote 那样直接做蓝牙键盘?
iOS 不允许第三方应用作为蓝牙 HID 外设——这是 Apple 平台级限制,不是某个 app 能绕开的。所以我们走 Wi-Fi WebSocket,达到同样的复习操控效果。
能在 Windows 或 Linux 上用吗?
应该可以——Python 插件本身跨平台——但我们只在 macOS 上做主动 QA。最低支持 Anki 2.1.55+(Qt6 版本)。
怎么更新插件?
Anki Desktop 自动检查插件更新。工具 → 插件 显示版本号,检查更新 从 AnkiWeb 拉取新版。
iOS app 是开源的吗?
插件开源,采用 LGPL-3.0: jyehn/flashcard-guru-remote-addon。iOS app 本身保持闭源。

Anki 遥控器 & 手柄指南

每种方案的分步教程:

源码 & 支持