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.
Как это работает:
SmartScriptService.GetSmartScript(id)возвращает проекциюGetScriptForRun— те же поля, что и раньше, но для C#ScriptCodeприходит какnull(маркер «код опущен, исполнить по id»). Сам исходник в базе не меняется.RoslynScriptEngine.ResolveRunnerна этом пути делаетCompiledSmartScriptCache.Get(scriptId)— без чтенияScriptCodeи без SHA-256 по нему. Актуальность кэша обеспечивается при его наполнении (проверка версии/хеша) и кластерной инвалидацией при сохранении.- Если 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) не изменились.
Когда происходит компиляция¶
Компиляция выполняется в следующих случаях: