# Как переназначить кнопку Plus Key на OnePlus: установка PlusKey, настройка приложений и ИИ-агентов

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-perenaznachit-knopku-plus-key-na-oneplus-ustanovka.html

## TL;DR

- Время выполнения: 20–30 минут
- Уровень сложности: Intermediate (потребуется терминал и ADB)
- Понадобится: смартфон OnePlus с аппаратной кнопкой Plus Key; ПК (Windows/macOS/Linux); platform-tools с утилитой `adb`; USB-кабель с передачей данных; APK приложения PlusKey — версию и источник берите из официальной документации приложения (сверьтесь с документацией, мы её не приводим); установленный ИИ-клиент или локальный сервер модели

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-perenaznachit-knopku-plus-key-na-oneplus-ustanovka-ru-1.jpg?v=1795077831)


- **Plus Key** — аппаратная клавиша на корпусе OnePlus, которая заменила трёхпозиционный переключатель Alert Slider (тот, что переключал «без звука / вибрация / звонок»). Список поддерживаемых моделей и версий прошивки — сверьтесь с документацией PlusKey: переназначение работает не на всех устройствах.
- **Отладка по USB (USB debugging)** — режим Android, разрешающий ПК отправлять команды на телефон. Включается так: `Настройки → О телефоне → Номер сборки` (нажать 7 раз) → вернуться назад → `Для разработчиков` → `Отладка по USB` = Вкл.
- **ADB (Android Debug Bridge)** — консольная утилита из пакета platform-tools. Проверьте, что она есть:
```bash
adb version
```
Ожидаемый вывод — строка вида `Android Debug Bridge version 1.0.41` (у вас будет другая версия — это нормально).
- **Права**: root не нужен, но понадобится подтвердить на экране телефона запрос «Разрешить отладку по USB?» с отпечатком ключа RSA.
- **Кабель**: дешёвые кабели «только зарядка» не передают данные — с ними `adb devices` покажет пустой список.
- **ИИ-агент**: либо мобильное приложение-чат, либо локальный сервер модели с HTTP-эндпоинтом (например, `http://127.0.0.1:8080`). Точный адрес и имя модели подставьте свои.

Чек-лист подготовки:

- [ ] Отладка по USB включена
- [ ] `adb version` отвечает на ПК
- [ ] `adb devices` показывает устройство в статусе `device`
- [ ] APK PlusKey скачан
- [ ] Известен адрес ИИ-эндпоинта или выбрано приложение-агент

## Шаг 1. Подключение по ADB и установка PlusKey

**Что сделать:** подключите телефон кабелем, подтвердите запрос отладки на экране и установите APK.

**Зачем:** PlusKey переназначает системную клавишу, а такие приложения ставятся и настраиваются только через ADB — обычная установка из файла не даёт нужных разрешений.

Подключение и проверка:

```bash
adb devices
```

Ожидаемый вывод:

```
List of devices attached
R58XXXXXXXX	device
```

Если вместо `device` стоит `unauthorized` — разблокируйте телефон и нажмите «Разрешить» в системном диалоге.

Установка (замените имя файла на своё):

```bash
adb install -r PlusKey.apk
```

Ожидаемый вывод: `Performing Streamed Install` и затем `Success`.

Затем узнайте фактическое имя пакета — оно нужно для всех дальнейших команд:

```bash
adb shell pm list packages | grep -i plus
```

**Пример:** вывод `package:com.pluskey.remapper` означает, что дальше вместо плейсхолдера `<pluskey.package>` вы подставляете `com.pluskey.remapper`.

**Как проверить:** `adb shell pm list packages | grep -i plus` печатает ровно одну строку с именем пакета, а в лаунчере появилась иконка PlusKey.

