Ray

Что такое Ray?

Ray — кросс-языковый и кросс-фреймворковый настольный помощник по отладке, предназначенный для сбора, организации и визуализации вывода отладки вашего кода. Вместо того чтобы выводить данные прямо в приложение или консоль, Ray предоставляет централизованную, функционально богатую среду, в которой строки, массивы, объекты, запросы, письма, события и многое другое можно отправлять и отображать в читаемом, удобном для навигации формате. С Ray вы можете фильтровать, искать, архивировать и анализировать данные отладки из PHP, Laravel, JavaScript и далее — все в одном отдельном приложении. Цель проста: сохранить процесс отладки быстрым, организованным и не мешать вашему рабочему процессу, при этом предлагая мощные инструменты для понимания и действий над данными.

Ray 3.0 представляет улучшения, которые соединяют традиционную отладку с ИИ-поддерживаемыми рабочими процессами, генерацию HTML-компонентов и более богатые диаграммные представления. Продукт подчеркивает единообразие между языками, встроенные инструменты для навигации по IDE, возможности удаленного доступа и гибкую визуализацию данных — при этом оставаясь простым в освоении как для команд, так и для отдельных пользователей.

Основные особенности

• Централизованная среда отладки: собирайте и упорядочивайте весь вывод отладки в одном настольном приложении, а не в разбросанных по терминалам и журналам.
• Поддержка множества языков и фреймворков: работает с PHP, Laravel, JavaScript и другими; последовательный синтаксис и рабочий процесс.
• Удаленная отладка по SSH: подключайтесь к удаленным серверам и передавайте вывод отладки напрямую в Ray, обеспечивая диагностику в реальном времени без локальных изменений кода.
• Архивирование и извлечение сообщений: сохраняйте важные выводы для сравнения, аудита или воспроизведения сложных ошибок.
• Пауза и измерение выполнения: приостанавливайте выполнение путей кода и измеряйте время между вызовами, чтобы точнее выявлять узкие места производительности без добавления дополнительного кода.
• Ни одного dump-вывода (авто-вывод): получайте вывод автоматически из запросов, задач, исключений и других источников данных, уменьшая объем повторяющегося кода в вашем проекте.
• Переход к IDE: открывайте соответствующее место исходного кода прямо из Ray, поддерживаются многие популярные IDE для быстрой навигации.
• Темы и расширяемость: меняйте темы под ваш рабочий процесс, создавайте макросы и расширяйте Ray своими клиентами или привязками для не поддерживаемых сред.
• HTML-компоненты и вывод, управляемый ИИ: позвольте ИИ сгенерировать HTML-компоненты или прототипы внутри Ray и взаимодействуйте с ними напрямую.
• Диаграммы Mermaid и ERD: генерируйте структурированные диаграммы, помогающие объяснить сложные схемы баз данных с встроенными просмотрщиками.
• Интеграция с MCP-сервером: предоставьте агентам ИИ доступ к вашей Windows-среде и инструментам для продвинутой автоматизации и задач генерации.
• Новое в Ray 3.0: смотрите, что генерирует ваш ИИ, взаимодействуйте с выводами ИИ внутри приложения и используйте улучшенные средства диаграммирования и визуализации.
• Кроссплатформенность: Ray работает на macOS, Windows и Linux, обеспечивая единообразный опыт отладки на разных устройствах.
• Документация и сообщество: подробная документация сопровождает Ray, а экосистема поддержки сообщества охватывает языки и фреймворки.

Как использовать Ray

