2026-09-21: 사용자용 EXE를 dist/windows-unified-x64/app/notparsec.exe로 통합했다. 같은 앱의 Computers/Settings Client·Host와 한 기기 프로필을 사용한다. 기존 데이터 이전·충돌 선택 및 실제 버튼의 양방향 인증 시험을 구현했다. 현재 구현·원본 대응·시험, 실행 안내.
아래는 이전 progress-3 이력이다. 역할별 배포와 기본 데이터 경로는 위 현재 안내로 대체한다. 전체 원본 화면 동등성, 실제 두 PC/영상/오디오/입력은 여전히 미완료다.
Windows GUI 구현 기록 · progress-3
2026-09-23 후속: 배포 앱을 notparsec.exe로 통합하고 기기 목록 연결, 접속 허용, 인증서 자동 확인, PC 간 TLS/WSS 중계와 화면·입력 경로를 연결했다. 현재 사용법과 한계, 서버 계약, 관리자 웹 설정. 아래 역할별 EXE와 미디어 미구현 설명은 이전 GUI 작업 기록이다.
2026-09-21 정정: 아래는 기존 구현 이력이다. 역할별 사용자 EXE는 Parsec 통합 앱 구조와 불일치하며 수정 대상이다. 자체 4개 화면 배치도 원본 일치를 검증하지 않았다. 최종 목표는 Parsec 재현 계약과 다음 착수 지시를 따른다. 아직 통합 앱을 구현했다는 뜻은 아니다.
2026-09-20 Ubuntu 후속: WSS/세션/ticket/grant/lease/후보 교환 서버와 공통 DTO·클라이언트 helper를 추가했다. 아래 Windows GUI는 아직 이 흐름에 연결하지 않았으며 수동 presence/직접 비밀번호 인증 동작은 유지한다. 실제 서버 계약, Ubuntu 검증. 이 문서의 이전 Ubuntu 미실행 설명은 과거 GUI 작업 당시 기록이다.
2026-09-20. GUI 착수 결과이며 Parsec 수준의 원격 화면 기능 완성을 뜻하지 않는다.
실제 구현
crates/desktop-ui: egui/eframe 0.33.3 + Glow. 호스트 관리/직접 연결, 내 기기, 설정, 진단의 네 화면. 호스트와 클라이언트 EXE가 같은 UI 라이브러리를 역할별로 사용한다.crates/session: CLI와 GUI가 공유하는 인증서 고정 QUIC 클라이언트와 취소 가능한 호스트 서버. 별도 CLI subprocess에 비밀번호를 전달하지 않는다.- 인자 없는 EXE 실행은 GUI,
gui --data-dir PATH는 지정한 데이터 폴더의 GUI, 기존 CLI는 그대로 지원한다. Ubuntu의 control-server에는 GUI를 추가하지 않았다. - 호스트 비밀번호 초기화/확인/변경, 현재 사용자 DPAPI 보호, 공개 인증서와 SHA-256 표시/내보내기, IP:포트 대기 시작/중지. 새 디렉터리 초기화 시 기존 공개 인증서를 덮어쓰지 않는다.
- 클라이언트는 공개 DER 파일과 TLS leaf의 일치 확인 후에만 비밀번호 입력을 표시한다. 60초 입력 시간, 마스킹, 취소, 실패/30초 제한/미지원 응답 구분. 인증 성공 후 시험 연결 종료. 비밀번호 자동 저장·자동 재인증 없음.
- HTTPS origin에 묶인 Ed25519 기기 키 자동 생성, 등록 요청/관리자 웹 승인, 기기 목록과 이름/ID 검색, 10초마다 HTTP heartbeat와 목록 자동 갱신. 조회 시점/오래된 온라인 상태 표시. 기기 목록에서 주소를 얻어 자동 연결하는 기능은 남아 있다.
- GPU·모니터·등록된 코덱 후보를 백그라운드 진단하고 JSON 표시/저장. 화면 픽셀 수집이나 전송은 하지 않는다.
- 밝은/어두운 테마, 명시적으로 저장하는 UI 설정. 손상 파일을 보존하고 기본값으로 시작한다. 설정 검색 카탈로그에 분석 목록 163개 전부 포함. 원본 키의 값 편집/적용은 아직 구현하지 않았다.
데이터와 비동기 수명
기본 경로는 %LOCALAPPDATA%\notParsec\host / client. 기존 CLI 데이터는 gui --data-dir .\runtime\host 등으로 지정한다. UI에 별도 계정·로그인·로그아웃 화면은 없다.
ui.json 스키마 1에는 대상 주소, 공개 인증서 경로, 대기 주소, 서버 주소, 표시 이름, 테마만 저장한다. 알려지지 않은 키·버전·과도한 크기를 거부하고 임시 파일을 통한 교체로 저장한다. 비밀번호·등록 코드·토큰·개인 키는 UI 설정에 없다. 기기 키는 별도 DPAPI 파일이다. 비밀 문자열은 처리 후 및 화면 이동 시 비우며 비밀번호 위젯의 undo 기록도 매 프레임 제거한다. egui/OS의 모든 임시 메모리를 완전히 소거한다고 보장하는 것은 아니다.
Tokio runtime의 작업 결과를 채널로 UI에 전달한다. 네트워크 작업 취소 시 JoinHandle을 abort하고 수신 채널을 버려 늦은 응답이 취소 상태를 덮지 않게 한다. 이미 검증된 연결 객체를 버리면 QUIC endpoint도 닫힌다. 호스트는 별도 stop 채널로 종료하고 종료 상태가 확인될 때까지 재시작 버튼을 숨긴다. 창을 닫으면 stop을 보내고 runtime 종료에 최대 5초를 준다. 비밀번호 저장/등록처럼 이미 쓰기가 시작될 수 있는 작업에는 중간 취소 버튼을 제공하지 않는다. 강제 프로세스 종료 중의 원격 등록 결과는 재조회가 필요할 수 있다.
검증
- Windows Rust 검사 21개: 기존 15개 + GUI/설정 6개.
- GUI harness가 실제 버튼을 통해 호스트 시작 → 인증서 확인 → 취소 → 틀린 비밀번호 → 올바른 비밀번호 → 호스트 중지를 수행한다. 실제 loopback QUIC 사용, 비밀번호 비보관, 마지막 UDP 포트 반환을 확인한다.
- 인증서 확인 전 비밀번호 UI 부재, 화면 이동 시 비밀 제거/대기 작업 취소, 오염된 설정 거부/원본 보존, 원자적 설정 교체, Privacy Mode·가상 디스플레이를 포함한 카탈로그 163개 확인.
cargo fmt --all -- --check, workspace clippy-D warnings, release 빌드. 실행 파일만 임시 폴더로 복사한 QUIC/장치 API smoke와 PE import 검사.- 네이티브 창의 직접 연결/호스트/설정/진단 표시 검증 결과는
VERIFICATION.md의 progress-3 기록을 따른다.
현재 한계와 다음 통합
- GUI 인증 성공은 영상 세션 성공이 아니다. 캡처→인코더→전송→디코더→표시, 오디오/입력을 연결해야 한다.
- STUN/relay, WSS 알림, ticket, 기기 상세에서 직접 연결 통합이 남았다. 현재 GUI는 HTTP heartbeat의 30초 lease를 10초마다 자동 갱신하며 CLI에서는
device heartbeat --watch를 사용한다. - Privacy Mode·Virtual Displays·HDR·클립보드·게임패드 등의 카탈로그는 설명만 존재한다. 조작 가능한 가짜 스위치를 추가하지 않았다.
- GUI는 Windows만 지원한다. GPU OpenGL 드라이버와 Windows 한글 글꼴을 사용한다. 별도 Windows PC, 다중 DPI, 전체 키보드/스크린리더 흐름, 자동 업데이트·트레이·최소 복구 화면은 검증/구현이 남았다.
- 기존 CLI 호환을 위해 콘솔 EXE를 유지했다. 더블클릭하면 콘솔 창도 함께 보일 수 있다. 창을 닫으면 호스트가 종료되며 백그라운드 Windows 서비스로 동작하지 않는다.
- Ubuntu 24.04.4 / Intel N100 x86_64 대상 구성은 유지한다. 실제 홈서버 SSH 인증과 서버 기동 검증은 여전히 남아 있으며 이번 GUI 작업에서 원격 서버를 변경하지 않았다.
사용법
설계 HTML의 GUI 안내와 전체 실행 문서를 사용한다. 파일별 크기와 SHA-256은 release manifest, OS DLL 목록은 PE 검사에 있다.