Guru
免費 · 開源 · LGPL-3.0

用你已有的 iPhone 當 Anki 遙控器

掃 QR 碼 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)…——會顯示一個 QR 碼。
    • 在 Guru 裡: 設定 → Anki 遙控器 → 配對 Mac——掃碼即可。
    搞定。在 Mac 上開啟任意牌組,iPhone 立即接手。

實際設定截圖

照著這些截圖走：先在 Anki Desktop 安裝外掛並重新啟動，再開啟 QR code 配對視窗，最後用 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 顯示 QR code

重新開啟 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 上的 QR code，即可完成連線。

可遙控的操作

顯示答案翻當前卡片。
重來 / 困難 / 良好 / 簡單完整四檔評分。
重播音訊適用於有媒體的牌組。
復原回退上一次評分。

硬體手把支援

把手把插到 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 本身保持閉源。

原始碼 & 支援