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

С чего начинать: Go, Python или Node?

Начинайте с Go, если нет реальной причины выбрать иначе. Выбирайте Node/TypeScript для основного поддерживаемого пути без Go. Выбирайте Python, когда плагин остаётся локальным для репозитория, а команда уже Python-first.

Какой самый простой Python-сценарий?

Сначала используйте обычный Python scaffold:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python
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

См. Python runtime.

Когда нужен --runtime-package?

Используйте --runtime-package только когда хотите один и тот же helper dependency в нескольких репозиториях. Большинству команд лучше сначала пройти обычный путь с локальным helper.

npm и PyPI пакеты plugin-kit-ai — это runtime API?

Нет. Это способы установить CLI. Они не являются публичным runtime API и не являются SDK.

Когда использовать bundle-команды?

Используйте bundle-команды, когда нужны переносимые Python или Node артефакты, которые другая машина сможет скачать или установить. Не путайте их с основным способом установки CLI.

Можно ли держать native target files как source of truth?

Это не рекомендуемая долгосрочная модель. Исходное состояние проекта должно жить в package-standard layout, а target-файлы должны быть сгенерированными output-файлами.

generate — это опционально?

Нет, если вы хотите управляемую модель проекта. generate — часть основного процесса, а не случайный helper.

validate --strict — это опционально?

Воспринимайте его как главную проверку готовности, особенно для локальных Python и Node runtime-проектов.

Один repo может вести несколько target’ов?

Да. Это одна из основных идей plugin-kit-ai.

Практическое правило такое:

• держите authored state в одном managed repo
• начинайте с главного target’а сегодня
• добавляйте другие target’ы, когда появляются реальные product, delivery или integration требования

См. Один проект, несколько target’ов и Модель target’ов.

Все targets одинаково стабильны?

Нет. Runtime, packaging, extension и workspace-config target’ы не несут одинаковое обещание по поддержке.

См. Границу поддержки, Поддержку target’ов и Процесс авторинга.