Skip to content

Help plugins ru

Alex Miarsky edited this page Nov 10, 2026 · 1 revision

Плагины

Откройте Администрирование → Плагины и выберите проект. Общий сценарий: Выберите пакет → Проверьте содержимое → Активируйте в проекте. Пакет хранится на сервере; активация применяет манифест к одному проекту. Пустой каталог открывает стартовый экран без пустой боковой панели. Кнопка Руководство по плагинам в заголовке открывает эту инструкцию в любой момент.

Просмотр плагинов не мешает закрыть окно администрирования. При несохранённых изменениях или незавершённой операции окно остаётся открытым; сначала сохраните или отмените изменения.

Установить готовый пакет

  1. Нажмите Установить пакет. ZIP-файл загружает архив с этого компьютера; Ссылка для загрузки позволяет серверу скачать его по адресу. ZIP должен содержать manifest.xml и файлы плагина. Для ссылки можно указать контрольную сумму SHA-256 или MD5, предоставленную автором пакета.
  2. После загрузки откроется Обзор пакета. Прочитайте Документацию и проверьте Манифест XML. Загрузка файлов сама по себе ничего не активирует.
  3. Нажмите Проверить активацию. Проверьте пакет и проект в подтверждении, затем Активировать. Манифест может создавать и менять данные проекта, выполнять серверный код. Итоговое состояние показывает результат активации.

Для активации нужен рабочий проект, а не системные admin или sthpw. Изменения доступны администраторам с правом выполнения скриптов. Файлы встроенных пакетов доступны только для чтения, но сами пакеты можно активировать в проекте.

Создать свой плагин

Готовый пример: Workspace Pulse

В TS/examples/workspace_pulse лежит универсальный пример плагина. Соберите ZIP через TS/tactic_stream/tools/build_workspace_pulse.py, установите его здесь и активируйте в нужном проекте. Pulse показывает задачи, наличие сроков, общие фильтры, графики и очередь со штатным поиском. VFX overview находит имеющиеся типы эпизодов, сцен, шотов и ассетов. Страницы используют обычный сайдбар и нативный рендерер ТХ/ТС; их можно менять редактором страниц и внутренним агентом. Демо-записи и службы не создаются. Удаление/перезагрузка затрагивают конфигурации плагина: сначала экспортируйте собственные правки его страниц.

В ТХ вложенные таблицы дашборда используют обычный редактор колонок. При открытии дефинишена сохраняются тип и вид выбранной таблицы; вид основного поиска не меняется.

Новый пакет

  1. Нажмите Создать свой плагин на старте или Создать в каталоге.
  2. Укажите заголовок и уникальный код, например studio_tools. Поддерживаются буквы, цифры, подчёркивания, дефисы и пути из сегментов через /. Выберите тип и добавьте описание. Кнопки создания и отмены видны даже при прокрутке формы.
  3. Создать плагин создаёт пакет DEV и регистрирует его активным в выбранном проекте. Обзор покажет фактический результат. Добавьте файлы, документацию и записи манифеста через разделы редактора.
  4. Сохраните правки. Для применения данных изменённого манифеста выберите Другие действия → Перезагрузить плагин и прочитайте подтверждение. Сохранение файла и перезагрузка плагина — разные операции.
  5. Экспорт ZIP позволяет передать текущий пакет. Опубликовать версию создаёт отдельный каталог выпуска и ZIP без перезаписи существующей версии и автоматической активации. DEV не является номером выпуска.

Пустой пакет, виджет, колонка и тема используют штатные типы. Виджет начинается с современного переиспользуемого макета элемента. Пакеты используют существующие рендереры; установка не добавляет скомпилированный QML/Vue-компонент. Шаблон проекта экспортирует выбранный проект штатным механизмом шаблонов вместо создания и активации плагина.

Состав пакета: виджеты, колонки, темы, данные и Python

Откройте Состав пакета у активного плагина. Слева выберите ресурс, справа появится исходник или сохранённый предпросмотр. В узком окне редактор расположен под списком. Добавить ресурс предлагает:

  • Виджет: современный переиспользуемый sobject-layout с заголовком, описанием и заметками. Элемент view подключает вложенный макет. Композиции работают на страницах CustomLayout и в ячейках таблиц обоих клиентов.
  • Колонка: переиспользуемая композиция. В таблице укажите tactic.ui.table.CustomLayoutElementWdg, в его view — имя ресурса. Визуальная настройка доступна в Item layouts и Columns Editor. Предпросмотр использует реальную запись или демонстрационные данные для пустого типа.
  • Тема: светлый/тёмный фон, акценты и стиль общих контролов. Сохраните и нажмите Применить тему к проекту. Личный светлый/тёмный режим сохраняется. Использовать личное оформление, смена проекта или удаление выбранной темы возвращают личную палитру. CSS и клиентский код не исполняются.
  • Python-действие: штатный config/custom_script. Сохранение проверяет синтаксис без запуска. Введите JSON-объект аргументов, нажмите Выполнить Python-действие, подтвердите и прочитайте результат. Тот же зарегистрированный путь доступен через Script tools.
  • Данные проекта: тип объектов и необязательный код записи; пустой код означает все записи. Включить схему таблицы добавляет регистрацию и DDL. Удаление плагина удаляет выбранные записи; запись схемы владеет всей таблицей.
  • Обработчики установки и удаления: два Python-файла и запись манифеста python path="..." undo_path="...". Выберите любой файл для редактирования. Первый запускается при установке, второй — при удалении в обратном порядке манифеста.

