部落格

在 Mac 的 Cursor 中使用語音輸入而不破壞程式碼

了解如何在 Mac 版 Cursor 中口述提示詞,分開自然語言與精確程式碼,補充上下文,並在 Agent 執行前完成檢查。

作者 tsuvic發佈 約 2 分鐘

TalkTalkType 目前只支援英文和日文聽寫。此譯文用於介紹產品,並不表示已經支援中文聽寫。

在 Cursor 中,語音輸入最適合說明意圖、限制條件、故障現象和預期結果。程式碼、檔案路徑、識別符、命令和完整錯誤訊息則更適合手動輸入或貼上,因為這些內容通常不能容忍任何字元錯誤。

更可靠的做法是混合輸入:先把游標放在 Cursor 的聊天輸入框,用自然語言說明問題,再透過 Cursor 的上下文功能加入準確技術資料,最後在送出前檢查完整提示詞。

口述問題,手動輸入程式碼

語音適合解釋為什麼需要修改。你可以說明目前行為、目標行為、不能改變的條件、已經嘗試的方法和驗收標準。這些背景通常比一句簡短命令更有價值。

檔案路徑、函式名稱、套件版本、正規表示式、Shell 命令、環境變數、堆疊資訊和必須編譯通過的程式碼,應當輸入或貼上。一個字元錯誤就可能指向錯誤檔案,或改變命令的實際作用。

例如,可以口述:“登入回呼在本機成功,但部署後失敗。保留現有工作階段格式,不要修改資料庫結構。”接著貼上準確錯誤,並把相關函式和測試加入上下文。

在撰寫與執行之間保留檢查步驟

Cursor 的官方快捷鍵文件把聊天輸入與送出、排隊、接受、拒絕和執行產生結果分開。快捷鍵也可以重新映射,因此不同安裝環境的操作可能不完全相同。

在執行任何動作前結束錄音。放開錄音快捷鍵,確認文字進入正確輸入框,刪除重複表達,並確認焦點仍在目標位置。完成這些檢查後再送出。

要求移轉、相依套件變更、刪除、終端命令或大範圍重構時,這一步尤其重要。語音應該加快指令撰寫,而不是取消 Agent 行動前的審核邊界。

使用 Cursor 自己的功能補充上下文

長篇說明不能取代精確上下文。Cursor 可以把選取的程式碼、檔案、剪貼簿內容和其他參照加入聊天。不同模式的權限也不同:Agent 可以探索、編輯和執行工具,Ask 更適合唯讀調查。

用語音表達任務目標和判斷標準。用程式碼選取、檔案參照、日誌貼上和模式選擇,控制提供給 Cursor 的證據與權限。

如果原因尚未明確,先在 Ask 中調查。等目標修改和邊界清楚後,再切換到 Agent。

把長提示詞拆成短小區塊

技術提示詞可以分為問題、預期行為、限制條件、相關檔案和驗證方法。

每次只口述一個區塊。標題、準確檔名、命令和測試名稱應手動輸入。這樣比一段連續轉寫更容易發現遺漏,也能避免重要例外埋在長段落末尾。

例如,“驗證:執行現有身分驗證測試,不更新快照”就提供了清楚的完成標準。

在說出專案細節前檢查隱私設定

Cursor 說明,AI 請求會經過 Cursor 後端。其目前資料使用文件表示,啟用 Privacy Mode 後,客戶資料不會用於訓練,並與模型供應商採用零資料保留安排,但仍受文件列出的安全例外約束。免費和付費使用者都可以使用 Privacy Mode。

這不代表任何內容都適合口述。不要說出密鑰、API 金鑰、存取權杖、生產環境憑證、客戶隱私資料,或組織政策禁止傳送給 AI 的原始碼。

語音輸入工具在文字到達 Cursor 前也會處理音訊與轉寫。應分別評估語音輸入路徑和 Cursor 請求路徑。

把 TalkTalkType 當作輸入層

TalkTalkType 會在按住 Option-Space 時錄音,並把結果傳回原本取得焦點的輸入框。在 Cursor 中,草稿可以直接留在目前聊天,不必經過獨立的轉寫編輯器。

Clean 會在保留含義和語氣的前提下輕度整理自然語言,Raw 會保留更多原始轉寫。兩種模式都不應猜測程式碼或修正識別符。請在口述後加入準確技術資料,並在送出前檢查組合後的提示詞。

在任意 Mac 應用程式中使用聽寫介紹了焦點輸入框傳遞和剪貼簿備用路徑。

當解釋成為瓶頸時使用語音

在 Cursor 中,語音輸入最有價值的情境是補充上下文:為什麼問題重要,哪些部分不能改變,以及如何驗證結果。

如果任務主要是語法,請手動輸入。口述推理,輸入準確字元,附上證據,並在送出前檢查。這樣的分工能更快建立完整提示詞,同時避免讓 Agent 猜測關鍵細節。

部落格