juc500 정상동작

2026-07-21 21:04:25 +09:00
parent a423db0556
commit bb9874b931
2917 changed files with 708025 additions and 668 deletions
@@ -0,0 +1,60 @@
+---
+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** 모두 필요.