🎯 О чём этот конспект: Подробный разбор Windsurf — новой агентской IDE от Codeium. В видео демонстрируется процесс создания мобильного приложения на React Native «с нуля» до рабочих экранов с логикой, навигацией и отладкой при помощи AI-агента Cascade.

👤 Кому будет полезно: Вайбкодерам, разработчикам мобильных приложений и всем, кто хочет перейти от простых чат-ботов к полноценным AI-агентам, которые сами пишут файлы, создают структуру проекта и исправляют ошибки в терминале.

✨ Что получите: Вы научитесь настраивать Windsurf, использовать режимы Chat и Write, генерировать UI по скриншотам и делегировать агенту сложные задачи по связке компонентов и навигации.

1. Установка и первичная настройка Windsurf

Контекст: Windsurf — это не просто плагин, а полноценная IDE (форк VS Code), созданная специально для работы в паре с AI-агентом. В отличие от обычных редакторов, он индексирует проект локально, понимая зависимости, структуру компонентов и логику переходов. Это позволяет AI давать контекстно-зависимые советы, которые реально работают в рамках вашего стека.

Выгода: Быстрый старт за счет импорта всех настроек из VS Code или Cursor и глубокое понимание проекта агентом с первой секунды.

Как применить:

• Шаг 1: Загрузка — Перейдите на codeium.com, скачайте версию под свою ОС (macOS, Windows, Linux) и установите её.
• Шаг 2: Импорт настроек — При первом запуске выберите «Import from VS Code», чтобы сохранить свои темы, расширения и горячие клавиши.
• Шаг 3: Авторизация — Залогиньтесь через аккаунт Codeium или Google. Это необходимо для доступа к моделям (Claude 3.5 Sonnet, GPT-4o).
• Шаг 4: Индексация — Откройте папку с проектом. Windsurf автоматически начнет индексировать файлы (app.js, навигацию, ассеты), что критично для работы функций Autocomplete и Cascade.

Результат: Готовая к работе среда, которая «знает» структуру вашего React Native приложения.

2. Работа с Cascade: Режимы Chat и Write

Контекст: Cascade — это «мозг» Windsurf. Он работает в двух режимах. Chat — для обсуждения архитектуры, объяснения кода или поиска багов через диалог. Write — агентский режим, где AI сам создает файлы, правит код и выполняет команды в терминале. Вы можете выбирать модели: Claude 3.5 Sonnet (лучшая для кода) или GPT-4o.

Выгода: Экономия времени на написании бойлерплейта и рутинной правке импортов.

Как применить:

• Шаг 1: Использование Chat — Откройте панель справа. Спросите, например: «Как реализовать Tab Navigation в этом проекте?». AI проанализирует ваши файлы и даст пошаговую инструкцию.
• Шаг 2: Использование Write — Переключитесь в режим Write. Введите промпт для создания новой функции.
• Шаг 3: Выбор модели — В нижней части панели Cascade выберите Claude 3.5 Sonnet для более точного написания многострочного кода.

Пример промпта для генерации экрана:

Create a profile screen that displays common information and follows a standard layout. 
Populate it with dummy data. Make it accessible by adding a new menu item in the navigation bar. 
Ensure it adheres to the app's style and layout.

Результат: Агент сам создаст файл ProfileScreen.tsx, пропишет его в навигации и добавит кнопку в меню.

3. Генерация UI по скриншотам (Image-to-Code)

Контекст: Одна из самых мощных функций Windsurf — возможность загрузить изображение (дизайн из Figma или скриншот) и попросить AI превратить его в рабочий код на React Native. Агент не просто рисует картинку, а создает интерактивные компоненты с использованием состояний (useState).

Выгода: Мгновенное превращение визуальной идеи в работающий прототип с логикой ввода данных.

Как применить:

• Шаг 1: Загрузка изображения — В панели Cascade нажмите на иконку изображения и выберите скриншот (например, карточку логина).
• Шаг 2: Описание задачи — Напишите промпт, указывающий, что именно нужно сделать.

Пример промпта:

Create a new page called Login. Add a menu item to navigate to this page. 
On the login page, create a login card based on the provided image. 
Use states for email and password inputs.

• Шаг 3: Проверка — Агент создаст JSX-структуру, стили и функции-заглушки для кнопок (Apple Sign-in, Google Sign-in).

Результат: Полностью функциональная форма логина, которая соответствует дизайну на скриншоте.

4. Агентская отладка и исправление ошибок

Контекст: Windsurf умеет читать ошибки из терминала. Если приложение падает, вам не нужно гуглить — достаточно скопировать текст ошибки в Cascade. Агент проанализирует контекст (например, отсутствие картинки в папке assets) и предложит исправление.

Выгода: Сокращение времени на дебаг в 2-3 раза.

Как применить:

• Шаг 1: Копирование ошибки — Если в симуляторе или терминале появилась красная ошибка (например, Module not found), скопируйте её.
• Шаг 2: Промпт на исправление — Вставьте ошибку в Cascade с просьбой исправить.
• Шаг 3: Применение фикса — AI может предложить заменить отсутствующий ассет на иконку из библиотеки (например, Ionicons), которая уже установлена в проекте. Нажмите «Accept», чтобы применить правки.

Результат: Ошибка исчезает, код автоматически переписывается под существующие зависимости.

5. Интерактивное редактирование через Command (Cmd+I)

Контекст: Функция Command позволяет вносить быстрые правки прямо в редакторе или терминале без открытия боковой панели. Это «умный» поиск и замена, усиленный AI. Если выделить кусок кода, изменения коснутся только его.

Выгода: Точечные правки кода «на лету» без нарушения общей структуры файла.

Как применить:

• Шаг 1: Вызов — Нажмите Cmd + I (или Ctrl + I на Windows).
• Шаг 2: Промпт в коде — Выделите объект с данными и напишите: Change dummy data to realistic car information.
• Шаг 3: Промпт в терминале — В терминале через Cmd + I можно написать: Launch Expo, и AI сам подставит нужную команду (например, npx expo start).
• Шаг 4: Отмена — Если результат не понравился, нажмите Cmd + Z, чтобы мгновенно откатить изменения.

Результат: Быстрая модификация данных и запуск скриптов без ручного ввода команд.

FAQ

В: Чем Windsurf лучше Cursor? О: Windsurf предлагает более глубокую «агентность» (Flow), где AI может выполнять цепочки действий: создать файл -> обновить навигацию -> запустить терминал -> проверить ошибку. Также у него мощная интеграция с Codeium для быстрого автокомплита.

В: Какие модели доступны бесплатно? О: В бесплатном плане есть 50 премиум-промптов (для Claude 3.5 Sonnet/GPT-4o) и 200 кредитов на действия агента. После их исчерпания доступна базовая модель Codeium без ограничений.

В: Может ли Windsurf работать с изображениями для стилизации? О: Да, вы можете загрузить скриншот любого элемента интерфейса, и Cascade проанализирует отступы, цвета и шрифты, чтобы воссоздать их в коде вашего проекта.

В: Как Windsurf понимает, куда добавлять новые экраны? О: Благодаря локальной индексации. Он видит вашу структуру папок (например, /screens, /components) и автоматически помещает новые файлы в нужные директории, соблюдая ваши правила именования.

В: Можно ли использовать Windsurf для других языков, кроме React Native? О: Да, IDE универсальна. Она отлично работает с Python, JS/TS, Go и любыми веб-фреймворками, адаптируя свои предложения под специфику языка.

Конспект создан на основе видео «Windsurf AI Tutorial for Beginners (React Native)» канала Codeium. Все права на оригинальный материал принадлежат авторам. Источник: https://www.youtube.com/watch?v=vROTkvd_v5g