notParsec / 문서전체 문서

설명·설계 문서

현재 GUI · progress-7

design/GUI_IMPLEMENTATION.ko.md

출처: 현재 작업 폴더 · 원문 다운로드

이 문서의 목차

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 수준의 원격 화면 기능 완성을 뜻하지 않는다.

실제 구현

데이터와 비동기 수명

기본 경로는 %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초를 준다. 비밀번호 저장/등록처럼 이미 쓰기가 시작될 수 있는 작업에는 중간 취소 버튼을 제공하지 않는다. 강제 프로세스 종료 중의 원격 등록 결과는 재조회가 필요할 수 있다.

검증

현재 한계와 다음 통합

  1. GUI 인증 성공은 영상 세션 성공이 아니다. 캡처→인코더→전송→디코더→표시, 오디오/입력을 연결해야 한다.
  2. STUN/relay, WSS 알림, ticket, 기기 상세에서 직접 연결 통합이 남았다. 현재 GUI는 HTTP heartbeat의 30초 lease를 10초마다 자동 갱신하며 CLI에서는 device heartbeat --watch를 사용한다.
  3. Privacy Mode·Virtual Displays·HDR·클립보드·게임패드 등의 카탈로그는 설명만 존재한다. 조작 가능한 가짜 스위치를 추가하지 않았다.
  4. GUI는 Windows만 지원한다. GPU OpenGL 드라이버와 Windows 한글 글꼴을 사용한다. 별도 Windows PC, 다중 DPI, 전체 키보드/스크린리더 흐름, 자동 업데이트·트레이·최소 복구 화면은 검증/구현이 남았다.
  5. 기존 CLI 호환을 위해 콘솔 EXE를 유지했다. 더블클릭하면 콘솔 창도 함께 보일 수 있다. 창을 닫으면 호스트가 종료되며 백그라운드 Windows 서비스로 동작하지 않는다.
  6. Ubuntu 24.04.4 / Intel N100 x86_64 대상 구성은 유지한다. 실제 홈서버 SSH 인증과 서버 기동 검증은 여전히 남아 있으며 이번 GUI 작업에서 원격 서버를 변경하지 않았다.

사용법

설계 HTML의 GUI 안내와 전체 실행 문서를 사용한다. 파일별 크기와 SHA-256은 release manifest, OS DLL 목록은 PE 검사에 있다.