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

Настольный клиент

Настольный клиент переносит работу с ИИ на ваш компьютер. Вы открываете openapi.yaml из репозитория, описываете желаемый результат и проверяете его — без переключения между редактором спецификаций, HTTP-клиентом, mock-инструментом, генератором документации и средством тестирования. Для начала не нужна облачная учётная запись.

Управление остаётся у вас: ассистент предлагает, вы подтверждаете.

День в рабочей области​

Клиент построен вокруг следующих задач.

  • Открыть спецификацию и разобраться в ней. Ассистент читает текущий документ и сразу предлагает, что можно сделать: заполнить пробелы, дополнить документацию или проверить процессы.
  • Создать API. Опишите ресурс, и ассистент предложит конечные точки. Уточняйте ту же операцию: добавляйте параметр, корректируйте ответ или код состояния, не затрагивая посторонние части документа.
  • Подготовить тестовые данные. Создавайте реалистичные строки примеров из схем, чтобы запросы и сценарии работали с конкретными значениями.
  • Выполнить запрос или целый сценарий. Отлаживайте один вызов либо объединяйте несколько конечных точек в сквозной процесс и получайте отчёт об успешных и неудачных шагах.
  • Продолжать работу до готовности бэкенда. Запустите локальный mock, который отвечает по контракту, пока настоящий сервис ещё разрабатывается.
  • Передать API агентам программирования. Превратите спецификацию в MCP-сервер, чтобы ИИ-инструменты находили и вызывали нужные операции с подходящими аргументами.
  • Увидеть базу данных за API. Выведите таблицы, связи и SQL из спецификации, сравните их с реальной базой и определите необходимые изменения.
  • Менять настройки прямо в чате. Попросите сменить тему или язык, настроить прокси либо управлять переменными окружения.

Разделы и их назначение​

Один документ используется во всех разделах; переключаться между ними позволяет компактный переключатель.

РазделНазначение
СпецификацияГлавный раздел: чат с ИИ, документ и предпросмотр в реальном времени
Рабочая область запросовОтправка и изучение реальных HTTP-запросов с вкладками и окружениями
Сценарное тестированиеОбъединение конечных точек в процессы, запуск и получение отчётов
ДокументацияПросмотр спецификации в виде оформленной документации API
MCPПросмотр и использование MCP-сервера, созданного из спецификации
Mock-серверЗапуск локального mock API во время разработки
Модель данныхПолучение таблиц и связей, сравнение с базой данных, генерация SQL
НастройкиТема, язык, прокси, сертификаты и параметры рабочей области

Как ассистент работает с вами​

Вы описываете намерение естественным языком. Ассистент выбирает подходящую функцию, детерминированный движок проверяет её, а вы подтверждаете действие в карточке. Модель никогда не редактирует документ самостоятельно.

  • Изменения спецификации приходят в виде карточек правок с точечными операциями; при редактировании существующей операции меняется только запрошенное поле;
  • Действия только для чтения — список операций, получение схемы, выполнение запроса на чтение — возвращают факты, на которых ассистент строит ответ;
  • Действия записи требуют подтверждения перед выполнением.

Модель настраиваете вы: укажите совместимого с OpenAI провайдера и выберите его в настройках. См. ИИ и модели.

Что даёт локальная работа​

  • Ваши настоящие файлы. Приложение открывает, редактирует и сохраняет реальные файлы на диске и отслеживает локальные изменения.
  • Без ограничений CORS. Запросы проходят через локальный процесс, а не веб-представление, поэтому ограничения между источниками не блокируют вызовы.
  • Вы выбираете конечную точку модели. Запросы идут через главный процесс, но промпты, нужный контекст и учётные данные всё равно передаются настроенному провайдеру. Локальная работа не означает, что удалённые запросы к ИИ не передают данные.
  • Работа без сети. Проектирование, mock и документация не требуют сети; она нужна для реальных запросов, синхронизации Git или облачной модели.
  • Локальное выполнение. Mock, исполнитель сценариев, доступ к базам данных и терминал работают на вашем компьютере.

Лицензия настольного клиента​

Настольный клиент продаётся по бессрочной лицензии с разовой оплатой: одна покупка, автономная работа, без учётной записи. Ключ создаётся при покупке и показывается один раз. Лицензия отделена от Powerduck Cloud — хостинга по ежемесячной подписке. См. Оплата облака.

С чего начать​