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

1Компаньйон не заводиться

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

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

2Код сполучення відхилено

Коди сполучення дійсні протягом 5 хвилин з моменту їх показу на телефоні. Якщо ви вводили більше часу або ваш телефон оновлював код (на деяких екранах коди змінюються під час кожного відвідування), код, який бачить ваш ПК, більше не збігається.

1. Отримайте новий код зі свого телефону. Відкрийте WindowsHelper на телефоні → торкніться Керування ПК у нижній панелі навігації. З'являється новий 8-символьний код (або відображається існуючий).
2. Слідкуйте за символами, які найлегше заплутати. У кодах використовуються великі літери та цифри, але без них I, O, 0, and 1 за проектом. Якщо ви ввели щось із цього, ви ввели неправильно.
3. Введіть код у супровідному вікні протягом однієї-двох хвилин після того, як побачите його на своєму телефоні.
4. Інтернет перевірка. Вашому телефону та комп’ютеру потрібне робоче підключення до Інтернету (рукостискання пари відбувається через Firestore). Нестабільний домашній Wi-Fi може викликати той самий симптом — спробуйте вимкнути та знову ввімкнути Wi-Fi на тому пристрої, який слабший.

3Команди не виконуються на моєму ПК

Три поширені причини: обмеження швидкості (10 команд на хвилину є обмеженням з обох сторін), перевірка безпеки перед польотом, яка відхилила команду перед виконанням, або невідповідність підпису застарілого ключа сполучення після повторного з’єднання на стороні телефону.

1. Перевірте "Живі команди" у супровідному вікні — кожна отримана команда записується туди з результатом. Якщо відображається "Попередня перевірка не вдалася" або "Досягнуто обмеження швидкості", це ваша причина. Зачекайте 60 секунд, доки вікно курсу очиститься.
2. Якщо компаньйон ніколи не реєстрував команду, телефон так і не доставив. Відкрийте засіб перегляду журналів WindowsHelper Companion (клацніть правою кнопкою миші значок → Переглянути журнали...) і перевірте наявність помилок підключення Firestore в останніх записах.
3. Повторна пара. Якщо перевірка підпису відхиляє ваші команди, ключі телефону та ПК не синхронізовані. Клацніть правою кнопкою миші значок → Новий код сполучення на ПК, потім повторно введіть новий код на екрані керування ПК телефону.
4. Перевірте підключення постукуванням Тестове підключення на екрані керування ПК телефону. Успішний ping відповідає через <500 мс із супутньою версією + час безвідмовної роботи. Помилка означає, що сам дріт зламаний, а не ваша команда.

4На телефоні написано "ПК офлайн"

Компаньйон кожні 30 секунд пише серцебиття у Firestore. Телефон вважає ПК офлайн, якщо останнє серцебиття старше ~90 секунд. Найпоширенішою причиною є те, що комп’ютер перебував у режимі сну, компаньйон вийшов з комп’ютера або з’явився Інтернет на комп’ютері.

1. Переконайтеся, що компаньйон працює. Подивіться на зелену піктограму на системній панелі комп’ютера. Якщо його немає, двічі клацніть файл .exe у папці завантажень, щоб перезапустити його.
2. Розбудіть ПК. Якщо ваш комп’ютер перебував у режимі сну, серцебиття припиняється, доки він не прокинеться. Перемістіть мишу, а потім зачекайте 30-60 секунд, поки не пролунає наступний серцевий удар — таблетка телефону автоматично повернеться до зеленого кольору.
3. Перевірте Інтернет на ПК. Відкрийте на ПК браузер і завантажте будь-який сайт. Невдале завантаження сторінки означає, що серцебиття не може досягти Firestore — виправте мережу, тоді серцебиття відновиться.
4. Натисніть «Оновити» на телефоні. Pull to refresh на екрані керування ПК примусово повторно перевіряє документ пульсу. Якщо комп’ютер справді підключений до Інтернету, програма негайно оновлюється.

5Антивірус помістив .exe на карантин

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

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

(Get-FileHash -Algorithm SHA256 ~\Downloads\WindowsHelperCompanion.exe).Hash

4. Крайній засіб: тимчасово спробуйте інший AV-продукт. Деякі AV-пристрої для вигідних умов відзначають майже все; золотий стандарт Windows Defender, як правило, є найточнішим. Якщо ваш AV є єдиним, хто позначає це, дуже ймовірно, що це помилковий результат.