語音命令

圖片採用英文標示，說明操作流程與資料路徑；實際介面以目前 App 與 macOS 為準。

語音命令使用獨立的命令熱鍵（預設 滑鼠中鍵）。辨識語音後，可先匹配本機使用者詞典，未命中再呼叫已啟用且可用的意圖模型，最後執行允許的動作。語音辨識是否聯網取決於所選輸入模型；本機詞典只讓命令解析免於大模型請求。

操作流程圖：使用者詞典、意圖模型與執行能力 — 使用者詞典、意圖模型與執行能力（操作流程圖）

總開關

路徑：設定 → 語音命令 → 啟用語音命令，預設開啟。

關閉後，命令熱鍵、歷史再執行與命令 Deeplink 都不能啟動命令管線，語音輸入與翻譯仍可使用。現有配置會保留，但下方執行能力、詞典與意圖模型設定會隱藏；先重新開啟總開關才能修改。

執行能力

在 執行能力 中點選卡片允許或禁止動作類型。限制同時適用於詞典與意圖模型。

卡片	用途	預設
允許熱鍵	向前台 App 注入快捷鍵；可設定危險熱鍵確認	開
允許文字輸入	在游標處插入文字	開
允許懸浮回答	顯示模型生成的回答	開
允許選區改寫	用意圖模型改寫選中文字；需要試用 / Pro 與可用模型	開；受授權限制
允許打開應用 / 檔案 / URL	打開 App、檔案、網址或系統設定	開
允許快捷指令	執行 Shortcuts.app 中已有的快捷指令	開
允許系統控制	音量 / 亮度、媒體、鎖屏 / 休眠、計時器、視窗、提醒與日程	開

目前沒有 Shell 執行能力。打開終端 App 只會打開應用；執行工作流請用已有快捷指令，見終端命令現狀。

系統控制與可選權限

自然語言系統操作通常由試用 / Pro 的意圖模型解析，例如「把視窗移到左半邊」或「明天提醒我交周報」。手動詞典編輯器沒有系統動作選項，但符合條件的成功動作可自動學習。

視窗操作需要輔助使用，並取決於目標視窗是否支援調整。創建提醒事項或行事曆日程時，macOS 會按需請求對應的完整訪問權限；拒絕會使該動作失敗，不必為普通聽寫授予這兩項權限。提醒與日程寫入系統的預設可用清單 / 行事曆，可能按你的系統帳號設定同步。指令片語中明確說明標題與時間，執行後到對應 App 確認結果。

自訂命令詞典

打開 設定 → 語音命令 → 自訂命令詞典：

輸入一個或多個短語（可用逗號等分隔）。
動作選擇：快捷鍵、插入文字、打開應用 / URL、打開檔案、快捷指令。
指定文字、快捷鍵、目標路徑或快捷指令名稱；打開檔案可用「選擇…」。
App Bundle ID 留空為全局，指定後只在該 App 前台時生效。
可編輯、啟用 / 停用或刪除項目；可篩選手動與自動學習項目。

項目保存在本機偏好中，沒有隨應用啟用的內建目錄、命令包或起步預設。可照命令參考自行添加示例。

匹配與快速通道

先精確匹配，再嚴格模糊匹配。每輪順序為：App 手動 → App 自動學習 → 全局手動 → 全局自動學習，只考慮已啟用且動作被允許的項目。

優先本機命令詞典 預設開啟，詞典命中時跳過意圖模型。多次成功執行相同的模型指令片語與符合條件的動作後，可生成帶閃電標記的自動學習項目；問答與選區改寫不參與自動學習。可在詞典中管理這些項目。「0ms」指省去大模型呼叫的快速路徑，不是麥克風到動作的實測總耗時。

意圖模型

試用 / Pro 專屬；Free 僅可用本機命令詞典。開啟且配置成功後，未匹配的指令片語可以交給雲端 BYOK 或已安裝的本機 Spark-X2.5 模型。

意圖模型可與「文字處理」同步服務商、模型與端點；關閉同步後獨立設定。同一服務商的 Key 共用。選區改寫也使用意圖配置並受同一授權門檻約束；潤色 / 翻譯位於文字處理頁。僅本機模式阻止公網意圖模型，請用本機模型或迴環端點。

歷史中的解析來源

詞典（localRegistry）：手動或自動學習使用者項目都使用這個來源。
意圖模型（llm）：由雲端或本機大模型解析。
手動（manual）：手動動作來源。

自動學習標記用於詞典管理，不是第四種歷史解析來源。詳見歷史記錄。

朗讀與播報

在 設定 → 語音命令 → 朗讀與播報 中分別設定完整問答自動朗讀與操作結果播報。操作播報預設關閉；改寫結果使用手動朗讀。聲音與語速不依賴自動朗讀開關，均使用本機系統語音。

依語言選擇聲音，可先試聽；本文分段比對語言。原有聲音偏好只遷移到對應語言，未安裝的聲音自動回退並提示。
浮動視窗可暫停、繼續或停止朗讀；進度選單提供重新朗讀、上一段和下一段。朗讀保留本文與連結文字，省略程式碼、公式和網址。
開始新錄音、關閉或切換回答、插入文字時停止朗讀；睡眠及預設輸出裝置變更也會停止，避免意外恢復播放。