用途：在 Windsurf 中搭建 AI 辅助的本地开发闭环，目标流程为用 Cascade 编辑、在 IDE 内预览、迭代、测试、提交。
主要能力与用法：
- 项目上下文：在项目根目录创建并提交 .windsurfrules，写明技术栈、架构与代码约定，让 Cascade 理解项目。
- 索引排除：配置 .codeiumignore（语法同 .gitignore），排除 node_modules/、.next/、dist/、build/、coverage/、.min.js、.map、.env 等，减少索引体积、加快建议。
- Turbo 模式：在 Windsurf 设置中把 Cascade 的 Terminal Execution Level 设为 Turbo，使 Cascade 自动执行终端命令；同时配置 windsurf.cascadeCommandsAllowList 与 windsurf.cascadeCommandsDenyList 安全名单，允许 npm、pnpm、npx、node、tsc、vitest、jest、eslint、prettier 及部分 git 命令，拒绝 rm -rf、sudo、git push --force、git reset --hard、DROP TABLE、shutdown 等。
- Previews：让 Cascade 启动开发服务器并在 IDE 内打开预览标签，可点击“Send element”把 UI 元素发给 Cascade，控制台错误会自动转发用于调试，支持热重载迭代。
- 开发循环：打开 Cascade（Cmd/Ctrl+L）描述需求，Cascade 改文件并执行命令，预览热更新，点击问题元素回传，修复后运行测试并提交。
- 终端集成：在终端用 Cmd/Ctrl+I 输入自然语言生成命令，例如“find all files importing the Button component”生成 grep -rl "import.*Button" src/；高亮终端错误按 Cmd/Ctrl+L 发给 Cascade 诊断。
适用场景：搭建或优化 Windsurf 本地开发环境、需要 AI 辅助编码与快速 UI 迭代的团队或个人。
限制与前置条件：需已登录 Windsurf 并打开项目，Node.js 18+ 或 Python 3.10+，项目已初始化 Git。资料未提供收费、价格、平台支持范围及效果数据。常见问题包括缺少 .windsurfrules 导致上下文缺失、大仓库索引慢、Turbo 缺少拒绝名单、预览未启动服务器或热重载断开等。