juc500/docs/INPUTSHARE.md

입력공유 수동 검증 체크리스트

양쪽 PC(Windows + Mac)에 동일 커밋을 받은 뒤:

# Mac
./scripts/setup_macos.sh
./start.sh

# Windows
scripts\setup_windows.bat
.\start.bat

절차

1. 케이블 연결 → 양쪽 GUI에서 연결 (파일 패널이 떠야 함)
2. 양쪽에서 입력공유 켜기 (기본은 꺼짐 — USB 연결만으로는 켜지지 않음. 한쪽만 켜면 핸드오프 불가)
   • Mac: 손쉬운 사용에서 Python/Terminal 허용 후 다시 켜기
3. A쪽 마우스를 화면 오른쪽 끝으로 밀어 잠시 대기
   • A 상태: 상대 PC 제어 — 키보드·마우스 입력이 B로 전달
   • B 상태: 상대가 조종 중 — 커서/클릭/키가 B에 적용
4. 마우스를 상대(B) 화면 왼쪽 끝으로 이동
   • A로 제어권 복귀 (이 PC 제어), 커서는 A 화면 오른쪽 안쪽에 놓임
5. GUI의 [상대 PC] / [이 PC] 버튼으로도 전환되는지 확인 (입력공유 ON일 때만)
6. Esc / 정상 종료 / 끊기 — 입력공유 해제 + 로컬 마우스·키보드 강제 복구
7. 강제 종료 후에도 다음 실행 시 시작 단계에서 입력 상태를 복구하는지 확인
8. 파일 전송 중에도 세션이 죽지 않는지 확인 (입력은 잠시 끊길 수 있음)

레이아웃

상대 PC를 오른쪽에 둔다고 가정합니다.

현재 모니터 오른쪽 끝에 두고, 그 오른쪽에 다른 모니터가 없을 때 상대 PC로 넘어갑니다. (다중 모니터면 맨 오른쪽 화면의 오른쪽 끝으로 밀어 주세요.)

동작	결과
모니터 오른쪽 가장자리로 마우스	제어권 → 상대 PC (KM 캡처 → USB 전송)
상대 가상 커서 왼쪽 가장자리	제어권 → 이 PC (캡처 해제, 로컬 KM 복귀)

참고: 이 PC 커서는 ACK 수락 후 숨겨지고, 상대 PC 커서가 움직입니다. 상대가 수락하지 않으면(입력공유 OFF 등) 약 1.5초 후 자동으로 이 PC로 복귀합니다. 양쪽에 동일 버전의 inputshare.py / protocol.py가 있어야 ACK(2)·NACK(3) 핸드셰이크가 동작합니다.

파일 붙여넣기 (클립보드 → 상대 폴더)

Finder / Explorer에서 파일을 복사한 뒤, JUC500으로 상대 폴더에 붙여넣을 수 있습니다. (OS 창을 넘나드는 진짜 드래그 앤 드롭은 지원하지 않습니다.)

1. USB 연결 후 JUC500 UI에서 상대 대상 폴더를 엽니다 (배지에 붙여넣기 → … 표시).
2. Finder 또는 Explorer에서 파일/폴더를 복사 (Cmd+C / Ctrl+C).
3. JUC500 창에서 Ctrl+Shift+V 로 전송합니다.
4. 전송 진행은 가운데 상태/프로그레스에 표시되고, 끝나면 상대 폴더 목록이 새로고침됩니다.

대상 폴더를 열지 않은 경우 기본값은 상대 쪽 Desktop 상대 경로입니다. 가능하면 UI에서 폴더를 먼저 여세요.

텍스트 붙여넣기 (상대 PC 제어 중)

1. 이 PC에서 텍스트를 복사 (Ctrl+C / Cmd+C).
2. 마우스로 상대 PC 제어로 이동.
3. 상대 앱에서 Ctrl+V (Mac에서는 Cmd+V도 가능) — 클립보드 텍스트가 상대로 동기화된 뒤 상대에서 붙여넣기됩니다.
   (파일 전송용 Ctrl+V 가로채기는 하지 않습니다.)