1. Получить Ray: скачайте и установите Ray с официального сайта. Лицензии управляются через Spatie, с вариантами цены, включая стандартную и промо-цены запуска (на Ray 3.0 смотрите цены на странице оформления заказа).
2. Установить и инициализировать: запустите настольное приложение Ray на вашей машине разработчика. Убедитесь, что Ray запущен и готов принимать данные.
3. Отправлять данные отладки из вашего кода: используйте функцию ray() (или эквивалент в вашем языке), чтобы отправлять строки, массивы, объекты, запросы, письма, события или любые данные, которые вы хотите исследовать. Вы можете пометить выводы, чтобы улучшить фильтрацию и поиск.
4. Исследовать рендеринг внутри приложения: Ray рендерит ваши данные в читаемом, структурированном формате. Используйте фильтры по типу, происхождению или пользовательским ярлыкам, чтобы сузить результаты, и используйте поиск, чтобы найти что угодно во всех сообщениях.
5. Фильтрация, архивирование и уточнение: Прикрепляйте цвета или ярлыки к выводам, архивируйте сообщения для дальнейшего использования и ставьте паузу/измеряйте выполнение, чтобы изолировать проблемы.
6. Переход к вашему IDE: из дампа переходите прямо к соответствующему месту в вашем редакторе. Ray поддерживает множество популярных IDE для быстрой навигации.
7. Использование ИИ и HTML-компонентов: используйте функции с поддержкой ИИ Ray для генерации HTML-компонентов или прототипов, или объясняйте сложные данные с помощью диаграмм Mermaid/ERD.
8. Расширение и настройка: если Ray ещё не поддерживает язык или фреймворк, на который вы опираетесь, расширяйте Ray через макросы или создайте пользовательского клиента для отправки данных.
9. Развертывание удаленно, если необходимо: используйте удаленную отладку по SSH, чтобы мониторить и отлаживать код, работающий на удаленных серверах.
10. Исследование и оптимизация: используйте паузу, тайминг и инструменты фильтрации для изоляции проблем с производительностью, воспроизведения проблем и сопоставления выводов между запусками.

Примеры использования

• PHP и Laravel debugging: вывод данных во время выполнения PHP и Laravel напрямую в Ray, визуализация массивов и объектов и инспекция запросов с контекстной пометкой.
• Debugging JavaScript и frontend: захват выводов, схожих с консолью, ответов API и событий Node.js или браузерного кода, все в одном месте.
• Удаленная отладка на серверах: отлаживайте код на удаленных машинах через SSH, транслируя логи и выводы в Ray для анализа в реальном времени.
• Разработка с ИИ: генерируйте HTML-компоненты, прототипы или объяснения сложных схем с помощью ИИ и визуализируйте результаты внутри Ray с использованием встроенных просмотрщиков.
• Визуализация баз данных и схем: создавайте диаграммы Mermaid или ERD из ваших потоков данных и запросов, чтобы лучше понять связи в базе данных.
• Согласованность потока отладки: поддерживайте одинаковый опыт отладки на macOS, Windows и Linux, чтобы команды оставались синхронными независимо от окружения.

Часто задаваемые вопросы

• Какова модель ценообразования и лицензирования? Ray предлагает платную лицензию на рабочий стол. По последнему релизу, цены указаны на странице оформления заказа, с опцией стартовой распродажи по сниженной цене. Лицензии обычно действуют в течение заданного периода (например, 1 год) и управляются через официальную систему лицензирования (Spatie). Упоминаются лицензии с пожизненным доступом как опция, при условии текущих условий. Лицензии, приобретенные до мажорной версии, могут оставаться действительными по прежним условиям.
• Какие платформы поддерживаются? Ray разработан как кроссплатформенный и работает на macOS, Windows и Linux, обеспечивая единообразный опыт отладки на всех основных настольных средах.
• Какие языки и фреймворки поддерживаются? Ray поддерживает PHP, Laravel, JavaScript и дополнительные языки через привязки к языку или пользовательские клиенты. Продукт подчеркивает единообразный синтаксис и рабочий процесс во всех поддерживаемых языках.
• Можно ли отлаживать удаленно или на серверах? Да. Ray поддерживает удаленную отладку по SSH, позволяя подключаться к удаленным серверам и передавать вывод отладки напрямую в Ray без изменений локального кода.
• Как работают поиск, фильтрация и архивирование? Вы можете фильтровать сообщения по типу, источнику или пользовательским ярлыкам, использовать поиск по всем сообщениям и архивировать важные выводы для последующего использования или сравнения. Это помогает эффективно управлять большими объемами данных отладки.
• Есть ли интеграция с ИИ и генерация HTML? В Ray 3.0 появились функции, позволяющие ИИ генерировать HTML-компоненты и диаграммы, с встроенным просмотрщиком Mermaid и ERD. Вы также можете связывать результаты ИИ с вашим процессом отладки для повышения инсайтов.
• Как начать? Скачайте настольное приложение-Ray с официального сайта, ознакомьтесь с документами по привязкам языков и начните отправлять данные через вызовы ray() в вашем коде. Если нужна настройка или расширение Ray, можно изучить макросы и пользовательских клиентов.

Примечания: Ray продвигает рабочий процесс, в котором вывод отладки не попадает в ваше приложение, но при этом остается доступным, полнофункциональным и полезным. Цель — предоставить мощную, расширяемую и кроссплатформенную среду отладки, которая растет вместе с вашими проектами и командами, сохраняя ваш поток разработки.