## Шаг 2. Выдача разрешений и назначение действий на кнопку
![Иллюстрация к разделу «Шаг 2. Выдача разрешений и назначение действий на кнопку»](https://ai-release.org/guides/img/kak-perenaznachit-knopku-plus-key-na-oneplus-ustanovka-ru-2.jpg?v=1795077839)


**Что сделать:** откройте PlusKey, пройдите его экран первичной настройки, включите службу специальных возможностей (Accessibility Service — системный механизм Android, позволяющий приложению реагировать на нажатия и выполнять действия в других приложениях) и назначьте действия на жесты кнопки.

**Зачем:** без службы Accessibility приложение видит нажатие, но не может перехватить его и запустить нужный сценарий.

Точный список разрешений PlusKey смотрите в его документации; типовой набор для таких приложений выдаётся так:

```bash
adb shell pm grant <pluskey.package> android.permission.WRITE_SECURE_SETTINGS
adb shell dumpsys deviceidle whitelist +<pluskey.package>
```

Вторая команда добавляет приложение в белый список режима энергосбережения (Doze) — иначе система усыпит службу и кнопка перестанет срабатывать после долгого простоя.

Службу Accessibility включите вручную: `Настройки → Специальные возможности → Скачанные приложения → PlusKey → Вкл`.

Проверка, что служба реально активна:

```bash
adb shell settings get secure enabled_accessibility_services
```

До включения команда печатает `null`, после — строку вида `<pluskey.package>/<pluskey.package>.ИмяСлужбы` (имя класса зависит от версии приложения).

**Пример распределения жестов** (набор триггеров зависит от версии PlusKey — сверьтесь с документацией):

| Жест на Plus Key | Что назначить | Зачем |
|---|---|---|
| Одиночное нажатие | Запуск приложения ИИ-агента | Быстрый доступ к чату одной рукой |
| Двойное нажатие | Запуск камеры или фонарика | Частая бытовая задача |
| Долгое нажатие | Отправка запроса на локальный ИИ-сервер | Голосовой/текстовый ввод без открытия приложения |

Проверить, что приложение-цель вообще запускается на телефоне, можно так:

```bash
adb shell monkey -p <package.цели> -c android.intent.category.LAUNCHER 1
```

Если после этой команды приложение открылось, значит связка «PlusKey → приложение» тоже сработает.

Для сценария с локальной моделью удобно сначала поднять сам сервер инференса — пошаговая настройка разобрана в гайде [Как ускорить DeepSeek с помощью DeepInfer: установка и настройка инференса](https://ai-release.org/guides/kak-uskorit-deepseek-s-pomoschyu-deepinfer-ustanovka-i.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide). Убедитесь, что эндпоинт отвечает:

```bash
curl -s http://127.0.0.1:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"<имя-модели>","messages":[{"role":"user","content":"тест"}]}'
```

Порт `8080` и имя модели — плейсхолдеры: подставьте те, что указаны в конфиге вашего сервера.

**Как проверить:** нажмите Plus Key один раз — открывается назначенное приложение; нажмите дважды — открывается второе действие. В `adb shell settings get secure enabled_accessibility_services` больше нет `null`.

## Шаг 3. Проверка работы и финальный результат
![Иллюстрация к разделу «Шаг 3. Проверка работы и финальный результат»](https://ai-release.org/guides/img/kak-perenaznachit-knopku-plus-key-na-oneplus-ustanovka-ru-3.jpg?v=1795077849)


**Что сделать:** убедитесь, что нажатия доходят до системы и обрабатываются PlusKey, затем проверьте поведение после перезагрузки.

**Зачем:** самая частая причина «кнопка не работает» — не ошибка настройки, а выгруженная из памяти служба или отозванное разрешение.

Поток событий кнопки:

```bash
adb shell getevent -l
```

Нажмите Plus Key. В терминале появятся строки с `EV_KEY` — это подтверждает, что железо исправно и событие доходит до Android. Точное имя кода клавиши для вашей модели — сверьтесь с документацией. Выход из режима — `Ctrl+C`.

Логи самого приложения:

```bash
adb logcat | grep -i pluskey
```

Успех выглядит как строки о старте службы и об обработанном нажатии, без повторяющихся `Exception` и `ANR`.

Финальная проверка:

```bash
adb reboot
```

После загрузки (30–60 секунд) нажмите Plus Key, не открывая PlusKey вручную. Кнопка должна сработать сразу — это значит, что служба поднимается автоматически.

**Как проверить:** после перезагрузки все три жеста отрабатывают без открытия приложения настроек, а `adb logcat | grep -i pluskey` не содержит ошибок.

## Возможные проблемы и решения

**Проблема. Телефон виден, но ADB отказывается с ним работать**

- Ошибка: `error: device unauthorized. Please check the confirmation dialog on your device.`
- Причина: на телефоне не подтвердили запрос отладки или ранее был сохранён другой ключ RSA.
- Решение: на телефоне `Для разработчиков → Отозвать разрешения на отладку по USB`, затем перезапустите сервер и подтвердите диалог заново:
```bash
adb kill-server && adb start-server && adb devices
```

**Проблема. APK не устанавливается поверх старой версии**

- Ошибка: `Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE: Package <pluskey.package> signatures do not match previously installed version]`
- Причина: на телефоне уже стоит PlusKey, подписанный другим ключом (например, сборка из другого источника).
- Решение: удалите старую версию и поставьте заново:
```bash
adb uninstall <pluskey.package>
adb install -r PlusKey.apk
```

**Проблема. Через несколько часов кнопка перестаёт реагировать**

- Ошибка в логах: `ANR in <pluskey.package>` или служба просто отсутствует в `adb shell settings get secure enabled_accessibility_services` (значение `null`).
- Причина: система выгрузила службу из памяти из-за энергосбережения.
- Решение: добавьте приложение в белый список Doze и отключите для него оптимизацию батареи:
```bash
adb shell dumpsys deviceidle whitelist +<pluskey.package>
```
Затем `Настройки → Батарея → Оптимизация → PlusKey → Не оптимизировать` и перезагрузите телефон.

## Резюме и следующие шаги

PlusKey ставится через `adb install`, получает разрешения и службу Accessibility, после чего на одиночное, двойное и долгое нажатие Plus Key назначаются приложения и сценарии ИИ-агента. Дальше имеет смысл связать кнопку с полноценным агентом, который публикует сборки и отвечает в чатах, — см. [Как автоматизировать публикацию приложений в App Store и Google Play с помощью ИИ-агентов](https://ai-release.org/guides/kak-avtomatizirovat-publikatsiyu-prilozheniy-v-app-stor.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

## FAQ

**Нужен ли root, чтобы переназначить Plus Key?**
Нет. Достаточно установки APK через ADB, разрешения `WRITE_SECURE_SETTINGS` и включённой службы Accessibility.

**Чем Plus Key отличается от Alert Slider?**
Alert Slider — это физический трёхпозиционный переключатель режимов звука; Plus Key — отдельная кнопка, нажатия которой переназначаются приложением. Поддерживаемые модели уточняйте в документации PlusKey.

**Кнопка перестанет работать после обновления прошивки?**
Возможно: обновление может сбросить разрешения или изменить обработку клавиши. После апдейта повторите вызов `adb shell settings get secure enabled_accessibility_services` — если вернулось `null`, включите службу заново.

**Можно ли повесить на кнопку ИИ-чат, как на часах Wear OS?**
Да, если приложение-чат запускается ярлыком. Логика выбора приложений и ограничения платформы разобраны в гайде [Как использовать ИИ-чат на умных часах Wear OS: установка, настройка и лучшие приложения](https://ai-release.org/guides/kak-ispolzovat-ii-chat-na-umnyh-chasah-wear-os-ustanovk.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).
