Devin Desktop 使用教學（原 Windsurf）：安裝、Devin Local、Plan 模式、規則與權限

本文根據 Devin 官方文檔的 Desktop 部分整理，資料核對於 2026-10-11。Windsurf 已改名為 Devin Desktop，網上大量講 Cascade 的舊教學已經和現在的預設介面對不上。產品是什麼、收費情況，見本站 AI 應用目錄裏的「Devin Desktop（原 Windsurf）」條目。

適用於誰

• 之前用 Windsurf，升級後發現介面和叫法都變了的人；
• 搜「devin desktop 教學」「devin desktop 是什麼」「devin desktop windsurf」的人；
• 想找一個能同時管理本地和雲端多個智能體的編輯器的人。

結論先說

1. Devin Desktop 就是原來的 Windsurf 編輯器，官方定位是「內置 Devin 的 AI IDE」：在本機跑 Devin Local、把任務派給雲端的 Devin、在一個地方管理所有智能體。
2. 預設智能體換了：新標籤頁預設用 Devin Local（和 Devin CLI 共用的新一代智能體框架），新對話不會再從 Cascade 開始；舊的 Cascade 對話仍能在歷史裏打開。
3. 模式三種：Code（預設，直接改）、Plan（先出方案）、Ask（只讀）。Ctrl+.（macOS ⌘+.）切換。
4. 規則首選放 **.devin/rules/.md*，舊的 .windsurf/rules 和 .windsurfrules 仍然讀取；根目錄的 AGENTS.md 也會當作常駐規則。
5. 記憶（Memories）只屬於舊的 Cascade，Devin Local 不儲存記憶——需要長期記住的東西寫成規則、AGENTS.md 或 skill。

步驟一：安裝

Linux 上有個容易困惑的地方：軟件源地址裏仍然是 windsurf 的舊名字，但包名已經是 devin-desktop。官方說明 windsurf 作為過渡包保留，老安裝會繼續更新。添加軟件源的命令較長，直接從官方 Install 頁複製。

步驟二：首次啟動

1. 選主題。保持勾選「Install devin-desktop terminal command」，之後可以在終端裏用 devin-desktop 項目路徑 打開項目；展開 Import Settings 可以導入 VS Code 或 Cursor 的設定和鍵位；
2. 登入。需要 Devin 帳號，沒有的話可以免費註冊。瀏覽器登入不順利時，官方提供了手動填 Devin API key 的方式；
3. 打開項目，開始第一個任務。

步驟三：認識 Devin Local

Devin Local 運行在你的電腦上，能訪問本地文件、工具和環境。官方列的幾項改進：

• 更省 token：更重視提示詞緩存，官方稱多數任務比 Cascade 少用最多約 30% 的 token；
• 子智能體（Subagents，預覽）：可以把子任務交給獨立的子智能體，前台或後台運行；
• 沙箱：操作系統級沙箱，按權限範圍限制可寫路徑，並用域名白名單 / 黑名單過濾網絡；
• Quick Review：專門用來快速審查改動的子智能體。

在智能體選擇器裏找不到 Devin Local？ 命令面板（Ctrl+Shift+P）→ 打開 Devin User Settings → Agents 標籤頁 → 打開 Devin Local → 重啟。公司的 Enterprise 帳號需要管理員先在後台開啟。

步驟四：三種模式

Plan 模式下，智能體會先探索代碼庫、向你提澄清問題、給出幾個可選方案，最後把詳細計劃寫進一個倉庫之外的 Markdown 文件（~/.devin/plans 或 ~/.windsurf/plans）。計劃寫好後點文件上的 Implement，或批准它退出 Plan 模式，即可開始實現。

兩個實用技巧（均來自官方文檔）：

• 在提示詞裏帶上關鍵詞 megaplan（ultraplan、masterplan 也行），會切到 Plan 模式並讓它規劃得更充分，至少先問你一個澄清問題；
• 第一次實現跑偏了，不用硬修：丟棄改動 → 修改計劃文件 → 在新對話裏 @ 這個計劃文件再點 Implement。

步驟五：寫規則

工作區規則在 frontmatter 裏用 trigger 字段聲明激活方式：

官方的建議很明確：想讓智能體可靠地反覆使用的知識，寫成規則或加進倉庫的 AGENTS.md，不要依賴自動生成的記憶——規則能進版本控制、能和團隊共享、激活方式可控。跨工具共用見《AGENTS.md 怎麼寫》。

步驟六：權限與隔離

權限規則。Devin Local 用更細的權限體系取代了舊的「自動執行級別」：

• Deny：直接禁止（優先級最高）；
• Ask：每次都問；
• Allow：自動批准。

規則可以分別限定讀文件、寫文件、執行命令、HTTP 抓取和 MCP 工具，可在項目、用戶、組織三級配置。例如用 Read(**/*.pem) 這樣的 glob 拒絕讀取證書文件。

Worktree 會話。開始會話時在位置選擇器裏選 New worktree，智能體會在一個獨立的 git worktree 裏編輯、構建、測試，不動你的主工作區；完成後點會話上的 Merge 把改動合回來。

Restricted Mode。工作區以受限模式打開時，所有智能體（Cascade、Devin Local、ACP 智能體）都不可用，hooks 也不加載。打開來歷不明的倉庫時先用這個模式看一眼是個好習慣。

管理多個智能體：Agent Command Center

Devin Desktop 2.0 新增的介面，用看板把所有智能體按狀態分列：正在跑的、卡住等你處理的、等待審查的。它同時包含本地智能體（編輯器裏的會話）和雲端智能體（各自跑在獨立虛擬機上的 Devin 會話）。

老 Windsurf 用戶遷移

• 在命令面板運行 Devin: Open Cascade Migration Wizard，把原來的 workflows 和 memories 引導式遷過來（記憶建議遷成 skills）；
• .windsurf/rules、.windsurfrules 不用馬上改，仍被讀取；新建規則會存到 .devin/rules；
• 用 JetBrains 的：本站應用條目裏記錄過官方 FAQ 的說法——Windsurf 的 JetBrains 插件已進入維護模式，官方改為推薦通過 ACP 使用 Devin。

常見問題

Q：Cascade 還能用嗎？

舊對話還在歷史和側邊欄裏；但新對話不會從 Cascade 開始，官方文檔裏 Cascade 被稱為 legacy agent。

Q：計劃文件會進我的倉庫嗎？

不會，它存在用戶目錄下；可以用 @ 引用它在新會話裏繼續。

Q：MCP 怎麼配？

官方有單獨的《Cascade MCP Configuration》頁面，Devin Local 的 MCP、hooks、skills 則在「Customizations」介面統一查看。挑選和審查 MCP 伺服器見《MCP 伺服器怎麼選》。

參考資料

• Welcome to Devin Desktop（官方）：https://docs.devin.ai/desktop/getting-started
• Install Devin Desktop（官方）：https://docs.devin.ai/desktop/install
• Devin Local Agent（官方）：https://docs.devin.ai/desktop/devin-local
• Cascade Modes（官方）：https://docs.devin.ai/desktop/cascade/modes
• Memories & Rules（官方）：https://docs.devin.ai/desktop/cascade/memories
• Agent Command Center（官方）：https://docs.devin.ai/desktop/agent-command-center