Petdex

Установка и выбор анимированных талисманов petdex для VibeOS.

Метаданные навыка

Источник	Встроенный (устанавливается по умолчанию)
Путь	skills/productivity/petdex
Версия	1.0.0
Автор	VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	petdex, mascot, display, cli, tui, desktop

Справочник: полный SKILL.md

к сведению

Далее приведено полное описание навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

Навык Petdex

Просматривайте, устанавливайте и выбирайте анимированные талисманы-«питомцев» из публичной галереи petdex. Установленный питомец реагирует на активность агента (бездействие, выполнение инструмента, проверка, ошибка, завершение) в CLI, TUI и десктопном приложении VibeOS. Этот навык управляет CLI-командой vibeos pets и настройкой display.pet — он не генерирует спрайты.

Когда использовать

• Пользователь хочет получить талисман для рабочего стола/терминала или спрашивает о «питомцах» / petdex.
• Пользователь хочет сменить, просмотреть или отключить активного питомца.
• Диагностика причин, по которым питомец не отображается (поддержка графики в терминале, конфигурация).

Предварительные требования

• Сетевой доступ к petdex.dev для получения галереи/манифеста (только чтение, без аутентификации).
• Pillow (основная зависимость VibeOS) для декодирования спрайтов — уже установлен.
• Для полноценного отображения в терминале: терминал с поддержкой графики (kitty, Ghostty, WezTerm, iTerm2 или sixel). В противном случае автоматически используется резервный вариант — Unicode с полублоками в truecolor.

Как запустить

Используйте инструмент terminal для выполнения vibeos pets <подкоманда>.

Краткая справка

Цель	Команда
Просмотр галереи	vibeos pets list (добавьте подстроку для фильтрации: vibeos pets list cat)
Список установленных питомцев	vibeos pets list --installed
Установка питомца	vibeos pets install <slug> (добавьте --select, чтобы сделать его активным)
Выбор активного питомца	vibeos pets select <slug> (без slug откроется выбор)
Изменение размера питомца везде	vibeos pets scale <коэффициент> (например, 0.5, ограничение 0.1–3.0)
Предпросмотр/анимация в терминале	vibeos pets show [slug] [--cycle] [--state run]
Отключение питомца	vibeos pets off
Удаление питомца	vibeos pets remove <slug>
Диагностика настройки	vibeos pets doctor

Процедура

1. Найдите питомца: vibeos pets list <запрос> и запомните его slug.
2. Установите и активируйте: vibeos pets install <slug> --select.
3. Просмотрите его: vibeos pets show (Ctrl+C для остановки).
4. Подтвердите настройку: vibeos pets doctor — показывает выбранного питомца, настроенный режим рендеринга, обнаруженный графический протокол терминала и эффективный режим.

Питомцы устанавливаются в <VIBEOS_HOME>/pets/<slug>/ (с учётом профиля). Выбор питомца записывает display.pet.slug + display.pet.enabled в config.yaml.

Конфигурация

В разделе display.pet файла config.yaml:

• enabled (bool) — главный включатель/выключатель.
• slug (str) — активный питомец; пустое значение = первый установленный.
• render_mode — auto (определить) | kitty | iterm | sixel | unicode | off.
• scale (float) — размер на экране для исходных кадров 192×208 (по умолчанию 0.33, ограничение 0.1–3.0). Один регулятор изменяет размер на всех поверхностях; устанавливается командой vibeos pets scale <коэффициент>, слеш-командой /pet scale или ползунком «Внешний вид» в десктопном приложении.
• unicode_cols (int) — ширина в колонках для резервного варианта Unicode.

Возможные проблемы

• Питомец отображается только после установки И выбора (enabled: true).
• Внутри конвейера/перенаправления (нет TTY) рендеринг в терминале отключён по дизайну.
• npm CLI petdex устанавливает питомцев в ~/.codex/pets; VibeOS использует собственное хранилище с учётом профиля <VIBEOS_HOME>/pets/ — устанавливайте через vibeos pets.

Проверка

• vibeos pets doctor сообщает ✓ ready, когда питомец установлен, выбран, включён и Pillow импортируется.