Найти причину

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

Пакет не открывается

Симптом	Что проверить
Файл остаётся обычным документом	Расширение .donut.js или .dgplugin
Не найден манифест	manifest.json должен быть в корне архива
Неверная точка входа	entry и наличие маркера в начале .js
Неподдерживаемый ресурс	Нет .ts, вложенных архивов, видео, SVG или node_modules
Конфликт путей	Нет .., абсолютных путей, ссылок и дублей имён

Команда не появилась

Зарегистрируйте её внутри activate и дождитесь commands.register. Scope ui.contribute должен совпадать с placement.

Команды composer и chatToolbar находятся в меню долгого нажатия на аватар в шапке чата. messageMenu и selection — в меню сообщения. settings — в настройках плагина.

Метод возвращает ошибку

Код	Следующий шаг
permission_denied	Проверить объявление и текущее предоставление возможности
scope_denied	Проверить точный scope и контекст
gesture_required	Вызвать операцию из явного действия пользователя
feature_unavailable	Выбрать поддерживаемый сценарий и проверить клиент
revision_conflict	Получить свежий черновик и не использовать старый handle
rate_limited	Сократить частоту действий
cancelled	Завершить операцию без повторного скрытого действия

Изменения не обновились

Увеличьте SemVer-версию и сохраните прежний id. Тот же или более старый файл не переустанавливается поверх новой версии. Не складывайте артефакт сборки в исходную папку проекта.

Иконка заменена пазлом

Проверьте поле icon, наличие картинки в assets/ и формат PNG/JPEG/WebP. В чате пользовательскую картинку можно получить только после завершённой загрузки и статической проверки документа.

Где искать ошибки

Установленный плагин → информация → «Дополнительно» → журнал ошибок. Сообщение об ошибке помогает отличить ограничение API от ошибки в JavaScript. Не включайте приватные данные пользователя в диагностические тексты.