Карточки персонажей9 минут чтения

Импорт и экспорт карточки персонажа: JSON, PNG и CHARX

Как перенести карточку ИИ-персонажа в Scenly из файла и как скачать свою. Чем отличаются JSON, PNG и CHARX, что происходит с полями при импорте и что делать, если файл не загружается.

Автор
Scenly
Опубликовано

TL;DR

  • Карточку можно загрузить в Scenly из файла JSON, PNG, APNG или CHARX — поля формы заполнятся автоматически, и всё можно поправить перед сохранением.
  • JSON — это просто текст карточки. PNG — та же карточка, вложенная внутрь картинки. CHARX — архив: карточка плюс её файлы-ассеты.
  • Scenly понимает все версии спецификации — CCv1, CCv2 и CCv3 — и сам повышает старую до новой.
  • Свою карточку можно скачать в любом из трёх форматов из меню персонажа.
  • Если файл не загружается, причина всегда одна из пяти: это не карточка, в PNG нет данных, в CHARX нет card.json, файл повреждён или файл слишком большой.

JSON, PNG или CHARX: что выбрать

Все три формата хранят одну и ту же карточку. Разница — в упаковке и в том, что помещается рядом.

JSON — текстовый файл. Внутри только данные: имя, описание, характер и остальные поля. Картинок и файлов в нём нет.

PNG — обычная картинка, внутрь которой вложен текст карточки. Такой файл можно открыть как изображение, и при этом он остаётся полноценной карточкой: платформа читает скрытый текст и восстанавливает все поля. Внутри PNG карточка лежит в двух копиях: актуальной V3 и упрощённой V2 — вторую читают приложения, которые ещё не знают V3.

CHARX — zip-архив. В корне лежит card.json — та же карточка, что и в JSON-файле, — а рядом файлы-ассеты: иконка, фон и всё, что автор приложил к карточке. Это самый полный формат: он переносит не только тексты, но и файлы.

JSONPNGCHARX
Что внутриТолько данныеДанные + картинкаДанные + файлы-ассеты
Можно открыть как изображениеНетДаНет
Портрет персонажа прилагаетсяНетДа, сам файл и есть портретДа, иконка из архива
Файлы карточки (иконки, фоны)НетНетДа
РазмерМеньшеБольшеСамый большой
Для чего удобенПравка, обмен текстом, бэкапПубликация, обмен «одним файлом»Перенос карточки вместе с файлами

Практическое правило: для правки удобнее JSON, для публикации и обмена — PNG, для переноса карточки вместе с файлами — CHARX.


Как импортировать карточку

Импорт доступен на странице создания персонажа.

  1. Откройте форму нового персонажа.
  2. Найдите блок «Импорт карточки» и выберите файл .json, .png, .apng или .charx.
  3. Поля формы заполнятся данными из файла. Появится подтверждение: «Карточка загружена. Проверьте поля и сохраните».
  4. Просмотрите поля, поправьте то, что нужно, и сохраните.

Импорт не создаёт персонажа сразу — он только заполняет форму. Пока вы не нажали «Сохранить», ничего не появится в вашей библиотеке. Это позволяет посмотреть, что внутри файла, и отказаться, если карточка не нравится.

Если в форме уже были заполненные поля, платформа спросит подтверждение: «Поля формы будут заменены данными из файла. Продолжить?»


Что происходит с полями при импорте

Импорт — это не копирование файла один в один, а приведение карточки к формату Scenly.

Версия повышается автоматически. Файл в формате CCv1 или CCv2 превращается в CCv3: недостающие поля добавляются пустыми. Старые карточки V1 — плоский JSON без блока data, где все поля лежат в корне файла, — оборачиваются в современный формат целиком. Ничего конвертировать руками не нужно.

Отсутствующие поля не ломают импорт. Если в файле нет, например, сценария или примеров диалогов, эти поля просто останутся пустыми. То же с null вместо текста: генераторы карточек иногда пишут его там, где должен быть пустой текст, — платформа читает это как «не задано». Обязательное после импорта одно — имя: если его в файле нет, платформа попросит указать.

HTML превращается в текст. Если автор карточки вставил в поля разметку, теги убираются, а текст остаётся. Служебные конструкции формата — макросы {{char}} и {{user}}, разделитель <START> — сохраняются как есть.

Метки приводятся к единому виду. Дубли склеиваются, пустые отбрасываются. Если метка уже существует в каталоге, персонаж подключится к ней; если нет — метка создастся.

Метка 18+ переносится. Если карточка помечена как взрослая, этот признак сохранится. Показ таких персонажей в каталоге зависит от настройки 18+ в вашем профиле.

Портрет из PNG становится фото. При импорте PNG-карточки сама картинка добавляется персонажу как первое фото. Отдельно загружать её не нужно. Анимированная карточка APNG читается так же, а портретом становится её первый кадр — галерея хранит неподвижные изображения.

Файлы из CHARX переезжают вместе с карточкой. Иконка из архива становится первым фото, остальные ассеты — фоны и прочие файлы — сохраняются за персонажем и возвращаются на место при экспорте. Если вложения перенести не удалось, карточка всё равно сохранится: платформа предложит импортировать файл ещё раз, чтобы доложить файлы.

Служебные поля платформы перезаписываются. Имя автора карточки заменяется на имя вашего аккаунта, версия спецификации проставляется платформой. Это данные о том, кто и в каком формате хранит карточку, — они не переносятся из файла.


Как экспортировать свою карточку

