常見問題與疑難排解

當主流程已經清楚，但某一個環節仍然卡住時，先從這裡查。

我應該安裝哪個桌面端建構？

• 大多數使用者應該安裝最新發佈版本，可以從 桌面端下載 或 GitHub Releases 選擇，不要從原始碼建構開始。
• 依自己的作業系統、CPU 架構和安裝格式選擇對應建構。
• 原始碼建構與開發指令請參閱 專案 README。

Sona 一直提示我完成首次設定

• 打開提醒橫幅，將模型和麥克風步驟完成。
• 如果之前跳過了引導，請確認 設定 > 模型設定 中已經設定好 即時錄音模型 和 批次轉錄模型。
• 如果曾主動關閉提醒橫幅，請在 Sona 再次提示時從相關入口重新進入引導。

下載推薦模型 失敗，或者一直無法完成

• 保持 Sona 開啟，並確保網路穩定；推薦模型包較大，下載和解壓縮都需要時間。
• 檢查剩餘磁碟空間；如果引導被中斷，可以之後到 設定 > 模型設定 重試或重新設定。
• 如果多次停住，先打開 診斷 查看模型下載或本機執行時的提示，再重試。

模型已經下載，但 Sona 仍提示缺少

• 打開 設定 > 模型設定，確認對應欄位已經選取：即時轉錄用 即時錄音模型，檔案轉錄用 批次轉錄模型。
• 確認模型資料夾仍保留解壓縮後的檔案；下載後移動或重新命名資料夾會讓 Sona 找不到原路徑。
• 如果模型是在 Sona 外部下載的，請在 設定 > 模型設定 手動選擇，不要只依賴首次設定狀態。

即時錄音 無法開始

• 檢查系統麥克風權限。
• 確認已經設定 即時錄音模型。
• 確認目前輸入來源是否正確： 麥克風 或 系統音訊。

即時錄音 能開啟，但仍聽不到麥克風

• 打開 設定 > 輸入裝置，選擇您真正想讓 Sona 使用的麥克風。
• 檢查系統麥克風權限，並確認沒有其他應用程式獨佔這個裝置。
• 如果目前輸入來源是 系統音訊，先切回 麥克風 驗證輸入路徑。
• 如果裝置選擇看起來正確但 Sona 仍提示沒有輸入，打開 診斷 查看本機音訊和轉錄狀態。

在哪裡查看本機轉錄診斷？

• 打開 設定 > 常規，進入 診斷。
• 它可以協助檢查本機轉錄就绪狀態、模型路徑、輸入裝置狀態和打包執行環境。
• 尋求協助時，優先提供可見的診斷提示或錯誤訊息，而不是只描述症狀。

批次轉錄 無法開始

• 確認已經設定 批次轉錄模型。
• 確認檔案副檔名屬於支援格式。
• 如果 Sona 提示格式不支援，請先轉換檔案格式再重試。

LLM 潤飾 或 翻譯 不可用，或者執行失敗

• 確認 設定 > LLM 服務 中已經填寫正確的 provider 認證憑證。
• 確認功能本身已經繫結模型：潤飾需要 潤飾模型，翻譯需要 翻譯模型。
• 先使用 測試連線 驗證連通性。
• 如果您使用自訂介面位址或本機服務，例如 Ollama，請先確認該服務本身可存取。

找不到 Auto-Polish

• 打開 LLM 潤飾 > 進階設定，在那裡可以設定 Auto-Polish、頻率、關鍵詞、場景預設和自訂上下文。
• 如果您想先理解這些入口各自負責什麼，繼續參閱 詞彙與進階設定。

匯出時只有 原文

• 只有目前轉錄已經包含翻譯文字時，譯文 和 雙語 才會出現。

說話者校對 是空的，或者沒有候選人

