裝不起來的時候

按鈕一直是「準備中…」，按不下去

安裝程式要先從網路載入幾個模組，載完按鈕才會變成可按。正常幾秒內完成。

• 等 10 秒。還是「準備中…」代表模組載入失敗了。
• 重新整理頁面（Ctrl+Shift+R）。
• 如果你的網路有擋外部網域，模組是從 esm.sh 來的，要放行。

按了安裝，沒有跳出選擇裝置的視窗

• 看網址列右邊有沒有被擋掉的圖示——瀏覽器可能把視窗擋住了。
• 確認瀏覽器是 Chrome、Edge 或 Opera。
• 這一頁必須是 https:// 開頭（或 localhost）。 用 file:// 直接開本機檔案是不行的，瀏覽器不給 USB 權限。

視窗跳出來了，但清單裡沒有頭盔

這幾乎一定是這三個原因之一：

• 開發者模式沒開。最常見。
• 線只能充電。換一條。
• 有別的程式佔住頭盔了。SideQuest、Meta Quest Developer Hub、 Android Studio，或任何背景在跑的 adb。全部關掉再試。

如果你電腦上有 adb，在命令列跑 adb kill-server 再試一次。它會在背景獨佔頭盔的介面，瀏覽器就搶不到。

卡在「USB 已開啟，等待頭盔回應偵錯授權…」

戴上頭盔看畫面。那個授權視窗只出現在頭盔裡，電腦螢幕上看不到。 它會顯示一串 RSA 金鑰指紋，問你要不要允許。

• 看到的話：勾「一律允許從這部電腦」，按「允許」。
• 頭盔螢幕是黑的：戴上去讓它醒過來，視窗才會顯示。
• 等太久會顯示逾時訊息，按「重新開始」再試一次即可。

頭盔裡根本沒跳出那個授權視窗

• 到頭盔的設定 → 系統 → 開發人員，確認「USB 偵錯」是開的。 關掉再打開一次通常有效。
• 把 USB 線拔掉重插。
• 把瀏覽器整個關掉（所有視窗，不只那個分頁）再開。 瀏覽器連過頭盔之後不會馬上放掉，只關分頁沒有用。

下載很慢

APK 大約 40 MB，放在 GitHub Pages 上，實測大概每秒 500 KB 左右， 也就是一分多鐘。慢是正常的，不是壞掉。

為什麼不放在更快的地方：APK 原本放在 GitHub 的 release 附件，那裡快得多， 但那個位置不允許網頁去讀取（瀏覽器的跨來源限制），所以只能搬到這裡。

下載失敗，或中途斷掉

• 按「重新開始」重試。下載會從頭來過。
• 中途不要讓電腦睡著。
• 一直失敗的話，可以到 GitHub Releases 直接下載 APK，用 SideQuest 之類的工具安裝。

安裝失敗，訊息裡有 SIGNATURE 或 UPDATE_INCOMPATIBLE

你的頭盔上已經有一個用不同金鑰簽署的舊版——例如你以前自己建置過， 或從別的地方裝過。Android 不允許用不同金鑰覆蓋安裝。

安裝器會偵測到這種情況並問你要不要移除舊版。移除會連同已下載的語音模型 一起刪掉（約 226 MB），裝好之後可以在頭盔裡重新下載。

裝好了，但打字時看不到這個鍵盤

• 安裝器會嘗試自動啟用。沒成功的話，在頭盔裡打開注音輸入法 App， 按「開啟鍵盤設定」，把它打開。
• 啟用之後還要選用它：App 裡有「切換輸入法」按鈕， 或在輸入文字時從系統的鍵盤切換選單選。
• App 首頁會顯示目前狀態（「已啟用」與「目前選用」兩行），照著看就知道卡在哪一步。

語音輸入沒反應，或收不到聲音

• 打開 App，確認「麥克風權限」是「是」。不是的話按 「允許使用麥克風」。
• 確認「語音模型」顯示已安裝。沒有的話按「下載語音模型」（226 MB，要 Wi-Fi）。 模型沒裝的話，它聽得到你講話但不會出字。
• App 裡有「麥克風測試」按鈕，會用四種錄音方式各錄三秒並量音量， 可以確認麥克風本身有沒有在收音。
• 講話時跟平常一樣就好，不用刻意大聲或靠近。

語音會吃掉最後一個字

講快的時候比較容易發生。句尾稍微停頓半秒再放開可以明顯改善。 這是辨識模型分段解碼的特性，我們還在調整，不是你的操作有問題。

我想確認下載到的是正確的檔案

latest.json 裡有這一版的版本號、檔案大小與 SHA-256。 你可以自己下載 APK 之後比對雜湊值：

• Windows：certutil -hashfile VRTwKeyboard.apk SHA256
• macOS／Linux：shasum -a 256 VRTwKeyboard.apk