Экспорт доступен из меню действий с персонажем.

  1. Откройте своего персонажа.
  2. В меню действий выберите «Экспорт JSON», «Экспорт PNG» или «Экспорт CHARX».
  3. Файл сохранится в загрузки браузера с именем персонажа.

Что стоит знать про экспорт:

  • JSON сохраняется с отступами — такой файл удобно открывать и править в текстовом редакторе.
  • PNG собирается из первого фото персонажа. Если фото нет, вместо портрета будет нейтральная заглушка — данные при этом полноценные. Внутрь картинки кладутся обе копии карточки: V3 и упрощённая V2 для старых приложений.
  • CHARX собирается как самодостаточный архив: карточка и все её файлы, а если своей иконки у карточки нет — обложка добавляется как основная иконка.
  • Если персонаж помечен 18+, в скачанном файле эта пометка сохранится — чтобы при импорте в другой сервис карточка не потеряла признак.
  • Экспорт — это копия. Изменения в файле не влияют на персонажа в Scenly, пока вы не импортируете файл обратно.

Экспорт — самый простой способ сделать резервную копию карточки перед рискованной правкой: скачали, поэкспериментировали, не понравилось — импортировали обратно.


Перенос из других сервисов

Формат карточек открытый, поэтому файлы из других площадок обычно импортируются без проблем. Но набор поддерживаемых полей у всех разный, и часть данных может не подхватиться.

Что переносится хорошо: имя, описание, характер, сценарий, первое сообщение, примеры диалогов, системный промпт, метки, лорбук, а в CHARX — ещё и файлы-ассеты.

Что может потеряться: данные, которые исходный сервис хранил в своих расширениях, — они останутся внутри файла, но Scenly их не прочитает. А при переносе PNG в старое приложение, которое читает только V2, пропадут поля новой версии — псевдоним, групповые приветствия, ассеты — и директивы @@ из лорбука: старый формат их не понимает.

После импорта всегда просмотрите поля: то, что в другом сервисе выглядело одним способом, здесь может требовать поправки.

Разбор всех полей — в статье «Все поля карточки персонажа».


Если файл не загружается

Ошибок импорта пять, и у каждой понятная причина.

«Ожидается карточка chara_card_v2 или chara_card_v3». Файл — не карточка. Либо это вообще другой JSON, либо карточка без обязательной структуры — например, плоский файл старого формата, в котором нет даже имени. Проверьте, тот ли файл выбран.

«В PNG нет карточки персонажа». Картинка открылась, но внутри неё нет вложенных данных. Так бывает с обычными изображениями, которые не являются карточками, и с PNG, сохранёнными нестандартным способом.

«В CHARX нет файла card.json». Архив открылся, но карточки в нём нет — внутри только файлы. Так бывает с обычными zip-архивами и с CHARX, собранными не по спецификации.

«Файл повреждён». Данные внутри есть, но прочитать их не получается: файл обрезан при передаче, пересохранён с потерей данных или изначально собран с ошибкой. Попробуйте скачать файл заново из первоисточника.

«Файл слишком большой». Лимиты: текст карточки — 512 КБ, PNG — 5 МБ, CHARX-архив — 20 МБ (один файл внутри — до 8 МБ, всего до 64 файлов). Обычно превышение означает, что в карточку вложили очень длинные тексты или тяжёлую картинку. Сократите тексты, сожмите изображение или уберите лишние файлы из архива.

Если ошибка повторяется на файле, который точно рабочий, — напишите нам через форму обратной связи, приложив файл: разберёмся.


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

Импорт перезапишет моего существующего персонажа? Нет. Импорт всегда создаёт нового персонажа. Чтобы обновить существующего, импортируйте файл в форму редактирования — там перед заменой полей будет подтверждение.

Можно ли импортировать JSON без картинки? Да. JSON — самодостаточный формат, персонаж создастся без фото. Портрет можно добавить позже в редакторе.

Можно ли импортировать старую карточку V1? Да. Плоский JSON без блока data — это формат CCv1, платформа сама обернёт его в современный вид. Единственное условие — в файле должно быть имя персонажа.

Что будет с файлами внутри CHARX? Они переезжают вместе с карточкой: иконка становится первым фото, остальные ассеты хранятся за персонажем и возвращаются на место при экспорте.

Что будет с лорбуком при импорте? Он переносится целиком: записи, ключи, настройки. Если в исходной карточке лорбука не было, вкладка останется пустой.

Можно ли скачать карточку другого автора? Нет. Экспорт доступен только для своих персонажей. Чужие карточки можно читать на их страницах, но файлом забрать их нельзя.

Сколько раз можно экспортировать? Ограничение только от злоупотреблений: до 30 скачиваний в час на все форматы вместе. Для обычной работы этого более чем достаточно.

Зачем экспортировать, если персонаж уже сохранён? Для резервной копии, для переноса в другой сервис и для правки в текстовом редакторе с последующим импортом обратно.

Потеряются ли настройки лорбука при экспорте в JSON? Нет. JSON хранит карточку целиком, включая лорбук со всеми записями и настройками.

Откроется ли CHARX в других сервисах? CHARX — формат из спецификации CCv3, его понимают приложения с поддержкой этой версии. JSON и PNG остаются самыми универсальными: их читают и старые площадки.


Что дальше

  1. Все поля карточки персонажа — что проверять после импорта.
  2. Что такое карточка ИИ-персонажа — устройство карточки и разница версий CCv1/CCv2/CCv3.
  3. 7 ошибок, из-за которых персонаж получается плоским — чеклист, если импортированная карточка играет плохо.

Импортировали и хотите улучшить? Начните с описания персонажа — это поле сильнее всего влияет на качество ответов.