juc500/docs/INPUTSHARE.md

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

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

```bash
# 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 가로채기는 하지 않습니다.)