Netshards SyncWiki · v0.1.4Maya 2024 · Production pipeline
Актуальный рабочий процесс

Одна сцена.
Понятный статус.

Практическая Wiki для аниматоров, layout-художников, риггеров, моделлеров и художников по окружению. Здесь описан текущий Netshards Sync: от входа и checkout до Review, Publish и обновления ассетов.

Начать работуВыбрать свою роль
01 · Старт

Быстрый старт

После первой установки ежедневная работа начинается из верхнего меню Maya. Git, Python и права администратора художнику не нужны.

Запусти Maya 2024

Дождись меню Netshards Sync. Если меню не появилось, смотри раздел «Ошибки и поддержка».

Открой нужный Assembler

Project Assembler — задачи и шоты. Asset Assembler — библиотека опубликованных ассетов и Casting.

Войди под своим Kitsu-аккаунтом

Оба окна используют одну сессию, но открываются независимо. Выйти из аккаунта можно из профиля в любом окне.

Выбери проект и работай только через задачу

Плагин запоминает связь сцены с задачей. Это защищает версии, checkout и публикацию от случайного выбора другой строки.

!

Первая установка v0.1.4 выполняется через EXE. Дальнейшие обновления плагин скачивает, проверяет и устанавливает сам.

02 · Роли

Кому какое окно

Интерфейс скрывает разделы, где у пользователя нет назначенных задач. Поэтому у аниматора может не быть вкладки Assets, а у художника по ассетам — Sequence.

Шоты

Анимация и Layout

Открывай Project Assembler → Sequence. Здесь шоты, версии, статусы, checkout, кадры, видео и Casting.

Open→Review→Publish
Ассеты

Character, Rig, Environment, Props

Свои задачи публикуй через Project Assembler → Assets. Готовые ассеты для сцены бери в Asset Assembler.

Импорт→Новая версия
Проверка

Супервайзер

Открывай опубликованную версию без checkout для проверки. Решение по Review и статусу Approved принимается в Kitsu.

Preview→Approved
03 · Шоты

Project Assembler

Главное окно задач. Выбор строки не меняет связь уже открытой сцены: Review и Publish всегда относятся к задаче, записанной внутри текущего файла Maya.

Новый шот

«Открыть»

Если публикаций ещё нет, плагин создаёт рабочую сцену, подключает доступные ассеты из Casting и берёт checkout.

Есть версия

Открыть или «Продолжить»

Открыть загружает выбранную опубликованную версию. Продолжить возвращает к последнему локальному workfile.

Project Assembler ×
Overview
Sequence
Assets
Shots
Preview
Scene AssetsCurrent · Latest · Local
КолонкаЧто показывает
ВерсияВыбранная опубликованная версия сцены. Старые версии остаются воспроизводимыми.
StatusТекущий статус задачи из Kitsu. Обнови список круговой стрелкой после изменения.
AssetsСколько ассетов Casting присутствует в сцене.
CheckoutСвободна ли задача и кто сейчас редактирует её.
FramesДиапазон кадров задачи или опубликованного видео.
04 · Защита

Checkout без конфликтов

Checkout — временная блокировка редактирования задачи. Она не даёт двум художникам одновременно публиковать разные сцены в одну задачу.

Available

Свободно

При «Открыть», Start или «Продолжить» плагин заберёт checkout автоматически.

Ваше имя

Ваш checkout

Можно сохранять, обновлять references, отправлять Review и публиковать.

Другой художник

Только просмотр

Опубликованную сцену можно открыть read-only. Publish и обновление ассетов заблокированы.

i

Плагин продлевает checkout, пока Maya работает. При выходе из аккаунта или открытии другой сцены блокировка освобождается. После аварийного закрытия она истечёт автоматически.

05 · Отправка

Review → Approved → Publish

Review отправляет видео на проверку. Publish создаёт окончательную версию сцены. Эти действия не взаимозаменяемы.

WorkfileSave / Ctrl+S
ReviewPlayblast в Kitsu
FeedbackПравки
ApprovedРешение супервайзера
PublishСцена в облаке

Сохрани связанную сцену

Review работает с текущим открытым шотом. Проверь название задачи и кадры.

Netshards Sync → Review Shot

Плагин создаёт 1280×720 H.264 preview, добавляет комментарий и отправляет видео в Kitsu. Новая версия сцены при этом не создаётся.

Дождись Approved

Супервайзер проверяет видео в Kitsu. После правок отправь новый Review; старая проверка не подменяется.

Netshards Sync → Publish Shot

Плагин сохраняет текущую сцену, проверяет актуальный Review, статус Approved и checkout, затем загружает неизменяемую версию.

!

Не публикуй повторно только из-за ошибки комментария или статуса. Если файл уже загружен, плагин отдельно сообщит об этом. Повтор создаст лишнюю версию.

06 · Библиотека

Assets Assembler

Отдельное окно библиотеки Kitsu. Здесь отображаются только ассеты с опубликованной версией; пустые карточки в Scene Assets не попадают.

Assets Assembler ×
Overview
Characters Rigged
Characters
Environment
Props
Персонажи
A
Агу
C
Сайгак
Q
Qyran
E
Arena
P
Prop
Thumbnail
Открытая сценаCasting и версии
Открыт шот

Добавление в Casting и сцену

Выбери опубликованный ассет и нажми Добавить. Одно действие добавляет ассет в Casting и создаёт управляемый Maya Reference.

