# Установка решения из Intellos Hub

Версия инструкции: 1 · 2026-10-08. Вход: строка вида «Установи решение
`<id>@<версия>` по инструкции https://hub.intellos.ru/agent/install.md».

Hub должен быть подключён — https://hub.intellos.ru/agent/setup.md.

## Граница полномочий

Агент скачивает файл решения и помогает человеку его установить. Без согласия человека
агент ничего не меняет в пространстве Intellos; существующие приложения не правит —
решение ставится новым приложением. Ключи и секреты в файлах решения пустые: их задаёт
человек, агент их не придумывает, не просит прислать в чат и не записывает в файлы.

## Шаги

1. **Карточка.** `get_package` с `id` и версией. Прочитай «Что нужно»: плагины,
   сервисы, ключи (их задаёт человек), что выбрать после установки.
2. **План.** Покажи человеку: что ставится, какие плагины понадобятся, какие ключи
   и выборы останутся за ним. Дождись согласия.
3. **Файл.** `download` с `id` и версией. Шаблон приходит текстом в `content`;
   сохрани его как `<id>-<версия>.yml` и сверь `sha256` с ответом.
   Нет доступа — `request_access` и сообщи человеку, что заявка подана.
4. **Импорт.** В студии Intellos: «Создать приложение» → «Импорт DSL-файла» →
   выбрать файл. Студия предложит поставить недостающие плагины — их список совпадает
   с карточкой.
5. **Настройка.** Человек задаёт ключи из карточки и делает выборы (база знаний,
   модель) — в узлах и настройках плагинов приложения.
6. **Проверка.** Опубликовать приложение и прогнать один запрос по описанию из карточки.
7. **Отчёт.** Что установлено (`id@версия`, `sha256`), где приложение, что человек
   сделал руками и результат проверочного прогона. Запомни `id@версия` —
   по нему `check_updates` найдёт обновления.

Автоматическая установка вызовами MCP-сервера Intellos появится в следующей версии
инструкции.

## Плагин

1. `get_package` — карточка плагина: инструменты, нужная версия Intellos, настройки
   (адрес сервиса, ключи — их задаёт человек).
2. `download` — временная ссылка на `plugin.difypkg` и на подпись `plugin.difypkg.sig`.
   Скачай оба файла и сверь `sha256` пакета с ответом.
3. Подпись (для закрытого контура) проверяется открытым ключом
   https://hub.intellos.ru/.well-known/hub-signing-keys.json — порядок в https://hub.intellos.ru/agent/signing.md.
4. Установка — человеком: «Плагины → Установить плагин → Локальный файл пакета».
   После установки — настройки плагина из карточки.
5. Если карточка даёт «строку зависимости для DSL», шаблоны ссылаются на плагин именно ею.

## Навык

1. `get_package` — что делает навык и когда применяется.
2. `download` — временная ссылка на `skill.zip`; сверь `sha256`.
3. Перед установкой покажи человеку состав навыка (у карточки есть просмотр файлов)
   и скрипты, если они есть: навык исполняет их от имени человека.
4. Распакуй архив в папку навыков клиента: Claude Code — `.claude/skills/<id>/`
   в проекте или `~/.claude/skills/<id>/` для всех проектов; другой клиент — по его
   документации стандарта Agent Skills. В папке должен оказаться `SKILL.md`.
5. Проверка: попроси клиент перечислить доступные навыки — новый навык в списке.

## Откат

Удалить созданное приложение в студии. Плагины, поставленные для решения, удалять,
только если человек подтвердил, что они больше нигде не нужны.

## Обновление

`check_updates` со списком установленных `id@версия`. Статус `update` — есть новая
версия, в `changes` — что изменилось; `yanked` — установленная версия отозвана,
поставь актуальную; `replaced` — решение снято, есть замена `replaced_by`.
Перед обновлением выгрузи текущую версию приложения из студии: человек мог править
его сам, и эти правки нужно сохранить или согласовать.