Перейти к содержимому
NextPDF

Кулинарная книга Connect

Кулинарная книга Connect

Заголовок раздела «Кулинарная книга Connect»

NextPDF Connect делает движок NextPDF доступным для удалённых вызовов и систем искусственного интеллекта (AI) по протоколу Model Context Protocol (MCP), через REST API (Representational State Transfer) и службу gRPC. Кулинарная книга Connect собирает рецепты задач для этого интерфейса, а эта страница служит её указателем. Она фиксирует слаг каждого рецепта, уровень, к которому он относится, и применяемую транспортную границу. Поскольку это указатель, он не содержит утверждений о поведении какого-либо рецепта. Каждая страница рецепта создаётся в репозитории nextpdf/server в каталоге docs/public/, содержит собственные утверждения и подключается к этому сайту агрегатором с сохранением исходного происхождения.

Чтобы увидеть контракт, которому следует каждый рецепт Connect, прочитайте Соглашения о рецептах. Полный обзор интеграций экосистемы приведён в Кулинарной книге интеграций.

Как уровень влияет на доступные запуски

Заголовок раздела «Как уровень влияет на доступные запуски»

Развёртывание Connect формирует свой набор инструментов при загрузке; он не фиксируется заранее. Реестр инструментов сервера всегда регистрирует базовые инструменты. Затем он проверяет наличие провайдеров Pro и Enterprise с помощью class_exists() и регистрирует их инструменты только если nextpdf/premium установлен рядом с сервером. Рецепт, который зависит от инструмента Pro или Enterprise, выполняется только на развёртывании, где этот инструмент удалось разрешить. При установке только из открытого исходного кода такой инструмент отсутствует, и вызов возвращает ошибку неизвестного инструмента, а не молча снижает функциональность. Каждый рецепт указывает свой уровень, а этот указатель группирует рецепты по уровням, чтобы вы могли с первого взгляда увидеть, что поддерживает развёртывание.

Общее число инструментов — это свойство развёртывания, определяемое во время выполнения. Ни один рецепт и ни одна строка в этом указателе не утверждают фиксированного числа. Источником истины служит собственный каталог инструментов сервера, на который ссылается каждый рецепт.

Транспорт и модель ошибок

Заголовок раздела «Транспорт и модель ошибок»

Каждый рецепт вызывается одинаково через все три транспорта: через MCP tools/call, через конечную точку инструмента REST или через службу gRPC. Они используют один общий исполнитель инструментов. Рецепты, которые обращаются к удалённой службе по протоколу передачи гипертекста (HTTP), рассматривают сбой транспорта и неуспешный статус HTTP как разные случаи. Клиент PSR-18 выбрасывает типизированное клиентское исключение только тогда, когда он вообще не может отправить запрос, как описано в PSR-18 §4. Ответ 4xx или 5xx — это другое. Это обычное возвращаемое значение, которое проверяет вызывающая сторона, а не исключение, как описано в PSR-18 §4.

Карта слагов рецептов

Заголовок раздела «Карта слагов рецептов»

Каждый рецепт находится по адресу /cookbook/connect/<recipe>/. В таблице указаны слаг, уровень, к которому относится рецепт, и однострочное описание области применения. Страницы рецептов создаются в nextpdf/serverdocs/public/ и агрегируются сюда. Пока страница не появилась, ссылка на неё остаётся предварительной.

