Repository navigation
Handbook ru
English | Русский
История изменений описывает изменения каждой версии.
TACTIC-Handler — настольный клиент на Python 3 и Qt Quick для Southpaw TACTIC. Он объединяет в одном рабочем пространстве навигацию по проектам, поиск, управление объектами и задачами, просмотр публикаций, синхронизацию репозиториев, контролируемый check-in, автоматизацию, администрирование и тонкую интеграцию с DCC.
TACTIC остаётся единственным источником серверных данных. Handler не заменяет сервер TACTIC, базу данных, права доступа, пайплайны, правила именования или репозитории. Он предоставляет для них адаптивный нативный интерфейс и выносит медленные операции TACTIC, сети, репозиториев и файловой системы из UI-потока Qt.
Состояние проекта
Handler — прототип в разработке. Perforce-like workspace — отдельный незавершённый прототип. Перед рабочим развёртыванием нужна ручная приёмка на целевом сервере TACTIC, реальных репозиториях, Windows и нужном DCC. Перед обновлением смотрите готовность релиза.
- Возможности Handler
- Типичный рабочий процесс
- Требования
- Установка
- Первое подключение
- Интеграция с Maya
- Добавление нового DCC
- Скрипты и автоматизация
- Единый Handler API
- Конфигурация и серверное хранение
- Архитектура
- Структура репозитория
- Документация
- Разработка и проверка
- Эксплуатация и безопасность
- Известные границы
- Лицензия
- Нативное рабочее пространство PySide6/QML с доками, которые можно двигать, складывать во вкладки, менять по размеру, отделять в окна и восстанавливать.
- Именованные общепроектные пресеты раскладки. Пункт сайдбара может применять сохранённую раскладку при открытии своей вкладки поиска.
- Независимые вкладки поиска, сохраняющие запрос, загруженные страницы, выделение, раскрытые элементы, вид результатов, группировку, сортировку, позицию прокрутки и состояние доков.
- История недавно закрытых вкладок и меню всех вкладок, когда они перестают помещаться по ширине.
- Отдельные корни навигации для Handler и оригинального веб-интерфейса TACTIC:
- Handler использует представление
tactic_handler. - Оригинальный TACTIC использует представление
project_view.
- Handler использует представление
- Редактор сайдбара с обычным и XML-режимом, ссылками, секциями, разделителями, иконками, привязкой сохранённых поисков, начального вида результатов, раскладки рабочего пространства, скриптового шелфа и прав доступа.
- Предпросмотр сайдбара Handler от лица группы учётных записей. Администратор может редактировать структуру и сразу видеть, какие черновые пункты увидит modeller, rigger, supervisor или другая группа TACTIC.
- Русская и английская локализация интерфейса. Настроенные на сервере названия Search Type, пайплайнов, процессов, статусов, контекстов, групп и репозиториев показываются без перевода и переосмысления.
- Светлая и тёмная темы, выбор набора иконок, настройки текста и переключаемый бэкенд рендеринга Qt Quick.
Каждая вкладка поиска владеет одним полным запросом. Текст, теги, быстрые фильтры, ручные условия и условия на TACTIC Expression Language объединяются в один запрос, а не выполняются как несвязанные клиентские фильтры.
Доступны:
- широкий поиск по полям
name,title,keywordsиdescription; - асинхронные подсказки и открытие найденного средней кнопкой в новой вкладке;
- каталоги проектных тегов и выбор нескольких тегов;
- компактные Quick Filters по полям объекта и связанным задачам;
- опубликованные администратором раскладки и начальные значения Quick Filters;
- персональные изменения Quick Filters в каждой вкладке с возвратом к общепроектному стандарту;
- расширенный поиск с упорядоченными условиями
AND/OR; - текстовые, числовые, денежные, временные, пользовательские и списковые отношения, а также проверки на пустое и уникальное значение;
- фильтры
**Expressionна TACTIC Expression Language, включаяHave/Do not haveпо связанным объектам и заведомо более медленный Match по каждому объекту; - серверные Saved Searches с созданием, обновлением, переименованием, дублированием, копированием ссылки, удалением и обновлением каталога;
- обычная пагинация и непрерывная загрузка без сброса позиции;
- фильтрация показываемых процессов;
- серверная сортировка и группировка, включая статусы объектов и задач;
- дерево, карточки, таблица, компактные строки, версии справа и версии снизу.
Дерево результатов лениво загружает дочерние связи, процессы, задачи, снапшоты и версии. Если пользователь во время запроса сменил проект, вкладку, выделение или область данных, устаревший ответ не применяется к новому состоянию.
Handler строит форму объекта по текущему описанию TACTIC EditWdg. Сохраняются серверные порядок полей, заголовки, обязательность, режим только чтение, варианты выбора и фактические значения.
Поддерживаются:
- создание и редактирование проектных sObject;
- адаптивные формы для текста, многострочного текста, флагов, списков, пользователей, проектов, процессов, пайплайнов, статусов, дат, паролей, родителей, превью и миниатюр;
- массовое создание объектов с шаблонами
{n}и выравниванием нулями, например{n:03}; - мастер предпросмотра пачки, где каждый будущий объект можно отдельно изменить и снабдить своим превью до общего создания на сервере;
- создание и удаление связей в обоих направлениях;
- поиск в списках доступных и связанных объектов, непрерывная пагинация, множественное выделение и редактирование связей перетаскиванием;
- дублирование объектов;
- удаление с предварительным просмотром зависимостей;
- непосредственное редактирование полей базы, где это допускают контекст и права;
- Object Report с идентификацией, полями, задачами, заметками, детьми, снапшотами, файлами, активностью, рабочими часами и стоимостью.
Неподдерживаемые кастомные поля EditWdg остаются видимыми, но доступны только для чтения. Handler не подменяет их другим контролом и не рискует записать некорректное значение.
Snapshot Browser следует за текущими sObject, процессом, контекстом, снапшотом и файлом. В нём есть:
- режимы «Превью и файлы», «Только превью» и «Только файлы»;
- горизонтальное и вертикальное разделение панелей;
- «Вписать» для полного изображения и «Заполнить» для заполнения области с обрезкой краёв;
- выбор качества с учётом DPI: web-превью используется, пока его хватает, а оригинал запрашивается, когда физический размер изображения на экране требует большего разрешения;
- переход между всеми файлами выбранного снапшота, доступными для предпросмотра;
- представление версионных снапшотов и снапшотов
versionless/latest; - имя, роль, размер, репозиторий, путь, локальное состояние и актуальность файла;
- открытие, показ в проводнике, копирование пути, синхронизация и доступные DCC действия;
- использование нативной семантики File для путей и репозиториев вместо реконструкции пути из показанного имени.
Инструменты репозиториев включают:
- Repository Editor для серверных описаний и локальных путей под каждую платформу;
- выбор и проверку репозитория по умолчанию;
- Repository Sync по объекту, снапшоту, пресету процесса, дочерней области и диапазону версий;
- явную очередь передачи с прогрессом, политикой конфликтов, повтором и отменой;
- проверку актуальности по существованию, ожидаемому размеру и времени на сервере;
- необязательную полную проверку контрольной суммы;
- Watch Folders, привязанные к конкретным проекту, объекту, корню репозитория, правилам сопоставления и параметрам check-in.
Если локальный файл уже актуален, он используется сразу. Handler не создаёт для него видимую задачу скачивания и не делает лишний сетевой запрос.
Handler отделяет подготовку от выполнения: добавление файлов само по себе не означает, что они уже опубликованы.
Цепочка check-in поддерживает:
- отдельные файлы, последовательности, слои, UV/UDIM, анимации и многофайловые группы;
- области перетаскивания Publish и Attachment на объектах результатов;
- непосредственную публикацию иконки для поддерживаемых изображений;
- сканирование Drop Plate и сопоставление через Matching Templates;
- быструю загрузку и необязательные проектные правила загрузки;
- создание дочерних объектов из файлов вместе со связью и выбором поведения при совпадении имён;
- процесс, контекст, репозиторий, описание, метод передачи, версию, итоговое
имя,
versionless, правила именования и параметры превью; - предпросмотр версионных и
versionless-путей до отправки; - превью из файлов, буфера обмена и Screenshot Maker;
- объединённый или раздельный check-in для пачки файлов;
- отправку текущей операции, отмеченных операций или всех готовых операций в порядке очереди;
- безопасные границы отмены, повтор, прогресс, ошибки и сохранение незавершённых операций;
- автоматическое удаление успешно выполненных элементов.
Версию, путь репозитория, передачу файлов и создание снапшота TACTIC всегда контролирует автономный Handler. Сохранение сцены в DCC только подготавливает нативные данные для той же очереди отправки.
Полное рабочее пространство Tasks и компактные редакторы используют общее хранилище задач и поддерживают:
- области текущего объекта, выделенных объектов, Search Type, проекта, пользователя и команды;
- фильтры по процессу, исполнителю, статусу, дате, прогрессу, тексту и быстрые фильтры;
- таблицу, группы, календарь и Gantt;
- серверную фильтрацию, сортировку, группировку и пагинацию;
- выделение с Shift/Ctrl, черновые изменения, массовое редактирование, создание и удаление с зависимостями;
- настраиваемые колонки таблицы;
- историю задач и точную синхронизацию с Task Inspector;
- заметки с областью объекта, процесса или отдельной задачи;
- секции запланированных и незапланированных задач Gantt;
- изменение дат с учётом рабочих дней и ограниченной отменой или повтором;
- ввод рабочего времени, табель, состояние утверждения, календарь задач, рабочие и финансовые отчёты при наличии нужных серверных данных и прав.
Состояние рабочего пространства Tasks сохраняется отдельно для каждого проекта. Отмеченные строки и несохранённые изменения намеренно не восстанавливаются после перезапуска как будто это всё ещё действительные серверные операции.
- Notes для sObject, процессов и контекстов задач.
- Личные и групповые диалоги.
- Текст, ответы, упоминания, реакции, пересылка, закрепление, поиск, участники, состояние доставки и файлы беседы.
- Вложения через файловый диалог, изображение из буфера, Screenshot Maker и перетаскивание.
- Независимые черновики для каждой цели Notes и каждого диалога, сохраняемые при переключении и перезапуске.
- Проектный Activity Feed с изменениями объектов и задач, заметками, публикациями, рабочим временем и поддерживаемыми событиями связей.
- Внутренние уведомления о сообщениях и активности с независимыми переключателями.
- История и счётчики непрочитанного даже при отключённых всплывающих уведомлениях.
- Полный каталог Unicode emoji с категориями и поиском.
Уведомление — только краткий итог. Полные исключения, трассировки, параметры запросов и вывод скриптов остаются в Debug Log или исходном редакторе.
Handler содержит:
- серверный Script Editor для
config/custom_script; - дерево скриптов, общие вкладки, постоянные грязные черновики, номера строк, подсветку синтаксиса, поиск и замену, подсветку совпадений и токенов, автодополнение, структуру символов, переход к определению внутри файла и ограниченную историю правок;
- отдельный вывод для каждой вкладки со
stdout,stderr, результатами и трассировкой; - историю сохранённых редакций из нативных транзакций TACTIC;
- цели Local Python, Server Python, поддерживаемый Server JavaScript и выбранный DCC;
- выполнение выделенного фрагмента или всего исходника;
- проверенную синхронизацию проектных скриптов в локальное дерево
custom_scripts/<project>; - упорядоченные Script Triggers до и после действий Handler или DCC;
- любое число подходящих скриптов на одно действие с запуском сверху вниз;
- необязательные фильтры по Search Type, точному
search_key, процессу и контексту; - явную обработку ошибок: упавший триггер Before блокирует действие, а ошибка триггера After записывается в лог и не мешает следующим After-скриптам;
- персональные и общепроектные Script Shelves;
- общий шелф и переопределение для конкретной вкладки сайдбара;
- кнопки фиксированного размера с именем, иконкой, полной подсказкой и порядком;
- горизонтальную прокрутку при нехватке ширины;
- применение настроенного общего шелфа к текущей вкладке прямо из редактора;
- создание или замену нативного шелфа Maya при подключённом Maya-клиенте с нужной возможностью.
Триггеры открытия и сохранения снапшота оборачивают операции автономного Handler. События открытия, импорта, референса и сохранения сцены Maya явно помечены как Maya DCC и выполняются именно в клиенте, который совершает действие.
Нативное окно Administration доступно только администраторам TACTIC. Все изменения остаются локальными черновиками до явного сохранения.
Оно включает:
- каталоги Search Type, поля, заголовки, описания, цвета, превью, поддержку пайплайнов, счётчики, связи и ограничения безопасного удаления;
- создание проектных Search Type и дополнительных полей базы;
- граф схемы проекта, ключевые колонки, прямые связи, таблицы many-to-many, черновую раскладку и инспектор соединений;
- граф рабочих процессов, пайплайны, процессы, рабочие процессы статусов задач, зависимости, правила именования, триггеры и уведомления;
- пользователей, профили, пароли, деактивацию, повторную активацию и членство в группах;
- группы и их описания;
- матрицы доступа к проектам, пунктам сайдбара, действиям меню, Search Type, процессам и статусам задач;
- нативный XML/JSON для конфигурации, которой нет в обычной форме;
- проверку редакций и конфликтов, чтобы не перезаписать незаметно изменение другого администратора.
Холсты схемы и рабочих процессов поддерживают мышь и клавиатуру, групповое выделение и перемещение, редактирование соединений, панорамирование, масштабирование, центрирование, автоматическую раскладку и автопрокрутку у краёв. Удаление узла из схемы проекта не удаляет таблицу; разрушительное удаление Search Type — отдельная подтверждаемая операция.
- Структурированный Debug Log с фильтрами, живыми и сохранёнными сессиями, полными сообщениями, деталями, данными запросов, телами скриптов и трассировками.
- Маскирование секретов перед записью диагностики.
- ID запроса для маршрутизации и ошибок Handler Server.
- Ограниченный стек внутренних уведомлений.
- Сторож зависания интерфейса, сохраняющий стеки Python-потоков и нативный минидамп в Windows перед завершением безнадёжно зависшего процесса.
- Один экземпляр приложения: повторный запуск восстанавливает существующее окно.
- Необязательное закрытие в системный трей.
- Упорядоченное завершение опроса, рабочих потоков, очередей, наблюдателей, локального Handler Server, DCC-клиентов, моделей и логов.
- Запустите Handler и подключите пресет сервера с действующим билетом TACTIC.
- Настройте включённый репозиторий по умолчанию для текущей ОС.
- Активируйте проект в переключателе проектов.
- Откройте Search Type или Saved Search из сайдбара Handler.
- Уточните запрос текущей вкладки текстом, тегами, Quick Filters или Advanced Search.
- Выберите sObject. Следящие доки обновят его задачи, заметки, описание, снапшоты, файлы и активность.
- Просмотрите или отредактируйте объект, создайте/свяжите детей, обновите задачи, напишите сообщение, синхронизируйте файлы или подготовьте check-in.
- Проверьте в Commit Queue каждый файл, назначение, имя, версию, превью и параметр, затем явно запустите отправку.
- Для DCC-действия подключите и выберите точный DCC-клиент в верхней панели до открытия, импорта, референса, сохранения или запуска DCC-скрипта.
Большинство записей следует одному правилу: выбрать точную цель, подготовить черновик, проверить его, явно сохранить и обновить владеющее серверное представление.
- Python 3. Python 2 не поддерживается.
- Точная версия PySide6 из requirements.txt.
- Доступ к существующему серверу Southpaw TACTIC.
- Учётная запись и билет TACTIC с правами для нужных операций.
- Доступное хранилище репозитория и корректные сопоставления путей платформ для работы с файлами.
Исходный клиент TACTIC и пакеты совместимости уже находятся в thlib/side,
отдельно устанавливать их не нужно.
- Windows — основная среда приёмки настольного приложения. На ней проверяются системный трей, идентичность на панели задач, minidump, несколько мониторов и нативные окна.
- Репозитории поддерживают платформенные корни, но любая новая целевая платформа считается готовой только после ручной приёмки.
- Готовый рабочий DCC-коннектор в репозитории — Maya; нужна версия Maya с Python 3.
- Другие DCC подключаются отдельным манифестом тонкого коннектора и нативной реализацией. Наличие общего протокола само по себе не означает, что конкретный DCC уже поддерживается.
В этом репозитории находится клиент Handler. Он не устанавливает и не запускает сервер TACTIC.
Выполните команды из корня актуальной рабочей копии с файлом launch.py.
py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements.txtПри первой настройке или диагностике запускайте с видимой консолью:
python launch.pyПосле настройки можно запускать без консольного окна:
pythonw launch.pywlaunch.py и launch.pyw — поддерживаемые точки запуска. Их можно вызывать из
другой рабочей директории: пути приложения вычисляются от самой рабочей копии.
Перед распространением сборки проверьте зафиксированную среду выполнения в новом окружении Python:
python tests/run_clean_environment_smoke.pyДля контролируемой автономной установки передайте --wheelhouse PATH.
- Откройте Configuration → Server.
- Выберите или создайте пресет сервера.
- Укажите адрес сервера, портал и прокси, необходимые вашей установке.
- Нажмите Проверить, чтобы проверить текущий черновик без сохранения учётных данных.
- Нажмите Получить тикет, чтобы авторизоваться и сохранить подключение.
- Выберите проект через Configuration → Projects или главный переключатель проектов.
- Откройте Configuration → Repositories и задайте включённый доступный путь для репозитория по умолчанию.
Доступная конечная точка и действующий тикет — разные состояния. Сервер может отвечать без авторизации, а сохранённый тикет может истечь при по-прежнему доступном сервере.
При ошибке старта используйте окно ошибки приложения и Debug Log. Отдельно проверяйте адрес, VPN или прокси, билет, выбранный проект и путь репозитория — не повторяйте серверную запись вслепую.
Перетащите installer/drop_install.mel в область просмотра Maya. Выберите родительскую директорию установки и нужный набор действий, затем нажмите Установить.
Установщик:
- устанавливает Handler как
TACTIC-handlerвнутри выбранной директории; - создаёт шелф Maya
Niki_And_Friends; - предлагает наборы Animation, Modelling/Rig и Full;
- подключает все действия шелфа через одну тонкую среду выполнения;
- оставляет учётные данные TACTIC, настройки репозитория и check-in в автономном приложении.
В installer/README.md описано восстановление, если источник пакета недоступен.
Шелф Maya в итоге вызывает ту же рабочую точку запуска:
import importlib
import sys
HANDLER_PATH = "D:/TACTIC-Handler"
if HANDLER_PATH not in sys.path:
sys.path.insert(0, HANDLER_PATH)
from tactic_handler_dcc import maya
maya = importlib.reload(maya)
maya.startup(HANDLER_PATH)Запуск возвращает управление сразу. Он ищет работающий локальный Handler или запускает
launch.pyw, подключается в фоне и переиспользует уже подключённый клиент при
повторном вызове:
maya.status() # Текущее состояние старта и подключения.
maya.show_handler() # Показать или восстановить окно Handler.
maya.stop() # Завершить работу API, освободить дескрипторы и отключиться.Если одновременно подключено несколько Maya или других DCC, выберите нужный клиент в верхней панели Handler. Команда маршрутизируется по ID клиента, а не только по названию приложения.
Коннектор Maya объявляет только фиксированные зарегистрированные возможности: информацию о сцене, подготовку, проверку, сохранение, playblast, открытие, импорт, референс, выполнение скрипта и создание нативного шелфа. Handler показывает действие только тогда, когда выбранный клиент объявил нужную возможность.
Скачивание и загрузка репозитория никогда не переносятся в Maya. Handler сначала разрешает и синхронизирует файл, затем отправляет проверенный локальный путь точному клиенту. Сохранение сцены возвращает подготовленные данные, после чего Handler выделяет версию, переносит файлы и создаёт снапшот.
Поддержка DCC управляется манифестом. Обычная новая интеграция не требует менять центральные QML-меню, Handler Server, корень композиции, контроллеры check-in, меню триггеров или маршрутизацию Configuration.
Скопируйте два шаблона под одинаковым идентификатором приложения, например nuke:
tactic_handler_dcc/connectors/_template.py -> tactic_handler_dcc/connectors/nuke.py
tactic_handler_dcc/_template.py -> tactic_handler_dcc/nuke.py
Дальше:
- Задайте в манифесте идентификатор и название приложения, подписи, поддерживаемые действия и события триггеров, поля конфигурации и правила фокуса.
- Импортируйте SDK хоста внутри конструктора коннектора или нативных методов, чтобы автономный Handler мог обнаружить модуль без установленного DCC.
- Реализуйте диспетчер главного потока хоста.
- Регистрируйте только фиксированные нативные методы. Не создавайте заглушки для неподдерживаемых действий.
- Возвращайте из DCC локальные данные сцены и подготовки; не загружайте файлы в TACTIC из DCC.
- Добавьте необязательный обработчик закрытия хоста для корректного отключения.
- Перезапустите Handler, подключите новый клиент и проверьте страницу Configuration, действия объектов, действия Tools, триггеры и работу фокуса.
Действие объекта задаёт один контракт цели:
-
file: Handler синхронизирует опубликованный файл и передаёт локальный путь; -
scene_checkin: Handler запускает общую подготовку сцены и Commit Queue; -
item: Handler передаёт нативной команде структурированный контекст sObject или снапшота.
Полный контракт манифеста, возможностей, жизненного цикла и потоков описан в DCC API и протоколе тонкого клиента.
| Цель | Где выполняется | Для чего |
|---|---|---|
| Local Python | TACTIC-Handler | Доверенный UI-код, локальная оркестрация и отправленная через Handler API работа. |
| Server Python | Сервер TACTIC | Серверные операции, поддерживаемые установленной версией TACTIC. |
| Server JavaScript | Сервер TACTIC | Поддерживаемые серверные JavaScript-скрипты. |
| Selected DCC | Точный подключённый клиент | Нативные действия хоста через проверенный сохранённый скрипт или временный файл редактора. |
Local Python работает в UI-потоке Qt приложения Handler. Нельзя выполнять там блокирующую работу TACTIC, репозитория, базы, большой файловой системы или CPU; отправляйте операцию через открытый API. DCC-скрипты обязаны соблюдать правила главного потока своего хоста.
Каждый триггер получает TACTIC_SCRIPT_KWARGS. Основные значения:
data = TACTIC_SCRIPT_KWARGS
event = data.get("event")
phase = data.get("phase") # "before" или "after"
operation_id = data.get("operation_id")
project_code = data.get("project_code")
client_id = data.get("client_id")
targets = data.get("targets", [])
search_key = data.get("search_key")
process = data.get("process")
context = data.get("context")Цели и снапшоты здесь представлены обычными описаниями. Перед чтением полей, задач, связей или файлов получите настоящий объект через открытый API:
from tactic_handler_api import get_api
th = get_api()
data = TACTIC_SCRIPT_KWARGS
for target in data.get("targets", []):
key = target.get("search_key")
if key:
sobject = th.sobject(key)
print(dict(sobject.get_info()))До создания объекта search_key может отсутствовать. После успешного массового
создания новые ключи приходят в result_search_keys. Действие со снапшотом может
содержать search_key снапшота, чьи нативные объекты File доступны через
th.snapshot(...).
Шелфы дают быстрый доступ к сохранённым скриптам из панели Search.
- Персональные шелфы принадлежат текущей учётной записи.
- Общие шелфы принадлежат текущему проекту.
- У каждого владельца есть общий шелф и возможное переопределение для конкретной вкладки сайдбара.
- Общий шелф фиксирован: его нельзя переименовать или удалить.
- Шелфы отдельных вкладок имеют стабильный серверный идентификатор и редактируемое отображаемое имя.
- Кнопка хранит путь скрипта, подпись, иконку, подсказку и порядок.
- При нехватке ширины строка прокручивается горизонтально, а кнопки не сжимаются до нечитаемого состояния.
- Применить к этой вкладке назначает сохранённый шелф текущему пункту сайдбара.
- Создать/обновить шелф Maya доступно только для подключённой Maya с нужной возможностью. Созданный шелф Maya начинается с запускалки Handler и повторяет настроенные кнопки скриптов.
Пакет tactic_handler_api предоставляет один объектный API для Script Editor,
отдельного Python и подключённых DCC. Работа TACTIC и репозитория всё равно
выполняется в автономном Handler.
from tactic_handler_api import get_api
th = get_api()
operation = th.submit(
lambda: [project.get_code() for project in th.projects()]
)
# Прочитайте результат позже, когда операция завершилась.
if operation.done:
print(operation.result())Не вызывайте wait() и блокирующие методы данных из UI-потока Handler или DCC.
Обработчик, изменяющий UI DCC, нужно явно отправлять через отложенный диспетчер
этого хоста.
from tactic_handler_api import local
with local() as th:
result = (
th.project("demo")
.stype("types/object")
.query(limit=50, order_by=["name asc"])
)
for sobject in result.items:
print(sobject.get_code(), sobject.get_value("name"))Идентификаторы в примере условные. Handler не предполагает, что пространство имён Search Type совпадает с кодом проекта.
- проекты и Search Types;
- постраничные запросы объектов;
- поэтапное создание, редактирование и сохранение sObject, а также получение связей;
- задачи, заметки, снапшоты, зависимости, рабочие процессы, пайплайны, схема, учётные записи и группы;
- нативные метаданные File и семантика путей;
- сопоставление, локализация, открытие и показ файлов в файловом менеджере;
- просмотр и синхронизация репозиториев;
- Commit Queue без интерфейса;
- необязательная навигация UI по проектам, объектам, докам и окнам;
- асинхронные операции, обработчики прогресса, отмена, подписки и явное освобождение ресурсов.
Доступная удалённо поверхность API задаётся разрешающим списком в tactic_handler_api/contract.py.
Произвольный доступ к атрибутам Python и сгенерированный сетевой код не являются
частью протокола. Полные примеры и дерево методов находятся в
руководстве Handler API.
Рабочие настройки используют только thlib.environment.env_read_config и
env_write_config. Handler не использует QSettings, реестр Windows или
параллельный формат совместимости для рабочего состояния.
Примеры локальных и пользовательских данных:
- пресеты серверов и активное подключение;
- язык, тема, набор иконок, средство отрисовки и уведомления;
- геометрия и видимость окон;
- текущая раскладка доков;
- вкладки Search и состояние рабочего пространства Tasks отдельно по проектам;
- политика кэша и сохранённые каталоги;
- значения check-in по умолчанию и настройки DCC.
Каждой пользовательской постоянной настройке соответствует логичная страница Configuration. Внутренние кэши, временное выделение и активное состояние нативного модального редактора не выдаются за пользовательские настройки.
Handler использует нативные таблицы конфигурации TACTIC, а не заводит параллельную базу для локальных копий.
| Данные | Серверный владелец |
|---|---|
| Сайдбар Handler |
config/widget_config, search_type=SideBarWdg, view=tactic_handler
|
| Оригинальный веб-сайдбар |
config/widget_config, search_type=SideBarWdg, view=project_view
|
| Дочерние представления сайдбара | Связанные строки SideBarWdg в config/widget_config
|
| Сохранённые поиски и стандарты Quick Filter | Категоризированные записи config/widget_config
|
| Пресеты раскладки рабочего пространства | Категоризированные записи config/widget_config
|
| Общие и персональные Script Shelves | Категоризированные записи config/widget_config с областью проекта или учётной записи |
| Сохранённые скрипты | config/custom_script |
| Скриптовые триггеры и триггеры рабочих процессов |
config/trigger по соответствующим нативным контрактам |
| Tasks, Notes, Snapshots, Files, Users, Groups, Workflows и Security | Их нативные объекты и конфигурация TACTIC |
Переключатель TH/TACTIC в Sidebar Editor выбирает независимый корень, а не копирует сайдбар в локальные настройки. Предпросмотр группы — фильтр представления над черновиком и нативными правилами доступа, а не ещё один сохранённый вариант сайдбара.
flowchart TD
QML["Интерфейс Qt Quick\nthlib/ui/qml"]
CTRL["Контроллеры и модели для QML\nthlib/ui"]
CORE["Доменный и репозиторный слой TACTIC\nthlib"]
TACTIC["Удалённый сервер TACTIC"]
BRIDGE["Handler Server\nлокальный маршрутизатор с аутентификацией"]
DCC["Среда тонкого DCC-клиента и коннектор"]
QML --> CTRL
CTRL --> CORE
CORE --> TACTIC
CTRL <--> BRIDGE
BRIDGE <--> DCC
- QML отвечает за представление и временное состояние указателя и фокуса. В нём нет работы TACTIC, репозитория, базы или тяжёлой файловой системы.
- Контроллеры функций владеют запросами, проверкой, ошибками, поколениями запросов, отменой, публикацией моделей и постоянным состоянием функции.
-
ApplicationController— общий фасад навигации и координации для QML, а не универсальный владелец бизнес-логики. -
thlibвладеет нативными объектами TACTIC, семантикой репозитория и File, серверными процедурами и API совместимости. - Автономный Handler владеет аутентификацией, проектным состоянием, скачиванием, загрузкой, именованием, выделением версий и созданием снапшотов.
- Коннектор DCC владеет только фиксированными нативными действиями хоста и их отправкой в главный поток хоста.
- У каждого изменяемого состояния и побочного эффекта есть один ответственный владелец. Остальные представления используют проекции и отбрасывают устаревшие результаты.
Handler Server — отдельный локальный процесс, соединяющий настольный клиент с одним или несколькими тонкими DCC-клиентами.
- Слушает только
127.0.0.1на временном порту. - Обнаружение относится к конкретным пользователю и сессии.
- Каждая серверная сессия получает случайный токен рукопожатия.
- Клиенты регистрируют ID, тип приложения, ID процесса и возможности.
- Проверки соединения, переподключение, ID запросов, тайм-ауты и ошибки отключения явные.
- Маршрутизация определяется выбранным ID клиента.
- Протокол использует JSON с префиксом длины и пределом 1 MiB.
- DCC может выполнить только методы, зарегистрированные в
CommandRegistry. - Сгенерированный Python-код и данные для
evalиexecзапрещены.
Подробности: архитектура Handler Server.
- Сетевые и TACTIC-запросы выполняются в принадлежащих функциям пулах рабочих потоков.
- Репозиторий и тяжёлая файловая работа никогда не идут в UI-потоке.
- Запросы несут поколение или идентификатор операции, поэтому поздний ответ не изменяет уже другую вкладку, проект или новый жизненный цикл контроллера.
- Неактивный тяжёлый док ненадолго сохраняет содержимое для быстрого переключения, затем освобождает его для ограничения памяти.
- Опрос сообщений, активности, реакций и присутствия общий, а не создаётся отдельно каждым представлением.
- Завершение работы упорядочено и идемпотентно.
| Путь | Назначение |
|---|---|
launch.py, launch.pyw
|
Поддерживаемые консольная и оконная точки запуска. |
thlib/ui/ |
Текущее приложение PySide6/QML: контроллеры, модели, сервисы, справка, переводы и ресурсы. |
thlib/ui/qml/ |
Представления функций, хосты, адаптивные раскладки и общие элементы управления. |
thlib/ |
Доменная модель TACTIC, запросы, серверные процедуры, репозитории, файлы и среда выполнения. |
thlib/side/client/ |
Встроенный транспорт унаследованного клиента TACTIC и код совместимости из исходного проекта. |
handler_server/ |
Локальное обнаружение, протокол с аутентификацией, маршрутизация, реестр клиентов, тайм-ауты и жизненный цикл процесса. |
tactic_handler_dcc/ |
Среда тонких DCC-клиентов, открытые удалённые объекты, манифесты коннекторов, запуск Maya и шаблоны. |
tactic_handler_api/ |
Единый открытый API Handler и разрешённые контракты. |
custom_scripts/ |
Локальные зеркала проектных скриптов и серверные или репозиторные модули скриптов. |
installer/ |
Установщик Maya с перетаскиванием и ресурсы шелфа. |
project_templates/ |
Ресурсы шаблонов проектов для поддерживаемых сценариев настройки. |
docs/ |
Архитектура, контракты функций, руководства API, справочник базы, тестирование и документация релизов. |
tests/ |
Модульные, контроллерные, QML-, протокольные, архитектурные, интеграционные, дымовые и предрелизные проверки. |
thlib/ui — единственный актуальный пакет интерфейса приложения. Удалённые экраны
QWidget и запускалки совместимости не являются путями выпуска.
Начните с индекса документации.
Приложение напрямую читает UTF-8 Markdown из
thlib/ui/help_articles. По возможности у темы есть
английский и русский варианты. Поддерживаются заголовки, таблицы, списки,
цитаты, ссылки, изображения и ограждённые блоки кода. При отсутствии перевода открывается
английский вариант.
Основные темы:
- Обзор
- Начало работы
- Поиск и фильтры
- Создание и редактирование sObject
- Check-in
- Commit Queue
- Snapshot Browser
- Задачи и планирование
- Заметки и сообщения
- Репозитории
- Script Editor
- Script Triggers
- Script Shelf
- Sidebar Editor
- Администрирование
- Архитектура приложения
- Текущее поведение UI
- Политика UI-компонентов
- Архитектура поиска
- DCC API
- Единый Handler API
- Архитектура Handler Server
- Контракт сообщений и Activity Feed
- Политика кэша и сброса данных
- Карта совместимости TACTIC
- Справочник базы TACTIC
- Стратегия тестирования
- Чеклист приёмки релиза
Установите зависимости разработки:
python -m pip install -r requirements-dev.txtВо время разработки запускайте нужные модули unittest:
python -m unittest tests.test_contracts tests.test_controller_scenarios -vПроверка настоящего корня композиции QML в заэкранном режиме:
python -m unittest tests.test_qml_smoke_harness -vДымовой стенд использует изолированные настройки и не запускает обычную инициализацию TACTIC, Handler Server или опрос сервера.
python tests/run_isolated_suite.pyКаждый тестовый модуль запускается в отдельном процессе, чтобы глобальное состояние Qt Quick, шрифтов, буфера обмена, сокетов и движка QML не протекало между модулями.
Строгая команда проверки перед слиянием и выпуском:
python tests/run_release_gate.pyОна проверяет рабочее дерево и пробельные символы, запускает Ruff и qmllint,
компилирует Python, выполняет изолированный набор, загружает обе точки запуска
из другой рабочей директории и проверяет жизненный цикл настоящего корня QML
в заэкранном режиме.
Только во время разработки --allow-dirty разрешает грязное рабочее дерево,
сохраняя остальные проверки. Этот параметр не предназначен для кандидата в релиз.
Автоматическая проверка намеренно не притворяется, что проверила живую авторизацию, права, изменения, репозитории, трей и несколько дисплеев Windows или Maya. Ручные результаты записываются по инструкции готовности релиза.
- Сохранять серверные названия и нативную семантику объектов.
- Не помещать транспорт и бизнес-логику в QML.
- Не выполнять TACTIC, сеть, базу, репозиторий или тяжёлую работу в UI-потоке.
- Использовать нативные методы File для идентификации репозитория, пути, предпросмотра, размера и проверки актуальности.
- Направлять команду DCC точному выбранному ID клиента.
- Делать сфокусированные изменения и обновлять регрессионные проверки и документацию вместе с поведением.
- Не трогать посторонние пользовательские изменения в грязном рабочем дереве.
- Считать предупреждения QML, циклы привязок, утечки жизненного цикла, отсутствующие полосы прокрутки и дефекты раскладки при высоком DPI настоящими ошибками.
Общие правила репозитория находятся в AGENTS.md, правила UI — в thlib/ui/AGENTS.md.
- Запускайте скрипты только доверенных авторов. Локальные и DCC-скрипты имеют все возможности своего процесса хоста и авторизованного пользователя.
- Handler Server — локальный мост DCC, а не удалённый сервис автоматизации. Он отвергает конфигурацию с доступом не только через loopback-интерфейс.
- Токены, тикеты, пароли и секреты подключения нельзя коммитить или прикладывать к отчётам.
- Debug Log маскирует учётные данные, но намеренно сохраняет полные несекретные диагностические данные.
- Удалённые сессии и дескрипторы Handler API ограничены и освобождаются после бездействия.
- Записи не повторяются автоматически. Сначала исправьте причину, затем явно повторите операцию, чтобы не создать дубликаты.
- Политика конфликтов и перезаписи в репозитории всегда явная. Обнаружение ничего не копирует и не удаляет.
- Удаление определения Watch Folder не удаляет саму директорию.
- Отмена команды DCC кооперативная: она не может прервать нативный вызов API хоста, уже выполняющийся в главном потоке хоста.
- Нужен настроенный поддерживаемый сервер TACTIC; дистрибутив сервера в репозиторий не входит.
- Поведение сервера, процедуры, плагины, схемы, права и раскладки репозиториев различаются между установками и требуют живой приёмки.
- Maya — готовая DCC-реализация в репозитории. Шаблон коннектора показывает путь расширения, но не доказывает готовность другого DCC.
- Текущий транспорт Handler Server — локальный JSON/TCP с префиксом длины, а не WebSocket.
- Очередь команд DCC не сохраняется между перезапусками Handler Server.
- Отмена не может принудительно остановить уже выполняющийся вызов Maya API.
- Разрушительные серверные, схемные, репозиторные и DCC-сценарии проверяются только в изолированных проекте, репозитории и сцене.
TACTIC-Handler распространяется по Eclipse Public License 1.0. Встроенные сторонние компоненты и шрифты сохраняют собственные лицензии и файлы атрибуции.
TACTIC-Handler · Releases · Issues · English · Русский
English
- Home
- Installation
- Feature tour
- User guide
- Assistant
- Dashboards
- Knowledge Base
- Maya / Shelf
- Plugins / Плагины
Русский
- Главная
- Установка
- Обзор возможностей
- Руководство пользователя
- Помощник
- Дашборды
- База знаний
- Maya / Shelf
- Plugins / Плагины
Development / Разработка