Windsurf 官方教學中文版

📖 本篇術語速查表

英文 / 縮寫	中文	一句話解釋
官方教學	official	講 Windsurf 具體功能設定。
按問題查	problem-first	從問題反查章節。
事實基準	baseline	設定以官方為準。

不想讀完？把下面這段提示詞丟給 AI 幫你跑完——幫你按要解決的問題定位該讀 Windsurf 官方教學哪一章。

你是 Windsurf 官方教學導航顧問。

【角色】
Windsurf 官方教學導航顧問，按最小夠用、安全優先的原則給可落地方案，每條結論都落到能照做的具體步驟或示例，不停留在「建議」「考慮一下」這類空泛表述。

【輸入】
- 要解決的具體問題：___
- 用的場景：___
- 經驗水平：___
- 緊迫程度：___
- 現狀：___

【工作流程】
1. 把問題歸類（上手 / Cascade / 上下文 / 命令 / MCP / 技能工作流 / 模型 / 團隊排障）
2. 定位對應章節
3. 給閱讀順序
4. 標出需核驗的
5. 給落地下一步

【輸出規範】
▌一、問題歸類
▌二、對應章節
▌三、閱讀順序
▌四、需核驗內容

【硬約束】
- 按問題精準定位不通讀
- 易變資訊以官方為準
- 貼合經驗水平
- 不要替我臆測情況或編造不存在的功能，資訊不全先問清
- 不確定的設定或介面一律以官方文件為準，禁止照搬過時寫法

這一組不是逐字翻譯，而是把 Windsurf 官方文件重組成中文開發者能直接查、直接落地的教學。事實邊界來自 Windsurf / Cognition 官方資料和 MCP 官方規範；模型、價格、用量、計劃、企業控制這類高波動事實，只寫查詢入口和決策邊界。

先給結論：個人上手按“安裝 → Cascade → 上下文 → 終端”讀；團隊上線按“MCP → Skills/Workflows → 模型用量 → 團隊控制”補齊治理。

閱讀入口

安裝與首次啟動

下載、登入、匯入 VS Code/Cursor 設定，確認 PATH 和第一次只讀驗證。

Cascade 核心能力

理解 Code/Chat、計劃、佇列、工具呼叫、checkpoint、revert 和多會話。

上下文與規則

區分 Memories、Rules、AGENTS.md、Workflows、Skills 和 .codeiumignore。

終端與命令控制

設定 Command、auto-execution、allow/deny list、團隊命令策略和 dedicated terminal。

MCP 整合

使用 Marketplace、mcp_config.json、HTTP/SSE、認證插值、tools 限制和企業 registry。

Skills、Workflows 與 Hooks

判斷什麼時候寫 Skill、Workflow、Hook，什麼時候只用 Rule 或 AGENTS.md。

模型、Adaptive 與用量

理解 Adaptive、SWE 模型族、BYOK、quota、extra usage 和團隊模型策略。

團隊控制與排障

梳理 Admin Portal、SSO/SCIM、RBAC、命令、MCP、共享、記錄和常見故障。

學習路徑

flowchart TD
    Start["第一次上手"] --> Setup["安裝與首次啟動"]
    Setup --> Cascade["Cascade 核心能力"]
    Cascade --> Context["上下文與規則"]
    Context --> Terminal["終端與命令控制"]
    Terminal --> Use{"個人使用還是團隊上線?"}
    Use -->|個人繼續進階| Models["模型、Adaptive 與用量"]
    Use -->|團隊上線| MCP["MCP 整合"]
    MCP --> Skills["Skills 與 Workflows"]
    Skills --> Models
    Models --> Team["團隊控制與排障"]

    style Cascade fill:#dbeafe,stroke:#2563eb,stroke-width:2px
    style Terminal fill:#fef3c7,stroke:#d97706,stroke-width:2px
    style Team fill:#fee2e2,stroke:#dc2626,stroke-width:2px

官方事實源

主題	官方來源
安裝與 onboarding	Welcome to Windsurf
Cascade	Cascade Overview
Memories / Rules / AGENTS.md	Memories & Rules、AGENTS.md
Terminal	Terminal
MCP	Model Context Protocol (MCP)、MCP Specification
Skills / Workflows	Skills、Workflows
Models / Usage	AI Models、Adaptive、Quota-Based Usage
Teams / Troubleshooting	Guide for Admins、Common Windsurf Issues
全量索引	Windsurf llms.txt

查閱順序

如果你只想把 Windsurf 跑起來：

如果你要把 Windsurf 接進團隊流程：

術語口徑

術語	本系列中的用法
Windsurf	IDE 產品本體
Cascade	Windsurf 內的 agentic AI assistant
Rules	持久行為規則，可全域、workspace、system 級設定
AGENTS.md	目錄範圍規則，進入 Cascade 同一套 Rules engine
Workflows	手動 slash command 呼叫的多步流程
Skills	帶 `SKILL.md`、指令碼、模板、資源的能力包
MCP	Model Context Protocol，用於把外部工具和服務接給 Cascade
Adaptive	Cognition 的智慧模型路由，由 Windsurf 根據任務選擇底層模型

深讀：為什麼官方教學要和實戰教學分層

官方教學負責事實邊界：路徑、入口、限制、官方建議、企業控制和排障來源。實戰教學負責把這些事實組合成真實專案方法，比如第一次只讀驗證、命令 deny list、MCP 准入、Skill 目錄策略和模型預算控制。

這兩層不能混在一起。官方事實會變化，所以每篇都保留核驗日期和官方來源；實戰經驗會沉澱成判斷規則，但不能覆蓋官方頁面裡的最新價格、模型和企業功能狀態。

本組自檢

讀完整組後，用這 4 個問題檢查：

你能否在新機器上完成安裝、登入、PATH 和第一次只讀 Cascade 驗證？
你能否區分 Memories、Rules、AGENTS.md、Workflows、Skills 和 MCP？
你能否給真實儲存庫設定終端 allow/deny list 和 .codeiumignore？
你能否為團佇列出模型、命令、MCP、共享、SSO/SCIM 和排障的上線清單？

透過標準：你能把 Windsurf 作為一個可治理的 AI IDE 使用，而不是隻把它當作聊天側欄。