# Как подключить DeepSeek Harness к Android-смартфону: dsh-go и удалённое управление агентом без облака > AI Release · @ai_release1 · https://ai-release.org/guides/kak-podklyuchit-deepseek-harness-k-android-smartfonu-ds.html ## TL;DR - **Время выполнения:** 30–45 минут (без учёта времени на сборку APK из исходников) - **Уровень сложности:** Intermediate - **Понадобится:** Android-смартфон с включённой отладкой по USB, ПК (Windows/macOS/Linux), ADB в `PATH`, Git, JDK + Android SDK (только если собираете APK сами), API-ключ DeepSeek, локальная сеть или туннель (например, Tailscale) для удалённого режима - **Важно:** dsh-go — неофициальный клиент от стороннего разработчика `ccch1mneyyy`; поддержки со стороны DeepSeek нет. Всё, что касается внутренних экранов и параметров приложения, сверяйте с README репозитория ## Требования и подготовка ![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-podklyuchit-deepseek-harness-k-android-smartfonu-ds-ru-1.jpg?v=1792962137) dsh-go — неофициальный Android-клиент DeepSeek Harness (харнесс — обвязка вокруг модели: инструменты, файлы, команды). Проект лежит по адресу `github.com/ccch1mneyyy/dsh-go` и подписан как «Android · Unofficial». Заявлены два режима: запуск харнесса прямо на телефоне и удалённое управление компьютером. - [ ] Смартфон Android, версия ОС — **сверьтесь с README репозитория** (в описании проекта конкретные версии не указаны) - [ ] Отладка по USB включена: «Настройки» → «О системе» → 7 тапов по «Номер сборки» → «Для разработчиков» → «Отладка по USB» - [ ] ADB установлен на ПК: `adb version` должен вывести версию без ошибки - [ ] Git: `git --version` - [ ] JDK и Android SDK — нужны только при сборке из исходников - [ ] API-ключ DeepSeek из личного кабинета - [ ] Свободно 500 МБ+ на телефоне под APK и данные приложения - [ ] ПК и телефон в одной сети (для удалённого режима) **Пример:** проверка ADB на ПК: ```bash adb version ``` Ожидаемый вывод — строка вида `Android Debug Bridge version 1.0.41` (номер у вас будет свой). Если команда не найдена, ADB не в `PATH` — ставьте platform-tools и добавьте каталог в переменную окружения. Подключение телефона по USB подробно разобрано в гайде [Как подключить Android к Windows через ADB: команды, список устройств и ошибки](https://ai-release.org/guides/kak-podklyuchit-android-k-windows-cherez-adb-komandy-sp.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide). ## Шаг 1. Получить сборку dsh-go и проверить связь ПК ↔ телефон **Что сделать:** склонировать репозиторий, прочитать README, определить способ установки (готовый APK из Releases или сборка из исходников), затем убедиться, что ПК видит телефон. **Зачем:** dsh-go обновляется сторонним автором, поэтому единственный достоверный источник параметров (имя пакета, поддерживаемые версии Android, названия режимов, порты) — README. Клонирование даёт локальную копию и allows проверить наличие Gradle-обёртки. **Как проверить:** команды ниже и их вывод. ```bash git clone https://github.com/ccch1mneyyy/dsh-go.git cd dsh-go ls -la ``` Ожидаемо: `README.md` и каталоги проекта. Если в README указан готовый APK в разделе Releases — скачивайте его и переходите к шагу 2, сборка не нужна. Если APK нет, проверьте наличие `gradlew`: ```bash ls gradlew ``` Если файл есть — собирайте стандартной командой Android-проекта (точную задачу сверьте с README): ```bash ./gradlew assembleDebug ``` Готовый файл по стандартному пути: `app/build/outputs/apk/debug/app-debug.apk`. Далее — связь с телефоном: ```bash adb devices ``` Успех — телефон в списке со статусом `device`: ``` List of devices attached R58M12ABCDE device ``` Если статус `unauthorized`, разблокируйте телефон и нажмите «Разрешить отладку» в системном диалоге. Почему это работает: ADB-демон на телефоне принимает только ПК, которому вы выдали RSA-ключ. ## Шаг 2. Установить приложение и настроить оба режима ![Иллюстрация к разделу «Шаг 2. Установить приложение и настроить оба режима»](https://ai-release.org/guides/img/kak-podklyuchit-deepseek-harness-k-android-smartfonu-ds-ru-2.jpg?v=1792962143) **Что сделать:** установить APK, открыть приложение, ввести API-ключ и выбрать режим работы — локальный (харнесс на телефоне) или удалённое управление ПК. **Зачем:** это ядро сценария. Локальный режим убирает ПК из цепочки — харнесс крутится на самом устройстве. Удалённый режим оставляет вычисления на компьютере, а телефон превращается в пульт. **Как проверить:** приложение запускается без падения, ключ сохранён, выбранный режим отображается как активный. Установка: ```bash adb install -r app/build/outputs/apk/debug/app-debug.apk ``` Ожидаемый вывод: `Performing Streamed Install` и `Success`. Имя пакета для дальнейших команд возьмите из README (**сверьтесь с документацией** — в описании проекта оно не приводится), здесь оно обозначено как ``. Запуск и просмотр логов: ```bash adb shell monkey -p -c android.intent.category.LAUNCHER 1 adb logcat | grep -i dsh ``` | Режим | Что происходит | Что нужно на телефоне | Что нужно на ПК | |---|---|---|---| | Локальный | Харнесс работает на смартфоне | API-ключ DeepSeek, свободное место | Не нужен после установки | | Удалённое управление | Телефон управляет харнессом на компьютере | Сеть до ПК, данные подключения из README | Запущенный харнесс, доступ по сети | **Пример настройки локального режима:** откройте приложение → экран настроек подключения → вставьте ключ вида `sk-...` → сохраните → выберите режим работы на устройстве. Почему это работает: клиент обращается к API модели напрямую с телефона, поэтому ключ хранится в приложении, а не на ПК. **Пример настройки удалённого режима:** включите на ПК сетевой доступ к харнессу, узнайте IP компьютера в локальной сети: ```bash ipconfig ``` В приложении укажите адрес ПК и параметры подключения из README (**сверьтесь с документацией** — порт и протокол в описании проекта не указаны). Если ПК и телефон в разных сетях, поднимите туннель: пошаговая схема с Termux, SSH и беспроводным ADB — в гайде [Как подключить старый Android-смартфон без root к Tailscale: Termux, SSH и беспроводной ADB](https://ai-release.org/guides/kak-podklyuchit-staryy-android-smartfon-bez-root-k-tail.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide). Там же разобрано, зачем нужен SSH-ключ и как проверить туннель до подключения клиента. ## Шаг 3. Проверка работы и финальный результат ![Иллюстрация к разделу «Шаг 3. Проверка работы и финальный результат»](https://ai-release.org/guides/img/kak-podklyuchit-deepseek-harness-k-android-smartfonu-ds-ru-3.jpg?v=1792962151) **Что сделать:** прогнать приёмочный чек-лист в выбранном режиме и убедиться, что команда доходит до модели и возвращает ответ. **Зачем:** установка без проверки не считается выполненной — нужно увидеть, что цепочка «приложение → модель» или «приложение → ПК → модель» живая. **Как проверить:** по пунктам ниже. - [ ] Приложение открывается, не закрывается при старте - [ ] Ключ сохранён: после перезапуска поле не пустое - [ ] Тестовый запрос возвращает текст ответа - [ ] В `adb logcat` нет повторяющихся ошибок авторизации - [ ] (Удалённый режим) ПК виден по сети: `ping ` отвечает ```bash adb logcat -d | grep -iE "401|unauthorized|timeout" ``` Пустой вывод — хороший знак. Строки с `401` означают проблему с ключом (см. раздел ниже). **Пример успеха:** вы отправляете в приложении короткий запрос, через несколько секунд появляется ответ модели, а в логах нет `401`/`timeout`. Для удалённого режима дополнительно видно, что запрос пришёл на ПК — харнесс на компьютере пишет строку обращения в своём логе. ## Возможные проблемы и решения **Проблема. Телефон не виден для ADB** - Ошибка: `adb: no devices/emulators found` - Причина: кабель только для зарядки, выключена отладка по USB или завис ADB-сервер. - Решение: заменить кабель на data-кабель, проверить «Отладка по USB», затем перезапустить сервер: ```bash adb kill-server adb start-server adb devices ``` **Проблема. APK не ставится поверх предыдущей версии** - Ошибка: `Failure [INSTALL_FAILED_UPDATE_INCOMPATIBLE]` - Причина: установленная копия подписана другим ключом (например, вы собрали APK сами, а до этого ставили релизный). - Решение: удалить старую копию и установить заново: ```bash adb uninstall adb install -r app/build/outputs/apk/debug/app-debug.apk ``` **Проблема. Локальный режим не отвечает** - Ошибка: `401 Unauthorized` в `adb logcat` - Причина: ключ не введён, скопирован с пробелом в конце или отозван в кабинете DeepSeek. - Решение: удалить ключ в настройках приложения, вставить заново без пробелов, сохранить и перезапустить приложение. Если в README указан отдельный шаг проверки ключа — выполните его (**сверьтесь с документацией**). ## Резюме и следующие шаги Вы получили рабочую связку: dsh-go установлен, ключ сохранён, выбранный режим проверен по чек-листу. Дальше настройте десктопную часть по гайду [DeepSeek Harness Desktop: как установить и подключить плагины на Windows и Mac](https://ai-release.org/guides/deepseek-harness-desktop-kak-ustanovit-i-podklyuchit-pl.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide) — она нужна для удалённого режима. ## FAQ **dsh-go — официальный клиент DeepSeek?** Нет. Это неофициальный Android-клиент, репозиторий ведёт сторонний разработчик `ccch1mneyyy`, в описании стоит пометка «Android · Unofficial». Поддержки со стороны DeepSeek нет. **Нужен ли root на телефоне?** Для установки APK и работы через ADB root не требуется. Требования самого dsh-go к правам в описании проекта не приведены — сверьтесь с README. **Работает ли удалённое управление без облака?** Управление идёт по вашей сети или через собственный туннель между телефоном и ПК. При этом сам харнесс обращается к модели по API, поэтому доступ в интернет для инференса нужен. Точные сетевые требования — в README. **Какие версии Android поддерживаются?** В описании проекта минимальная версия не указана. Проверьте раздел требований в README репозитория `github.com/ccch1mneyyy/dsh-go` перед установкой.