VokeLine 發生問題時，先找到與畫面訊息或症狀最接近的項目，再依序檢查。先儲存或複製仍可看到的文字，不要一開始就重新安裝、清除資料或反覆重新產生結果。
安裝與更新
安裝包無法開啟
- 確認來自下載頁，符合平台與架構，而且下載已完成。
- 重新下載目前版本。系統攔阻時，核對來源並依正常安裝、開啟提示處理。
- macOS 確認程式已放入應用程式；Linux AppImage 確認允許作為程式執行。
- 未提供適用安裝包時，請聯絡支援，不要改用另一平台的版本。
恢復後依快速開始準備模型。平台與架構供應情況以下載頁目前顯示為準。
更新檢查失敗或沒有新版本
到設定 → 軟體更新，檢查網路後重試。沒有新版本時繼續使用目前版本；下載或安裝失敗則保留可用程式，依提示重試。更新前先完成錄音或檔案工作，以免中斷。
模型與下載
已下載，卻仍提示沒有模型
在模型頁確認支援目前工作、檔案檢查完成，再點選使用。錄音需要錄音轉錄能力，檔案需要檔案轉錄能力；確認對應預設標記已出現。完整步驟見模型管理。
下載暫停、失敗或檢查未通過
- 暫停時先恢復網路並繼續下載；檢查磁碟空間與下載大小。
- 失敗可重試；檔案不完整、損壞或無法讀取時依提示重下。
- 要刪除使用中的模型重下，先改用另一可用模型，完成錄音或轉錄後再刪除原版本。
記憶體不足時，先關閉耗用記憶體的程式，或選擇裝置能執行的模型。處理器不符需求時依卡片更換模型，反覆下載無法解決硬體限制。
離線時無法下載
離線不能下載新模型或續傳；已安裝且可用的本機模型仍可處理錄音與檔案。AI、搜尋及雲端操作需要網路，請分別檢查。
麥克風與錄音
找不到裝置或沒有聲音
- 連接麥克風，檢查實體靜音和系統輸入音量。
- 在設定 → 語音與快捷鍵重新開啟裝置清單，選擇目前可用輸入；拔除舊裝置後不要沿用失效選擇。
- 使用測試麥克風，靠近說幾句話。10 秒內會自動完成，不存測試錄音。
- 權限不足時進入系統麥克風設定；允許後再測試，仍不可用可重新開啟程式。
偵測到聲音後再試短錄音。入口和各平台設定，見檢查麥克風。
沒有文字或辨識錯誤
確認模型支援你使用的語言、選取的麥克風可正常運作，並減少環境噪音後再試一次。錄音會自動辨識語言；檔案轉錄則僅在模型支援時，才能指定音訊語言。變更介面語言不會改變辨識語言。若要用其他語言解釋、摘要或擷取要點，請選擇對應的 AI 操作並設定輸出語言。音訊語言只用來告訴模型要辨識哪一種語言。
快捷鍵與直輸
快捷鍵沒有反應
- 到設定 → 語音與快捷鍵，確認註冊成功或是否顯示占用、衝突及不可用。
- 有衝突時換組合鍵，等儲存成功後回目標程式測試。
- Linux 可能限制全域按鍵，媒體鍵也可能被系統或其他程式占用。先用首頁或浮動麥克風確認基本錄音正常。
- 開啟了不同模式時，確認使用的是指定模式快捷鍵，還是採用預設模式的按鈕或媒體入口。
各平台初始值與設定，見快捷鍵與耳機按鍵。
直輸沒有寫入或要求先選欄位
先點選可編輯的目標欄位並放好游標，再使用直輸快捷鍵。程式等待選擇目標時，依提示點選；錄音期間保持該位置，不切換視窗或欄位。
需要權限時使用直輸系統權限管理；macOS 檢查輔助使用權限。目標程式不接受寫入時，先用編輯模式檢查並複製貼上，保留文字後再排查。
Esc 沒有立刻隱藏視窗
Esc 依狀態先關閉彈出視窗或返回原文，再處理收合。要隱藏或結束，使用對應入口；錄音與儲存提示先完成。見停止、收合、隱藏與結束。
檔案轉錄
無法加入檔案或開始轉錄
確認格式為 WAV、MP3、FLAC、OGG、M4A、MP4，檔案不為空且不超過 2 GB，每次不超過 100 個。移除不合要求的檔案，確認已選擇可用檔案模型及音訊語言。
檔案重新命名、移動、被外部修改或待選清單失效後，要重新選擇。副檔名符合卻無法讀取時，確認能否播放、是否有音軌，以及是否損壞。
工作失敗、中斷或沒有文字
- 查看提示，先解決模型、檔案與系統資源問題。
- 失敗工作可重新轉錄；先前中斷時，重新啟動所需工作。
- 完成卻沒有文字時，檢查音訊有沒有清楚語音，再用正確語言與合適模型重試。
取消工作只在適用狀態提供，清理已完成只整理工作清單，不取代歷史刪除。見音訊檔案轉錄。目前不支援說話者區分。
AI 與點數
提示需要登入或點數不足
確認目前帳戶與可用點數。需要購買時開啟個人中心，完成後核對點數明細，再回桌面等資訊更新；點數可用且模型可用後，再執行。
本機轉錄成功，不代表 AI 的登入、連線與點數條件都已滿足；AI 模型和錄音模型是不同設定。
模型不可用、文字太長或處理失敗
- 在 AI 操作頁選擇目前可用模型並儲存。
- 縮短或分段處理超限文字，再查看點數提示。
- 網路中斷、限流或服務繁忙時稍後再試；仍處理或核對中則先等狀態更新。
- 結果已顯示時，請先複製保留。「重試」會嘗試恢復原本的請求；「重新執行」會開始新操作，可能再次使用點數。
步驟與語言規則，見AI 文字操作。點數變化不明時查看明細並回報，不要以連續重新產生測試是否恢復。
登入與紀錄
Google 登入沒有回到程式
確認預設瀏覽器可開登入頁，並在同一流程完成帳戶選擇。出現返回 VokeLine 提示時依提示開啟；取消或逾時後再從選單開始。網路或 Google 暫時不可用時，先處理原因，或用選單實際提供的其他方式。
工作階段被替換或恢復失敗
同帳戶在另一端的新登入會替換目前工作階段。選擇本次要用的一端重新登入，避免兩邊互相替換。恢復失敗先重試，仍失效則重新登入。見登入與工作階段。
登入後找不到原本的本機歷史
確認紀錄屬於訪客、目前帳戶還是其他帳戶，也確認產生在同一裝置。本機歷史依身分與裝置分開；切換只會改變目前顯示的本機紀錄，不自動移轉。跨裝置前需先儲存到雲端。
雲端筆記沒有出現或儲存失敗
確認帳戶相同、曾主動儲存且網路可用，再重新整理，查看未分類與對應標籤。後續清單失敗時保留已載入內容並重試；達上限先刪除不需要的紀錄或標籤。
編輯衝突時保留草稿，與最新內容比較。本機與雲端刪除互不替代；不可復原的清理範圍，見清理紀錄。
支援與意見回報
入口： 從桌面的「帳號」選單開啟「個人中心」，再進入網站的「協助與意見回饋」；需要時先登入。
- 說明程式版本、作業系統、功能、操作方式、預期結果與實際情況。
- 附上完整提示；模型問題補充模型名稱，檔案問題補充格式與大小，點數問題補充訂單或明細時間。
- 截圖先遮蔽不必要的信箱、個人文字與付款資料，不要傳密碼、登入權杖或服務金鑰。
- 在同一回報查看回覆並補充資料，避免為同一問題重複建立。
送出前先把可見文字複製到安全位置。儲存失敗或處理狀態未確認時，保留資料，依提示處理後再重試。