타겟 PC에서 텍스트가 누락/깨질 때 체크리스트

Home · Docs · Text Flush · File Flush

증상은 다양하지만, 원인은 보통 포커스, 타이핑 속도(타이밍), IME/입력기, 앱 자동기능 4개 축으로 수렴합니다. 아래 순서대로 체크하면 빠르게 원인을 분리할 수 있습니다.

0) 먼저 “전송 문제 vs 입력 문제” 분리

전송 문제(웹→BLE): 연결 끊김/재전송/진행률 멈춤
입력 문제(USB HID→Target PC): 전송은 끝났는데 결과 텍스트가 누락/깨짐

대부분은 “입력 문제”입니다.

1) 포커스/환경 체크 (가장 흔함)

Start 직전에 Target PC의 입력 위치(커서)를 다시 확인
실행 중 마우스/키보드를 건드리지 않기
알림/팝업/업데이트/백신 알림 최소화
화면 보호기/절전/자동 잠금 OFF
RDP/VM에서는 누락이 더 흔함 → 딜레이를 크게

2) 타이핑 속도(딜레이) 조정

Q. 글자가 가끔씩 빠진다(누락)

typingDelayMs를 먼저 올립니다 (예: 30 → 60 → 100)
그래도 안 되면 keyPressDelayMs도 올립니다 (예: 10 → 20)

Q. 엔터/탭/특수키 주변에서 깨진다

keyPressDelayMs를 올려 “눌림 유지”를 늘립니다.
콘솔(터미널)이라면 typingDelayMs도 함께 올립니다.

3) 앱 자동 기능 제거(IDE/에디터 영향)

자동 완성/자동 들여쓰기/자동 포맷은 입력 변형을 만들 수 있습니다.

메모장/단순 에디터에서 100% 성공 확인
IDE로 옮긴 뒤 자동기능을 하나씩 끄면서 비교

4) IME(한글/한영 전환) 이슈

시작 전에 Target PC 입력기를 영문 상태로 맞춥니다.
한/영 전환키가 환경과 맞는지 확인합니다.
modeSwitchDelayMs를 늘려 토글 직후 안정화 시간을 줍니다.

원본(Markdown): docs/troubleshooting-missing-text.md