AI 工具速查

Windsurf 指令大全

Windsurf 指令大全把 Cascade、Command、Terminal 控制、Rules / Memories、Code Lenses 與 Smart Paste 集中整理，方便 coding workflow 直接速查。

100 個指令 8 個分類 更新：2026-06-21

TL;DR

如果你只是想先上手，先記 `Cmd/Ctrl+L` 開 Cascade、`Cmd/Ctrl+I` 開 Command、`@terminal`、`Turbo mode`、`windsurf.cascadeCommandsAllowList`、`Smart Paste`。這頁再把 Rules、Memories、Code Lenses 與進階控制補齊。

目錄：8 個分類

常見比較

Windsurf vs Cursor 兩者都偏 IDE-first，但 Windsurf 更強調 Cascade / Command / terminal handoff；Cursor 更成熟於多檔編輯與 @ context。 Windsurf vs GitHub Copilot Copilot 更深綁 GitHub 與多 surface；Windsurf 更像 agentic IDE workflow。

鍵盤快捷鍵 7

Keyboard Shortcuts

Windsurf / Devin Desktop 主要快捷鍵。

Cmd/Ctrl+L
基礎
開啟 Cascade 開啟 Cascade，並自動帶入目前 editor 或 terminal 的選取內容。
Cmd/Ctrl+I
基礎
開啟 Command 在編輯器中用自然語言直接生成或修改程式碼。
Cmd/Ctrl+Enter
基礎
提交 Command 指令 在 Command 視窗內送出自然語言指令。
Cmd/Ctrl+Shift+A
基礎
開啟 Chat 面板 開啟 chat panel，並在 editor 與 chat 之間切換焦點。
Cmd+Option+V / Ctrl+Alt+V
進階
Smart Paste 將剪貼簿內程式碼轉換成目標語言後貼入目前檔案。
Cmd+Enter
基礎
接受生成結果 在 Command 生成完成後，將建議寫回編輯器並關閉 popup。
Cmd+Backspace
進階
撤銷生成結果 還原到 Command 生成前的狀態，並保留剛剛的指令以便 follow-up。

Cascade 與 Chat Context 3

Cascade & Chat Context

把 editor、terminal 與 chat context 串起來的高頻入口。

Terminal selection + Cmd/Ctrl+L
基礎
送 terminal 片段到 Cascade 在 terminal 選取 stack trace 後送進 Cascade，作為下一個 prompt 的 context。
@terminal
基礎
在 Cascade 中引用 terminal 讓 Cascade 直接理解目前 active terminals 與內容。

規則與記憶 2

Rules & Memory

Memories、Rules 與可持續客製化行為。

Rules
進階
Rules 使用規則系統來限制或引導 Cascade / Command 的行為。
Memories
進階
Memories 把穩定偏好或工作流存成記憶，降低每次重複說明的成本。

Command / Cascade 模式 21

Command & Cascade Modes

Command、Cascade、Chat 模式與各自適合的任務。

Cascade Code mode
基礎
Code 模式 適合要 Claude/Devin 主動改程式碼、呼叫工具與執行步驟時使用。
Cascade Chat mode
基礎
Chat 模式 適合先討論、分析與規劃，不急著直接改檔。
Command (file-scoped edits)
基礎
Command 單檔編輯 最適合做 file-scoped、inline 的自然語言修改，不消耗 premium credits。
請修正目前檔案，並說明你改了什麼。
基礎
修正：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請修正選取的程式碼，並說明你改了什麼。
基礎
修正：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請修正這段 terminal error 與相關程式碼，並說明你改了什麼。
基礎
修正：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請修正整個 workspace 的關聯與結構，並說明你改了什麼。
基礎
修正：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請修正目前函式或 class，並說明你改了什麼。
基礎
修正：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請修正這份 stack trace 與上下文，並說明你改了什麼。
基礎
修正：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。
請針對目前檔案提出 3 步驟實作計畫。
基礎
做計畫：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請針對選取的程式碼提出 3 步驟實作計畫。
基礎
做計畫：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請針對這段 terminal error 與相關程式碼提出 3 步驟實作計畫。
基礎
做計畫：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請針對整個 workspace 的關聯與結構提出 3 步驟實作計畫。
基礎
做計畫：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請針對目前函式或 class提出 3 步驟實作計畫。
基礎
做計畫：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請針對這份 stack trace 與上下文提出 3 步驟實作計畫。
基礎
做計畫：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。
請根據目前檔案推測 root cause。
進階
除錯：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。
請根據選取的程式碼推測 root cause。
進階
除錯：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。
請根據這段 terminal error 與相關程式碼推測 root cause。
進階
除錯：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。
請根據整個 workspace 的關聯與結構推測 root cause。
進階
除錯：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。
請根據目前函式或 class推測 root cause。
進階
除錯：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。
請根據這份 stack trace 與上下文推測 root cause。
進階
除錯：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

