Guru
免费 · 开源 · LGPL-3.0

用你已有的 iPhone 当 Anki 遥控器

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

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 → 重放 · ZU → 撤销

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

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

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

方案价格适用范围最适合
你的 iPhone(Guru)免费手机 → Anki Desktop,走 Wi-Fi随时随地复习——还能驱动 AnkiMobile 拒绝配对的 8BitDo 手柄
游戏手柄 + 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 遥控器 & 手柄指南

每种方案的分步教程:

源码 & 支持