繁體中文

為什麼 Mac 上的 Anki 手把偵測不到或無法使用

在 Mac App Store 下載 InputConfig這款 App 完全免費。不需要建立帳號。沒有訂閱，沒有麻煩的下載，也沒有任何鎖住的功能。針對 Apple 晶片最佳化。

幾乎每次的原因，都是遙控器在錯誤的模式，或是 Mac 上沒有任何東西把它的按鈕變成 Anki 的按鍵。Mac 上的 Anki 不會自己讀取手把。它需要 Contanki 外掛，或是像我做的免費 App InputConfig 這樣的全系統對應工具，它會送給 Anki 一般的按鍵。把遙控器調到手把模式，重新配對，然後兩者擇一使用，絕不要兩個一起用。

這一頁是依症狀整理的解法清單。至於配置本身，Anki 手把指南說明了每個按鈕，設定 Anki 遙控器則談到第一次配對。

步驟

  1. 把遙控器關機並設為手把模式：8BitDo Micro 用 D，Zero 2 則同時按住 A 和 Start。
  2. 在「系統設定」的「藍牙」中移除舊的項目，然後重新配對遙控器。
  3. 打開 InputConfig 的 Live Visualizer，按每一個按鈕，看看有什麼傳到 Mac。
  4. 啟用內建的 Anki 預設集，並開啟 Switch presets when the front app changes。
  5. 如果安裝了 Contanki，在 InputConfig 執行時把它關掉，或反過來。

把症狀對上解法

你看到的情況常見原因解法
Contanki 說 Controller not detected遙控器在鍵盤模式，或外掛看不到這個手把手把模式，或全系統對應工具
遙控器輸入字母或捲動卡片鍵盤模式，Micro 上的 K切換到 D 並重新配對
藍牙顯示已連接，Anki 卻沒反應沒有任何東西在對應它Contanki，或 InputConfig 的 Anki 預設集
每次按壓都算兩次同時有兩個對應工具關掉其中一個
有一個按鈕從來沒有作用手把自己留用，例如 D 模式下 Micro 的 Star改用別的按鈕
在 iPad 上有用，在 Mac 上沒用AnkiMobile 有自己的手把支援Mac 上的對應工具
macOS 更新後就停了Contanki 有人回報，沒有確認的解法先在 Live Visualizer 檢查，再試試全系統對應工具

請先找到你那一列，因為模式、配對和對應工具是三個不同的問題。

把遙控器調到手把模式

大多數 Anki 遙控器是小小的 8BitDo 手把，而它在每種模式下都是不同的裝置：

  • 8BitDo Micro。底部邊緣的開關有 S、D 和 K。D 是 InputConfig 讀得到的一般遊戲手把，S 讓它變成 Switch 手把，K 則讓它變成輸入固定字母的藍牙鍵盤。
  • 8BitDo Zero 2。它沒有開關。同時按住 A 和 Start 開機，進入它的 macOS 模式，配對時顯示為 Wireless Controller。改按 R 和 Start 開機，則會變成鍵盤。
  • 其他 8BitDo 手把。Pro 2 用 D。SN30 Pro 或 SN30 Pro+ 則同時按住 B 和 Start 開機。
InputConfig 的主視窗，有一則備註寫著偵測到處於 XInput 模式的 8BitDo 手把、該型號的解決方法，以及一個說明按鈕。
Figure 1. InputConfig 會指出處於 Mac 無法使用的模式的 8BitDo 手把，並說明該選哪個模式，這是 Anki 遙控器看起來沒反應時，最先該檢查的地方。

鍵盤模式對 Anki 不是錯的，只是另一條路：它輸入的字母是 8BitDo 決定的，很少符合 Anki 的 Space 和 1 到 4。要用你自己的配置，請使用手把模式，並且在配對之前就設定好。

移除遙控器並重新配對

在某個模式下配對過的遙控器，到了另一個模式會顯示為新的裝置，而舊的項目會礙事。

  • 你：打開「系統設定」的「藍牙」，移除遙控器，用你選的模式開機，並進入配對模式。Micro 要按住 Pair 三秒，Zero 2 則按住 Select 三秒。
  • macOS：列出遙控器，附有 Connect 按鈕。
  • 確認：它顯示為已連接，而且遙控器上的燈停止閃爍。

