Выбор модели поставки

У Python и Node плагинов есть два поддерживаемых способа доставки helper-логики. Они решают разные практические задачи.

Быстрое практическое правило

Если вам сегодня нужен просто самый простой рабочий Python или Node репозиторий, начните с пути по умолчанию.

Если вы уже точно знаете, что нескольким репозиториям нужен один общий helper dependency, начинайте сразу с --runtime-package.

Два режима

• vendored helper: scaffold записывает helper-файлы прямо в репозиторий
• shared runtime package: --runtime-package подключает plugin-kit-ai-runtime как dependency вместо записи helper в src/

Один и тот же проект в двух режимах

Путь по умолчанию с локальным helper:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python

Путь с общим пакетом:

plugin-kit-ai init my-plugin --platform codex-runtime --runtime python --runtime-package

Когда выбирать vendored helper

• нужен самый гладкий первый старт
• вы хотите, чтобы репозиторий оставался самодостаточным
• хотите видеть helper implementation прямо в репозитории
• команда ещё не стандартизировалась на одной версии helper-пакета в PyPI или npm

Это путь по умолчанию, потому что он проще всего для первого старта на Python и Node.

Когда выбирать shared runtime package

• нужна одна reusable helper dependency на несколько plugin repos
• удобнее обновлять helper behavior через обычные package version bumps
• команда готова pin'ить версии в requirements.txt или package.json
• вы уже знаете, что репозиторий должен идти по shared dependency path с первого дня

Что это обычно значит на практике

• выбирайте vendored helper, когда главная цель: "быстро запустить один рабочий репозиторий"
• выбирайте shared runtime package, когда главная цель: "использовать один и тот же helper package в нескольких репозиториях"
• не выбирайте shared package только потому, что он звучит более production-like; он не убирает требование иметь Python или Node на машине исполнения

Что при этом не меняется

• Go всё ещё остаётся рекомендуемым путём по умолчанию, когда нужен самый сильный путь для продакшена
• Python всё ещё требует Python 3.10+ на машине исполнения
• Node всё ещё требует Node.js 20+ на машине исполнения
• validate --strict остаётся главной проверкой готовности
• CLI install packages не превращаются в runtime API

Рекомендуемая политика для команды

• выбирайте Go, когда нужен самый сильный долгосрочно поддерживаемый путь
• выбирайте vendored helpers, когда нужен самый гладкий Python или Node старт
• выбирайте shared runtime package, когда вы уже знаете, что нужна reusable dependency strategy across repos

Свяжите эту страницу с Python runtime, Выбором starter repo, Bundle handoff, Стартовыми шаблонами и Готовностью к продакшену.