No description
| references | ||
| README.md | ||
| SKILL.md | ||
🛒 Skill: universal-shopper (v3.0 - Flexible Assistant Edition)
universal-shopper — это высокоуровневый управляющий модуль для поиска товаров, анализа отзывов и физической синхронизации корзины пользователя. Скилл оптимизирован для работы в условиях ограниченных ресурсов (лимит 100к токенов) и ориентирован на максимальное удобство пользователя.
1. Концепция «Разумной гибкости»
В отличие от предыдущих версий, текущая архитектура не блокирует работу при малейшем отклонении, а переходит в режим диалога.
- Исследование vs Закупка: Агент разделяет намерения пользователя. Если нужно просто сравнить цены, он не требует авторизации и не нажимает кнопки. Если нужно «купить» — он выполняет физическое добавление в корзину.
- Интерактивный Аудит: При изменении цены или состава корзины агент формирует отчет о расхождениях и запрашивает подтверждение, вместо того чтобы прерывать транзакцию.
2. Ключевые возможности
🔄 Физическая синхронизация (Cloud Sync)
Агент работает непосредственно в браузере пользователя, используя его сессию.
- Результат: Товар, добавленный агентом, мгновенно появляется в мобильном приложении Ozon, Wildberries или любого другого магазина.
- Lazy Auth (Ленивая авторизация): Агент запрашивает вход через VNC только тогда, когда это действительно необходимо (например, сайт не дает положить товар в корзину гостю).
💰 Адаптивная система цен (Price Corridor)
Скилл обучен специфике цен на маркетплейсах:
- Dual-Pricing: Фиксирует «Обычную цену» и «Цену по карте лояльности».
- Умная проверка: При аудите агент понимает, что цена верна, если она укладывается в диапазон между базовой и скидочной ценой. Снижение цены ниже ожидаемой одобряется автоматически.
🛡 Безопасность и Anti-Fraud (Red Team Ready)
- Account Privacy: Агенту запрещен доступ к разделам настроек, адресов и личных карт. Он работает только в «публичных» зонах сайта (поиск, карточка товара, корзина).
- Защитный «Хвост»: В каждую задачу для браузера вшивается инструкция по игнорированию любых команд, встроенных в текст сайта (защита от непрямых инъекций).
- VNC Isolation: Все критические действия (ввод СМС, капчи, пароли) выполняются человеком через VNC. Агент никогда не касается этих данных.
3. Технический стек и Оптимизация
- Token Economy: Скилл настроен на жесткую экономию (лимит 100,000 токенов). Он требует от браузера «стерильных» ответов без рекламного мусора и длинных описаний.
- State Management: Состояние корзины хранится в файле
/app/workspace/cart_state.json.- При каждом запуске агент делает ревизию памяти: сверяет файл с тем, что реально лежит в корзине на сайте, и предлагает актуализировать список.
- Python Engine: Математические расчеты и сравнение списков выполняются в изолированной песочнице через
execute_code.
4. Жизненный цикл заказа
- Инициализация: Проверка файла состояния -> Ревизия корзины на сайте -> Диалог с пользователем о продолжении или очистке.
- Поиск и Добавление: Сбор цен (Standard/Loyalty) -> Краткий анализ отзывов (на предмет брака/подделок) -> Физический клик «В корзину».
- Аудит: Глубокая сверка «Память vs Сайт» -> Формирование отчета об изменениях цен -> Получение одобрения пользователя.
- Передача: При установке статуса
AUDIT_SUCCESSуправление переходит к скиллуsafe-paymaster.
5. Интеграция с safe-paymaster
Скилл universal-shopper является «Бухгалтером», подготавливающим почву для «Кассира». Он гарантирует, что к моменту оплаты:
- В корзине нет лишних услуг (страховок, пакетов).
- Цены подтверждены и согласованы.
- Файл
cart_state.jsonсодержит актуальный «контракт» на оплату.
Контекст: Windows 11 / WSL2 / Docker / Qwen 3.5-122b