Clev3r LabClev3r Lab развивает язык и компилятор оригинального Clev3r-1 для LEGO Mindstorms EV3. Происхождение компилятора, справки и редакторских доработок указано в лицензионных сведениях. Первый запуск с настоящим EV3В VS Code или VSCodium 1.143.0 или новее установите Clev3r Lab
( Подключение по USB · Работа с программами EV3 0.18.4 подключает правую панель к реальному EV3: текущие каналы датчиков, энкодеры, скорость и занятость моторов через USB, Wi-Fi или Bluetooth. Опрос не меняет режимы датчиков и не требует запуска симулятора. 0.18.1 размещает значок Clev3r, телеметрию, проводник и исходник в штатных областях VS Code. Центральная панель больше не имитирует полное окно IDE. 0.18.0 подключает согласованный полнооконный интерфейс к VM 0.12.0: живое поле, робот, датчики, моторы и LCD, пауза и история прогона. Работа с лабораторией и откат. Прежняя панель и отладчик сохранены отдельной командой. 0.17.2 исправляет замечания аудита: сохраняет выражения имён ресурсов, связывает выбор EV3 с отменой операции, использует настройки проекта выбранной основной программы и не подсвечивает исходник main для чужого слота VM. Упаковка создаёт чистые деревья компилятора/VM, ограничения полного deployment проверяются до передачи. Результаты аудита. 0.17.0 добавляет:
Текущая готовность и границы: COMPLETION.md. Clev3r: Записать энкодеры для калибровки сохраняет временной ряд A–D без управления моторами. JSON записи можно передать мастеру разгона/торможения; доступны также таблицы TXT/TSV. 0.16.4 добавляет кнопку Запустить на EV3 (▶) сверху редактора рядом со сборкой
и загрузкой. Она сохраняет изменённые файлы Clev3r, собирает выбранную
основную программу, загружает её на выбранный блок и запускает переданный RBF.
Из Запуск из редактора и дерева EV3 по умолчанию выполняется без дополнительного подтверждения.
Чтобы включить вопрос перед запуском, включите Clev3r: Confirm Program Start
( Рядом с запуском сверху редактора доступна кнопка Остановить программу EV3. Она использует существующую команду остановки, в том числе отменяет текущую сборку/загрузку перед выбором блока. Удаление файлов по-прежнему запрашивает отдельное подтверждение. 0.16.3 включает закреплённое ядро 0.8.0, исправляет пути соседних импортов после вложенного модуля и добавляет единую офлайн-проверку с профилями тестовых сцен. 0.16.2 исправляет пути include/import и отмену запуска симулятора, расширяет его форматы датчиков и виртуальные показания батареи; оборудование не требуется. 0.16.1 исправляет диагностику глобальных переменных в Sub и отмену наблюдения; включает симулятор 0.6.0 с изолированными виртуальными файлами. В 0.16.0 добавлены карта строк В 0.15.0 добавлены сведения и заготовки по оборудованию, диагностика портов, явные запуск/остановка/удаление, копия исходников с восстановлением проекта, сохранённые Wi-Fi и Bluetooth подключения. Работа с новыми возможностями и границы проверки — ROBOT_WORKFLOW.md. В 0.15.2 исправлено опасное закрытие частичных списков каталогов штатной прошивки; после работы с прежней версией следует перезагрузить EV3 перед управлением моторами. В 0.15.1 исправлен манифест Sources. На EV3 проверены пустые порты и восстановление проекта; визуальные испытания и остальные аппаратные сценарии ещё впереди. В 0.14.0 в Explorer добавлена панель EV3: файлы робота. Подключите включённый
EV3 по USB и раскройте панель, затем имя блока. Она показывает внутреннюю папку
Чтобы скачать файл, нажмите значок облака со стрелкой рядом с ним и выберите место
сохранения. Замена существующего файла подтверждается стандартным диалогом.
Проверяются размер из списка и совпадение двух полных чтений файла. На проверенном
блоке MD5 из каталога оказался недостоверным, поэтому проверка на него не опирается.
При изменении файла на роботе обновите список и повторите. При обрыве/отмене
прежний локальный файл сохраняется. Чтение можно
отменить в уведомлении или кнопкой в заголовке панели. Максимальный файл — 32 MiB,
каталог — 1 MiB текста / 4096 записей. Только внутренняя память В 0.13.0 добавлены Clev3r: Новая программа из шаблона и
Clev3r: Сохранить программу как шаблон робота. Найдите их в палитре команд
( Обычная заготовка спрашивает имя папки EV3 и добавляет Шаблон содержит весь текст текущего редактора, включая несохранённые правки.
Он хранится локально в профиле VS Code/VSCodium (не в проекте и не в VSIX),
автоматическая синхронизация расширением не включается. Замена одноимённого шаблона
требует подтверждения. Максимальный размер одного шаблона — 256 KiB.
Новая программа открывается как несохранённый документ: сохраните её в В 0.11.0 добавлены кнопки сборки, USB-загрузки и отмены над кодом, а также выбранная основная программа и сборка в строке состояния. Справка и журнал — в меню редактора. В 0.10.0 добавлена команда Clev3r: Выбрать основную программу. Выбор сохраняется для рабочей папки и применяется к сборке, загрузке и анализу, в том числе при открытом модуле. Подробности — в инструкции быстрого старта из установочного комплекта. 25.10.2026: версия 0.11.0 проверена в чистых профилях VS Code/VSCodium на Windows
с отдельным .NET Core Runtime 10 без SDK. Добавлены Outline, использования
и комментарии к пользовательским функциям. Linux-проверки относятся к 0.7.0;
новую версию на Linux проверим отдельно. Сводка — Добавлена загрузка по USB: инструкция и границы проверки. Первое расширение для VS Code и VSCodium на Linux и Windows. Отдельная IDE больше не разрабатывается. Симулятор остаётся отдельным проектом. УстановкаВ разделе «Расширения» найдите Clev3r Lab и нажмите Install Pre-Release Version или Установить для версии Preview. Откройте папку проекта и подтвердите доверие к ней, если знаете её содержимое. Среда выполнения загружается автоматически при первом использовании. В среде с заранее установленным Runtime можно указать путь в Clev3r: Dotnet Path. В WSL расширение и среда выполнения работают на стороне Linux. Диагностика при вводе (0.2.0)Через 350 мс после изменения текста запускается фоновый анализ: ошибки и
предупреждения подчёркиваются в коде и появляются в Problems. Сохранение
и компиляция не нужны; исправления автоматически обновляют диагностику.
Учитываются несохранённые открытые include/import и зависимости на диске.
Для анализа include в контексте программы держите основной Диагностика при вводе — отдельная проверка неполного кода, а не замена компиляции. Некоторые конструкции могут давать предварительные предупреждения. На один запрос установлены пределы: 128 файлов, 4 MiB символов текста/JSON и 15 секунд. Ошибки запуска анализа видны в Output → Clev3r. Проверено 22.10.2026: 37 Node-тестов прошли на Windows (Linux-проверка регистра
пропущена здесь и выполнена в Ubuntu). Кроссплатформенный набор анализа:
4 проверки прошли на Windows, все 5 — в Ubuntu/WSL, включая регистр путей,
UTF-16/CRLF, несохранённые include и закрытую зависимость в кодировке UTF-16.
Все 14 текущих проверок CLI прошли на Windows. Установленный VSIX 0.2.0 прошёл
проверку в VS Code 1.141.0 и VSCodium 1.140.0 на Windows: несохранённые ошибки,
точные диапазоны, исправление без сборки и несохранённый include.
Рабочие профили пользователя не менялись; тестовые профили находятся в Для отдельной проверки анализа из корня workspace:
РаботаF2, реальные проекты и повторные запросы (0.9.0)
Префиксы Одинаковые параллельные запросы символов объединяются; повторные запросы используют ограниченный кэш. Проверяются версии открытых документов, конфигурация, размеры/метки времени закрытых зависимостей и появление ранее отсутствовавшего файла. Переименование всегда получает новый снимок. На реальном проекте устранены ложные сообщения для out/Raw3, private, внутренних вызовов модуля, перегрузок и ++/--. Незавершённое выражение аргумента теперь отмечается в исходном файле. Обычная компиляция остаётся окончательной проверкой; отсутствующие пользовательские методы автоматически не подменяются. Установочный ZIP Outline, использования и комментарии (0.8.0)
Поиск идёт по открытым основным Комментарии подряд непосредственно перед Function/Sub или свойством модуля появляются в hover, дополнении и сигнатуре как обычный текст. Пустая строка отделяет комментарий от объявления. Например:
Команды и HTML из комментариев не выполняются. Переименование добавлено в 0.9.0; описание F2 приведено выше. Переменные и выходные аргументы (0.7.0)В дополнении, hover и F12 появились параметры, переменные из присваиваний,
типизированные объявления и счётчики При заполнении В USB-загрузчике исправлена повторная загрузка в существующую папку:
если блок отвечает NO_PERMISSION на CREATE_DIR, загрузчик проверяет существование
папки чтением каталога. Ошибка доступа к отсутствующей папке не игнорируется.
Проверены две последовательные загрузки через команду установленного VS Code
на реальный EV3; автозапуск не выполняется. Подробности — Переход к определению (0.6.0)
Пользовательские функции и модули (0.5.0)
Учитываются Открытые несохранённые буферы имеют приоритет перед диском. Зависимости читаются
заново при запросе, поэтому изменения закрытых модулей не требуют перезапуска.
Поддержаны циклические/транзитивные зависимости и библиотека Индекс строится ограниченным CLI-запросом: до 128 файлов и 4 MiB символов, без компиляции, записи исходников или подключения к EV3. Для пользовательских подсказок нужен настроенный .NET 10; при ошибке остаётся встроенный API, подробности доступны в Output → Clev3r. Новый запрос не использует результаты, устаревшие после изменения/закрытия буфера. Проверено 24.10.2026: 57 Node-тестов прошли на Windows (один отдельный тест
регистра путей рассчитан на Linux). Три проверки CLI-индекса прошли в Ubuntu/WSL,
две — на Windows с пропуском Linux-случая. Проверены локальные Function/Sub,
перегрузки, свойства и private в .bpm, цепочки зависимостей, include-контекст,
несохранённые модули, устаревшие результаты и совместимость сигнатур с реальной
компиляцией. Установленный VSIX 0.5.0 проверен в VS Code 1.141.0 и VSCodium
1.140.0 на Windows: дополнение, вставка out-переменной, hover, обновление
несохранённого .bpm и подсказка активного параметра. Рабочие профили не менялись.
Linux VSCodium 1.140.0 под Ubuntu/WSLg также прошёл все 15 сценариев установленного
пакета 0.5.0; Linux Node-набор — все 58 тестов без пропусков. Проверка использовала
только .NET Runtime. Сводка — Справка Clev3r (0.4.0)
Описания взяты из оригинального Clev3r и могут описывать возможности той IDE;
они не означают поддержку SD/Bluetooth/Wi-Fi или запуска робота нашим расширением.
Копия Проверено 24.10.2026: 49 Node-тестов прошли (один тест регистра путей предназначен для Linux), все 5 проверок генератора прошли. Установленный VSIX 0.4.0 проверен в VS Code 1.141.0 и VSCodium 1.140.0 на Windows: русские описания, имена/пояснения параметров, открытие read-only справки и пример ключевого слова. Все 34 исходных файла справки побайтово совпадают с оригиналом. Примеры справки массово не компилировались и на EV3 не исполнялись. В версии 0.3.0 проверено 24.10.2026: 44 Node-теста прошли, один тест регистра
путей рассчитан на Linux и пропущен на Windows. Все 3 проверки генератора
сигнатур прошли. Новые функции редактора проверяются в
Результат: каталог Что пока отсутствуетСнимок экрана физического EV3, полноценная аппаратная отладка с точными шагами и автоматическое системное сопряжение Bluetooth остаются вне реализации. Пояснения ошибок доступны; примеры из пользовательского PDF ждут сам документ. Реальные Wi-Fi/Bluetooth и SD требуют аппаратной приёмки. Desktop-расширение не запускает локальный .NET в браузерном vscode.dev; отдельная поддержка Astra Linux и macOS ещё не проверена. Сборка из исходниковИз каталога расширения, с Python 3, Node.js и SDK .NET 10.0.402:
Скрипт собирает CLI, включает его соответствующие исходники и создаёт VSIX
в
Windows-скрипт
В пакетном режиме тестовый host отдельно проверяет, что загружено расширение
из каталога установки VSIX, а не исходники из рабочей папки.
Фактические проверки 0.1.0
С версии 0.18.9 доступны F4 (сборка/загрузка, без EV3 — только сборка), F5 (сборка/загрузка/запуск), F6 и Shift+F5 (остановка). В заголовке файлового дерева EV3 выбирается область: программы, присутствующая SD-карта или вся файловая система. Полный режим поддерживает просмотр и скачивание системных файлов. Подробнее — ROBOT_WORKFLOW.md. В режиме «Реальным роботом» правая панель показывает настоящий LCD EV3 (178 × 128), полученный чтением framebuffer штатной прошивки. Захват работает и в меню, и во время выполнения программы, не запускает VM и не требует помощника на блоке. Частота зависит от соединения; устаревший кадр очищается. Боковая справкаСлева в Activity Bar появилась книга «Справка Clev3r». В панели можно искать команды и их описания, раскрывать разделы, читать параметры и примеры, переходить назад/вперёд и копировать примеры. «По коду» открывает описание команды под курсором, в том числе из её аргументов. Кнопка «Разделы» освобождает больше места для чтения. История и прокрутка сохраняются при переключении панелей. Команда Clev3r Lab: Боковая справка также доступна в палитре и контекстном меню кода. Прежние hover-подсказки и Clev3r: Справка со вкладкой сохраняются; из панели вкладка открывается кнопкой «Открыть во вкладке». Панель справки и правые показания EV3 могут оставаться открыты одновременно. Боковая справка входит в Clev3r Lab и устанавливается вместе с ним. Классы выделены бирюзовым, функции — песочным, параметры — голубым; примеры содержат подсветку синтаксиса. Светлая и контрастные темы получают свою палитру. Выключение EV3В палитре команд: Clev3r Lab: Выключить EV3, либо правой кнопкой по блоку в проводнике EV3 → Выключить EV3. После подтверждения расширение останавливает программу и моторы, синхронизирует файлы и отправляет команду выключения. Опрос отключается; после включения нажмите Подключить EV3. Сообщение подтверждает отправку команды, полное отключение питания удалённо не проверяется. Подробности: выключение EV3. В 0.21.9 показания реального EV3 обновляются независимо от передачи LCD. Целевой период опроса — 100 мс с учётом времени запроса; реальная частота USB/Bluetooth пока требует замеров. Экран остаётся включённым и собирается по частям; одинаковые пиксели не перерисовываются с каждым портовым кадром. Кнопка По коду в справке открывает статью по встроенной команде под курсором в редакторе (например, Открытая боковая справка автоматически переходит к команде по двойному клику на её имени в коде. Настройка Высоту каталога и статьи можно менять, перетаскивая горизонтальную границу между ними. При фокусе на границе работают стрелки ↑/↓, Shift для крупного шага, Home/End для границ. Пропорция сохраняется. Разделы по умолчанию свёрнуты; открытым остаётся один, поиск раскрывает совпадения временно. |