ХАЛЯВКА — Price Monitor
Подробная инструкция по установке
==================================

Нужно: Windows, браузер Google Chrome или Microsoft Edge.
Время: около 5–10 минут, если ставите впервые.

Важно: расширение пока не в магазине Chrome — его подключают
вручную. Это нормально для бесплатных проектов. Вы ничего
не ломаете в браузере.


ЧАСТЬ 1. СКАЧАТЬ И РАСПАКОВАТЬ
-------------------------------

1. Откройте в браузере: https://halyavka.online/extension/

2. Нажмите «Скачать установщик (один ZIP)».
   Сохранится файл halyavka-price-monitor-setup.zip

3. Найдите файл в папке «Загрузки».

4. Щёлкните по ZIP правой кнопкой мыши → «Извлечь всё…»
   (или «Распаковать», «Extract all»).

5. Выберите папку, куда распаковать — удобно «Рабочий стол»
   или «Документы». Нажмите «Извлечь».

6. Откройте появившуюся папку. Внутри должно быть:
   • Установить.bat  (или Ustanovit.bat — то же самое)
   • install.ps1
   • папка PriceMonitor
   • этот файл PROCHITAJ.txt

   Если видите только один файл .zip — вы не распаковали архив.
   Вернитесь к шагу 4.


ЧАСТЬ 2. ЗАПУСТИТЬ УСТАНОВЩИК
------------------------------

1. Дважды щёлкните «Установить.bat».

2. Если Windows спросит «Разрешить этому приложению…» — «Да».

3. Если антивирус спросит про PowerShell — разрешите.
   Установщик НЕ качает ничего из интернета, только копирует
   файлы из папки PriceMonitor на диск.

   ВАЖНО (Kaspersky и похожие): сразу добавьте в ИСКЛЮЧЕНИЯ папку
   %USERPROFILE%\Halyavka
   Иначе антивирус может пометить мост автообновления как «Trojan»
   (ложное срабатывание на .cmd + PowerShell). Это не вирус —
   код открыт: https://github.com/paved-bio/halyavka-price-monitor
   Если файлы уже в карантине — восстановите и отметьте «Доверять».

4. Откроется чёрное окно. Подождите несколько секунд.
   Должны автоматически открыться:
   • папка с расширением в Проводнике
   • страница «Расширения» в Chrome или Edge

5. Путь к папке уже скопирован в буфер обмена (Ctrl+V).


ЧАСТЬ 3. ПОДКЛЮЧИТЬ В CHROME (ГЛАВНОЕ)
--------------------------------------

Страница адреса: chrome://extensions
(в Edge то же самое: edge://extensions)

Шаг 3.1 — Режим разработчика
   • Посмотрите в ПРАВЫЙ ВЕРХНИЙ угол страницы расширений.
   • Найдите переключатель «Режим разработчика».
   • Включите его (должен стать синим / активным).

Шаг 3.2 — Загрузить распакованное
   • Слева вверху появится кнопка «Загрузить распакованное»
     (в Edge может называться «Загрузить расширение»).
   • Нажмите её.

Шаг 3.3 — Выбрать папку
   • Откроется окно выбора папки.
   • Нужна папка PriceMonitor, куда установщик скопировал файлы.
     Обычно это:
     C:\Users\ВАШЕ_ИМЯ\Halyavka\PriceMonitor
   • Совет: в адресной строке окна нажмите Ctrl+V — вставится путь.
     Или откройте папку, которую установщик уже показал в Проводнике.
   • Внутри папки должен лежать файл manifest.json.
   • Нажмите «Выбор папки».

Шаг 3.4 — Проверить карточку
   • На странице расширений появится карточка «Price Monitor».
   • Переключатель у карточки должен быть ВКЛ (синий).
   • Не должно быть красной надписи «Ошибка».

Шаг 3.5 — Закрепить иконку (по желанию)
   • Нажмите на значок пазла справа от адресной строки Chrome.
   • Найдите Price Monitor → значок булавки.
   • Иконка появится на панели — так удобнее открывать.


ЧАСТЬ 4. ПРИВЯЗАТЬ TELEGRAM
---------------------------

1. Откройте бота: https://t.me/HalyavkaOnline_bot

2. Нажмите /start

3. В меню выберите кнопку «🔍 Трекер цен»
   (или отправьте команду /tracker)

4. Бот пришлёт код из 4 цифр — код связки.

5. В Chrome нажмите иконку Price Monitor → введите код → «Подключить».

В VK-боте привязка расширения пока нет — трекер цен только через Telegram.


ЧАСТЬ 5. ПЕРВОЕ ОТСЛЕЖИВАНИЕ
----------------------------

1. Откройте страницу товара на Ozon, Wildberries или Steam.

2. Нажмите иконку Price Monitor.

3. Укажите желаемую цену (или «появится в наличии»).

4. Нажмите «Мониторить этот товар».

5. Когда цена изменится — придёт уведомление в Telegram.


БЕЗ УСТАНОВКИ (ПРОЩЕ, НО БЕЗ КНОПКИ В БРАУЗЕРЕ)
------------------------------------------------

В Telegram-бот отправьте одним сообщением ссылку и цену:
   https://ozon.ru/product/... 4500
Бот добавит отслеживание без расширения.


ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ
------------------------

«Не вижу Режим разработчика»
   Прокрутите страницу chrome://extensions вверх.
   В Edge переключатель тоже справа вверху.

«Выбрал папку, но ошибка»
   Выберите именно папку PriceMonitor, где лежит manifest.json,
   а не ZIP-архив и не родительскую папку.

«Карточки нет»
   Перезапустите Chrome полностью (закройте все окна).
   Запустите Установить.bat ещё раз.

«Код из бота не подходит»
   Код одноразовый. Запросите новый в боте.
   Вводите 4 цифры без пробелов.

«Расширение пропало после перезагрузки ПК»
   Иногда Chrome отключает неопубликованные расширения.
   Зайдите в chrome://extensions и включите переключатель снова.

«Антивирус / Kaspersky пишет Trojan, host.cmd, PowerShell»
   Ложное срабатывание на автообновление (не из Chrome Store).
   1) Исключения → папка %USERPROFILE%\Halyavka
   2) Карантин → восстановить файлы Halyavka
   3) При необходимости: https://halyavka.online/extension/auto-update.html
   Подробнее: https://halyavka.online/extension/#antivirus

«Много вкладок магазинов само открывается»
   Так работает проверка цен (воркер/мониторинг). Вкладки закрываются сами.


Сайт: https://halyavka.online/extension/
Бот:  https://t.me/HalyavkaOnline_bot
Код:  https://github.com/paved-bio/halyavka-price-monitor
