Перейти к содержанию

C# (Roslyn) — типизированные смарт-скрипты

Статус

Реализовано. Доступно с 2026-04-20.


Обзор

Пятый язык смарт-скриптов. Выполняется через Roslyn Scripting API — тот же компилятор C#, что и у ядра Первой Формы, внутри платформы и без внешних зависимостей.

Ключевое отличие от Lua, JavaScript и OneScript: те выполняются на стороннем движке с прослойкой преобразования данных, а C#-скрипт — это тот же C#, что и сама платформа. Скрипту напрямую доступны контекст сессии и сервисы платформы, без промежуточных преобразований.

Аспект JS (Jint) C# (Roslyn)
Типизация Нет Полная, на этапе компиляции
Асинхронность Ограниченная Нативные async/await, Task.WhenAll
Преобразование данных Через обёртки между JS и платформой Нет — прямой вызов сервисов
Ошибки Во время выполнения На этапе компиляции (до запуска)
Первый запуск ~5 мс ~100–200 мс (первая компиляция)
Повторный запуск Средняя скорость (интерпретация) Высокая скорость (после компиляции)
Изоляция Встроенная (лимит операций, таймаут) Таймаут (полная изоляция — в планах)

Версионирование — обязательно

То же правило что и для JS. Каждый C# SmartScript обязан содержать комментарий с версией и датой в начале скрипта:

// v1 | 2026-04-21 10:30 | Начальная версия
// v2 | 2026-04-22 15:45 | Добавлена проверка прав

Компиляция, кеш и память

Компиляция и выполнение разделены. На этапе компиляции из текста скрипта строится исполняемый код — это дорогая операция (~100–200 мс на первый запуск, до 1–3 с на крупный скрипт ~200 КБ). На этапе выполнения готовый код вызывается с подготовленным контекстом — это уже быстро (нативная скорость).

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

Проверка сохранённой компиляции при дочернем вызове

При дочернем вызове сохранённого C# SmartScript платформа проверяет, соответствует ли переданный код сохранённой компиляции. Сначала из записи скрипта выбирается только CompiledSourceHash — SHA-256 исходника, сохранённый при компиляции. SHA-256 переданного кода вычисляется потоково и сравнивается с этим значением.

Если хэши совпали, используется runner из кэша сохранённой компиляции: исходный код ScriptCode для такой проверки не загружается. Это уменьшает объём чтения и выделения памяти при повторных дочерних вызовах крупных скриптов.

Полное сравнение исходного кода сохранено как резервная ветка. Она применяется, если хэш ещё отсутствует у скрипта, сохранённого до появления precompile-колонок, или не совпал с переданным кодом — например, при запуске несохранённого текста из редактора либо после гонки параллельного сохранения. Если резервное сравнение подтверждает совпадение, обычный путь наполнения кэша повторно сохраняет актуальный хэш; если код различается, выполняется ad-hoc компиляция переданного текста.

Исполнение по id без чтения исходника

При дочернем вызове сохранённого C# SmartScript (RunScriptSync, RunScriptBackground) исходный код скрипта из базы не загружается вовсе — runner берётся из кэша сохранённой компиляции по scriptId.

Как это работает:

  1. SmartScriptService.GetSmartScript(id) возвращает проекцию GetScriptForRun — те же поля, что и раньше, но для C# ScriptCode приходит как null (маркер «код опущен, исполнить по id»). Сам исходник в базе не меняется.
  2. RoslynScriptEngine.ResolveRunner на этом пути делает CompiledSmartScriptCache.Get(scriptId) — без чтения ScriptCode и без SHA-256 по нему. Актуальность кэша обеспечивается при его наполнении (проверка версии/хеша) и кластерной инвалидацией при сохранении.
  3. Если runner в кэше отсутствует (язык переключили, строку удалили параллельно) — исходник дочитывается через GetScriptForCompile и компилируется ad-hoc; следующий вызов наполнит кэш обычным путём.

Если дочернему вызову передаётся сам код (например, несохранённый черновик из редактора), применяется сверка по CompiledSourceHash (см. выше). Source-движки (JS, OneScript, Lua, Python) этой оптимизацией не затронуты — их проекция по-прежнему отдаёт ScriptCode. Поведение скриптов (исключения, ошибки компиляции, проверки редакторских черновиков) не изменилось.

Ленивая загрузка кода при резолве по имени/id

При резолве SmartScript по имени или идентификатору (Include, RunScriptSync, RunScriptBackground) платформа загружает из базы только необходимые поля, а не полную запись скрипта:

  • C# Include — только идентификационные поля (Id, Description, LanguageId, IsLibrary, SubcatId). Исходный код (ScriptCode) и скомпилированные байты (CompiledAssembly) не читаются: C#-библиотеки исполняются из кеша скомпилированных сборок (CompiledSmartScriptCache).
  • Разрешение имени в идентификатор (name→id в JS, OneScript, SmartScriptService) — только Id.
  • Source-движки (JS, OneScript, Lua) — загружается ScriptCode (нужен для интерпретации), но не CompiledAssembly (это поле использует только C#-движок).

Резолв крупных библиотечных наборов (например, регистрация десятков модулей через Include на каждый запрос) не тянет из базы тяжёлые ScriptCode и CompiledAssembly. Семантика, синтаксис и ошибки резолва (неоднозначное имя, NotFound, несовпадение SubcatId) не изменились.

Когда происходит компиляция

Компиляция выполняется в следующих случаях: