Одна из основных особенностей любой автоматизации это то, что со временем она имеет свойство разрастаться и покрывать все большую и большую площадь. Поначалу вы хотите, чтобы скрипт за вас просто нажимал одну кнопку. Потом добавляется пара условий нажатия этой кнопки. Через денек - еще одна кнопка. Глазом моргнуть не успеете, как в скрипте уже 1000+ строк.

Встроенный редактор скриптов EyeAuras рассчитан в основном на небольшие проекты - простой кликер, небольшой бот, какая-то вспомогательная утилита, ну и, разумеется, использование прикладных скриптов в деревьях поведения и макросах.

В какой-то момент, его возможностей просто перестает хватать - вы хотите разложить классы удобно по папочкам, навигироваться по коду с помощью умного поиска, написать юнит-тесты и пользоваться всеми остальными прелестями современной разработки, которые предоставляют IDE типа JetBrains Rider, Visual Studio или Visual Studio Code. Вот только в этих компаниях сотни и тысячи людей, чего нельзя сказать об EyeAuras. Вывод просто - EyeAuras никогда не догонит эти средства разработки, значит нужно искать какое-то другое решение.

И это решение - Export / Import / Live Import.

Пример

Работать будем с Hello, World - никакой принципиальной разницы нет, все ауры ведут себя примерно одинаково.

В верхней части C# Action есть группа кнопок, которые как раз отвечают за интеграцию с IDE

Export

Экспортирует ваш скрипт + все зависимости в виде .sln и .csproj. По пути настраивается ссылка на EyeAuras NuGet сервер (нужна для подтягивания зависимостей и SDK), импорты и все остальные необходимые мелочи. Важно! При экспорте целевая папка очищается, так что не экспортируйте в папку, где лежат какие-то важные данные. По умолчанию EyeAuras предложит одну из стандартный папок, рекомендую оставить как есть. По результатам экспорта у вас получится вот такая папочка с псевдо-случайным именем и несколькими файлами в ней. Это и есть ваш проект, который далее можно открыть в IDE.

Building a project

Обратите внимание, что проект, который вы получите на выходе должен успешно собираться - Export не просто подготавливает текстовые файлы, а именно полноценный C# проект со всеми нужными зависимостями и ожидается, что если скрипт работал в EyeAuras, то он будет собираться и в IDE. Если это не так - смело нажимайте Report a Problem в окне EyeAuras, будем разбираться. Только не забудьте отметить галочку Auras.zip, чтобы в репорт попал и ваш скрипт.

Working with a code

Почти весь стандартный функционал IDE будет доступен - подсветка синтаксиса, навигация по коду, создание файлов и все остальное. За исключением возможности отладки - этот функционал сейчас находится в бета-тесте и будет доступен позже либо в конце 2025, либо уже в 2026 году. Что точно доступно и работает:

• подсветка синтаксиса и автодополнение
• навигация по коду, в том числе в служебные библиотеки EyeAuras
• показ документации по классам прямо в редакторе (наведите мышь)
• возможность подключать NuGet пакеты
• работа с Blazor файлами (как с code-behind, так и без)
• возможность создавать папки, классы и т.п.
• возможность подключать внешние библиотеки - предпочтительнее всего через Embedded Resources
• возможность писать юнит-тесты на ваш код - EyeAuras поймет, какие проекты нужно подтягивать из солюшена при импорте и не будет затягивать проект с тестами

Что НЕ работает:

• вы пока что НЕ сможете запустить ваш скрипт прямо из-под IDE и подебажить его. Этот функционал будет позднее.
• pre-/post-build действия не будут отрабатывать в EyeAuras - это значит что вы все еще можете использовать их для, к примеру, генерации JavaScript из TypeScript для ваших Blazor UI, однако в EyeAuras будут потягиваться уже финальные JS файлы

Import

Итак, вы поработали с кодом и теперь готовы подтянуть изменения обратно в EyeAuras и запустить скрипт. Для этого есть несколько вариантов. Начнем с самого простого - нажать Import и выбрать .sln файл. EyeAuras загрузит этот солюшен, извлечет из него всю нужную информацию и обновит скрипт. Обратите внимание, что при синхронизации все ваши локальные изменения (сделанные в самой EyeAuras) ПОСЛЕ экспорта будут утеряны - EyeAuras именно загрузит ваш код из проекта.

Далее вы можете просто запустить скрипт как обычно - код уже будет новый.

В целом на этом бы можно было и остановиться - есть возможность экспорта, есть возможность импорта, с этим уже можно разрабатывать решения. Однако в разработке одна из самых ценных вещей это время "оборота" - сколько вы тратите на то, чтобы внести изменения в ваш код и далее увидеть их в готовом продукте. Меньше время оборота - быстрее разработка, быстрее тестирование, больше времени можно потратить на улучшение продукта, а не игру с инструментами.

