Усунення несправностей

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 є звичайним хибно-позитивним результатом для антивірусної евристики — вони об’єднують усе середовище виконання .NET і ваш код в один файл, який статистично схожий на пакувальники зловмисного програмного забезпечення для механізмів, які не розпізнають видавця. Підписання коду усуває це; ми працюємо над цим. Тим часом:

1. Додайте виключення ПЕРЕД повторним завантаженням. Відкрийте налаштування антивірусної програми (Windows Захисник: Налаштування → Конфіденційність і безпека → Windows Безпека → Захист від вірусів і загроз → Керувати налаштуваннями → Додати або видалити виключення). Додайте виключення для:
   • Папка, у яку ви збережете .exe (наприклад, C:\Users\YourName\Downloads), або
   • Будь-який файл, що починається з WindowsHelperCompanion (наприклад, WindowsHelperCompanion-*.exe).
2. Відновити з карантину, якщо його вже було видалено. Більшість антивірусних продуктів мають перегляд карантину (Defender: захист від вірусів і загроз → Історія захисту). Знайдіть запис, натисніть його, а потім Дозволити або Відновити.
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-продукт. Деякі AV-пристрої для вигідних умов відзначають майже все; золотий стандарт Windows Defender, як правило, є найточнішим. Якщо ваш AV є єдиним, хто позначає це, дуже ймовірно, що це помилковий результат.