---
description: juc500 코드 수정 시 상대편(Mac Studio) 소스도 반드시 동기화
alwaysApply: true
---

# 상대편 소스 동기화 (필수)

juc500은 **양쪽 PC가 같은 프로토콜·입력공유 코드**를 실행해야 한다. 노트북만 수정하고 상대편이 구버전이면, 수정이 맞아도 테스트 결과가 틀려 보인다.

## 환경

| 역할 | 경로 | 호스트 |
|------|------|--------|
| 노트북 (로컬) | `/Users/macbook/dev/juc500/juc500` | Macbookui-MacBookPro |
| 상대편 (피어) | `/Users/aidev/dev/juc500/juc500` | aidevs-Mac-Studio |

## 코드 수정 후 필수 절차

1. **로컬** `juc500_xfer/` (및 관련 파일) 수정
2. **USB 연결된 상태**에서 상대편으로 동일 파일 전송
3. 상대편 앱 **재시작** 안내 (코드 반영)
4. 양쪽 **「연결」** → **「입력공유」** 후 테스트

## 동기화 방법 (연결 시)

```bash
./scripts/sync_peer.sh                    # 기본: inputshare, protocol, static
./scripts/sync_peer.sh juc500_xfer/usb_link.py   # 추가 파일
```

또는 API 직접 호출:

```bash
curl -s -X POST -H 'Content-Type: application/json' \
  -d '{"paths":["/Users/macbook/dev/juc500/juc500/juc500_xfer/inputshare.py"],
       "dest_dir":"dev/juc500/juc500/juc500_xfer"}' \
  http://127.0.0.1:8765/api/local/send
```

`static/` 파일은 `dest_dir`를 `dev/juc500/juc500/juc500_xfer/static`으로 지정.

## 동기화가 필요한 변경

- `juc500_xfer/inputshare.py` — 입력공유 (항상 양쪽)
- `juc500_xfer/protocol.py` — USB 프로토콜 (항상 양쪽)
- `juc500_xfer/static/*` — GUI (양쪽)
- `juc500_xfer/usb_link.py`, `gui_server.py` — 연결/전송 관련 시 양쪽

## 테스트 금지 조건

- 상대편 동기화·재시작 전에 **입력공유/연결 기능 테스트를 완료했다고 보고하지 말 것**
- `connected=False` 또는 IF5 Access denied 시 먼저 연결 복구

## 상대편 재시작 (사용자 안내)

```bash
cd /Users/aidev/dev/juc500/juc500 && ./start.sh
```

손쉬운 사용 권한은 **양쪽 Mac** 모두 필요.