Terminal Control 10

Terminal Control

Terminal 裡的 Command、Turbo mode、allow/deny list。

Terminal Command (Cmd/Ctrl+I)
基礎
Terminal Command 在 terminal 內把自然語言轉成 CLI syntax。
Turbo mode
進階
Turbo mode 讓 terminal 指令更偏向自動執行流程，而不是每一步都手動確認。
windsurf.cascadeCommandsAllowList
進階
Allow list 設定永遠自動放行的 terminal command stem，例如 `git`。
windsurf.cascadeCommandsDenyList
進階
Deny list 設定永遠不自動執行的 terminal command stem，例如 `rm`。
請為目前檔案加入最小可用的 logging 與 metrics。
進階
加入觀測：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。
請為選取的程式碼加入最小可用的 logging 與 metrics。
進階
加入觀測：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。
請為這段 terminal error 與相關程式碼加入最小可用的 logging 與 metrics。
進階
加入觀測：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。
請為整個 workspace 的關聯與結構加入最小可用的 logging 與 metrics。
進階
加入觀測：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。
請為目前函式或 class加入最小可用的 logging 與 metrics。
進階
加入觀測：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。
請為這份 stack trace 與上下文加入最小可用的 logging 與 metrics。
進階
加入觀測：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

進階功能 29

Advanced Features

Code Lenses、MCP、checkpoints、linter integration 等能力。

Code Lens: Explain
基礎
Explain Code Lens 在函式或 class 上方用 Code Lens 快速請 Cascade 解釋程式碼。
Code Lens: Refactor
基礎
Refactor Code Lens 直接對函式或 class 執行 refactor，相當於高精度的 scoped Command。
Code Lens: Docstring
基礎
Docstring Code Lens 為函式自動生成 docstring。
MCP
進階
MCP 整合 透過 MCP 把外部工具與資料源接進 Windsurf / Devin Desktop。
Checkpoints
進階
Checkpoints 在大型 agentic 任務中保留回退點，方便你快速比較或 rollback。
請替目前檔案補上測試。
基礎
補測試：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請替選取的程式碼補上測試。
基礎
補測試：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請替這段 terminal error 與相關程式碼補上測試。
基礎
補測試：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請替整個 workspace 的關聯與結構補上測試。
基礎
補測試：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請替目前函式或 class補上測試。
基礎
補測試：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請替這份 stack trace 與上下文補上測試。
基礎
補測試：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。
請重構目前檔案，維持原本行為不變。
進階
重構：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請重構選取的程式碼，維持原本行為不變。
進階
重構：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請重構這段 terminal error 與相關程式碼，維持原本行為不變。
進階
重構：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請重構整個 workspace 的關聯與結構，維持原本行為不變。
進階
重構：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請重構目前函式或 class，維持原本行為不變。
進階
重構：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請重構這份 stack trace 與上下文，維持原本行為不變。
進階
重構：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。
請找出目前檔案最可能的效能瓶頸。
進階
找效能瓶頸：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請找出選取的程式碼最可能的效能瓶頸。
進階
找效能瓶頸：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請找出這段 terminal error 與相關程式碼最可能的效能瓶頸。
進階
找效能瓶頸：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請找出整個 workspace 的關聯與結構最可能的效能瓶頸。
進階
找效能瓶頸：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請找出目前函式或 class最可能的效能瓶頸。
進階
找效能瓶頸：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請找出這份 stack trace 與上下文最可能的效能瓶頸。
進階
找效能瓶頸：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。
請對目前檔案做嚴格 code review。
進階
做 code review：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。
請對選取的程式碼做嚴格 code review。
進階
做 code review：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。
請對這段 terminal error 與相關程式碼做嚴格 code review。
進階
做 code review：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。
請對整個 workspace 的關聯與結構做嚴格 code review。
進階
做 code review：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。
請對目前函式或 class做嚴格 code review。
進階
做 code review：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。
請對這份 stack trace 與上下文做嚴格 code review。
進階
做 code review：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