• 說話者校對 依賴目前轉錄已有的說話者元資料。如果這份轉錄沒有說話者歸屬資訊，清單可能為空。
• 候選建議取決於 設定 > 詞彙 中的 說話者檔案、已匯入的參考樣本、已設定的說話者模型，以及目前專案啟用了哪些檔案。
• 只要編輯器中已經顯示說話者徽章，您仍然可以點擊它並手動繫結檔案。

找不到 版本快照

• 版本快照 只會出現在已經儲存到工作區、且包含轉錄分段的條目上。
• 暫時的 current 轉錄和仍在進行中的即時錄音草稿不會顯示這個入口。
• Sona 會在 LLM 潤飾、翻譯、重新轉錄 等批次改寫前，以及從其他快照復原前建立快照。

復原備份後能看到文字，但沒有音訊播放

• 備份封存刻意保持輕量，只包含設定、工作區、輕量歷史轉錄與摘要、自動化狀態，以及儀表板 LLM 使用記錄。
• 原始音訊檔案不會進入備份，因此復原後的條目可能可以閱讀和編輯，但除非音訊透過其他路徑可用，否則不會顯示播放功能。

為什麼新內容會先進入 Inbox

• Inbox 是錄音和匯入內容的預設承接位置，專門用來存放尚未分配到專案的內容。
• 如果您希望新內容自動留在某個專案裡，請先打開該專案，再開始 即時錄音 或 批次轉錄。
• 如果內容已經進入 Inbox，您之後仍然可以在 工作區、專案與 Inbox 中將它移動到目標專案。

刪除專案後，裡面的內容會怎樣

• 刪除專案只會移除專案本身，不會刪除專案裡的錄音或匯入內容。
• Sona 會將這些內容移回 Inbox，您之後仍然可以繼續使用或重新分配它們。

為什麼我還在錄音時就看到了一個 草稿 條目

• 即時錄音進行中時，Sona 可能會先建立一個可見的 草稿 條目，讓這次工作階段提前在 工作區 裡佔好位置。
• 當您停止錄音後，Sona 會直接完成這條草稿，而不是再額外建立第二條記錄。
• 在收錄中，請將這條草稿理解為目前即時工作階段；錄音結束後，正式轉錄仍然會從同一入口繼續使用。

即時字幕 沒有顯示出來

• 請先回到 即時錄音 頁面，確認已經打開 即時字幕；設定 > 字幕設定 只負責視窗行為和外觀，不負責啟動入口。
• 如果您只是想顯示系統音訊字幕，不必先開始錄音，直接開啟 即時字幕 即可。
• 即時字幕 依賴同一套離線即時轉錄能力，因此也需要先設定可用的 即時錄音模型。
• 如果您想先釐清 即時錄音 頁面開關和字幕設定之間的區別，繼續參閱 即時字幕與語音輸入法。

語音輸入法無法工作

• 先在 設定 > 語音輸入法 中啟用 語音輸入法。
• 確認頁面上的快速鍵、模型、VAD、輸入裝置與就緒狀態都符合預期。
• 語音輸入法依賴同一套離線即時轉錄能力，因此也需要先設定可用的即時轉錄模型。
• 如果您還沒決定該用 按住說話 還是 切換模式，繼續參閱 即時字幕與語音輸入法。

去哪裡復原中斷的批次處理或自動化任務

• 如果 Sona 提示有待復原條目，請先打開頂部通知中心。
• 使用 復原中心 繼續或捨棄中斷的批次處理與自動化任務。
• 如果您實際要找的是診斷或備份入口，請前往 設定 > 常規。

看不到播放控制項

• 只有當目前轉錄關聯了音訊來源時，底部播放器才會顯示，例如已儲存的錄音條目或已處理完成的檔案。

我想從原始碼建構或參與開發

• 請查看 專案 README 中的原始碼建構與開發指令說明。
• 如果只是正常使用 Sona，請優先安裝發佈版本；原始碼建構主要面向貢獻者和開發偵錯。