Pag-troubleshoot

1Hindi magsisimula ang kasama

Ang pinakakaraniwang dahilan ay ang natigil na proseso ng nakaraang session habang nakabukas ang pairing-key file. Ang kasama ay single-instance — kapag ang isa ay tumatakbo na (kahit na walang nakikitang window) ang bagong launch ay tahimik na lalabas.

1. Suriin muna ang system tray. Tumingin sa kanang ibaba ng iyong screen malapit sa orasan para sa isang berdeng icon na hugis "PC". Kung nandoon, tumatakbo ang kasama — i-double click lang ito upang ibalik ang window.
2. Patayin ang anumang naipit na pagkakataon. Pindutin Ctrl+Paglipat+Esc para buksan ang Task Manager. sa Mga Detalye tab, hanapin WindowsHelperCompanion.exe. 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 kasama-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 5 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. Panoorin ang pinaka-madaling malito na mga character. 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 isang minuto o dalawa ng makita ito sa iyong 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. Suriin ang "Mga live na utos" seksyon sa kasamang window — ang bawat natanggap na utos ay naka-log doon kasama ang resulta nito. Kung ito ay nagpapakita ng "Nabigo ang pre-check" o "Naabot na ang limitasyon sa rate", iyon ang iyong dahilan. Maghintay ng 60 segundo para maalis ang rate ng 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. Re-pair. 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 → Bagong Pairing Code sa PC, pagkatapos ay muling ilagay ang bagong code sa screen ng PC Control ng telepono.
4. Subukan ang pagkakakonekta sa pamamagitan ng pag-tap Subukan ang koneksyon sa PC Control screen ng telepono. Isang matagumpay na ping ang tumugon sa <500 ms na may kasamang bersyon + uptime. Ang ibig sabihin ng pagkabigo ay ang wire mismo ay sira — hindi ang iyong utos.

4Ang sabi ng telepono ay "PC offline"

Ang kasama ay nagsusulat ng isang tibok ng puso sa Firestore bawat 30 segundo. Isinasaalang-alang ng telepono ang PC na offline kung ang pinakahuling tibok ng puso ay mas matanda sa ~90 segundo. Ang pinakakaraniwang dahilan ay ang PC ay natutulog, ang kasama ay lumabas, o ang internet ng PC ay nawala.

1. Kumpirmahin na tumatakbo ang kasama. Tingnan ang system tray ng iyong PC para sa berdeng icon. Kung nawawala ito, i-double click ang .exe sa iyong folder ng Mga Download upang muling ilunsad.
2. Gisingin ang PC. Kung natutulog ang iyong PC, hihinto ang tibok ng puso hanggang sa magising ito. Igalaw ang mouse, pagkatapos ay maghintay ng 30-60 segundo para dumating ang susunod na tibok ng puso — awtomatikong bumabalik sa berde ang tableta ng telepono.
3. Suriin ang internet ng PC. Magbukas ng browser sa PC at mag-load ng anumang website. Ang isang nabigong pag-load ng pahina ay nangangahulugan na ang tibok ng puso ay hindi makakarating sa Firestore — ayusin ang network, pagkatapos ay magpapatuloy ang tibok ng puso.
4. I-tap ang I-refresh sa telepono. Pull-to-refresh sa PC Control screen ay pinipilit ang panibagong pagsusuri sa heartbeat doc. Kung talagang online ang PC, nag-a-update kaagad ang tableta.

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
   • Ang tiyak na filename 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 ~\Downloads\WindowsHelperCompanion.exe).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.