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 使用，而不是只把它当作聊天侧栏。