Отстраняване на неизправности

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 на телефона си → докоснете PC контрол в долната навигация. Появява се нов 8-знаков код (или се показва съществуващият).
2. Внимавайте за знаците, които най-лесно се бъркат. Кодовете използват главни букви и цифри - но изключват I, O, 0, and 1 по дизайн. Ако сте въвели някое от тях, значи сте въвели грешно.
3. Въведете кода в прозореца на Companion в рамките на минута-две, след като го видите на телефона.
4. Проверка в Интернет. И телефонът, и компютърът ви се нуждаят от работеща интернет връзка (ръкостискането за сдвояване минава през Firestore). Нестабилният домашен WiFi може да причини същия симптом — опитайте да деактивирате и активирате отново WiFi на всяко устройство, което е по-слабо.

3Командите не се изпълняват на моя компютър

Три често срещани причини: ограничение на скоростта (10 команди в минута е ограничението от двата края), проверка за безопасност преди полет, която отказва командата преди изпълнението, или несъответствие на подпис от остарял ключ за сдвояване след повторно сдвояване от страна на телефона.

1. Прегледайте раздела "Команди на живо" в прозореца на Companion — всяка получена команда се записва там заедно с резултата ѝ. Ако показва "Предварителната проверка се провали" или "Достигнат е лимитът на честота", това е причината. Изчакайте 60 секунди, докато прозорецът на честотата се изчисти.
2. Ако придружителят никога не е регистрирал командата, телефонът никога не го доставя. Отворете инструмента за преглед на регистрационни файлове WindowsHelper Companion (щракнете с десния бутон върху иконата в областта → Преглед на регистрационните файлове...) и проверете за грешки във връзката с Firestore в най-новите записи.
3. Сдвоете отново. Ако проверката на подписа отхвърля вашите команди, ключовете на телефона и компютъра не са синхронизирани. Щракнете с десния бутон върху иконата в областта → Завъртане на кода за сдвояване... на компютъра, след което въведете отново новия код на екрана за управление на компютъра на телефона.
4. Тествайте връзката, като докоснете Тест на връзката в екрана PC Control на телефона. Успешният пинг отговаря за <500 ms с версията на Companion и времето на работа. Неуспехът означава, че самата връзка е прекъсната — не командата ви.

4Телефонът казва „PC офлайн“

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 продукти имат карантинен изглед (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 е единственият, който отбелязва това, много вероятно е фалшиво положително.