支援與常見問題

從第一次設定到錄音完成後的排除方式，都整理在這一頁。

第一次使用

先建立語音轉錄 API Key，可選擇 OpenAI 或 Groq。若要使用文字整理，再建立 OpenAI 或 Gemini API Key。詳細方式請看 API Key 教學。
打開聲筆主 App，進入「設定 → API 管理」，貼上所選服務商的 API Key 並儲存。
留在「設定」分頁，在「語音轉錄設定」選擇服務商與模型，並在「處理模式」選擇是否使用文字整理 API。
前往「iPhone 設定 → 一般 → 鍵盤 → 鍵盤 → 新增鍵盤」，選擇「聲筆 Wa-Gong」。
在鍵盤清單點進「聲筆 Wa-Gong」，開啟「允許完整取用」。
回到聲筆主 App，第一次準備語音輸入時，依系統提示允許使用麥克風。
在備忘錄、訊息或其他文字欄位切換到聲筆鍵盤，點擊麥克風並依畫面指示完成第一次語音輸入。

iOS 需要使用者主動開啟「允許完整取用」，鍵盤才能與聲筆主 App 共用語音工作階段、處理模式與完成結果。API Key 仍保存在主 App 的 iOS Keychain，不會顯示在鍵盤中。聲筆不使用自有伺服器代送語音或文字內容。

iOS 自訂鍵盤不能直接錄音，因此麥克風由聲筆主 App 使用。聲筆會在你第一次準備語音輸入時要求權限，不會在剛開啟 App 時一次要求所有權限。

為什麼要手動滑回原本的 App？

iOS 自訂鍵盤不能直接存取麥克風，因此錄音由主 App 執行。系統不保證鍵盤可以自動把你帶回原本的 App，所以目前流程是開啟主 App 準備錄音，再手動滑回原本的 App，回到鍵盤後開始錄音。

錄音完成後沒有插入文字，怎麼辦？

找不到聲筆鍵盤或允許完整取用，怎麼辦？

先前往「iPhone 設定 → 一般 → 鍵盤 → 鍵盤 → 新增鍵盤」，加入「聲筆 Wa-Gong」。加入後回到鍵盤清單，點進「聲筆 Wa-Gong」，就能看到「允許完整取用」開關。

不小心拒絕麥克風權限，怎麼重新開啟？

前往 iPhone「設定」，找到「聲筆 Wa-Gong」，開啟麥克風權限，再回到主 App 重新準備語音輸入。

停止錄音後，多久會出現文字？

停止錄音後，聲筆會先完成語音轉錄。若目前處理模式開啟「使用文字整理 API」，還會依序完成文字整理；若關閉，會直接使用轉錄結果，因此少一次網路請求，通常能更快插入。實際時間仍會受到錄音長度、所選模型、服務商回應速度與網路狀況影響。

ChatGPT 或 Gemini 訂閱可以直接使用嗎？

不行。ChatGPT 訂閱、Gemini 服務訂閱與各自的 API 都是分開計費的服務。聲筆 Wa-Gong 需要你自行建立並設定對應的 API Key，API 費用由你選擇的服務商依 API 帳戶收取。

完整版與免費體驗怎麼計算？

每個本機安裝提供成功文字整理輸出累計 10,000 字的完整流程體驗。完整版為一次買斷，正式價格 NT$990，首發上架日起 1 個月優惠價 NT$590，優惠結束後恢復 NT$990。語音轉錄與文字整理的 API 費用不包含在買斷價格內。

如何恢復購買？

在 App 的「設定」中找到「完整版」，點擊「恢復購買」。請使用購買時相同的 Apple 帳號。Apple 退款或撤銷交易後，完整版權益會依 Apple 回傳的交易狀態重新判斷。

如何刪除最近轉錄？

在 App 設定中可以選擇最近轉錄保留數量，也可以選擇「不保留」。最近轉錄頁面也提供逐筆刪除與全部清除。API Key 則可從「API 管理」個別清除。

請寄信至 wa-gong@jackie-yeh.com。如果可以，請附上 App 版本、iPhone 型號、iOS 版本、使用的服務商與錯誤畫面。請不要把 API Key 寄在信件中。