Pemecahan masalah

1Companion tidak mau berjalan

Penyebab paling umum adalah proses macet dari sesi sebelumnya yang masih membuka berkas kunci penyandingan. Companion hanya berjalan satu instans — jika satu sudah berjalan (bahkan tanpa jendela terlihat), peluncuran baru berhenti diam-diam.

1. Periksa baki sistem lebih dulu. Lihat di kanan bawah layar dekat jam, cari ikon hijau berbentuk "PC". Kalau ada, berarti Companion MEMANG berjalan — cukup klik ganda untuk memunculkan jendelanya kembali.
2. Bunuh semua instance yang macet. Tekan Ctrl+Shift+Esc untuk membuka Pengelola Tugas. Di Detail tab, cari proses yang dimulai dengan WindowsHelperCompanion. Klik kanan → Akhiri tugas. Ulangi sampai tidak ada yang terdaftar.
3. Jalankan .exe lagi. Klik dua kali dari folder Unduhan Anda. Dalam 2-3 detik jendela muncul dan ikon baki berubah menjadi hijau.
4. Masih tidak ada apa-apa? Periksa log diagnostik bergulir di %APPDATA%\WindowsHelper\logs\ — yang terbaru companion-YYYYMMDD.ndjson file memiliki catatan permulaan (atau kesalahan yang mencegahnya). Buka Notepad → File → Buka dan tempel jalur tersebut untuk melihatnya.

2Kode penyandingan ditolak

Kode penyandingan berlaku selama 10 menit sejak ponsel Anda menunjukkannya. Jika Anda membutuhkan waktu lebih lama untuk mengetik, atau ponsel Anda menyegarkan kode (beberapa layar memutar kode pada setiap kunjungan), kode yang dilihat PC Anda tidak lagi cocok.

1. Dapatkan kode baru dari ponsel Anda. Buka WindowsHelper di ponsel Anda → ketuk Kontrol PC di navigasi bawah. Kode 8 karakter baru muncul (atau kode yang sudah ada ditampilkan).
2. Perhatikan karakter yang paling mudah tertukar. Kode menggunakan huruf besar dan angka — tetapi tidak termasuk I, O, 0, and 1 berdasarkan desain. Jika Anda mengetik salah satunya, Anda salah mengetik.
3. Ketik kode di jendela Companion dalam satu atau dua menit setelah melihatnya di ponsel.
4. Pemeriksaan internet. Ponsel dan PC Anda memerlukan koneksi internet yang berfungsi (jabat tangan penyandingan dilakukan melalui Firestore). WiFi rumah yang tidak stabil dapat menyebabkan gejala yang sama — coba nonaktifkan dan aktifkan kembali WiFi di perangkat mana pun yang lebih lemah.

3Perintah tidak berjalan di PC saya

Tiga penyebab umum: batas kecepatan (10 perintah per menit adalah batasan pada kedua ujungnya), pemeriksaan keselamatan sebelum penerbangan yang menolak perintah sebelum eksekusi, atau ketidakcocokan tanda tangan dari kunci penyandingan yang sudah usang setelah penyandingan ulang di sisi telepon.

1. Periksa bagian "Perintah langsung" di jendela Companion — setiap perintah yang diterima dicatat di sana beserta hasilnya. Jika tertulis "Pemeriksaan awal gagal" atau "Batas laju tercapai", itulah penyebabnya. Tunggu 60 detik sampai jendela laju kosong lagi.
2. Jika rekannya tidak pernah mencatat perintah tersebut, telepon tidak pernah mengirimkannya. Buka penampil log WindowsHelper Companion (ikon baki klik kanan → Lihat log...) dan periksa kesalahan koneksi Firestore di entri terbaru.
3. Sandingkan ulang. Jika verifikasi tanda tangan menolak perintah Anda, tombol telepon dan PC tidak sinkron. Klik kanan ikon baki → Putar kode penyandingan... di PC, lalu masukkan kembali kode baru di layar Kontrol PC ponsel.
4. Uji konektivitas dengan mengetuk Uji koneksi di layar PC Control ponsel. Ping yang berhasil membalas dalam <500 ms dengan versi Companion dan lama berjalan. Kegagalan berarti jalurnya sendiri putus — bukan perintah Anda.

4Telepon mengatakan "PC offline"

Companion menandai dirinya sebagai terhubung selama ia berjalan, dan ponsel Anda memeriksanya ulang setiap beberapa detik selama layar PC Control terbuka. Penyebab paling umum lencana offline adalah PC sedang tidur, Companion ditutup, atau internet PC putus.

1. Pastikan Companion sedang berjalan. Cari ikon hijau di baki sistem PC Anda. Jika tidak ada, klik ganda berkas .exe di folder Unduhan untuk menjalankannya lagi.
2. Bangunkan PC. PC yang tidur tidak bisa melapor. Gerakkan mouse, lalu biarkan layar PC Control terbuka beberapa detik — lencana kembali hijau dengan sendirinya. Jika tidak, jalankan ulang Companion: ia melapor begitu mulai berjalan.
3. Periksa internet PC. Buka peramban di PC dan muat situs web apa pun. Halaman yang gagal dimuat berarti Companion tidak dapat menjangkau Firestore — perbaiki jaringan, lalu ia akan melapor lagi.
4. Buka kembali layar PC Control. Kembali ke belakang, lalu ketuk PC Control lagi untuk memulai ulang pemeriksaan status. Jika PC benar-benar online, lencana diperbarui dalam beberapa detik.

5Antivirus mengkarantina .exe

.NET .exe yang berdiri sendiri merupakan kesalahan positif yang umum untuk heuristik AV — .NET menggabungkan keseluruhan runtime .NET + kode Anda ke dalam satu file, yang secara statistik mirip dengan pengemas malware hingga mesin yang tidak mengenali penerbitnya. Penandatanganan kode menghilangkan hal ini; kami sedang mengerjakannya. Sementara itu:

1. Tambahkan pengecualian SEBELUM mengunduh ulang. Buka setelan antivirus Anda (Windows Pembela: Setelan → Privasi & Keamanan → Windows Keamanan → Perlindungan virus & ancaman → Kelola setelan → Tambahkan atau hapus pengecualian). Tambahkan pengecualian untuk:
   • Folder tempat Anda menyimpan .exe (mis. C:\Users\YourName\Downloads), atau
   • File apa pun yang dimulai dengan WindowsHelperCompanion (mis. WindowsHelperCompanion-*.exe).
2. Pulihkan dari karantina jika sudah dihapus. Sebagian besar produk AV memiliki tampilan karantina (Pembela: Perlindungan virus & ancaman → Riwayat perlindungan). Temukan entri tersebut, klik entri tersebut, lalu Izinkan atau Pulihkan.
3. Verifikasi SHA-256 unduhan Anda. Jika Anda mengunduh ulang, pastikan hashnya cocok dengan yang dipublikasikan /companion-version.json:

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

4. Pilihan terakhir: coba produk AV lain untuk sementara. Beberapa AV murah menandai hampir semua hal; Windows Defender standar emas umumnya paling akurat. Jika hanya AV Anda yang menandai hal ini, kemungkinan besar hasilnya adalah positif palsu.