Skip to content

Latest commit

 

History

History
123 lines (101 loc) · 7.88 KB

File metadata and controls

123 lines (101 loc) · 7.88 KB

Целевая задача поставки v8std

Зафиксировано 16 сентября 2026 года. Документ описывает согласованный целевой результат, а не подтверждает готовность текущей реализации. Решение об HTTP уточнено 17 сентября. Текущее состояние и оставшиеся работы — в плане поставки.

Результат

Выпустить сайт и MCP с чистой переустановкой существующего VPS и обеспечить три варианта локального запуска. Решение пользователя от 17 сентября заменяет прежнее требование отдельного нового VPS: существующий сервер переустанавливается после подготовки резервной копии и проверенных артефактов.

В публичных текстах и схемах использовать обозначения v8std.ru (GitHub Pages) и ai.v8std.ru (VPS), без названия провайдера VPS.

Результат поставки Размещение и назначение
Статический сайт v8std.ru — GitHub Pages
Собранный поисковый индекс ai.v8std.ru — VPS; доступен для скачивания локальным MCP
MCP-сервис ai.v8std.ru — VPS
Docker-образ сайта с индексом Самостоятельный локальный сайт или совместный запуск с MCP
Docker-образ MCP Локальный запуск; тот же образ используется для MCP на VPS

Схема поставки

flowchart LR
    subgraph CONTENT_DELIVERY["Сайт и индекс"]
        SOURCE["docs/, код сайта,<br/>шаблоны и зависимости"]
        BUILD["Сборка сайта и индекса<br/>одной версии контента"]
        PAGES["Статический сайт<br/>v8std.ru — GitHub Pages"]
        VPSINDEX["Поисковый индекс<br/>ai.v8std.ru — VPS"]
        SITEIMAGE["Docker-образ сайта<br/>с тем же индексом"]
        LOCALSITE["Локальный сайт"]

        SOURCE --> BUILD
        BUILD -->|"Страницы"| PAGES
        BUILD -->|"Индекс"| VPSINDEX
        BUILD -->|"Страницы и индекс"| SITEIMAGE
        SITEIMAGE --> LOCALSITE
    end

    subgraph MCP_DELIVERY["MCP"]
        MCPSOURCE["Код MCP и зависимости"]
        MCPIMAGE["Сборка Docker-образа MCP"]
        VPSMCP["MCP-сервис<br/>ai.v8std.ru — VPS"]
        LOCALMCP["Локальный MCP"]

        MCPSOURCE --> MCPIMAGE
        MCPIMAGE --> VPSMCP
        MCPIMAGE --> LOCALMCP
    end
Loading

Индекс собирается один раз для версии контента. Один и тот же артефакт индекса поставляется на VPS и включается в Docker-образ сайта. Страницы локального сайта и его индекс относятся к одной версии контента.

Схема развёртывания

flowchart TB
    subgraph PUBLIC["Публичное развёртывание"]
        BROWSER["Браузер"] --> PAGES["v8std.ru: сайт на GitHub Pages"]
        CLIENT["MCP-клиент"] --> MCP["ai.v8std.ru — VPS: MCP"]
        MCP --> INDEX["ai.v8std.ru — VPS: индекс"]
    end

    subgraph SITEONLY["Локально: только сайт"]
        B1["Браузер"] --> S1["Docker сайта; MCP не требуется"]
    end

    subgraph MCPONLY["Локально: только MCP"]
        C2["MCP-клиент"] --> M2["Docker MCP"]
        M2 -->|"Скачивает индекс"| INDEX
    end

    subgraph BOTH["Локально: сайт и MCP"]
        B3["Браузер"] --> S3["Docker сайта: страницы и индекс"]
        C3["MCP-клиент"] --> M3["Docker MCP"]
        M3 -->|"Получает индекс по внутренней сети"| S3
    end
Loading

Правила локального запуска

MCP использует только Streamable HTTP, включая локальный запуск. Поддержка stdio и поставка через Docker MCP Catalog/Gateway исключены.

  • Сайт запускается и работает без MCP.
  • MCP без локального сайта скачивает индекс с ai.v8std.ru.
  • При совместном запуске MCP получает индекс из контейнера локального сайта. Контейнер сайта предоставляет индекс для скачивания по внутренней сети.
  • Источник индекса задаётся настройкой MCP; отдельные образы MCP для разных источников индекса не нужны.
  • Один образ сайта используется как отдельно, так и совместно с MCP.
  • Если выбранный локальный источник индекса недоступен, MCP сообщает явную ошибку и не переключается незаметно на публичный индекс.

Критерии готовности

  • Сайт опубликован и доступен на v8std.ru.
  • Серверная часть установлена на чистой ОС после переустановки существующего VPS. Индекс доступен для скачивания, MCP доступен клиентам через ai.v8std.ru.
  • Самостоятельный локальный сайт запускается из поставляемого Docker-образа и открывается в браузере без запущенного MCP.
  • Самостоятельный локальный MCP скачивает опубликованный индекс с ai.v8std.ru и обслуживает запросы MCP-клиента.
  • При совместном локальном запуске сайт открывается в браузере, а MCP обслуживает запросы по индексу локального сайта. Источник индекса проверен.
  • Недоступность локального источника индекса приводит к явной ошибке, без скрытого перехода на публичный источник.
  • Подтверждено совпадение артефакта индекса на VPS и в образе сайта для одной поставки, а также соответствие индекса версии контента.
  • До переустановки сохранена внешняя резервная копия и определён способ восстановления прежней установки. На время переустановки допустим согласованный простой MCP; после установки проверена работа через публичный адрес.

Готовность подтверждается фактическими проверками этих сценариев. Наличие этого документа само по себе не означает выполнение задачи. Конкретные команды сборки, адреса скачивания индекса и настройки запуска уточняются по реализации.