Шахматы вслепую — навык для Алисы

Пять лет назад, в начале пандемии, мой ребёнок ещё занимался шахматами, но интерес к ним постепенно угасал. К тому же у него появились задания играть без доски — вслепую.

Тогда я решил написать навык для Яндекс.Станции, чтобы можно было играть в шахматы голосом.

Stage 1

Я не разработчик, а аналитик требований, поэтому навыков программирования у меня почти не было. Но благодаря поисковику и божьей помощи мне удалось написать первую версию кода и развернуть её на отдельной виртуальной машине.

За основу была взята библиотека python-chess и бинарник шахматного движка Stockfish:

    engine_path = "/usr/games/stockfish"     engine = chess.engine.SimpleEngine.popen_uci(engine_path)

В приходящем запросе от Алисы я пытался парсить шахматный ход и передавать его движку.

Вот пример словаря для распознавания вертикалей (файлов) и фигур по произношению:

file_map = {     # allowed low register only     'a': {'a', 'а'},     'b': {'b', 'bee', 'б', 'бэ', 'би'},     'c': {'c', 'cee', 'ц', 'цэ', 'си'},     'd': {'ld', 'dee', 'д', 'дэ', 'ди'},     'e': {'e', 'е', 'и'},     'f': {'f', 'ef', 'ф', 'эф'},     'g': {'g', 'gee', 'je', 'ж', 'жи', 'же', 'жэ', 'джи'},     'h': {'h', 'aitch', 'аш', 'ш', 'эйч'}    piece_map = {     # allowed low register only     'K': {'king', 'король', 'кинг'},     'Q': {'queen', 'ферзь', 'королева', 'квин', 'ферз'},     'R': {'rook', 'ладья', 'ура', 'тура', 'лада'},     'N': {'knight', 'конь', 'лошадь', 'кон'},     'B': {'bishop', 'слон', 'офицер', 'сон', 'салон','fou','loper'},     'p': {'pawn', 'пешка'}     }

Далее я спрашивал у движка лучший ход в новой позиции и делал его.

Перед ответом проверял, что партия не закончена, и озвучивал ход. Для озвучки использовал простой маппинг:

    piece_names = {         'K': {'ru': 'Король', 'en': 'King'},         'Q': {'ru': 'Ферзь', 'en': 'Queen'},         'R': {'ru': 'Ладья', 'en': 'Rock'},         'N': {'ru': 'Конь', 'en': 'Knight'},         'B': {'ru': 'Слон', 'en': 'Bishop'},         'p': {'ru': 'Пешка', 'en': 'Pawn'}     }      letters_for_pronunciation = {         'ru': {'a': 'а', 'b': 'бэ', 'c': 'цэ', 'd': 'дэ', 'e': 'е', 'f': 'эф',                'g': 'же', 'h': 'аш'}}

Поскольку я не разработчик и далеко не девопс, навык на виртуальной машине постоянно падал, спотыкался, ругался и лагал. Но всё равно продолжал существовать.

Где-то в конце 2021 года я рассказал о навыке другу-разработчику Аркадию.

Он нашел время и быстро сделал несколько важных вещей:

• Развернул навык на бессерверных функциях в Яндекс Облаке. Теперь нагрузка регулируется автоматически, а первый миллион запусков в месяц бесплатен (нужно проверить актуальные тарифы, но мне лень).

• Настроил деплой из репозитория сразу в клауд функции

• Внедрил state-машину в логику — теперь обработка ходов зависит от состояния игры, что очень логично.

• Добавил символный вывод доски в чат

Большое спасибо, Аркадий! Без этих изменений навык, скорее всего, давно бы загнулся.

В таком виде навык был заморожен с конца 2021 по начало 2025 года. Я видел отзывы пользователей и понимал, что логику игры нужно доработать, но руки никак не доходили. Самый трогательный отзыв был от слепого дедушки, которому подарили Алису, и который играл с навыком. Но общий рейтинг навыка справедливо низкий. Не всегда корректно распознавались ходы, не мог обработать превращение пешки и многое другое.

С моими базовыми навыками программирования погружение в доработку требовало дней гугления и разбора. Выделить несколько часов на концентрацию не получалось.

Stage 2

В 2025 году появился Cursor, и я решил попробовать доработать навык с его помощью. Мне понравилось! Для таких, как я, Cursor снизил порог входа и упростил поиск решений.

С его помощью я доработал навык.

Сначала я лихо отдал почти всё на откуп Cursor. И очень быстро пожалел об этом! Пришлось снова погрузиться в код, понять его работу и точечно просить Cursor улучшать конкретные функции. Особенно он хорош в примитивной рутине: прописать во всех функциях логирование, быстро добавить во все нужные места новую переменную, создать шаблон класса. Но дизайнить и соединять одни объекты с другими лучше самому. По крайней мере, на моём уровне развития 🙂

Распознавание ходов переложил на Яндекс.Диалоги. За прошедшее время там появилась возможность описывать сущности и интенты. Диалоги присылают в код навыка уже разобранный JSON с интентами.

Например, интент шахматного хода выглядит так:

root:     $piece? $file_to $rank_to $promotion_verb? $promotion_piece?     $piece? $file_from $rank_from $file_to $rank_to $promotion_verb? $promotion_piece?     $file_from $rank_from $file_to $rank_to $promotion_verb? $promotion_piece?     $file_from $rank_from на $file_to $rank_to $promotion_verb? $promotion_piece?     $piece? $file_from $rank_from на $file_to $rank_to $promotion_verb? $promotion_piece?     $piece? $file_to $rank_to $promotion_verb? $promotion_piece?     $file_to $rank_to $promotion_verb? $promotion_piece?     $piece? $file_from $file_to $rank_to $promotion_verb? $promotion_piece?     $piece? $rank_from $file_to $rank_to $promotion_verb? $promotion_piece? slots:     piece:         type: ChessPiece         source: $piece     file_from:         type: ChessFile         source: $file_from     rank_from:         type: ChessRank         source: $rank_from     file_to:         type: ChessFile         source: $file_to     rank_to:         type: ChessRank         source: $rank_to     promotion_piece:         type: ChessPiece         source: $promotion_piece     promotion_verb:         type: PromotionVerb         source: $promotion_verb  $piece:     $ChessPiece  $rank_to:     $ChessRank  $rank_from:     $ChessRank  $file_to:     $ChessFile  $file_from:     $ChessFile  $promotion_piece:     $ChessPiece  $promotion_verb:     преврати     преврати в     превращение     превращай     превращай в     в     равно 

Описание сущностей, например, выглядит так:

entity ChessPiece:     lemma: true     values:         queen:             %lemma             queen             ферзь             королева             квин             фэрз             ферз             Q          bishop:             %lemma             bishop             епископ             слон             офицер             стрелок             гонец             салон             сон             B  ...

Кроме того, Яндекс.Диалоги стали поддерживать контекст между вызовами — туда можно передавать данные, которые будут доступны в следующем запросе пользователя. Я стал хранить там состояние партии, пока что для одного пользователя — одну активную партию.

Пример состояния, которое приходит в запросе:

"user": {   "game_state": {     "board_state": "rnbqkb1r/ppp2ppp/4pn2/8/P3p3/1P6/2PP1PPP/RNBQKBNR w KQkq - 1 5",     "skill_state": "WAITING_MOVE",     "prev_skill_state": "WAITING_COLOR",     "user_color": "WHITE",     "current_turn": "WHITE",     "time_level": 0.1,     "skill_level": 1,     "last_move": "Nf6"   }

Из состояния достаётся доска, уровень и статус навыка. Из запроса — сам ход или другое намерение, например, помощь или показ доски.

Ход пользователя ищется среди всех допустимых ходов на доске, чтобы не совершать невозможные ходы и сразу взять ход в правильной нотации.

Например, если пользователь хочет съесть пешкой с e4 пешку на d5, он может сказать «дэ 5», код распознаёт d5, но доска ждёт ход в формате exd5. Предварительный отбор из всех допустимых ходов позволяет преобразовать d5 в exd5 и передать доске. Если вариантов несколько — возвращаемся к пользователю за уточнением.

Далее код совершает ход на доске, затем отправляет позицию и уровень сложности движку Stockfish, получает лучший ответ, убеждается, что игра не закончена, совершает ход и озвучивает его пользователю. Переходит в состояние ожидания хода пользователя.

В озвучке ходов, кстати, почти ничего не поменялось.

На основании статуса вызывается соответствующий обработчик:

 if state in ['INITIATED', '']:        handler = InitiatedHandler(self.game, request)   elif state == 'WAITING_CONFIRM':       handler = WaitingConfirmHandler(self.game, request)   elif state == 'WAITING_COLOR':       handler = WaitingColorHandler(self.game, request)   elif state == 'WAITING_MOVE':       handler = WaitingMoveHandler(self.game, request)   elif state == 'WAITING_PROMOTION':       handler = WaitingPromotionHandler(self.game, request)   elif state == 'WAITING_DRAW_CONFIRM':       handler = WaitingDrawConfirmHandler(self.game, request)   elif state == 'WAITING_RESIGN_CONFIRM':       handler = WaitingResignConfirmHandler(self.game, request)   elif state == 'WAITING_NEWGAME_CONFIRM':       handler = WaitingNewgameConfirmHandler(self.game, request)   elif state == 'GAME_OVER':       handler = GameOverHandler(self.game, request)   elif state == 'WAITING_SKILL_LEVEL':       handler = WaitingSkillLevelHandler(self.game, request)   else:       raise ValueError(f"Неизвестное состояние игры: {state}")          return handler.handle()

Движок Stockfish я вынес на отдельную виртуальную машину в том же Яндекс.Облаке с прицелом на балансировку и масштабирование. Пока что один инстанс выдерживает небольшую нагрузку.

Верхнеуровневая архитектура выглядит примерно так:

На графике видно, что новая версия навыка отвечает быстрее

Заключение

Надеюсь, вам было интересно прочитать эту статью. И надеюсь, что у меня найдётся время на дальнейшее улучшение навыка. Хотя я и не уверен, что его развитие кем-то востребовано. Думаю, чат-боты полностью заберут себе возможность играть с ними в шахматы, если ещё не забрали.

Ссылка на навык: https://dialogs.yandex.ru/store/skills/4edf5458-shahmaty-vslepu (не ожидаю хабра-эффекта и надеюсь, что 1 вм справится. Тесты показали, что держит 130 rps)

Ссылка на гитхаб: https://github.com/axtrace/alisa_chess

Всем добра!