QUICK COMMANDS FOR AI — УСТАНОВКА И ОБНОВЛЕНИЕ
Версия расширения: 0.4.1 | Автор: snetkov.ru
==============================================

ВАЖНО! ДВА ВИДА АРХИВОВ — ДВА ПРАВИЛЬНЫХ ПУТИ

1) ПОЛНЫЙ АРХИВ (внутри папки chromium, yandex, firefox):
   Для Chrome выбирайте именно папку chromium, содержащую manifest.json.
   Если содержимое полного архива размещено в E:\ChatGPT-Quick-Commands,
   корректный путь:

   E:\ChatGPT-Quick-Commands\chromium\manifest.json

   Если при распаковке оставили внешнюю папку Quick-Commands-for-AI,
   путь может быть:

   E:\ChatGPT-Quick-Commands\Quick-Commands-for-AI\chromium\manifest.json

2) ОТДЕЛЬНЫЙ CHROME ZIP (файлы лежат в корне ZIP):
   Например, Chrome-Install-Quick-Commands-v0.4.1.zip.
   Распакуйте его в отдельную постоянную папку, например:

   E:\QuickCommands-Chrome\manifest.json

   Здесь папки chromium внутри нет. Это также правильно.

СПИСОК ИЗМЕНЕНИЙ ВЕРСИЙ: откройте файл CHANGELOG-RU.md рядом
с этой инструкцией. Более подробная история — CHANGELOG.md.

ГЛАВНОЕ ПРАВИЛО: в браузере выбирайте ТУ ПАПКУ, в которой
manifest.json лежит непосредственно, а не на один уровень глубже.
НЕ требуется перемещать manifest.json из папки chromium в корень проекта.

------------------------------------------------------------
A. GOOGLE CHROME — УСТАНОВКА ПОЛНОГО АРХИВА
------------------------------------------------------------

1. Распакуйте QuickCommands-0.4.1-All.zip в постоянный каталог.
2. Откройте папку с распакованными файлами и найдите chromium.
3. Убедитесь, что внутри chromium есть manifest.json.
4. Перейдите в Chrome по адресу chrome://extensions.
5. Включите «Режим разработчика».
6. Нажмите «Загрузить распакованное расширение».
7. Выберите папку chromium, а НЕ её родительскую папку.
8. Откройте чат на поддерживаемом сайте и обновите вкладку (Ctrl+R).

Для вашей структуры E:\ChatGPT-Quick-Commands выбор такой:

   E:\ChatGPT-Quick-Commands\chromium

------------------------------------------------------------
B. GOOGLE CHROME — УСТАНОВКА ОТДЕЛЬНОГО CHROME ZIP
------------------------------------------------------------

1. Распакуйте QuickCommands-0.4.1-Chrome.zip в отдельную
   постоянную папку, например E:\QuickCommands-Chrome.
2. Убедитесь, что manifest.json лежит прямо в ней.
3. Откройте chrome://extensions, включите режим разработчика.
4. Нажмите «Загрузить распакованное расширение» и выберите
   E:\QuickCommands-Chrome.

Этот вариант НЕ нужно смешивать с папкой, куда уже распакован
полный архив, если расширение работает оттуда.

------------------------------------------------------------
ВАЖНО: КАК РАБОТАЕТ АВТООТПРАВКА
------------------------------------------------------------

В настройках у каждой команды можно выбрать «Отправить по нажатию».
Этот режим работает только в распознанном обычном чате ChatGPT.
Для надёжности автоматическая отправка происходит лишь когда:
- поле ввода было пустым до нажатия;
- нет прикреплённых файлов и активной генерации;
- вкладка остаётся активной, пользователь не менял текст;
- расширение смогло однозначно найти редактор и кнопку «Отправить».

Если условия не выполнены, текст остаётся в поле для ручной отправки.
При двух последовательных нажатиях дождитесь окончания первой отправки
и убедитесь, что поле снова пустое. Не отправляйте случайно черновик.
На других сайтах (DeepSeek, Claude, Kimi и т. д.) доступна только вставка.

------------------------------------------------------------
C. ОБНОВЛЕНИЕ БЕЗ ПОТЕРИ НАСТРОЕК
------------------------------------------------------------

1. Экспортируйте пользовательские команды в JSON через настройки,
   если такая возможность доступна.