Сохранение ресурса проверяет исходник, обновляет установленную запись и выгружает её SPT в пакет одной штатной транзакцией Command. Обработчики установки при сохранении не запускаются. Виджеты и темы обновляются сразу; изменения выборок манифеста требуют активации/перезагрузки. Несохранённые изменения блокируют переходы, запуск и экспорт. Конкурирующие изменения отклоняются.

Полноценный пример: Studio Review

Запустите TS/examples/studio_review/build.py, затем установите TS/releases/studio-review-1.0.0.zip в отдельный тестовый рабочий проект. Плагин добавляет таблицу studio/review, три записи, ссылку в навигации, переиспользуемый виджет с вложенной колонкой статуса/прогресса, светлую/тёмную тему, Python-действие и обработчики установки/удаления. В составе пакета откройте approve, введите {"review_code":"STUDIO_REVIEW_001"} и выполните. Запись получит Approved, 100% и имя утвердившего пользователя. Обновите таблицу. Попробуйте тему, экспорт, перезагрузку и удаление. Удаление убирает собственную таблицу, настройки и ссылку, возвращая личные цвета. Предварительно экспортируйте данные, которые хотите оставить.

Штатные выборки манифеста также переносят пайплайны, процессы, триггеры, нейминг, навигацию и другие настройки. Пакет может содержать Python-модули, файлы и подключаемые манифесты. Современные виджеты собираются из существующих контролов: пакет не компилирует новые QML/Vue-контролы и не исполняет легаси HTML/JavaScript в Handler. SQL views и исключённые легаси-подсистемы не входят в контракт.

Редактирование и обслуживание

Каталог показывает заголовок, версию, путь и состояние в проекте. Ищите по заголовку/коду/пути, используйте фильтр Активен в этом проекте или сверните каталог стрелкой. Перед сменой пакета или раздела сохраните либо сбросьте правки. Кнопки сохранения и сброса появляются в заголовке по необходимости. После обрыва запроса обновите данные и проверьте результат на сервере перед повторной попыткой.

  • Обзор: состояние активации, переходы к проверке, передача пакета и сведения.
  • Сведения о пакете: редактирование заголовка и описания. Существующие код и версия не меняются на месте; для нового выпуска используйте публикацию.
  • Манифест XML: штатный редактор с поиском, заменой и отменой. Сохранение меняет файл; применение данных выполняется активацией или перезагрузкой.
  • Файлы: переходы по папкам, редактирование UTF-8, загрузка и скачивание, создание файлов/папок, переименование, перенос относительных путей и удаление. Заменить файл подтверждает замену выбранного файла локальным. Стрелка возвращает в родительскую папку. Редактируются файлы до 2 МиБ; двоичные и большие скачайте для локальной правки. ZIP в этом разделе остаётся файлом; для распаковки используйте установку пакета. Манифест нельзя переименовать или удалить.
  • Документация: исходник doc/index.html или README; при отсутствии можно создать README.md. Легаси HTML в редакторе не выполняется.
  • Другие действия: перезагрузка, удаление из проекта, очистка данных проекта, очистка файлов .spt и удаление пакета — по состоянию выбранного плагина. Перезагрузка удаляет и заново устанавливает данные проекта. Удаление из проекта и очистка удаляют записи, описанные манифестом; файлы пакета остаются на сервере. Очистка .spt удаляет сгенерированные выгрузки. Удаление пакета удаляет файлы и архивы, только если пакет не используется ни одним проектом. Каждое разрушительное действие объясняет область изменений и требует подтверждения.

Записи используют штатный журнал Command, файлов и базы данных; устаревшие правки отклоняются. Установки и скрипты автоматически не повторяются. Браузер использует авторизованные PluginManagerCmd RPC и UploadServer, ТХ — штатный клиентский транспорт. Оба клиента используют общую схему Frame и не опрашивают сервер в простое. Пакеты и загрузки по ссылке находятся на выбранном сервере.

Старые SQL-представления, неизвестные узлы манифеста и экспорт вложенного плагина остаются явными ошибками ядра; неподдерживаемое содержимое не выдаётся за установленное.

Clone this wiki locally