И вот здесь EyeAuras предлагает решение, которое позволяет разрабатывать даже быстрее, чем с использованием самых современных IDE - Live Import

Live Import

Если вы в курсе про существование многострадального Hot Reload в Visual Studio, то все, что ниже будет вам знакомо. К сожалению, даже спустя 3 года после введения этого функционала, он все еще находится на стадии "работает в 10% случаев", однако сама идея - прекрасна и заключается в том, чтобы разработчик вообще не перезапускал проект пересборки и всегда правил код "наживую", видя изменения на лету.

Live Import находится где-то между стандартным подходом Fix - Rebuild - Run - Repeat и Hot Reload:

• EyeAuras постоянно держит загруженными все нужные вашему скрипту библиотеки
• отслеживает изменения в файлах проекта
• на лету подгружает/перекомпилирует измененные части.

Вам все еще нужно сделать перезапуск (Stop/Start) скрипта из интерфейса EyeAuras, однако это будут считанные миллисекунды, так как все уже готово к запуску. Главный плюс этого подхода по сравнению с Hot Reload в том, что он работает и при этом ощутимо ускоряет скорость разработки. Как правило между внесением изменений в код и возможностью их увидеть у вас на экране проходит буквально несколько секунд, которые тратятся в основном на перезапуск скрипта. Эх, если бы можно было как-то этого избежать....

Live Import + C# Overlay

В EyeAuras есть несколько способов запуска скриптов и один из них это C# Overlay. Этот оверлей можно использовать для создания кастомного пользовательского интерфейса, отображения нотификаций или отрисовки какой-то другой информации на экране. Под капотом это скрипт, использующий Blazor Windows для отображения

Его основная особенность по сравнению с C# Action в том, что окно, которое вы видите на экране - "живое". Любые изменения, которые вы делаете в скрипте, будут тут же отображены на экране.

Код оверлея, как и обычного скрипта, можно так же экспортировать и далее сделать Live Import - тогда любые изменения, которые вы будете делать в IDE, в режиме реального времени будут подтягиваться и отображаться в окне оверлея.

Open in IDE

Эта кнопка объединяет Export + Live Import и позволяет свести к минимуму количество кликов. Когда вы на нее нажмете, EyeAuras сначала экспортирует проект в указанную папку, затем запустит IDE (ту, которая настроена для открытия .sln файлов по умолчанию, это может быть Rider/Visual Studio, что угодно), а затем сразу же запустит Live Import.

Так что буквально через несколько секунд вы уже можете начать вносить изменения в проект и видеть их на экране.

Какую IDE выбрать

Если коротко, для EyeAuras сейчас есть три действительно нормальных варианта:

• JetBrains Rider - мой личный выбор
• Visual Studio
• Visual Studio Code

Rider

Для проектов EyeAuras это обычно самый комфортный вариант:

• очень сильная навигация по C# коду
• хорошая работа с большими .sln
• удобные refactoring tools
• нормальная работа с Razor, Blazor и обычными *.cs
• хороший баланс между "мощная IDE" и "не мешает работать"

Важный нюанс: сейчас Rider часто по привычке называют "community", но технически речь идет не про отдельную Community Edition. С 24 октября 2024 года Rider просто стал бесплатным для non-commercial use. Официальная информация: Rider free for non-commercial use.

Если вы делаете EyeAuras-скрипты как hobby/open-source/обучающий проект, это делает Rider очень привлекательным вариантом.

Visual Studio

Это отличный вариант, если вы и так живете в экосистеме Microsoft или хотите классическую тяжеловесную Windows IDE.

Сильные стороны:

• привычная среда для многих .NET-разработчиков
• отличная интеграция с экосистемой Microsoft
• хороший выбор, если вы любите именно "большую" IDE под Windows

Если нужен бесплатный вариант, смотрите Visual Studio Community. Для индивидуальных разработчиков она бесплатна, а для организаций там уже есть свои условия лицензии.

VS Code

Это уже не "полная .NET IDE", а скорее очень гибкий редактор с расширениями.

Его сильные стороны:

• легкий и быстрый
• очень удобен, если вы любите editor-first workflow
• отлично чувствует себя в AI-first сценариях
• у него очень зрелая поддержка MCP и agent workflow

Для EyeAuras я бы рекомендовал VS Code в двух случаях:

• если вы уже привыкли к нему и не хотите пересаживаться
• если вам нужен максимально гибкий AI/MCP setup

Но если говорить именно про комфорт работы с большим C# проектом EyeAuras, мой личный выбор все равно - Rider.

AI-ассистенты: пользоваться ими уже просто выгодно

На практике в 2026 году писать код совсем без AI обычно просто менее выгодно:

• дольше искать API
• дольше собирать boilerplate
• дольше проверять идеи
• дольше разбираться в чужом коде

То есть вопрос уже обычно не в том, "нужен ли AI", а в том, какой именно AI лучше встроить в рабочий процесс.

Что использовать в разных IDE

Rider

Для Rider самый очевидный вариант - JetBrains AI Assistant.

Хорошая новость в том, что у JetBrains AI Assistant уже есть прямая интеграция с Codex, и это как раз мой текущий личный выбор для EyeAuras: Rider + AI Assistant + Codex.

Почему именно так:

• все живет прямо внутри IDE
• есть agent mode
• есть поддержка MCP
• хорошее соотношение цена/качество
• удобно для длинных задач, а не только для "допиши одну строчку"

Visual Studio

Для Visual Studio самый прямой и практичный вариант - GitHub Copilot.

Он уже хорошо встроен в саму IDE и закрывает базовые сценарии: chat, inline suggestions, multi-file edits, agent-like workflow.

VS Code

В VS Code у вас сразу несколько сильных путей:

• GitHub Copilot
• Codex IDE extension / Codex workflow

Плюс у VS Code сейчас очень сильная и зрелая поддержка MCP, что делает его очень удобным хостом для AI-инструментов.

Мой практический совет

Если нужен самый беспроблемный вариант именно под EyeAuras, я бы рекомендовал такой стек:

• Rider
• JetBrains AI Assistant
• Codex
• EyeAuras MCP

Это не единственный рабочий вариант, но сейчас это, на мой взгляд, один из самых удобных и сильных сценариев по соотношению качества, цены и количества ручной возни.

Что такое MCP и зачем он нужен

MCP это Model Context Protocol - открытый протокол, через который AI-инструменты могут получать доступ к внешним инструментам, ресурсам и действиям.

Если говорить совсем просто, MCP нужен для того, чтобы AI не просто "болтал про код", а мог:

• читать структуру проекта
• открывать нужные файлы
• вызывать специальные инструменты
• редактировать код через контролируемые tool calls
• получать дополнительные знания из документации, логов, ресурсов и API

То есть MCP превращает AI из "умного автодополнения" в более серьезного рабочего помощника.

Хорошие официальные вводные по теме:

• MCP в JetBrains AI Assistant
• MCP в VS Code

EyeAuras MCP: зачем он особенно полезен

У EyeAuras совсем недавно появился собственный MCP сервер. Это очень важный шаг, потому что теперь AI-инструменты могут работать со скриптами не вслепую, а через реальные инструменты EyeAuras.

Практически это значит, что AI может:

• смотреть workspace текущего скрипта
• читать и менять документы в проекте
• искать символы и документацию
• проверять диагностику компиляции
• работать с NuGet-зависимостями

Именно поэтому самый сильный сценарий сейчас выглядит так:

• вы открываете экспортированный .sln в IDE
• даете AI доступ к самому проекту
• дополнительно подключаете к нему EyeAuras MCP

В результате получается ассистент, который одновременно:

• видит ваш обычный C# проект
• понимает EyeAuras-специфику
• умеет не просто советовать, а реально вносить правки

Как запустить EyeAuras MCP

1. Откройте в EyeAuras вкладку AI Assistant / AI.
2. При необходимости нажмите Show Settings.
3. Проверьте поле MCP Port.
4. Нажмите Start MCP.

По умолчанию порт сейчас 48080, а endpoint выглядит примерно так:

http://127.0.0.1:48080/mcp

Если вы меняли порт в настройках, просто используйте тот endpoint, который показывает EyeAuras.

Как подключить его в IDE

Rider

В Rider это делается через:

Settings | Tools | AI Assistant | Model Context Protocol (MCP)

Дальше добавляете HTTP MCP server и указываете URL EyeAuras, например:

http://127.0.0.1:48080/mcp

VS Code

В VS Code можно добавить MCP server через встроенные настройки MCP или через mcp.json, тоже указав EyeAuras endpoint.

Visual Studio

В Visual Studio история зависит от конкретного AI-инструмента, но общая идея та же: нужно добавить внешний MCP server и направить его на EyeAuras endpoint.

Если выбирать IDE именно под сценарий "AI + MCP + EyeAuras", то сегодня Rider и VS Code выглядят наиболее удобными.

Export

Идея проста - ваш C# скрипт экспортируется в виде полноценного C# проекта, который можно даже сбилдить с помощью IDE. Далее вы работаете над ним, используя современные и удобные вам средства разработки, а когда все готово - просто импортируете проект обратно в EyeAuras, тем самым получая лучше от обоих миров. Вы все еще можете использовать все встроенные возможности EyeAuras SDK, такие как работу с изображениями, симуляцию ввода, работу с памятью, создание кастомных интерфейсов на Blazor и ImGui, ну и все остальное.

В декабре 2024 появился прототип экспорта и на протяжении года он постепенно совершенствовался и разрастался.

На данный момент размер самого большого бота, который реализован с использованием этого подхода уже превышает 23000 строк и при этом использует практически все, что было разработано для EyeAuras за все эти годы. Так что думаю на этом этапе этот функционал уже достаточно стабилен и рекомендуем к использованию для реальных проектов.