Произвольная сцена

Тест без задачи шота

Ассет можно подключить в пустую или любую локальную сцену. Справа будет указано: «Произвольная сцена · Casting отсутствует».

i

Категории берутся из Kitsu: Characters / Characters Rigged, Environment и Props. Карточки используют thumbnail и увеличенный preview Kitsu.

07 · References

Обновление ассетов в сцене

Опубликованный шот закрепляет точные версии ассетов. Новая публикация рига или локации не подменяет их автоматически.

ПолеЗначениеДействие
CurrentВерсия, уже подключённая в сценеНичего не меняется без решения художника
LatestПоследняя опубликованная версия ассетаСравни с Current
LocalСостояние локального кэшаПлагин скачивает только отсутствующий или повреждённый файл
ОбновитьLatest новее CurrentПерезагружает тот же reference node и сохраняет namespace
!

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

08 · Данные

Сцены, references и внешние файлы

Плагин поддерживает .ma и .mb, хранит опубликованные ассеты по версиям и не дублирует одинаковый reference для каждого шота.

В пакет сцены

Локальные зависимости

Текстуры, UDIM и image sequence, audio, Alembic, GPU cache, Arnold-файлы, USD и RigLogic DNA собираются автоматически, если путь доступен.

Отдельно

Maya References

Ассеты из Asset Assembler остаются отдельными версионными сущностями. В шоте хранится ссылка на точную опубликованную версию.

i

Локальный Maya Reference тоже поддерживается. Если он добавлен через Reference Editor, оставь его загруженным перед Publish: плагин упакует файл .ma/.mb и найденные вложенные зависимости вместе со сценой. Для версионных персонажей, локаций и реквизита всё равно используй Asset Assembler — тогда доступны Casting, Current/Latest и безопасное обновление.

!

Если текстура, cache, audio или другой внешний файл не найден, плагин покажет список. Можно пропустить отсутствующие файлы и продолжить Publish, но на другом компьютере этот контент останется пустым. Reference .ma/.mb перед публикацией должен существовать на диске и быть загружен.

Кэш общий для разных шотов: если одна и та же версия ассета уже проверена на диске, повторная загрузка не выполняется. Не удаляй всю папку PipelineCache вручную — там может быть неопубликованный workfile.

09 · Версия

Автоматическое обновление

При открытии Project Assembler или Asset Assembler плагин в фоне проверяет сервер релизов. Рабочий интерфейс при этом не блокируется.

Появляется «Доступно обновление»

Окно показывает установленную и новую версии. Можно выбрать «Позже» или «Обновить».

Установщик скачивается и проверяется

Плагин сверяет размер и SHA-256. Неполный или изменённый EXE не запускается.

Сцена сохраняется

Если Maya не смогла сохранить изменения, обновление откладывается и работа не закрывается.

Maya перезапускается с той же сценой

После успешной установки новая Maya открывает сохранённый .ma или .mb.

10 · Поддержка

Ошибки уже логируются

Плагин сохраняет техническую информацию локально и, после входа, отправляет обезличенный отчёт на backend в фоне. Содержимое сцен и файлы ассетов не отправляются.

Локальный журнал

Python, API и UI ошибки

%LOCALAPPDATA%\Netshards\Pipeline\logs\errors.jsonl

Журнал ограничен 5 МБ и ротируется. Пароли, токены и домашняя папка пользователя удаляются из текста.

Падение Maya

Native crash

%LOCALAPPDATA%\Netshards\Pipeline\logs\maya-scene-<PID>.log

После падения процесс уже не может отправить отчёт. Передай этот файл техническому специалисту.

i

В обращении укажи проект, шот/ассет, задачу, нажатую кнопку, примерное время и результат. Пароль и всю сцену отправлять не нужно. Исправление сначала согласовывается с владельцем проекта.

11 · FAQ

Частые вопросы

Короткие ответы для ситуаций, которые чаще всего останавливают работу.

Не вижу Sequence или Assets

Это нормально, если у аккаунта нет задач соответствующего типа. Проверь проект и назначения в Kitsu. Также сбрось фильтр возле поиска и нажми Refresh.

Шот открывается без права публикации

Посмотри Checkout. Если задачу держит другой художник, сцена открывается только для проверки. Если checkout Available, открой или продолжи задачу через Project Assembler.

Publish недоступен

Для шота нужны связанная сохранённая сцена, ваш checkout, актуальный Review и статус Approved. Для ассета выбери назначенную задачу в Project Assembler → Assets и используй «Импорт».

Почему ассет не появился в Assets Assembler?

В библиотеке показываются только ассеты с опубликованной сценой. Проверь тип ассета в Kitsu и наличие хотя бы одной успешной версии задачи.

Почему новая версия ассета не появилась в старом шоте?

Публикации воспроизводимы и не переключают references сами. Открой шот, выбери ассет с пометкой «Доступно обновление», нажми «Обновить», проверь сцену и опубликуй новую версию шота.

Review долго создаётся

Первый запуск может установить FFmpeg. Далее время зависит от диапазона кадров и размера viewport. После ошибки временный файл сохраняется, а его путь показывается в сообщении.

Можно открыть обе UI одновременно?

Да. Project Assembler и Assets Assembler — независимые окна одинаковой высоты; клик по нужному окну поднимает его поверх второго.

Ничего не найдено. Попробуй другое слово: например, checkout, Review или ассет.