Guru
免费 · 开源 · LGPL-3.0

用你已有的 iPhone 当 Anki 遥控器

扫码 10 秒把 iPhone 和 Anki Desktop 配对,然后在沙发上、跑步机上、任何地方按 显示答案 / 重来 / 困难 / 良好 / 简单。把廉价 8BitDo 手柄插到手机上,信号通过手机转发到 Mac——AnkiMobile 拒绝识别的小手柄,在这里能用。

下载于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 → 撤销

键盘模式是让廉价 8BitDo 手柄能用的关键——这些小手柄不暴露 Apple 的 GCExtendedGamepad profile,所以 AnkiMobile 拒绝识别。Guru 同时监听 GCKeyboard,正好对接 8BitDo 的「键盘模式」输出。

隐私

  • 仅限局域网。 配对令牌从不离开你本地的 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 本身保持闭源。

源码 & 支持