Каталог

Поиск, Catalog QL, Both-mode, линии доверия и процент проверок.

Каталог

Каталог — публичный индекс сетапов и компонентов. Читать его может кто угодно. Он не устанавливает, не собирает и не закрепляет пины. Карточка — доказательство для позднего решения в CLI.

URL и кто их видит

Проекция	URL	Кому видно
Human	`/{locale}/catalog`	всем
Machine	`/{locale}/ai/catalog`	всем

Query string сохраняется при переключении Human / Machine. Неизвестные ключи не игнорируются молча: страница показывает Некорректный фильтр каталога вместо тихого отбрасывания.

Запрос по умолчанию, когда страница открыта без параметров:

resource=all (Оба);
include_experimental=1 (экспериментальные объекты в списке);
sort=relevance, sort_direction=desc;
view=list;
page_size=25.

Лайки на карточках требуют сессии. Поиск, фильтры и чтение паспорта — нет.

Для чего этот экран

Каталог нужен, чтобы найти кандидата, прочитать оси доверия и скопировать everyday-intent установки. Registry show/version — inspect идентичности.

Каталог не:

запускает select или install в браузере;
пишет план provider;
считает author_verified доказательством, что версия безопасна;
прячет экспериментальные объекты, пока вы сами не выключите фильтр;
выдумывает теги вне словаря.

Both-режим показывает сначала сетапы, затем компоненты. Каждая группа сохраняет выбранную сортировку. Пагинация в Both сначала идёт по страницам сетапов, затем по страницам компонентов.

Что на экране

Поиск и Catalog QL

Плейсхолдер поля поиска — Поиск компонентов и сетапов. Клавиша Ctrl/Cmd K ставит фокус. Текст справки:

Ищите обычными словами или на Catalog QL: поля NAME, TAGS, HARNESS, TYPE, AUTHOR и VERIFIED; операторы :, AND, OR, NOT, IN, NOT IN и скобки. Пример: TYPE:skill AND HARNESS IN (codex, claude-code).

Форма	Смысл
обычные слова	полнотекстовый термин
`FIELD:value`	равенство по полю из allowlist
`FIELD IN (a, b)`	принадлежность
`FIELD NOT IN (a, b)`	исключение
`AND` / `OR` / `NOT`	булевы связки
`( … )`	группировка, глубина ограничена

Поля allowlist: NAME, TAGS, HARNESS, TYPE, AUTHOR, VERIFIED. Запрос длиннее 500 символов, слишком много токенов или неизвестное поле отклоняются на границе API. Структурные фильтры формы соединяются с AST QL через AND.

Возможно, вы имели в виду может предложить исправление. Оно не запускается, пока вы его не примете.

Ресурс, экспериментальные, раскладка

Элемент	Значения	По умолчанию
Тип ресурса каталога	Оба / Сетапы / Компоненты	Оба
Показать экспериментальные	вкл / выкл	вкл
Вид выдачи	Карточки / Список	Список
Сортировка выдачи	По релевантности / По времени обновления / По числу лайков	По релевантности
Направление	По возрастанию / По убыванию	По убыванию

Основные объекты помечены Основные (authoritative). Экспериментальные — Экспериментальные. Примечание под выдачей:

Основные и экспериментальные объекты показаны вместе. Подтверждение автора не доказывает безопасность содержимого.

Выключение экспериментальных прячет эту полосу только для этого поиска. Это не запись согласия для позднего select.

Фильтры

Фильтры и сортировка открывает панель. Применить фильтры записывает query string. Сбросить всё возвращает значения по умолчанию выше.

Фильтр	Ключ запроса	Что оставляет
Тег	`tags`	теги словаря (неверные id — ошибка)
Упряжка	`harness_id` / `harness_ids`	паспорта, которые называют этот харнесс
Тип компонента	`component_type` / `component_types`	`instruction`, `skill`, `mcp`, `hook`, `command`, `agent`, `plugin`, `setting`, `cli`
Автор	`authors`	id аккаунтов издателей, через запятую
Только проверенные	`verified_only`	оба `author_verified` и `component_verified` текущие
Страны	`country_code` / `country_codes`	связанные рынки; Не задано — нет списка стран
Региональные сервисы	`service_domain` / `service_domains`	связанные сервисы; список следует за выбранными странами
Обновлено с / по	`updated_from` / `updated_to`	включительные даты обновления в каталоге
Уровень поддержки	`support_tier`	`primary` или `beta`
Состояние поддержки	`support_state`	`verified`, `stale`, `missing`, `not_verified`