2. НЕ удаляйте расширение из браузера: могут пропасть его данные.
3. Посмотрите на chrome://extensions, из какой папки оно загружено.
4. Замените файлы ТОЛЬКО в этой же папке, не меняя её путь.
   Если ранее использовали E:\ChatGPT-Quick-Commands\chromium,
   распакуйте Chrome ZIP именно туда с заменой файлов (не создавая
   вложенную папку chromium), ИЛИ скопируйте содержимое chromium
   из полного архива в уже установленную папку chromium.
5. На chrome://extensions нажмите «Обновить» / «Перезагрузить».
6. Убедитесь, что версия стала 0.4.1, затем обновите вкладки ИИ-чатов.
7. Проверьте открытие настроек и сохранность команд.

------------------------------------------------------------
D. ДРУГИЕ БРАУЗЕРЫ
------------------------------------------------------------

Яндекс Браузер: для полного архива используйте папку yandex,
содержащую manifest.json. Для отдельного Yandex ZIP выбирайте
папку распаковки, где manifest.json находится в корне.
Страница расширений: browser://extensions. Возможны ограничения
установки расширений не из магазина.

Microsoft Edge: для полного архива выбирайте chromium, адрес
управления расширениями edge://extensions.

Opera: используйте Chromium-сборку и панель управления
расширениями Opera в режиме разработчика.

Firefox (временно): откройте about:debugging#/runtime/this-firefox,
выберите «Загрузить временное дополнение», затем файл
firefox/manifest.json из полного архива. После перезапуска Firefox
временное дополнение потребуется загрузить снова.

------------------------------------------------------------
E. ПРОВЕРКА И ПОЛЕЗНЫЕ ЗАМЕЧАНИЯ
------------------------------------------------------------

- Стандартные наборы: «Вайбкодинг», «Фото · обработка», «Юрист · правовой анализ».
- Дополнительные наборы в настройках: «Тексты», «Исследования»,
  «Документы», «Маркетинг». Добавляйте нужные и сохраняйте.
- «Избранное»: нажмите звёздочку ★ возле нужной команды
  в настройках, сохраните изменения, затем выберите «Избранное»
  над полем ввода чата или в окне расширения.
  Избранное использует исходный текст команды, не создавая копию.
- Настройки -> «ИИ-сервисы, где показывать панель»: снимите флажки
  с ненужных сайтов (ChatGPT, DeepSeek, Claude, Kimi, Gemini,
  Perplexity, Grok, Алиса AI) и нажмите «Сохранить изменения».
- Панель исчезает на выключенных сайтах, сохраняя все команды.
  На остальных выбранных сайтах она продолжает работать.
- Главный переключатель «Показывать панель» выключает её сразу
  на всех сайтах независимо от отдельных флажков.
- Выбор сайтов не изменяет доступы расширения в Chrome. Для
  отзыва разрешения откройте сведения расширения в браузере.
- Сохранённые команды находятся в хранилище расширения браузера.
- Не устанавливайте две активные копии Quick Commands одновременно.
- На страницах chatgpt.com/library/file/ панель намеренно не показывается.
- Если нет панели, проверьте доступ расширения к сайту и обновите вкладку.
- Если кнопка настроек не работает, попробуйте параметры расширения
  через chrome://extensions -> «Сведения», затем проверьте ошибки.
- Быстрые команды, например /passportsizephoto, — текстовые сокращения,
  а не отдельные API-возможности языковой модели.

Документация: https://snetkov.ru/
Каталог фото-команд: https://snetkov.ru/photopromt/

Сборка 0.4.1 тестовая; совместимость с каждым авторизованным
ИИ-сайтом проверяется отдельно.


------------------------------------------------------------
F. ДОБАВЛЕНА АЛИСА AI В ВЕРСИИ 0.4.1
------------------------------------------------------------

Откройте https://alice.yandex.ru/ в настольном браузере.
Зайдите в обычный чат или существующий диалог /chat/...
Панель доступна в настройках: «ИИ-сервисы, где показывать панель»
-> «Алиса AI». По умолчанию она включена.

Текст кнопок вставляется в поле Алисы и требует ручной отправки.
Даже если для команды выбран вариант «Отправить по нажатию»,
на Алисе автоотправка не выполняется. Это мера безопасности.

При обновлении Chrome может запросить дополнительный доступ к
alice.yandex.ru. Разрешайте его только при намерении использовать сайт.
Другие настройки сайтов и ваши команды должны сохраниться. Если панель
не появляется, откройте обычный чат и нажмите «Проверить» в окне
расширения, затем сообщите результат диагностики разработчику.

Реальная авторизованная страница Алисы ещё не прошла проверку
совместимости; тестовая сборка предназначена для проверки пользователем.
