Remote View
Remote View를 사용하면 대시보드에서 직접 지원되는 IDE 세션의 화면을 보고 상호작용할 수 있습니다.
인터넷 facing 원격 접근의 주요 경로는 클라우드입니다. 셀프호스트에서는 동일한 뷰가 로컬/LAN 대시보드 경로를 통해서만 작동합니다.
Remote View 열기
- 대시보드 또는 머신의 Workspace 탭에서 IDE 세션을 엽니다.
- 해당 세션의 Remote를 엽니다.
- ADHDev가 원격 표면을 열고 해당 IDE 세션의 스크린샷 스트림을 시작합니다.
보기 모드
분할 뷰
데스크탑에서 표준 원격 표면은 한쪽에 채팅, 다른 쪽에 IDE 화면이 있는 분할 대화로 열립니다.
원격 전용 뷰
화면이 전체 워크스페이스를 차지하도록 하려면 동일한 대화를 원격 전용 모드로 전환할 수 있습니다.
미리보기 표면
일부 레이아웃은 전체 원격 대화를 열기 전에 더 작은 스크린샷 미리보기를 표시하기도 합니다.
상호작용
Remote View가 활성화되면 IDE 세션을 제어할 수 있습니다:
| 액션 | 데스크탑 | 모바일 |
|---|---|---|
| 클릭 | 마우스 클릭 | 탭 |
| 우클릭 | 오른쪽 마우스 버튼 | 길게 누르기 |
| 더블 클릭 | 더블 클릭 | 더블 탭 |
| 입력 | 물리적 키보드 | 화면 키보드 |
| 스크롤 | 마우스 휠 / 트랙패드 | 두 손가락 스와이프 |
| 줌 | — | 핀치 줌 |
시각적 피드백
모든 클릭은 클릭이 등록됐음을 알 수 있도록 클릭 위치에 리플 효과를 표시합니다.
성능
직접 연결 (STUN)
P2P가 직접 연결되면 (릴레이 없이) 스크린샷이 빠르고 반응성이 좋습니다:
- 새로고침 속도가 자동으로 조정됩니다 (화면이 변경될 때 더 빠르고, 정적일 때 더 느림)
- 품질: 높음 (JPEG 품질 25)
릴레이 연결 (TURN)
P2P가 TURN 릴레이를 통하는 경우 (일반적으로 엄격한 NAT 뒤에서):
- 약간 더 느린 새로고침 속도
- 대역폭 감소를 위한 낮은 품질 (JPEG 품질 12)
- 모니터링 및 제어는 여전히 완전히 작동
플랜 기반 제한
클라우드 계정 제한:
| 플랜 | 플랜 최소 간격 | 릴레이 예산 |
|---|---|---|
| Free | 5초 | 60분/일 |
| Pro | 2초 | 4시간/일 |
| Team | 2초 | 무제한 |
| Enterprise | 추가 플랜 최소 간격 없음 | 무제한 |
INFO
릴레이 예산은 TURN 릴레이 스크린샷 시간에 적용됩니다. 직접 P2P 경로는 클라우드 릴레이 예산을 소비하지 않습니다.
INFO
이 할당량은 클라우드 플랜 제한입니다. 셀프호스트는 클라우드 스크린샷 예산을 사용하지 않지만, 네트워크 외부에서 호스팅 원격 접근 경로를 제공하지도 않습니다.
문제 해결
"CDP not connected" 경고
IDE가 CDP 활성화로 실행되고 있어야 합니다. 다음으로 다시 실행하세요:
bash
adhdev launch <supported-ide>검은 화면 / 스크린샷 없음
- IDE가 머신에서 실제로 열려 있고 표시되는지 확인하세요
- P2P 연결 상태를 확인하세요
- Remote View를 닫고 다시 여세요
느리거나 끊김
- TURN 릴레이를 사용 중인지 확인하세요 (연결 정보에 표시됨)
- 다른 P2P 집약 애플리케이션을 닫으세요
- 더 나은 NAT 트래버설이 있는 네트워크를 시도하세요 (STUN 직접 연결이 가장 빠름)
세션이 열리지만 원격 컨트롤이 제한적으로 느껴짐
- Remote View를 포괄적인 원격 데스크탑 약속이 아닌 먼저 IDE 워크플로우로 취급하세요
- Cursor는 현재 Remote View를 위한 가장 강력한 공개 시작점입니다
- IDE 자체가 부분적으로만 검증된 경우 채팅이 여전히 원격 컨트롤보다 더 잘 작동할 수 있습니다
다음 단계
- CLI 에이전트 → — 터미널 기반 에이전트 관리
- 대시보드 → — 대시보드 기본으로 돌아가기