模型與信用 2

Models & Credits

哪些功能消耗 premium credits、哪些不消耗。

Command = no premium credits
基礎
Command 不耗 premium credits 官方文件明確指出 Command 本身不消耗 premium model credits。
Devin Desktop Fast
基礎
Fast model Command 預設使用針對 current-file edits 最佳化的 fast model。

隱藏技巧 26

Power User Tips

Smart Paste、stack trace handoff 與 file-scoped 編輯技巧。

Follow-up in Command
進階
連續追問同一次生成 在 Command 生成之後直接追加 follow-up，會先撤掉目前結果再用累積指令重跑。
Code Lenses / @ Mentions for scoping
進階
先縮 scope 再問 官方最佳實務建議用 Code Lenses 或 @ mentions 做精準 scoping，避免 context length 不夠。
請解釋目前檔案的邏輯與資料流。
基礎
解釋：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請解釋選取的程式碼的邏輯與資料流。
基礎
解釋：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請解釋這段 terminal error 與相關程式碼的邏輯與資料流。
基礎
解釋：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請解釋整個 workspace 的關聯與結構的邏輯與資料流。
基礎
解釋：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請解釋目前函式或 class的邏輯與資料流。
基礎
解釋：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請解釋這份 stack trace 與上下文的邏輯與資料流。
基礎
解釋：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。
請幫我縮小目前檔案的修改範圍。
進階
縮小範圍：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請幫我縮小選取的程式碼的修改範圍。
進階
縮小範圍：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請幫我縮小這段 terminal error 與相關程式碼的修改範圍。
進階
縮小範圍：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請幫我縮小整個 workspace 的關聯與結構的修改範圍。
進階
縮小範圍：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請幫我縮小目前函式或 class的修改範圍。
進階
縮小範圍：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請幫我縮小這份 stack trace 與上下文的修改範圍。
進階
縮小範圍：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。
請比較目前檔案的兩種修法。
進階
比較方案：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請比較選取的程式碼的兩種修法。
進階
比較方案：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請比較這段 terminal error 與相關程式碼的兩種修法。
進階
比較方案：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請比較整個 workspace 的關聯與結構的兩種修法。
進階
比較方案：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請比較目前函式或 class的兩種修法。
進階
比較方案：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請比較這份 stack trace 與上下文的兩種修法。
進階
比較方案：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。
請把目前檔案整理成團隊文件。
基礎
文件化：目前檔案 把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。
請把選取的程式碼整理成團隊文件。
基礎
文件化：選取程式碼 把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。
請把這段 terminal error 與相關程式碼整理成團隊文件。
基礎
文件化：terminal 錯誤 把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。
請把整個 workspace 的關聯與結構整理成團隊文件。
基礎
文件化：整個 workspace 把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。
請把目前函式或 class整理成團隊文件。
基礎
文件化：Code Lens 目標 把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。
請把這份 stack trace 與上下文整理成團隊文件。
基礎
文件化：stack trace 把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

常見問題

Windsurf 最常用的快捷鍵有哪些？

先記 Cmd/Ctrl+L（Cascade）、Cmd/Ctrl+I（Command）、Cmd/Ctrl+Shift+A（Chat panel）、Cmd+Option+V（Smart Paste）、Cmd+Enter（接受生成）即可覆蓋大多數高頻使用情境。

Cascade 和 Command 差在哪？

Cascade 更像 agentic assistant，適合多步驟任務、工具呼叫與對整個工作流做協作；Command 更適合 file-scoped、inline 的自然語言編輯，而且官方文件明確指出它不消耗 premium model credits。

Windsurf Terminal 裡的 allow list / deny list 有什麼用？

這兩個設定控制 terminal 自動執行策略。allow list 可讓特定 command stem 永遠自動放行；deny list 則會永遠攔下危險指令，例如 rm。

Windsurf 的官方文件為什麼會跳到 Devin Desktop？

目前原本的 Windsurf 文件路徑已經轉址到 Devin Desktop docs。這份 cheatsheet 仍用 Windsurf 作為使用者熟悉的名稱，但功能說明以現行官方文件頁面為準。

資料來源

本頁內容以 2026-06-21 整理。Windsurf 文件目前已轉向 Devin Desktop docs，實際快捷鍵、模式名稱與 credits 規則請以官方文件為準。