Перейти к содержанию
ERITKOM
Open SourceНовость

pnpm 12.18 добавил выбор отдельных skills и подготовку офлайн-установки из архивов

Менеджер пакетов разделяет одобрение инструкций для агентов, загрузку архивов в store и публикацию платформенных вариантов в pnpr-реестрах.

Оригинальный знак pnpm из README проекта
pnpm contributors, источник, MIT, оригинал. Изменены размер и формат.

Одобрение относится к отдельным инструкциям

В pnpm 12.18 изменена работа со skills, которые зависимости поставляют для программных агентов. Если пакет содержит несколько таких наборов инструкций, pnpm approve позволяет выбрать, какие именно связывать с каталогами агента. Выбор сохраняется списком в permissions соответствующего пакета; остальные инструкции не предлагаются для повторного одобрения при следующем обращении.

При первом одобрении также выбираются целевые каталоги, и ответ записывается в skills.dirs. Это управление размещением инструкций, а не доказательство их безопасности или разрешение агенту выполнять любое описанное действие. Текст SKILL.md остаётся содержимым зависимости. Решение связать его с рабочим каталогом следует отличать от одобрения сборочных скриптов и от полномочий, которыми располагает сам инструмент автоматизации.

Имена ссылок стали короче

Обычная ссылка на skill теперь называется по самой инструкции, без обязательного префикса пакета. При совпадении имён между одобренными пакетами или конфликте с существующим каталогом применяется уточнённое имя с пакетом. Раньше такой конфликт приводил к ошибке установки. Следующая установка заменяет ссылки со старыми именами и отмечает созданные связи в отдельном блоке gitignore каталогов агента.

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

Store можно наполнить заранее

Команда pnpm store add принимает архивы пакетов, которые были загружены другим способом. Это позволяет заранее подготовить хранилище для установки без сети. Последующая pnpm install с offline и frozen-lockfile использует соответствующие архивы, когда запись lockfile указывает на нужный пакет и закрепляет его содержимое.

Документация отдельно описывает поддержанные значения integrity: контрольную сумму архива либо хеш распакованного tar при соответствующей настройке lockfile. Простое совпадение имени файла не заменяет эту связь. Команда наполнения store не добавляет зависимость в произвольный проект и не переписывает его состав. Для пакетов из именованного реестра существенен контекст проекта, где объявлен этот реестр. Офлайн-установка не означает, что отсутствующие пакеты можно восстановить без предварительной загрузки.

Платформенные варианты требуют pnpr

Другая часть выпуска посвящена архивам для отдельных платформ. Упаковка, публикация и выбор подходящего варианта работают с реестрами, объявленными как serverType: pnpr. Это условие нельзя опускать и приписывать новую схему любому существующему npm-совместимому серверу. У пакета могут быть отдельные варианты для архитектуры, платформы и требований ABI.

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

Источники

Принципы журнала и исправления.

ERITKOM / НОВЫЙ ПРОЕКТ

Расскажите о задаче и оставьте контакты. Мы свяжемся с вами, чтобы обсудить проект.

  1. 01 Контакты
  2. 02 Ваша задача