用途：当常规排障无法解决 Windsurf 问题时，用于分层定位 IDE、Cascade、索引、扩展与 MCP 层面的故障。
主要能力：
- 分层隔离：Windsurf 由 VS Code 基础层与 Codeium AI 层组成。编辑器崩溃、渲染、文件系统问题属 VS Code 层；AI 建议错误、Cascade 失败、索引卡住属 Codeium 层；扩展不工作属扩展兼容层。可用 windsurf --disable-extensions 测试 VS Code 层；在扩展中禁用 codeium 测试 Codeium 层。
- Cascade 上下文诊断：检查 .windsurfrules（上限 6000 字符，超出会被截断）、.windsurf/rules/*.md、项目与全局规则总预算（上限 12000 字符）、以及 ~/.codeium/windsurf/memories 记忆文件数量。
- 索引诊断：统计待索引文件数、查找大于 1MB 的大文件、检查 .codeiumignore 是否存在与模式数量；文件超过 10000 时建议打开子目录并补充忽略规则。
- 扩展冲突检查：通过 windsurf --list-extensions 列出扩展，识别与 Supercomplete/Cascade 竞争的扩展（如 copilot、tabnine、cody、intellicode 等）。
- MCP 调试：检查 ~/.codeium/windsurf/mcp_config.json 是否存在、JSON 是否有效，并列出各 MCP 服务命令。
使用方式：按步骤执行文中诊断脚本，先用分层测试缩小范围，再检查规则、记忆、索引、扩展与 MCP 配置。附带的快速一行诊断可汇总文件数、规则字符数、忽略模式数与扩展数。
限制与重置：若仍无法解决，可按渐进式重置：重启 Cascade、重置索引、重载窗口、清空记忆目录、删除 ~/.codeium/windsurf/cache/ 后重开，或卸载后重装。部分命令需终端访问，且需理解 Windsurf 架构。