Устранение неполадок

1Companion не запускается

Самая частая причина — зависший процесс прошлой сессии, который держит файл ключа сопряжения открытым. Companion запускается только в одном экземпляре — если один уже работает (даже без видимого окна), новый запуск тихо завершается.

1. Сначала загляните в системный трей. Посмотрите справа внизу экрана, рядом с часами, есть ли зелёный значок в форме "PC". Если он там, Companion РАБОТАЕТ — просто дважды щёлкните по нему, чтобы вернуть окно.
2. Убейте любой застрявший экземпляр. Нажмите Ctrl+Shift+Esc чтобы открыть диспетчер задач. На Подробности вкладку, найдите процесс, начинающийся с WindowsHelperCompanion. Щелкните правой кнопкой мыши → Завершить задачу. Повторяйте, пока ни один из них не будет указан.
3. Запустите .exe еще раз. Дважды щелкните папку «Загрузки». Через 2-3 секунды появится окно и иконка в трее станет зеленой.
4. Все еще ничего? Проверьте журнал скользящей диагностики по адресу %APPDATA%\WindowsHelper\logs\ — самый последний companion-YYYYMMDD.ndjson файл имеет стартовую запись (или ошибку, которая помешала этому). Откройте Блокнот → Файл → Откройте и вставьте этот путь, чтобы увидеть его.

2Код сопряжения отклонен

Коды сопряжения действительны в течение 10 минут с момента их отображения на телефоне. Если вам потребовалось больше времени для ввода кода или ваш телефон обновил код (на некоторых экранах коды меняются при каждом посещении), код, который видит ваш компьютер, больше не соответствует.

1. Получите новый код со своего телефона. Откройте WindowsHelper на своем телефоне → коснитесь Управление ПК в нижней навигации. Появится новый 8-значный код (или будет показан существующий).
2. Обратите внимание на символы, которые легче всего перепутать. В кодах используются прописные буквы и цифры, но исключаются I, O, 0, and 1 по дизайну. Если вы набрали что-то из этого, значит, вы набрали неправильно.
3. Введите код в окне Companion в течение минуты-двух после того, как увидели его на телефоне.
4. Интернет-проверка. И вашему телефону, и вашему компьютеру необходимо работающее подключение к Интернету (подтверждение соединения происходит через Firestore). Нестабильный домашний Wi-Fi может вызвать тот же симптом — попробуйте отключить и снова включить Wi-Fi на том устройстве, которое слабее.

3Команды не запускаются на моем компьютере

Три распространенные причины: ограничение скорости (10 команд в минуту — это ограничение на обоих концах), предполетная проверка безопасности, в результате которой команда была отклонена перед выполнением, или несоответствие подписи из-за устаревшего ключа сопряжения после повторного сопряжения на стороне телефона.

1. Посмотрите раздел "Команды в реальном времени" в окне Companion — каждая полученная команда записывается туда вместе с результатом. Если там "Предварительная проверка не пройдена" или "Достигнут предел частоты", вот и причина. Подождите 60 секунд, пока окно частоты не очистится.
2. Если компаньон никогда не записывал команду, телефон так и не доставил его. Откройте средство просмотра журналов WindowsHelper Companion (щелкните правой кнопкой мыши значок → на панели задач). Посмотреть журналы...) и проверьте наличие ошибок подключения Firestore в последних записях.
3. Выполните сопряжение заново. Если проверка подписи отклоняет ваши команды, значит, ключи телефона и ПК не синхронизированы. Щелкните правой кнопкой мыши значок на панели задач →. Поменять код сопряжения... на ПК, затем повторно введите новый код на экране управления ПК телефона.
4. Проверьте связь, нажав Проверить соединение на экране PC Control в телефоне. Успешный пинг отвечает за <500 ms и сообщает версию Companion и время работы. Неудача означает, что оборван сам канал — а не ваша команда.

4Телефон говорит: «Компьютер не в сети».

Companion отмечает себя как подключённый всё время, пока работает, а ваш телефон перепроверяет это каждые несколько секунд, пока экран PC Control открыт. Самая частая причина отметки «не в сети» — компьютер спал, Companion был закрыт или на компьютере пропал интернет.

1. Убедитесь, что Companion запущен. Найдите зелёный значок в системном трее ПК. Если его нет, дважды щёлкните .exe в папке «Загрузки», чтобы запустить заново.
2. Разбудите компьютер. Спящий компьютер не может сообщить о себе. Подвигайте мышью, затем оставьте экран PC Control открытым на несколько секунд — отметка сама вернётся к зелёной. Если нет, запустите Companion заново: он сообщает о себе в тот же миг, как стартует.
3. Проверьте интернет на компьютере. Откройте браузер на компьютере и загрузите любой сайт. Если страница не грузится, значит Companion не может достучаться до Firestore — почините сеть, и он снова начнёт сообщать о себе.
4. Откройте экран PC Control заново. Вернитесь назад, затем снова нажмите PC Control, чтобы проверка состояния началась сначала. Если компьютер действительно в сети, отметка обновится за несколько секунд.

5Антивирус поместил файл .exe в карантин.

Автономные файлы .NET .exe являются частым ложным срабатыванием эвристики AV — они объединяют всю среду выполнения .NET + ваш код в один файл, который статистически похож на упаковщики вредоносных программ и механизмы, которые не распознают издателя. Подписание кода устраняет это; мы работаем над этим. Тем временем:

1. Добавьте исключение ПЕРЕД повторной загрузкой. Откройте настройки антивируса (Windows Защитник: Настройки → Конфиденциальность и безопасность → Windows Безопасность → Защита от вирусов и угроз → Управление настройками → Добавление или удаление исключений). Добавьте исключение для:
   • Папка, в которую вы сохраните .exe (например. C:\Users\YourName\Downloads), или
   • Любой файл, начинающийся с WindowsHelperCompanion (например WindowsHelperCompanion-*.exe).
2. Восстановить из карантина, если он уже был удален. Большинство AV-продуктов имеют режим карантина (Защитник: защита от вирусов и угроз → История защиты). Найдите запись, щелкните ее, затем Разрешить или Восстановить.
3. Проверьте SHA-256 вашей загрузки. Если вы повторно загрузили, убедитесь, что хэш соответствует опубликованному на сайте. /companion-version.json:

(Get-FileHash -Algorithm SHA256 (Get-ChildItem ~\Downloads\WindowsHelperCompanion*.exe | Sort-Object LastWriteTime | Select-Object -Last 1)).Hash

4. В крайнем случае: временно попробуйте другой AV-продукт. Некоторые бюджетные антивирусы отмечают почти все; Золотой стандарт Windows Defender, как правило, является наиболее точным. Если ваш AV — единственный, кто это отмечает, скорее всего, это ложное срабатывание.