РецептУровеньОбласть применения
hello-world (запланировано в исходном репозитории)Core (базовый)Первый вызов Connect: создание, добавление содержимого, вывод
multi-page (запланировано в исходном репозитории)Core (базовый)Многостраничный документ через Connect
image-embedding (запланировано в исходном репозитории)Core (базовый)Встраивание изображения через Connect
html-table (запланировано в исходном репозитории)Core (базовый)Отрисовка HTML-таблицы через Connect
font-typography (запланировано в исходном репозитории)Core (базовый)Шрифты и типографика через Connect
exception-aware (запланировано в исходном репозитории)Core (базовый)Вызовы инструментов с учётом исключений
environment-diagnostics (запланировано в исходном репозитории)Core (базовый)Инструменты диагностики окружения
layout-inspection (запланировано в исходном репозитории)Core (базовый)Проверка макета без отрисовки
worker-safe (запланировано в исходном репозитории)Core (базовый)Пакетное использование, безопасное для воркеров
output-approval (запланировано в исходном репозитории)Core (базовый)Шлюз вывода с участием человека
event-hooks (запланировано в исходном репозитории)Core (базовый)Хуки событий жизненного цикла
fill-pdf-form (запланировано в исходном репозитории)Pro (профессиональный)Заполнение PDF-формы через Connect
extract-text-content (запланировано в исходном репозитории)Pro (профессиональный)Извлечение текстового содержимого через Connect
digital-signature (запланировано в исходном репозитории)Pro (профессиональный)Подписание PDF (PAdES B-B и B-T) через Connect
accessibility-check (запланировано в исходном репозитории)Pro (профессиональный)Проверка доступности PDF/UA
pii-redaction (запланировано в исходном репозитории)Enterprise (корпоративный)Удаление обнаруженных персональных данных из текстового слоя (необратимо)
aria-tagged-pdf (запланировано в исходном репозитории)Pro (профессиональный)Сопоставление ролей-ориентиров ARIA с тегированной структурой
figure-caption (запланировано в исходном репозитории)Pro (профессиональный)Доступный элемент Figure с вложенным Caption
aria-noteref-pattern (запланировано в исходном репозитории)Pro (профессиональный)Шаблон ссылки на сноску и текста сноски
compliance-check (запланировано в исходном репозитории)Enterprise (корпоративный)Запуск проверки по именованному стандарту
forensic-analysis (запланировано в исходном репозитории)Enterprise (корпоративный)Криминалистический анализ подписанного PDF
ltv-health-check (запланировано в исходном репозитории)Enterprise (корпоративный)Проверка состояния LTV (B-LT/B-LTA, только Enterprise)
batch-compliance (запланировано в исходном репозитории)Enterprise (корпоративный)Пакетная проверка стандартов
ai-ready-certification (запланировано в исходном репозитории)Enterprise (корпоративный)Проверка готовности к AI (не сертификация)
page-artifacts (запланировано в исходном репозитории)Enterprise (корпоративный)Пометка элементов разбиения на страницы как артефактов
conformance-mode (запланировано в исходном репозитории)Enterprise (корпоративный)Выбор режима соответствия (намерение соответствовать; решение принимает валидатор)
cjk-vertical-writing (запланировано в исходном репозитории)Enterprise (корпоративный)Метрики вертикального письма CJK
opentelemetry (запланировано в исходном репозитории)Core (базовый)Наблюдаемость Connect с помощью OpenTelemetry
tagged-pdf-tutorial (запланировано в исходном репозитории)Core (базовый)Учебник по тегированному PDF (намерение соответствовать; решение принимает veraPDF)

Слаг выражает назначение рецепта в стиле kebab-case с единственной завершающей косой чертой: без числового префикса, без номера версии и без расширения файла. Слаг рецепта не меняется после публикации, а перенесённый слаг сопровождается переадресацией.

Граница соответствия и сертификации

Заголовок раздела «Граница соответствия и сертификации»

Несколько рецептов затрагивают стандарты (PDF/UA-2, PDF/A-4, PAdES). Кулинарная книга Connect рассматривает поддержку стандарта именно как поддержку, но никогда как соответствие или сертификацию. Движок создаёт вывод, предназначенный для соответствия, а фактическое соответствие определяет независимый валидатор (например, veraPDF). Рецепт проверки готовности к AI — это проверка готовности, а не сертификация. Материал рецепта долгосрочной проверки LTV описывает возможность, доступную только в Enterprise. Его наличие в документе — это возможность, которую несёт документ, а не гарантия бессрочной действительности подписи. Каждый затронутый рецепт полностью повторяет эти границы. Этот указатель лишь отмечает, что они существуют, и указывает, откуда они следуют, вместо того чтобы выводить их повторно здесь.

Смотрите также

Заголовок раздела «Смотрите также»