Диагностика проблем

CLI установился, но не запускается

Проверьте, что binary действительно находится в shell PATH. Если вы ставили CLI через npm или PyPI, убедитесь, что пакет реально скачал опубликованный binary, а не воспринимайте сам пакет как runtime.

Python или Node runtime-проекты падают слишком рано

Сначала проверьте сам runtime:

• Python runtime-проекты требуют Python 3.10+
• Node runtime-проекты требуют Node.js 20+

Используйте plugin-kit-ai doctor <path>, прежде чем считать, что сломан сам проект.

Типовой сценарий восстановления:

plugin-kit-ai doctor ./my-plugin
plugin-kit-ai bootstrap ./my-plugin
plugin-kit-ai generate ./my-plugin
plugin-kit-ai validate ./my-plugin --platform codex-runtime --strict

Падает validate --strict

Воспринимайте это как сигнал, а не как шум. Смысл strict validation именно в том, чтобы ловить drift и readiness problems до того, как вы объявите проект здоровым.

Частые причины:

• generated artifacts устарели, потому что был пропущен generate
• выбранная platform не соответствует исходному состоянию проекта
• выбранный runtime-путь требует bootstrap или исправления окружения

generate выдаёт не то, что ожидалось

Обычно это значит, что исходное состояние проекта и ваша ментальная модель уже разошлись. Проверьте package-standard layout, а не редактируйте generated target files вручную в попытке “починить” output.

Я не понимаю, какой путь выбрать

Начинайте с пути Go по умолчанию, если нужен самый сильный контракт. Переходите на Node/TypeScript или Python только тогда, когда компромисс локального runtime действительно осознан и нужен.

См. Python runtime, Процесс авторинга и Частые вопросы.