diff --git a/README.md b/README.md new file mode 100644 index 0000000..b186719 --- /dev/null +++ b/README.md @@ -0,0 +1,44 @@ +# 💳 Skill: safe-paymaster (v3.0 - Universal SBP Controller) + +**`safe-paymaster`** — это специализированный модуль «Финансового контролера», отвечающий за безопасное завершение процесса покупки. Скилл ориентирован на работу с Системой быстрых платежей (СБП), обеспечивая пользователю максимальное удобство оплаты при нулевом риске компрометации банковских карт. + +## 1. Роль в системе +Скилл является «Кассиром», который вступает в работу только после того, как «Бухгалтер» (`universal-shopper`) подтвердил состав корзины и зафиксировал контракт в файле `/app/workspace/cart_state.json`. + +## 2. Ключевые принципы + +### 🌍 Универсальность (Any-Merchant Support) +В отличие от предыдущих версий, текущая архитектура позволяет агенту работать на **любом легитимном интернет-магазине**, выбранном пользователем. Безопасность перенесена с фильтрации магазинов на строгую валидацию **платежных шлюзов**. + +### 🤝 Протокол сосуществования (Card & SBP Coexistence) +Агент обучен корректно вести себя на современных платежных страницах: +* **Игнорирование:** Наличие полей для ввода данных банковских карт (номер, CVC, срок действия) на одной странице с выбором СБП воспринимается как нормальное поведение сайта. +* **Фокус:** Агент целенаправленно ищет и активирует только методы оплаты через СБП, Mir Pay или кнопку "Оплатить через приложение банка". +* **Hard Stop:** Агенту КАТЕГОРИЧЕСКИ запрещено вводить любые символы в поля ввода реквизитов карт. + +### 🔍 Глубокий поиск SBP-данных (Deep Discovery) +Поскольку Исполнитель (`internet_browser`) работает без Vision (зрения), извлечение ссылки на оплату происходит комбинированным методом: +1. **DOM Parsing:** Поиск ссылки `https://qr.nspk.ru/...` в скрытых атрибутах кнопок и тегах `