如果仍然配對不上，請充電、讓它靠近 Mac，並確認它沒有還跟附近的 Switch 或手機配對著。較舊的手把可能需要用 8BitDo 的 Upgrade Tool 更新韌體。Zero 2 的 USB 連接埠只用來充電和更新韌體，所以它只透過藍牙連接。每次改變模式，都要忘記舊的項目。

當 Contanki 說 controller not detected

Contanki 是在 Anki 內部讀取手把的免費外掛，當它找不到時，會說 Controller not detected。Anki 論壇上有幾則 Mac 上的回報。其中一則 2025 年 9 月 8 日的 Zero 2 討論串，是在鍵盤模式配對的遙控器。另一則2025 年 9 月 28 日的，是 MacBook 上的 Zero 2，重設外掛並買了新遙控器之後仍然如此。第三則2025 年 9 月 29 日的，是 PS5 手把在 macOS 更新後偵測不到。我在 2026 年 10 月 27 日讀取它們時，除了設定指南和聯絡外掛作者之外，沒有一則有確認的解法。

有兩條出路：

  • 給 Contanki 一個手把。處於鍵盤模式的遙控器就是鍵盤，所以外掛沒有東西可偵測。切換到手把模式並重新配對。
  • 跳過 Anki 裡的偵測。全系統對應工具讀取手把，並送給 Anki 一般的按鍵，所以 Anki 看到的永遠只是鍵盤。InputConfig 就是這樣運作，而同一個手把還能操作牌組清單、瀏覽器和 Mac 的其餘部分。

如果你試用 InputConfig，那個工作階段請把 Contanki 關掉。兩個對應工具同時運作，會讓每次按壓都回應兩次，看起來像遙控器壞了。

在 Live Visualizer 看 Mac 聽到什麼

在改變其他任何東西之前，先找出遙控器的按壓到底有沒有傳到 Mac。

  • 你：在 InputConfig 裡打開 Anki 預設集，並在 Live Visualizer 開啟的情況下，按遙控器上的每個按鈕。
  • InputConfig：在手把的圖上，讓每個傳到的控制項亮起。
  • 確認：一直沒有亮起的控制項，就是沒有傳到 Mac，所以請檢查連線和模式開關。如果遙控器根本不在側邊欄裡，請在選單列的 InputConfig、Devices 下勾選它。
InputConfig 內建的 Anki 預設集，Live Visualizer 的對照表在四個正面按鈕上標出 Again、Hard、Good 和 Easy。
Figure 2. Live Visualizer 中的 Anki 預設集。在這裡讓按鈕亮起的按壓，就是已經傳到 Mac，所以剩下的問題出在預設集或 Anki，不在藍牙。

處於 D 模式的 Micro 會把 Star 按鈕留給自己，當作它自己的連發鍵，所以 Star 永遠不會亮起，也無法綁定。那是手把本身的特性，不是故障。會亮起的就能綁定，不會亮起的就是連線或模式的問題。

開啟 Anki 預設集並保持開啟

InputConfig 內建 Anki 預設集，在 Built-in Presets、Desktop & Productivity 下。A / Cross 送出 Space，先顯示答案，再評為 Good。X / Square 送出 1 代表 Again，B / Circle 送出 2 代表 Hard，Y / Triangle 送出 4 代表 Easy，左肩鍵復原，右肩鍵重播音訊。

InputConfig 編輯器中開啟的 Anki 預設集，四個正面按鈕分別送出 Space、1、2 和 4，左肩鍵送出 Command Z，右肩鍵送出 R。
Figure 3. Anki 預設集的各列。如果某一列評了錯誤的答案，請在那一列按下 Scan 並按下你要的按鈕，該列就會移過去。

如果遙控器會亮但 Anki 沒反應，照這個階梯走，從最小的一步開始：

  1. 把 Anki 帶到最前面。按鍵會送給最前面的 App，所以被其他 App 擋住的複習視窗什麼都收不到。
  2. 檢查預設集正在執行。預設集頁面上的按鈕在執行時會顯示 Deactivate。在 Settings、Advanced 中開啟 Switch presets when the front app changes，這樣已經在預設集清單中的 Anki，就會自己開啟它。
  3. 檢查權限。InputConfig 需要「系統設定」的「隱私權與安全性」中的「輔助使用」。選單列圖示變成橘色，表示預設集正在等待它。
  4. 檢查 Anki 自己的按鍵。如果你改過 Anki 的答案快速鍵，請重新對那些列按 Scan，然後按下你的新按鍵。

