Конечный автомат на хуке не даёт ИИ-агенту повесить Bash: все 122 теста пройдены
Если ИИ-агент потерял закрывающую кавычку, Bash ждёт продолжения ввода, и агент висит до таймаута. Quote Guard заменил регулярки конечным автоматом (FSM): он читает команду символ за символом по правилам оболочки прямо в хуке PreToolUse, до запуска. При споре Bash и PowerShell агент получает подсказку и чинит вызов сам. Защиту от зависаний лучше держать в инфраструктуре, а не в промпте.
AI-обработка оригинала Habr AI; редакция Hamidun News
Представьте: автономный агент собирает команду для терминала и теряет закрывающую кавычку. Для текста это опечатка, а для Bash — повод остановиться и ждать. Оболочка решает, что ввод продолжится на следующей строке, печатает приглашение «>>» и молчит.
Если агент читает процесс синхронно, конец вывода (EOF) не приходит, процесс не завершается, сессия выгорает по таймауту, и агент падает. Автор проекта Quote Guard описал на Habr, как закрыть эту дыру без просьб в промпте. Он поставил перед запуском команды конечный автомат (FSM) — небольшую программу, которая читает строку символ за символом и в каждый момент знает, где находится: в обычном тексте, внутри кавычек или после символа экранирования.
Она встроена в хук PreToolUse — перехватчик, который срабатывает до того, как агент отдаст команду операционной системе. Надёжность подтверждают 122 автоматические проверки, и все они проходят.
Почему регулярки не работают
Первая мысль — проверять чётность кавычек, например count % 2 == 0. Но одна и та же строка по-разному читается в разных оболочках. Возьмём dir "C:\". В PowerShell обратный слэш — обычный разделитель пути: кавычка открылась, увидела C:\, закрылась, команда готова. В Bash тот же слэш экранирует следующую кавычку, она перестаёт быть закрывающей, и шелл ждёт продолжения, которого не будет.
Со вторым примером та же история: в echo "a"b"` бэктик в PowerShell — символ экранирования, а в Bash он запускает подстановку команды, шелл ищет парный бэктик и снова уходит в многострочный режим. Угадать оболочку по операционной системе хоста нельзя: в контейнерах Windows бывает Bash, в WSL — PowerShell, а агент запускает скрипты кросс-платформенно. Наивный валидатор либо пропустит зависание в Linux, либо заблокирует легитимный Windows-путь. После первого такого ложного срабатывания инженер просто отключит защиту.
Конечный автомат и «двойной замок»
Автор заменил регулярки на детерминированный автомат, у которого три изолированные грамматики — posix, powershell и cmd. Он переключает состояния (обычный текст, двойные кавычки, одинарные кавычки, экранирование) строго по правилам целевой среды.
Для неизвестных инструментов, например стороннего плагина или кастомного агента, работает режим Strict Intersect. Команду проверяют сразу по двум грамматикам, posix и powershell:
- безопасна в обеих — пропускаем;
- ведёт к зависанию в обеих — блокируем;
- оценки расходятся, как в случае с
dir "C:\"— выполнение прерывается с кодом Exit 2.
Вместо молчаливого зависания модель получает машиночитаемый отказ: неизвестный инструмент, строка безопасна в PowerShell, но вешает POSIX, и подсказка задать переменную QUOTE_GUARD_MAP=MyTool=powershell. Агент читает инструкцию и со второго шага присылает корректный вызов. Это экономит и время сессии, и токены на повторные попытки после таймаута.
История с heredoc и 122 проверки
Самое полезное в материале — честный разбор ошибки. Heredoc — это блок текста в Bash между маркерами вроде <<EOF и EOF. В версии v3.0 хук видел маркер <<EOF, решал, что внутри кавычки «сырые», и пропускал всю команду. Тест показал дыру: модель сгенерировала cat <<EOF … EOF, а следом echo "unclosed. Хук увидел маркер и пропустил всё, а незакрытая кавычка после блока повесила шелл.
В v3.1 добавили маскирование тела heredoc: содержимое затирается пробелами с сохранением смещений, чтобы не сбить парсер, а всё до и после проверяет автомат. Если сам терминатор EOF не закрыт, хук фиксирует состояние HEREDOC и блокирует запуск. Теперь cat <<EOF со скриптом внутри проходит, а EOF с последующим echo "broken — нет.
Проект проверяется на общем кросс-языковом наборе cases.jsonl с 31 грамматическим случаем. Всего 122 проверки: по 46 на реализации лексера на Python и Node.js (они должны вести себя побайтово одинаково), 25 на интеграцию хука PreToolUse и 5 на самопроверку детектора дублирования. Все проходят. Тесты состязательные: в них заложены попытки выйти из кавычек, вложенные конструкции, многострочные инъекции и обходы хука.
Что это значит на практике
Для тех, кто строит агентов с доступом к шеллу, вывод простой: вероятностную генерацию стоит ограждать детерминированным шлюзом. Хорошо и то, что отказ возвращается как инструкция для модели, а не как тишина.
Ограничения автор называет сам. Гарантия действует, только если хук установлен на хосте и переменные окружения не подменены. Покрыты три грамматики; другие оболочки, например fish или zsh с особыми расширениями, придётся описывать отдельно. Результаты тестов пока подтверждены только в репозитории проекта, независимого аудита нет. Но как шаблон для рантайма агентов подход рабочий: автомат вместо регулярок, структурированный отказ вместо зависания и обязательный тест на каждую найденную дыру.
- 21 нояб. 2026 г.Ролик о Claude в GTA 6 похож на фейк: полчаса управления съели 5-часовой лимит Pro
- 21 нояб. 2026 г.Claude Code ускорил декомпиляцию Snowboard Kids 2: с 20% до 45% функций за три месяца
- 21 нояб. 2026 г.VibeCBS собирает прозвища проектов заранее: агент находит в 2,8 раза больше документов
- 21 нояб. 2026 г.Вакансий FDE за год стало в 4,6 раза больше: что делает инженер у заказчика
Вопросы и ответы по материалу
Что известно по теме: почему регулярки не работают?
Первая мысль — проверять чётность кавычек, например count % 2 == 0. Но одна и та же строка по-разному читается в разных оболочках. Возьмём dir "C:\". В PowerShell обратный слэш — обычный разделитель пути: кавычка открылась, увидела C:\, закрылась, команда готова. В Bash тот же слэш экранирует следующую кавычку, она перестаёт быть закрывающей, и шелл ждёт продолжения, которого не будет.
Что известно по теме: конечный автомат и «двойной замок»?
Автор заменил регулярки на детерминированный автомат, у которого три изолированные грамматики — posix, powershell и cmd. Он переключает состояния (обычный текст, двойные кавычки, одинарные кавычки, экранирование) строго по правилам целевой среды. Для неизвестных инструментов, например стороннего плагина или кастомного агента, работает режим Strict Intersect.
Что известно по теме: история с heredoc и 122 проверки?
Самое полезное в материале — честный разбор ошибки. Heredoc — это блок текста в Bash между маркерами вроде <<EOF и EOF. В версии v3.0 хук видел маркер <<EOF, решал, что внутри кавычки «сырые», и пропускал всю команду. Тест показал дыру: модель сгенерировала cat <<EOF … EOF, а следом echo "unclosed. Хук увидел маркер и пропустил всё, а незакрытая кавычка после блока повесила шелл.
От чтения про ИИ-агентов — к запуску своего агента за вечер
Пошаговая сборка автономных агентов и MCP-связок в Hamidun Academy (academy.hamidun.com) (72 часа бесплатно) или мгновенный запуск готовых мультишаговых агентов в облаке Nomad.
Главное из мира ИИ — раз в неделю
7 ключевых событий недели, отобранных вручную. Без шума, репостов и пресс-релизов.
Готово! Проверьте почту — мы отправили подтверждение.