Чипы в строке поиска снимают один фильтр. Неизвестные ключи, неверные теги, неверные значения поддержки или сломанная строка QL дают Некорректный фильтр каталога с причиной. Они никогда не вызывают поиск.

Карточки выдачи

Каждая карточка показывает вид (Сетап или тип компонента), имя, версию, бейджи харнесса, теги, издателя, author_verified, component_verified, лайки и сводку безопасности, когда проверки есть.

author_verified и component_verified независимы. Подтверждённый автор всё равно может опубликовать неподтверждённую версию. Фильтр verified требует оба.

Дополнительные действия на карточке:

Действие	Нужна сессия	Эффект
Скопировать URL	нет	буфер обмена
Скопировать ID	нет	`stable_id`
Скопировать CLI-команду	нет	`ai-stp registry version --kind … --id … --version …`
Нравится / Не нравится	да	сохраняется в Лайки
Пожаловаться	да	открывает Жалобы с kind, id, version, digest

Пустая выдача:

Ресурс	Заголовок пустоты
Оба	Нет объектов каталога по этому запросу.
Сетапы	Нет сетапов по этому запросу.
Компоненты	Нет компонентов по этому запросу.
Только основные	Нет основных результатов по этому запросу.

Метрики использования (просмотры страницы, скачивания артефакта) появляются, когда скомпилирован catalog_usage_metrics. Это счётчики, не сигнал безопасности.

Соответствующие команды CLI

Everyday-установка, когда карточка уже есть:

ai-stp task start --intent install --idempotency-key install-session-01 --json

Expert-просмотр каталога (идентичность, не установка):

ai-stp registry search --json
ai-stp registry show --kind component --id <stable_id> --json
ai-stp registry show --kind setup --id <stable_id> --json
ai-stp registry version --kind component --id <stable_id> --version <x.y> --json
ai-stp registry version --kind setup --id <stable_id> --version <x.y> --json

registry search — CLI-близнец этой страницы. registry show — объект. registry version — один неизменяемый X.Y. Забрать в локальный кэш — другая команда:

ai-stp registry fetch --json

Канонический URL сайта для объекта:

ai-stp link web --json

Листья select и compose — не команды каталога. Everyday-установка после карточки — install intent выше. Expert-хореография — Выбор и Установка.

Тупики

Что видно	Что это значит	Что делать
Некорректный фильтр каталога	неизвестный ключ, плохой тег, плохой QL	уберите неизвестный параметр; почините QL
Нет объектов каталога	типизированная пустота	расширьте фильтры; оставьте экспериментальные включёнными
Сервис временно недоступен	API лежит	повторите; кэш CLI может ещё `registry show`
Лайк визуально ничего не делает	нет сессии	Войти, затем лайкнуть снова
В форме жалобы нет полей	вы открыли её не с версии	откройте карточку, затем Пожаловаться
Страница Both-режима выглядит как только сетапы	вы ещё на странице сетапов смешанного пейджера	идите вперёд мимо страниц сетапов
Карточка 404 после клика	снято с публикации, заблокировано или неизвестный id	оставайтесь в поиске; не угадывайте id

Machine-документ каталога перечисляет повседневный install start, активный запрос полями, затем сетапы и компоненты. Пустой machine-вывод — то же пустое сообщение, не stack trace.

Связанные страницы

Карточка компонента — один публичный компонент.
Карточка сетапа — один публичный сетап и его пины.
Каталог (смысл) — как читать результат.
Региональные сервисы — фильтры стран и сервисов.
Издатели — страницы авторов.
Доверие и безопасность — две оси verified.
Проверки безопасности — что покрывает процент.
Реестр — поиск и fetch в CLI.
Компоненты — закрытые виды.

!!! warning "Verified — это два бита" verified_only требует обе оси. Включить его, потому что автор кажется знакомым, всё равно прячет неподтверждённые версии этого автора.