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