Pag-troubleshoot

1Hindi nagsisimula ang Companion

Ang pinakakaraniwang dahilan ay isang na-stuck na proseso mula sa nakaraang session na hawak pa ang pairing-key file. Isang instance lang ang pinapayagan ng Companion — kung may tumatakbo na (kahit walang nakikitang window), tahimik na nagsasara ang bagong paglulunsad.

1. Tingnan muna ang system tray. Tingnan ang kanang ibaba ng screen malapit sa orasan para sa berdeng icon na hugis "PC". Kung nandoon ito, TUMATAKBO ang Companion — i-double-click lang para bumalik ang window.
2. Patayin ang anumang naipit na pagkakataon. Pindutin Ctrl+Shift+Esc para buksan ang Task Manager. sa Mga Detalye tab, maghanap ng isang proseso na nagsisimula sa WindowsHelperCompanion. I-right-click ang → Tapusin ang gawain. Ulitin hanggang walang nakalista.
3. Patakbuhin muli ang .exe. I-double click mula sa iyong folder ng Mga Download. Sa loob ng 2-3 segundo lalabas ang window at magiging berde ang tray icon.
4. Wala pa rin? Suriin ang rolling diagnostic log sa %APPDATA%\WindowsHelper\logs\ — ang pinakabago companion-YYYYMMDD.ndjson Ang file ay may start-up record (o ang error na pumigil sa isa). Buksan ang Notepad → File → Buksan at i-paste ang path na iyon upang makita ito.

2Ang code ng pagpapares ay tinanggihan

Ang mga code ng pagpapares ay may bisa sa loob ng 10 minuto mula nang ipakita ng iyong telepono ang mga ito. Kung mas matagal kang mag-type, o na-refresh ng iyong telepono ang code (nag-iikot ang ilang mga screen ng mga code sa bawat pagbisita), hindi na tumutugma ang code na nakikita ng iyong PC.

1. Kumuha ng bagong code mula sa iyong telepono. Buksan ang WindowsHelper sa iyong telepono → i-tap Kontrol ng PC sa ibabang nabigasyon. May lalabas na bagong 8-character na code (o ipinapakita ang umiiral na code).
2. Bantayan ang mga character na pinakamadaling mapagkamalan. Gumagamit ang mga code ng malalaking titik at digit — ngunit hindi kasama I, O, 0, and 1 sa pamamagitan ng disenyo. Kung nai-type mo ang alinman sa mga iyon, mali ang pag-type mo.
3. I-type ang code sa Companion window sa loob ng isa o dalawang minuto matapos mo itong makita sa telepono.
4. Pagsusuri sa Internet. Parehong kailangan ng iyong telepono at PC mo ng gumaganang koneksyon sa internet (ang pagpapares ng handshake ay dumadaan sa Firestore). Ang isang patumpik-tumpik na WiFi sa bahay ay maaaring magdulot ng parehong sintomas — subukang i-disable at muling i-enable ang WiFi sa alinmang device na mas mahina.

3Ang mga utos ay hindi tumatakbo sa aking PC

Tatlong karaniwang dahilan: limitasyon sa rate (10 utos bawat minuto ang takip sa magkabilang dulo), isang pagsusuri sa kaligtasan bago ang paglipad na tumanggi sa utos bago isagawa, o isang hindi pagkakatugma ng lagda mula sa isang lipas na key ng pagpapares pagkatapos ng muling pagpares sa gilid ng telepono.

