From 1b54d8fbea8fa46e161890e4285d3ffc4e889f88 Mon Sep 17 00:00:00 2001 From: Anton Titovets Date: Sat, 2 May 2026 23:22:14 +0300 Subject: [PATCH] Fastfix --- article-opi-release-2.0.0.md | 43 ------------------------------------ 1 file changed, 43 deletions(-) delete mode 100644 article-opi-release-2.0.0.md diff --git a/article-opi-release-2.0.0.md b/article-opi-release-2.0.0.md deleted file mode 100644 index 9555b82d39..0000000000 --- a/article-opi-release-2.0.0.md +++ /dev/null @@ -1,43 +0,0 @@ -# ОПИ вышел в 2.0.0: WebSocket и ещё кое-что - -**02.05.2026** - -Вышла вторая мажорная версия Открытого пакета интеграций. Номер сменился не «для галочки»: в составе есть крупная новая подсистема, отдельные способы поставки под старые платформы, доработка HTTP и MCP в консоли. Ниже по смыслу, без простыни из строк релиз-нотов. - -Если про ОПИ вы читаете впервые: это открытый набор методов для интеграций — расширение для 1С, пакет под OneScript, CLI под Windows и Linux. Код на GitHub, описания методов и примеры — на [openintegrations.dev](https://openintegrations.dev). - -## Зачем эта версия отдельным текстом - -Большую часть жизни пакета по-прежнему кормят обычные HTTP-сервисы: запрос, ответ, иногда файл или редирект. Но в реальных проектах регулярно всплывают три других запроса. Первый — долгое двустороннее соединение без опроса «каждые пять секунд». Второй — возможность перед вызовом метода без цирка подкрутить таймаут, прокси или формат ответа, не раздувая сигнатуру функций. Третий — возможность принести код на базу там, где удобен не CFE, а именно файл конфигурации CF под конкретную линию платформы. - -В 2.0.0 есть ответ на все три пункта, плюс в CLI добавлен MCP — для тех, кто хочет вызывать возможности консоли не только из командной строки. - -## WebSocket - -WebSocket нужен там, где «один запрос — один ответ» начинает мешать: уведомления, чаты, стрим данных, свой сервер для входящих соединений. После установки соединения стороны обмениваются сообщениями в обе стороны без каждого раза заново разворачивать HTTP-сессию. - -В ОПИ это оформлено модулем `OPI_WebSocket`. С клиента: подключиться (при желании через TLS или прокси), слать текст и двоичные данные, принимать ответы, пинг-понг, закрыть сессию нормальным кодом. С сервера: слушать порт, разбирать входящие сессии по id, отдавать данные в конкретное соединение, закрывать их и смотреть список активных. Для отладки можно включить лог — на память или в файл, как уже делают другие части пакета. - -Реализация на внешней компоненте, в том же духе, что и остальной «нетривиальный» транспорт в ОПИ. Подробности по параметрам — в документации раздела WebSocket. - -## Расширенный вызов - -Раньше, если нужен был не «голый JSON из тела», а ещё код ответа с заголовками, или другой таймаут на один конкретный вызов, приходилось либо городить свой HTTP поверх общих утилит, либо мириться с тем, что параметры методов заточены только под «суть» запроса: токен, chat id, текст. - -Теперь для части методов можно вызывать их **через расширенный вызов**: передаются обычные аргументы, отдельно — структура настроек HTTP-клиента (таймаут, расширенный ответ, прокси и т.п. — какие ключи поддерживаются, зависит от метода). В 1С/OneScript это функции из `OPI_РасширенныйВызов`; в CLI — опция `--config` с JSON. В документации для методов добавлены таблицы с этими ключами — не нужно гадать по исходникам. - -## Поставка в CF под 8.3.10 - -У ОПИ и раньше было несколько способов установки: CFE, EDT-проект, OneScript-пакеты, сборки CLI. Новое — отдельный вариант **файла конфигурации .cf**, ориентированный на платформу **8.3.10**. Если у вас как раз такой контур или политики про CF, а не про расширение отдельным файлом, появился ещё один легальный путь. - -Отдельно: в релизе подняты требования к режиму совместимости расширения (и основной конфигурации там, где это важно). Перед обновлением с 1.34 имеет смысл глянуть релиз-ноты и свои настройки совместимости, чтобы потом не ловить сюрприз при открытии базы. - -## MCP в CLI - -Консоль ОПИ давно используют в скриптах и CI. В сборку добавили **встроенный MCP-сервер через stdio** — стандартный способ подключить набор методов к средам, где инструменты объявляют себя по протоколу MCP и вызываются не руками, а клиентом. Если вы MCP уже не используете, строка для запаса на будущее: когда понадобится, не придётся писать свою заглушку. - -Как запускать и что передаётся — см. [документацию MCP в CLI](https://openintegrations.dev/docs/Start/CLI-version/mcp-server). - ---- - -Остальной список правок из 2.0.0 лежит в репозитории и анонсе релиза: там и мелкие исправления HTTP/OS, RSS, gRPC, и снятый с поддержки модуль Twitter, и прочее. Если по WebSocket или расширенному вызову появятся вопросы — их проще всего решить через issues на GitHub или обсуждение рядом с статьёй на Инфостарт.