要讓大按鈕代表 Hard 或 Again 而不是 Good，免費的 Anki Spacebar Binder 外掛可以改變答案面上 Space 的作用。

如果 Mac 重新啟動或遙控器一直斷線

會斷線的遙控器，通常是電池、它仍與另一台裝置配對，或是手把在一段時間沒有輸入後自己關機，當你在難的卡片上停頓時，這就像是斷線。請充電、取消它與附近其他任何東西的配對，然後重新配對。

Mac 重新啟動則是另一回事。2025 年 8 月的一則論壇討論串描述一台 macOS 15.6.1 的 MacBook Air M3，每當 8BitDo Micro 以 D 模式透過藍牙連接時就會重新啟動，當機記錄指向 Apple 處理輸入裝置的一個程序。更新韌體沒有阻止它，我讀取時那個討論串沒有確認的解法。對應工具治不了這個問題，因為它發生在任何 App 之下。如果手把能用傳輸線連接，就用傳輸線試試，也試試另一支手把，並把當機記錄回報給 Apple。在你處理的期間，PS5、PS4、Xbox 或 Switch Pro 手把，或單支 Joy-Con，都能執行同一個 Anki 預設集。

InputConfig 做不到的事

  • 阻止鍵盤模式遙控器的字母。它監聽鍵盤，但不會擋住或重新對應按鍵，所以在鍵盤模式下，每個字母仍然會傳到 Anki。與 InputConfig 搭配時，請使用手把模式。
  • 讀取手把自己留用的按鈕。D 模式下 Micro 的 Star，永遠不會回報給 Mac。
  • 在 iPad 上執行。InputConfig 是 Mac App。在 iPad 上，AnkiMobile 有自己的手把支援。
  • 修好藍牙當機。發生在 App 之下的重新啟動，要交給 Apple 和手把的製造商處理。

簡短版

  • 模式。Micro 用 D，Zero 2 用 A 和 Start，然後忘記並重新配對。
  • 檢查。在 Live Visualizer 中按每個按鈕。一直沒有亮起的控制項，就是沒有傳到 Mac。
  • 對應。啟用內建的 Anki 預設集，並開啟自動切換。
  • 只用一個對應工具。Contanki 或 InputConfig，絕不兩者一起用。

請從模式開關開始，因為它解釋了大多數看起來沒反應的 Anki 遙控器。

常見問題

為什麼 Anki 說 controller not detected？

這個訊息來自 Contanki 外掛。常見的原因是遙控器在鍵盤模式配對，對 Mac 來說它是鍵盤，所以沒有手把可以偵測。把它切換到手把模式並重新配對，或使用像 InputConfig 這樣的全系統對應工具，它會送給 Anki 一般的按鍵。

為什麼我的遙控器輸入字母，而不是評分卡片？

它在鍵盤模式，也就是 8BitDo Micro 上的 K，輸入的是 8BitDo 的字母。把它切換到 D，重新配對，並啟用 InputConfig 的 Anki 預設集，它會送出 Space 和 1 到 4。

我需要 Karabiner-Elements 嗎？

只有在你把遙控器維持在鍵盤模式，又想更改它輸入的字母時才需要。在手把模式下，由 InputConfig 或 Contanki 做對應，與 Karabiner-Elements 無關。

Anki 遙控器能搭配 InputConfig 在 iPad 上使用嗎？

不能。InputConfig 是 Mac App。iPad 上的 AnkiMobile 有自己的手把支援，這就是為什麼遙控器可以在那裡用，在 Mac 上卻不行。

我需要外掛嗎？

不需要。InputConfig 送出的是一般的按鍵，這就是 Anki 所需要的全部。Contanki 是外掛的路線，兩者都可行，但不能同時使用。

更多中文頁面

詳細指南（英文）

作者說明。Ryleigh Newman 開發了 InputConfig，因為雙手活動不便，每天都用手把操作自己的 Mac。本頁譯自英文。Mac 的語言設為繁體中文時，App 的主要按鈕和選單會顯示為中文，本頁使用這些名稱，並在括號中附上英文名稱。App 的其他部分和網站的其他頁面都是英文。

本頁的其他語言版本： English, Deutsch, Español, Français, Italiano, 日本語, 한국어, Polski, Português, Русский, ไทย, 简体中文

在 Mac App Store 下載 InputConfig免費。macOS 14 或以上版本。不需要帳號，資料不會離開你的 Mac。 原始碼在 GitHub 上.