Авиапоиск для DeepSeek Harness

Плагин для DeepSeek Harness (Desktop и dsh web, версии 0.2.x). Агент ищет авиабилеты через MCP-сервер авиапоиска, а результаты показываются карточками:

• маршрут, время, пересадки, багаж и цена на каждой карточке;
• вся выдача сразу, как в веб-чате (свернуть до первых N можно в настройках, collapseAfter);
• «Копировать», выбор нескольких билетов и «Скопировать все»;
• кнопка «Забронировать» открывает страницу бронирования.

После поиска ответ состоит только из карточек, модель не пересказывает билеты текстом. Если в запросе есть что-то ещё («…и скажи, какой лучше»), модель продолжает ответ.

Установка

1. Plugins → Add plugin → @digital-assistant/ama-avia → Install → Enable now. Если вы добавили индекс плагинов в Discover, плагин можно поставить и оттуда.
2. Появится плашка «Авиапоиск почти готов». Нажмите Ввести токен или откройте страницу плагина в Plugins.
3. Вставьте токен доступа и нажмите Сохранить. Строка состояния покажет «Подключено», перезапуск не нужен.

Токен выдаёт ответственный за интеграцию. Без токена плагин ничего не подключает. Карточки при этом остаются, если авиапоиск подключён иначе.

Попробуйте в новом чате: «Найди билеты Москва — Сочи на 20 ноября, 1 взрослый».

Токен и приватность

• Токен хранится в хранилище секретов DeepSeek Harness (~/.dsh/.credentials.yaml, читать файл может только ваш пользователь). Его нет в настройках, патчах профиля и в чатах. Значение в браузер не возвращается: страница видит только, сохранён токен или нет.
• Токен отправляется только серверу авиапоиска, в заголовке Authorization. По умолчанию это https://digital-assistant.a-m-a.com/mcp.
• Сервер получает текст поискового запроса, который составил агент. Других данных из чата плагин не передаёт.
• Ещё плагин отправляет анонимный id установки (X-Avia-Install-Id): это случайное число, которое плагин создаёт один раз и хранит в ~/.dsh/avia/install-id. Из ваших данных и из id телеметрии DeepSeek Harness он не выводится; сервер видит его вместе с вашим токеном. Он нужен, чтобы поиски людей с одним общим токеном не мешали друг другу. Удалите файл — при следующем подключении будет новый id.
• Заменить токен можно кнопкой Заменить токен, удалить — кнопкой Удалить токен на той же странице. Плагин не удаляет токен вместе с собой: перед удалением плагина нажмите «Удалить токен».

Токен можно задать и без интерфейса: AVIA_MCP_TOKEN=… в окружении запуска или в ~/.dsh/.env. Сохранённый на странице токен важнее этих значений.

Если стоит @digital-assistant/dsh-avia-cards

Так плагин назывался до 0.3.1. Удалите его в Plugins (Remove) и поставьте @digital-assistant/ama-avia. Токен вводить заново не нужно: он хранится в хранилище секретов DeepSeek Harness, а не в плагине.

Если раньше ставили вручную

Раньше подключение прописывали скриптом в ~/.dsh/cordis.patch.yml (строка avia-search-mcp). Если она осталась, плагин не запускает своё подключение, чтобы не было двух серверов avia, и показывает «Уже подключено вручную». Удалите из ~/.dsh/cordis.patch.yml блоки avia-search-mcp, avia-cards и repeat-tool-reminder (если файл больше ничего не содержит, удалите его) и перезапустите приложение. Потом введите токен на странице плагина.

Настройки

Обычно менять ничего не нужно. Строки плагина настраиваются id-патчем в cordis.patch.yml профиля (~/.dsh/profiles/<профиль>/cordis.patch.yml):

- id: avia-connection
  config:
    url: https://digital-assistant.a-m-a.com/mcp   # адрес MCP (https)
    tokenRef: AVIA_MCP_TOKEN                       # имя токена в хранилище секретов
    toolCallTimeoutMs: 300000
- id: avia-cards
  config:
    shortLinkBases: []    # дополнительные базы коротких ссылок бронирования
    cardsOnly: true       # false — модель снова пишет ответ текстом под карточками
    autoPollPending: true # долгий поиск плагин дожидается сам, до 270 с; false — опрашивает модель
    collapseAfter: 0      # сколько карточек видно сразу: 0 — все; 10 — первые 10, остальные по «Показать ещё»

Если что-то не работает

Строка состояния	Что делать
Токен не задан	Вставьте токен и нажмите «Сохранить»
Сервер не принял токен	Проверьте, что токен скопирован целиком, или запросите новый
Сервер недоступен / Не удалось подключиться	Проверьте сеть или VPN. Плагин сам повторяет подключение: через 30 с, 1, 2 и 5 минут, дальше раз в 5 минут. Чтобы не ждать, нажмите «Проверить снова»
Уже подключено вручную	См. «Если раньше ставили вручную»
Строка avia-connection выключена	Включите строку на странице плагина

Совместимость и лицензия

DeepSeek Harness 0.2.x, Node.js 20+. Плагин предназначен для пользователей digital-assistant, которым выдан токен доступа: установка и использование по этой инструкции разрешены. Лицензия UNLICENSED — открытой лицензии нет: изменять и распространять код без согласия правообладателя нельзя.