1. Tingnan ang seksyong "Live commands" sa Companion window — bawat natanggap na utos ay nakalog doon kasama ang resulta nito. Kung lumalabas ang "Pre-check failed" o "Rate limit reached", iyon ang dahilan. Maghintay ng 60 segundo para ma-clear ang rate window.
2. Kung ang kasama ay hindi kailanman naka-log sa utos, hindi ito naihatid ng telepono. Buksan ang WindowsHelper Companion log viewer (right-click tray icon → Tingnan ang mga log...) at tingnan ang mga error sa koneksyon sa Firestore sa mga pinakabagong entry.
3. Muling ipares. Kung tinatanggihan ng signature verification ang iyong mga command, hindi naka-sync ang mga key ng telepono at PC. I-right-click ang icon ng tray → I-rotate ang code ng pagpapares... sa PC, pagkatapos ay muling ilagay ang bagong code sa screen ng PC Control ng telepono.
4. Subukan ang koneksyon sa pamamagitan ng pag-tap sa Test connection sa PC Control screen ng telepono. Ang matagumpay na ping ay sumasagot sa loob ng <500 ms kasama ang bersyon ng Companion at ang uptime. Ang pagkabigo ay nangangahulugang sira ang mismong koneksyon — hindi ang utos mo.

4Ang sabi ng telepono ay "PC offline"

Minamarkahan ng Companion ang sarili nito bilang nakakonekta habang tumatakbo ito, at sinusuri iyon muli ng iyong telepono kada ilang segundo habang bukas ang PC Control screen. Ang pinakakaraniwang dahilan ng offline na badge ay natutulog ang PC, isinara ang Companion, o nawala ang internet ng PC.

1. Tiyaking tumatakbo ang Companion. Hanapin ang berdeng icon sa system tray ng PC mo. Kung wala, i-double-click ang .exe sa Downloads folder mo para muling ilunsad.
2. Gisingin ang PC. Hindi makapag-ulat ang natutulog na PC. Igalaw ang mouse, pagkatapos ay iwang bukas ang PC Control screen nang ilang segundo — kusang babalik sa berde ang badge. Kung hindi, muling ilunsad ang Companion: nag-uulat ito sa mismong sandaling magsimula.
3. Suriin ang internet ng PC. Magbukas ng browser sa PC at mag-load ng kahit anong website. Ang hindi pag-load ng pahina ay nangangahulugang hindi maabot ng Companion ang Firestore — ayusin ang network, at mag-uulat itong muli.
4. Buksang muli ang PC Control screen. Bumalik, pagkatapos ay i-tap muli ang PC Control para simulan muli ang pagsusuri ng status. Kung talagang online ang PC, mag-a-update ang badge sa loob ng ilang segundo.

5Na-quarantine ng antivirus ang .exe

Ang mga self-contained .NET .exes ay isang karaniwang false-positive para sa AV heuristics — binu-bundle nila ang buong .NET runtime + iyong code sa isang file, na mukhang istatistikal na katulad ng mga malware packer sa mga engine na hindi nakikilala ang publisher. Tinatanggal ito ng code-signing; ginagawa namin ito. Samantala:

1. Magdagdag ng pagbubukod BAGO muling i-download. Buksan ang iyong mga setting ng antivirus (Windows Defender: Mga Setting → Privacy at Seguridad → Windows Seguridad → Proteksyon sa virus at pagbabanta → Pamahalaan ang mga setting → Magdagdag o mag-alis ng mga pagbubukod). Magdagdag ng pagbubukod para sa alinman sa:
   • Ang folder kung saan mo ise-save ang .exe (hal. C:\Users\YourName\Downloads), o
   • Anumang file na nagsisimula sa WindowsHelperCompanion (hal. WindowsHelperCompanion-*.exe).
2. Ibalik mula sa quarantine kung naalis na ito. Karamihan sa mga produkto ng AV ay may quarantine view (Defender: Virus at proteksyon sa pagbabanta → History ng proteksyon). Hanapin ang entry, i-click ito, pagkatapos Payagan o Ibalik.
3. I-verify ang SHA-256 ng iyong pag-download. Kung muling na-download mo, kumpirmahin na ang hash ay tumutugma sa na-publish sa /companion-version.json:

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

4. Huling paraan: pansamantalang sumubok ng ibang produkto ng AV. Ang ilang mga bargain-bin AV ay nag-flag ng halos lahat; ang gold-standard na Windows Defender sa pangkalahatan ang pinakatumpak. Kung ang iyong AV lang ang nag-flag nito, malamang na false positive ito.