Пакет навыков Mbbrowser (Skills Package)

После настройки пакета правил (Rules Package) этот пакет навыков (Skills Package) служит вашим «меню быстрого старта». Для каждого сценария есть готовый шаблон подсказки — скопируйте его непосредственно в Cursor или Antigravity, подставьте свои параметры, и ИИ создаст полный, функциональный скрипт.

---

IMPORTANT

Автоматизация Mbbrowser: Первый закон выживания

1. Синергия двух пакетов (Критически важно!): В Antigravity или Cursor вы ОБЯЗАНЫ загрузить как пакет правил (Rules), так и пакет навыков (Skills). Правила дают низкоуровневый словарь API, а навыки — высокоуровневые логические определения. Они неразделимы.
2. Рекомендация локального режима: Переключение клиента в «Локальный режим» (Local Mode) при крупномасштабных запусках может повысить эффективность в сотни раз.
3. Напоминание о бэкапах: Регулярно создавайте резервные копии каталога бизнес-базы данных MBDATA.

---

Основное содержание пакета навыков Mbbrowser

Содержимое ниже представляет собой расширенный пакет навыков (Skill), разработанный для Antigravity. Пожалуйста, скопируйте его целиком и сохраните как .agent/skills/houniao-mbbrowser.md в корне вашего проекта.

---
name: houniao-mbbrowser-apiserver-full
description: >
  Полные спецификации разработки, детали интерфейсов, методы подключения CDP, устранение неполадок и допустимые значения параметров для Mbbrowser (MBBrowser) + ApiServer.
  Загружайте этот навык немедленно, когда пользователи упоминают Mbbrowser, ApiServer, антидетект-браузеры, изоляцию нескольких аккаунтов, запуск/остановку среды, перехват управления CDP/Playwright/Selenium/Puppeteer, Session_ID, обновление прокси, создание среды, коды ошибок, такие как -1/-105 и т. д.
  Строго следуйте различиям в типах Session_ID, используйте существующий контекст, проверяйте коды/статусы и проверяйте допустимые значения параметров.
  Отдавайте приоритет Playwright перед прямым соединением CDP.
---

# Полная спецификация Mbbrowser (MBBrowser) + ApiServer

**Ключевые напоминания**:
- Запуск ApiServer требует Local Mode + регулярное резервное копирование MBDATA.
- Все интерфейсы: **POST** + **application/json**.
- База: http://127.0.0.1:8186 (Порт настраивается).
- Успех: code=0; Ошибка: code<0 + message.
- Проверяйте `data.listid[0].status == 0` после запуска.
- Используйте `Public_ip` для проверки работы прокси.
- Контроль конкурентности: ≤20 сред в группе.

## Быстрый поиск интерфейсов

### Жизненный цикл среды (Самое важное)
- **Start**: POST /api/v1/browser/start  
  Session_ID: **Массив (Array)** ["id1", "id2"]  
  Рекомендуемые args: ["--blink-settings=imagesEnabled=false", "--interval-seconds=2", "--disable-extensions"]  
  isHeadless: false (Отладка) / true (Продакшн)

- **Stop**: POST /api/v1/browser/stop  
  Session_ID: **Строка (String)** "id"

- **Kill**: POST /api/v1/browser/kill (Рекомендуется для зависших процессов; Session_ID: Строка)

- **Status**: POST /api/v1/browser/status

### Интерфейсы запросов
- Список (Фильтр + Пагинация): /api/v1/session/listid  
- Детали (Включая CDP_Port, webdriver): /api/v1/session/id_container (type=1 — самый полный; Session_ID: Массив)

### Создание / Обновление
- Создание: /api/v1/session/create (Automatic_Configure=0 для быстрого создания).  
- Обновление базовых/прокси/расширенных настроек: соответствующие /update, /proxy/update, /adv_setting.

### CDP Подключение (Следовать обязательно!)
**Playwright Python**:
```python
port = env["browser_CDP_Port"]
ws = f"ws://127.0.0.1:{port}/json/version"
pw = sync_playwright().start()
browser = pw.chromium.connect_over_cdp(ws)
context = browser.contexts[0]  # ОБЯЗАТЕЛЬНО используйте существующий контекст!!
page = context.pages[0] if context.pages else context.new_page()
```

---

## 2. Справочник ошибок и параметров

### Индекс кодов ошибок
- **CODE 0**: Успех
- **CODE -106**: Ошибка часового пояса
- **CODE -105**: Валидация прокси не удалась
- **Status -7**: Среда уже запущена
- **Status -22**: Session_ID не найден

### Словарь параметров
- **SystemOS**: Windows, iPhone, Android, MacIntel и т. д.
- **Resolution**: 1920x1080 и другие стандартные разрешения.
- **TimeZone**: Стандарт IANA, например, "Asia/Shanghai +08:000".

---

Советы по использованию

Секреты для лучшей генерации кода ИИ

1. Будьте максимально конкретны: Не говорите просто «напиши скрипт для входа». Скажите: «URL входа — xxx, селектор имени пользователя — #username, поле пароля — #password, нажми .submit-btn после ввода и подожди, пока URL изменится на /dashboard».

2. Указывайте обработку ошибок: Например, «Сделай скриншот и запиши в файл лога, если вход не удался».

3. Определяйте формат вывода: Например, «Запиши результаты в result.csv, включая session_id, статус и время выполнения».

4. Описывайте требования к многопоточности: Например, «10 параллельных сред с использованием ThreadPoolExecutor».

5. Ссылайтесь на имена файлов: Например, «Прочитай session_id из sessions.txt по одному в строке».

Изменение кода, сгенерированного ИИ

Если в сгенерированном ИИ коде есть проблема, выделите этот код и введите:

В этом коде есть проблема: [опишите проблему], пожалуйста, исправьте её.

Или:

На основе приведенного выше кода добавьте следующую функцию: [опишите новое требование].

---

TIP

Настройка завершена? Переходите к следующей главе: Живое демо: Голос → Скрипт, чтобы увидеть, как одна фраза может пробудить эти мощные навыки.