聲筆 Wa-Gong App 圖示聲筆 Wa-Gong

支援與常見問題

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

第一次使用

本文依 App Store 1.7.0 整理。請先下載或更新聲筆，再設定 API Key。

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

為什麼需要這兩項權限

允許完整取用

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

麥克風

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

常見問題

為什麼有時會自動返回，有時要手動切回？

iOS 自訂鍵盤不能直接錄音，需先由主 App 準備。聲筆會對固定支援清單嘗試自動返回，可能需按系統「打開」。返回後，來源與工作階段符合條件時會嘗試自動錄音；未開始時請點麥克風。其他情況請手動切回。原草稿、畫面與游標是否保留由來源 App 決定。

錄音完成後沒有插入文字，怎麼辦？
  • 確認錄音結束時仍在原本的文字欄位。
  • 確認鍵盤有開啟「允許完整取用」。
  • 若處理模式選擇文字服務商整理，確認對應的 OpenAI、Gemini 或 Claude API Key、服務商與模型設定有效。
  • 回到主 App 查看錯誤訊息或最近轉錄，必要時使用複製功能手動貼上。
找不到聲筆鍵盤或允許完整取用，怎麼辦？

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

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

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

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

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

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

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

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

每個本機安裝提供成功產生文字累計 10,000 字體驗，不是每日額度。台灣 App Store 於 2026 年 10 月 17 日查核的完整版價格為 NT$990，一次買斷，解除 App 體驗字數限制；付款以 App 內當下價格為準。語音轉錄與文字整理的 API 費用不包含在買斷價格內。

轉錄失敗，還需要重新錄音嗎？

1.7.0 新增「保留錄音與原稿」。有效錄音會先保存，失敗後可回主 App 手動重送；已有完整辨識原稿時，可以只重試文字整理，或直接使用原稿。App 重開不會自行重送，恢復結果也不會自動插入，請手動使用文字。重試可能再次產生 API 費用。

保留內容達 20 筆或音訊合計 256 MB 時會暫停新增，已錄下內容優先保留；成功後清除音訊。請在恢復清單手動刪除不需要的內容，清除最近轉錄不等於刪除保留錄音。

自動學習會讀取其他 App 的所有文字嗎？

不會。此功能預設關閉，須在自訂詞彙設定主動啟用。只在聲筆能確認來源與修改範圍時記住符合條件的短詞修正，不在背景監聽其他鍵盤，不保存整段上下文，也不保證每次修改都學到。可撤銷、停用及篩選自動加入的詞；啟用詞會依服務能力用於後續辨識或文字整理。

可以不連網，或使用 Apple 雲端 AI 嗎？

目前需要網路與所選服務商的 API Key。本機模型研究及 Apple Private Cloud Compute 均未接入正式流程，不會在失敗時自動改用它們。

文字試跑免費，為什麼 API 還有費用？

試跑不扣聲筆的 10,000 字體驗額度，但內容與提示詞仍送到你選擇的文字服務，使用你自己的 API Key 計費。App 免費與 API 免費是不同的額度。

如何恢復購買？

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

如何刪除最近轉錄？

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

回報問題

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

相關頁面：API Key 教學、隱私權政策。