---
name: visual-explainer
description: Создаёт и редактирует наглядные объяснения, интерактивные сцены и рассказы. Помогает исследовать механизм вместе с пользователем и выпускать HTML, видео или исходный проект.
---

# Наглядные объяснения

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

## Работа в Codex

`story_help` показывает доступные основы и проекты установленного комплекта. `story_open` открывает пример или сохранённую работу в MCP App. `story_create` создаёт редактируемый проект и возвращает его пути, IDs и задание подготовки. Выбери подходящую основу по содержанию, затем меняй её исходники.

Контекст текущего кадра прикрепляется автоматически одним обновляемым снимком. Обычное обсуждение остаётся в чате. Используй его `sessionId` и ревизии; при устаревшем состоянии или необходимости подробностей вызови `story_inspect`. Полная временная шкала и геометрия нужны только для конкретного вопроса. Не пересказывай технические IDs пользователю.

`story_find` находит cue, главу или предмет; учитывай тип результата при управлении. `story_control` меняет существующую сцену; простая пауза не требует предварительного inspect. Перемотка и исследование сохраняют исходники. Ручной ввод пользователя имеет приоритет. Для дополнительного объяснения используй `story_navigate`: оно откроется в той же панели с возвратом к уроку.

Для авторской правки прочитай проект и нужный файл через `story_inspect`, затем вызови `story_edit` с рабочей `sourceRevision` и новым `requestId`. Одна правка — один шаг отмены; подготовка запускается автоматически. Watcher подхватывает обычные файловые правки открытого проекта. Точный API узнавай через `story_help(query, projectId)` из закреплённой зависимости. Старый проект сохраняет свою библиотеку; обновляй её только через явный `story_migrate`, с возможностью undo.

`story_voice` показывает доступные местные голоса и включает/меняет синтез; mute лишь меняет слышимость текущей дорожки. Правка реплики сохраняет cue IDs и переиспользует неизменённые фрагменты. Тихое объяснение остаётся полноценным.

`story_review` проверяет закреплённую ревизию проекта и возвращает job. Выбери cue/интервал для состояний сцены или авторский `scenario` JSON для реального взаимодействия. Получи отчёт и кадры через `story_inspect(jobId)`; команда `inspect` из результата читает нужный эпизод или объект без повторной записи.

`story_produce` выпускает HTML, видео, субтитры или исходный архив. Проверяй фактический результат через `story_inspect(jobId)`; `story_cancel` останавливает подготовку, `story_retry` продолжает проверенные этапы. Инструменты видео готовятся автоматически. Рабочие файлы сохраняются вне кэша плагина; пользовательские значения по умолчанию доступны через `story_preferences`.

## Авторство и проверка

Исходники, библиотека и CLI находятся в одном комплекте. Из каталога этого навыка CLI запускается как `node ../../tools/scene.mjs`; у самостоятельного проекта после установки зависимости доступен `npx visual-story`.

Состав комплекта проверяй через `story_help` либо `examples --json`, доступные импорты — через `api`. Выбирай основу из этого ответа: плагин поставляет SVG/3D и морфинг, а `characters`, `book` и Higgs относятся к полной библиотеке и в него не входят. В плагине озвучкой владеет `story_voice`. Если системный Node отсутствует, используй поставляемый `../../runtime/node` вместо `node`.

- Для выбора представления и сложного авторства прочитай [приёмы объяснения](references/authoring-guide.md) и один подходящий исходник из каталога.
- Для рассказа и ручного исследования — [SceneShell и общий маршрут](references/scene-template.md).
- Для морфинга — [MathMorph и InkMorph](../../docs/morphing.md); для рассказа из преобразований — [MorphStory](../../docs/morph-stories.md).
- Для SVG/графика — [данные и публикация](references/data-plots.md); для вложенной модели — [камера и навигация](references/nested-explorer.md).
- Для разрешённой локальной озвучки — [сценарий и голос](references/narration.md). Доступность провайдера и его права проверяются отдельно от голоса Codex.
- Для проверки движения — [наблюдение и кадры](references/motion.md#проверка).

Библиотека владеет плеером, камерой, геометрией, подписями и синхронизацией. Задавай предметную модель и смысловые метки; не создавай для каждой сцены собственные часы или копию общих контролов. Общую ошибку исправляй у её владельца.

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