2026-09-21 · 설계 v2026-09-21.6. 최상위 목표와 허용 차이는 PARSEC_PARITY, 기계 판독 기준은 parity-policy.json이다. 과거 자체 QUIC/MVP/fork 제안은 원본 사양으로 확정된 것이 아니다.
목표와 현재 상태
사용자용 Windows 앱은 같은 실행파일에서 접속과 호스팅을 모두 제공한다. Ubuntu 연결 관리 서버는 별도로 실행한다. 계정 없는 PC별 비밀번호, Rust, 자체 Ubuntu 서버와 통합 Windows EXE는 사용자가 명시한 변경이다. 개인용이라는 이유로 원본 기능·설정·레이아웃을 임의로 축소하지 않는다.
현재 apps/desktop의 notparsec.exe에서 공통 desktop-ui/session 모듈의 연결·호스팅을 함께 사용한다. 역할별 EXE는 새 사용자 배포에서 제외했고 기존 프로필을 보존하며 이전한다. Ubuntu 운영 배포는 검증됐지만 새 서버 세션/ticket/lease의 Windows 통합, 영상·소리·입력과 원본 화면 대조는 남아 있다. 현재 실행 방법, Ubuntu 운영 결과.
확인된 원본 경계와 대응
| 원본 근거 | 유지할 책임/사용 구조 | 자체 구현의 현재 판정 |
|---|---|---|
| 같은 코어 DLL에 host/client/UI 포함 | 같은 앱에서 연결·호스팅·설정 제공. 내부 모듈 분리는 사용자용 앱 분리와 다름 | 동일 EXE·프로필 통합 구현. 서비스/IPC/전체 원본 UI 비교는 남음. 교정 기록 |
| parsecd 로더 → 코어, 업데이트/복구 | 로딩·업데이트·실패 복구와 앱 수명 대조 | 정적 링크는 현재 구현 선택. 원본 책임 유지와 E03/E04 영향을 검증. F61/F70 |
| pservice → 사용자 세션 프로세스·IPC | Windows 서비스와 사용자 세션의 수명/권한 분리 | 미구현. 로그인 전·사용자 전환·종료를 원본과 대조. F40 |
| capture·encoder·BUD·decoder·renderer 경로 | 단계별 상태·버퍼 소유·복구/장치 변경·지연 제어 | NVENC/QUIC/MF 제안은 원본 일치 미검증. F07–F16/F26–F29 |
| Opus/WASAPI·입력·가상 장치 경로 | 전송 방향·권한·포커스·동기화·해제·fallback 대조 | 일부 진단 외 미구현. F18–F23/F38/F42 |
| Privacy/VDD/VUSB와 설정 UI | 원본 topology·모드·실패 복구·설치 조건 재현 | 설정 목록만으로 완료 불가. F39/F48–F59 |
| HTTPS/WSS 제어와 PC 간 미디어 | 연결 관리와 미디어 경계를 분리 | Ubuntu 서버는 E02 자체 구현. 원본 서버 내부 소스/DB는 미확인. F71–F79 |
근거: 구조 분석, 심층 분석, 검토 함수. 표는 모든 함수/프로세스 구조를 완전히 복원했다는 주장이 아니다.
Rust 소스 구성과 사용자 배포를 구별한다
현재 코드 위치:
- apps/desktop: 현재 사용자용 단일 notparsec.exe. 연결·호스팅·기기 관리·이전 CLI와 통합 GUI.
- apps/host, apps/client: 이전 CLI 회귀 시험 래퍼. 새 사용자 배포에는 포함하지 않는다.
- apps/control-server: Ubuntu 연결 관리 서버. 현재 CLI에 로컬 관리 명령 포함.
- crates/desktop-ui: 현재 통합 GUI와 프로필 이전. 원본 화면/상태/전체 배치는 추가 대조한다.
- crates/session: 실제 QUIC 비밀번호 인증 시험 경로. 원본 BUD와 동등한 전송이라는 뜻이 아니다.
- crates/device-client, crates/wire: 자체 서버 통신과 메시지. E02 계약과 원본 관찰 동작의 차이 추적.
- crates/access, crates/platform-win: 비밀번호/DPAPI와 Windows API·진단.
수정할 사용자 배포는 Windows의 동일한 notparsec.exe와 Ubuntu의 별도 notparsec-control-server다. Windows 엔트리 위치는 apps/desktop으로 정리할 수 있으나 이는 Rust 저장소 구성이다. 원본 내부의 원래 프로젝트 이름이나 소스 구조를 복원했다고 표시하지 않는다. 호스트/클라이언트 기능은 공통 코어 안에 분리해 유지할 수 있다.
현재 host/client 데이터 폴더·기기 ID·설정·키의 통합은 보존·충돌·재등록 영향을 먼저 명세한다. 다른 PC처럼 중복 등록하지 않도록 검증하되 기존 데이터를 임의로 폐기하지 않는다. 서비스·드라이버·설정 데이터는 원본 기능에 필요할 때 별도 구성으로 유지할 수 있다. 한 앱 요구를 모든 실행 파일과 드라이버를 없애라는 뜻으로 확대하지 않는다.
구현 결정의 근거
언어/빌드 도구는 E03 아래에서 바꿀 수 있으나 다음은 각각 원본 근거가 필요하다.
- 프로세스·스레드·IPC·상태 머신과 자원 소유/해제.
- GPU capture/색 변환/코덱 선택과 fallback, 화면별 stream과 해상도/DPI 변화.
- 미디어 패킷·조각·재조립·혼잡 제어·재전송/FEC·연결 복구와 기한.
- 오디오 sample/packet·jitter·device change, 입력 포커스·pressed-state·단절 해제.
- 설정 기본값·runtime override·저장·즉시 적용/재시작·권한과 UI 표시 조건.
기존 제안의 QUIC, 자체 wire schema, 버퍼 수 2, jitter 20–60ms, 1080p60·단일 세션 등은 원본 사양으로 확인한 값이 아니다. 현재 실행 시험에 쓰는 수치와 원본에서 복구한 수치를 분리한다. 원본 사실을 확인하지 못한 영역을 자체 설계로 채우지 않는다. 실행 가능한 독립 분석/구현은 계속 진행한다.
코드 재사용과 복구
우선 원본에 포함된 공개 코드와 확인 가능한 대응 함수를 조사한다. 공개 libmatoya 버전이 설치본 버전과 다르면 구조체/ABI/동작 차이를 기록한다. 공개 저장소의 소스, 디컴파일 의사 코드, 복구한 C/Rust, Rust 재작성은 서로 다른 근거 수준이다.
F46에서 원본 hash·함수 주소·타입/수명 추정·공개 revision·변경·이용 조건을 남기고 동일 입력/결과/오류·자원 해제 시험을 연결한다. 원본 주석·이름·타입·비공개 서버 소스를 완전히 복원했다고 주장하지 않는다. 검증하지 않은 DLL 로딩을 기능 완성으로 세지 않는다.
F44/F45는 원본에 대응하는 부품 조사다. Parsec 대신 Sunshine/Moonlight/RustDesk의 제품 구조·프로토콜·UI로 전환하는 목표는 폐기한다. 대응 근거가 없는 기능을 도입하지 않는다.
UI·설정·고급 기능
같은 앱의 Computers, Settings와 하위 탭, 공유/권한, 세션·오버레이·오류·트레이·복구 흐름을 원본과 비교한다. 배치·문구·색·크기·포커스·키보드·상태별 표시를 기록한다. 계정 화면은 E01에 따라 바꾸되 나머지 전체를 새 UI로 설계하지 않는다.
Privacy Mode, Virtual Displays, HDR/4:4:4, 멀티모니터, 장치 전달과 원본에서 확인한 다른 기능은 단계적으로 대조·구현한다. 미선택·MVP·개인용은 최종 삭제 사유가 아니다. 82개 기능/163개 설정/39개 UI 흐름은 현재 색인이고 전체 누락 검토를 계속한다.
자체 서버와 비밀번호 예외
Ubuntu 24.04.4 x86_64/N100, Nginx, n3m.kr, 내부 127.0.0.1:18080은 현재 배포다. 장치 등록·권한·세션 ticket·lease·철회 등은 실제 API와 운영 검증을 따른다. 자체 서버 내부 구조를 Parsec 서버 원본으로 간주하지 않는다. PC 전송의 임의 교체는 E02만으로 승인된 것으로 보지 않는다.
대상 PC의 비밀번호는 새 연결마다 host가 검증한다. 서버 ticket은 비밀번호를 대체하지 않는다. 현재 구현의 비밀번호/verifier 비전송·DPAPI·Argon2id와 인증 전 미디어 차단은 E01의 구현 근거로 기록한다. 인증서 파일 수동 교환은 현재 시험 흐름이며 최종 사용자 흐름으로 자동 확정하지 않는다.
완료 조건
각 F ID는 원본 사양 → 구현 경로 → 차이/명시 예외 → 비교 시험을 갖춘다. 구현/통합 시험 외에 development-status.json의 parity가 matched 또는 exception_verified여야 done이다. 루프백·mock·문서 작성은 두 PC의 실제 영상/입력이나 원본 UI 일치 검증을 대신하지 않는다.
기준 버전/예외가 바뀌면 관련 대조 결과를 재검토한다. 현재 선택과 과거 구현 기록을 보존하면서 생성 문서까지 갱신한다. 실행 순서는 NEXT_PARITY_IMPLEMENTATION을 따른다.