문제 해결
WindowsHelper Companion의 가장 일반적인 5가지 문제(각각 단계별 해결 방법 포함) 대부분의 문제는 이 페이지를 떠나지 않고도 1분 안에 해결할 수 있습니다.
1Companion이 실행되지 않음
다운로드한 파일(WindowsHelperCompanion-….exe) 아무 일도 일어나지 않습니다. 창도 없고, 트레이 아이콘도 없고, 오류도 없습니다.
가장 흔한 원인은 페어링 키 파일을 계속 열어 둔 이전 세션의 멈춘 프로세스입니다. Companion은 중복 실행이 되지 않습니다 — 이미 하나가 실행 중이면(창이 보이지 않더라도) 새로 실행한 쪽이 조용히 종료됩니다.
- 먼저 시스템 트레이를 확인하세요. 화면 오른쪽 아래, 시계 근처에 초록색 "PC" 모양 아이콘이 있는지 보세요. 있다면 Companion은 실행 중입니다 — 더블클릭하면 창이 다시 나타납니다.
- 멈춰 있는 인스턴스를 모두 종료합니다.
Ctrl+Shift+Esc를 눌러 작업 관리자를 엽니다. 에 세부정보 탭에서 다음으로 시작하는 프로세스를 찾으세요.WindowsHelperCompanion. → 작업 종료를 마우스 오른쪽 버튼으로 클릭합니다. 아무것도 나열되지 않을 때까지 반복합니다. - .exe를 다시 실행하십시오. 다운로드 폴더를 두 번 클릭합니다. 2~3초 내에 창이 나타나고 트레이 아이콘이 녹색으로 변합니다.
- 아직도 아무것도 없나요? 롤링 진단 로그를 확인하세요.
%APPDATA%\WindowsHelper\logs\— 가장 최근의companion-YYYYMMDD.ndjson파일에 시작 기록(또는 기록을 방해하는 오류)이 있습니다. 메모장 열기 → 파일 → 해당 경로를 열고 붙여넣어 확인하세요.
2페어링 코드가 거부되었습니다.
휴대폰의 8자리 코드를 Companion 창에 입력하고 연결을 클릭하면 "연결 실패"가 표시되거나 코드가 받아들여지지 않습니다.
페어링 코드는 휴대폰에 표시된 후 10분 동안 유효합니다. 입력하는 데 시간이 오래 걸리거나 휴대폰에서 코드를 새로 고친 경우(일부 화면에서는 방문할 때마다 코드가 교체됨) PC에 표시되는 코드가 더 이상 일치하지 않습니다.
- 휴대전화에서 새로운 코드를 받으세요. 휴대전화에서 WindowsHelper을(를) 열고 → 탭하세요. PC 제어 하단 탐색에서. 새로운 8자리 코드가 나타납니다(또는 기존 코드가 표시됩니다).
-
가장 혼동하기 쉬운 문자에 주의하세요.
코드는 대문자와 숫자를 사용하지만 제외됩니다.
I,O,0, and1디자인 상. 그 중 하나라도 입력했다면 잘못 입력한 것입니다. - 휴대폰에서 코드를 본 뒤 1~2분 안에 Companion 창에 코드를 입력하세요.
- 인터넷 확인. 휴대폰과 PC 모두 작동하는 인터넷 연결이 필요합니다(페어링 핸드셰이크는 Firestore를 통과함). 불안정한 가정용 WiFi는 동일한 증상을 유발할 수 있습니다. 약한 장치에서 WiFi를 비활성화했다가 다시 활성화해 보십시오.
3내 PC에서 명령이 실행되지 않습니다.
휴대폰은 명령을 보냈다고 표시하고, Companion도 연결됨으로 표시됩니다. 그런데 실제로는 아무것도 실행되지 않습니다 — 터미널이 잠깐도 뜨지 않고, 휴대폰에도 결과가 없습니다.
세 가지 일반적인 원인: 속도 제한(분당 10개의 명령이 양쪽 끝의 한도임), 실행 전 명령을 거부한 비행 전 안전 확인, 휴대폰 측 다시 페어링 후 오래된 페어링 키로 인한 서명 불일치.
- Companion 창의 "실시간 명령" 섹션을 확인하세요 — 수신된 모든 명령이 결과와 함께 거기에 기록됩니다. "사전 점검 실패" 또는 "요청 한도 도달"이 표시되면 그것이 원인입니다. 한도 창이 비워질 때까지 60초 기다리세요.
- 동반자가 명령을 기록하지 않은 경우 전화가 배달되지 않았습니다. WindowsHelper Companion 로그 뷰어를 엽니다(트레이 아이콘 →을 마우스 오른쪽 버튼으로 클릭) 로그 보기...) 최신 항목에서 Firestore 연결 오류를 확인하세요.
- 다시 페어링하세요. 서명 확인이 명령을 거부하는 경우 휴대폰과 PC 키가 동기화되지 않은 것입니다. 트레이 아이콘 →을 마우스 오른쪽 버튼으로 클릭하세요. 페어링 코드 순환... 그런 다음 휴대폰의 PC 제어 화면에 새 코드를 다시 입력하세요.
- 휴대폰 PC Control 화면에서 연결 테스트를 눌러 연결 상태를 확인하세요. 핑이 성공하면 <500 ms 안에 Companion 버전과 실행 시간이 함께 돌아옵니다. 실패한다면 명령이 아니라 연결 자체가 끊겼다는 뜻입니다.
4휴대전화에 'PC 오프라인'이라고 표시됨
휴대폰의 PC Control 화면에 초록색 "연결됨" 배지 대신 회색 또는 빨간색 "PC 오프라인" 배지가 표시됩니다.
Companion은 실행 중인 동안 스스로를 연결됨으로 표시하고, PC Control 화면이 열려 있는 동안 휴대폰이 몇 초마다 그것을 다시 확인합니다. 오프라인 배지가 뜨는 가장 흔한 원인은 PC가 절전 상태였거나, Companion이 종료되었거나, PC의 인터넷이 끊긴 경우입니다.
- Companion이 실행 중인지 확인하세요. PC의 시스템 트레이에서 초록색 아이콘을 찾아보세요. 없다면 다운로드 폴더의 .exe 파일을 두 번 클릭해 다시 실행하세요.
- PC를 깨우세요. 절전 상태의 PC는 자신의 상태를 알릴 수 없습니다. 마우스를 움직인 다음 PC Control 화면을 몇 초간 열어 두세요. 배지가 저절로 다시 초록색으로 바뀝니다. 바뀌지 않으면 Companion을 다시 실행하세요. 실행되는 순간 상태를 알립니다.
- PC의 인터넷을 확인하세요. PC에서 브라우저를 열고 아무 웹사이트나 불러오세요. 페이지가 열리지 않으면 Companion이 Firestore에 도달하지 못한다는 뜻입니다. 네트워크를 고치면 다시 상태를 알립니다.
- PC Control 화면을 다시 여세요. 뒤로 나갔다가 PC Control을 다시 탭하면 상태 확인이 처음부터 다시 시작됩니다. PC가 실제로 온라인이라면 배지는 몇 초 안에 갱신됩니다.
5바이러스 백신이 .exe를 격리했습니다.
.exe 파일은 실행 직후 다운로드 폴더에서 사라집니다. 바이러스 백신에 다음과 같은 알림이 표시됩니다. "위협이 제거되었습니다." 또는 "트로이 목마:Win32/Wacatac".
자체 포함된 .NET .exe는 AV 휴리스틱에 대한 일반적인 오탐입니다. 전체 .NET 런타임과 코드를 하나의 파일로 묶습니다. 이는 게시자를 인식하지 못하는 엔진에 대한 맬웨어 패커와 통계적으로 유사해 보입니다. 코드 서명을 사용하면 이 문제가 해결됩니다. 우리는 그것을 위해 노력하고 있습니다. 그동안:
-
다시 다운로드하기 전에 제외를 추가하세요.
바이러스 백신 설정을 엽니다(Windows Defender: 설정 → 개인정보 보호 및 보안 → Windows 보안 → 바이러스 및 위협 방지 → 설정 관리 → 제외 추가 또는 제거). 다음 중 하나에 대한 제외를 추가하세요.
- .exe를 저장할 폴더(예:
C:\Users\YourName\Downloads) 또는 - 다음으로 시작하는 모든 파일
WindowsHelperCompanion(예:WindowsHelperCompanion-*.exe).
- .exe를 저장할 폴더(예:
- 이미 제거된 경우 격리에서 복원합니다. 대부분의 AV 제품에는 격리 보기(Defender: 바이러스 및 위협 방지 → 보호 기록)가 있습니다. 항목을 찾아서 클릭한 다음 허용 또는 복원.
- 다운로드한 SHA-256을 확인하세요. 다시 다운로드한 경우 해시가 게시된 해시와 일치하는지 확인하세요. /companion-version.json:
(Get-FileHash -Algorithm SHA256 (Get-ChildItem ~\Downloads\WindowsHelperCompanion*.exe | Sort-Object LastWriteTime | Select-Object -Last 1)).Hash
- 최후의 수단: 일시적으로 다른 AV 제품을 사용해 보십시오. 일부 특가 AV는 거의 모든 것에 플래그를 지정합니다. 표준적인 Windows Defender가 일반적으로 가장 정확합니다. 귀하의 AV가 이를 표시하는 유일한 장치라면 이는 오탐일 가능성이 매우 높습니다.
아직도 붙어있나요?
위 단계로 문제가 해결되지 않았다면 %APPDATA%\WindowsHelper\logs\ 폴더에 있는 진단 로그 파일을 보내 주세요. 모든 이메일을 읽으며 24시간 이내에 답변하려고 노력합니다.
가장 최근의 것을 포함하여 companion-YYYYMMDD.ndjson 파일을 사용하면 무엇이 잘못되었는지 알아내는 속도가 10배 더 빨라집니다.