Windsurf 官方教程中文版
按 Windsurf 官方文件能力域重組的中文查詢手冊，覆蓋安裝、Cascade、上下文、MCP、Skills、模型和團隊控制。
這一組不是逐字翻譯，而是把 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 使用，而不是隻把它當作聊天側欄。