notParsec / 문서전체 문서

설명·설계 문서

notParsec 개발 착수 지시

design/START_DEVELOPMENT.md

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

이 문서의 목차

설계 버전: 2026-09-21.6 작업 폴더: D:\SoftwareDev\notParsec 우선 기준: AGENTS.md, design/PARSEC_PARITY.ko.md, design/parity-policy.json, design/NEXT_PARITY_IMPLEMENTATION.md 근거 문서: design/ARCHITECTURE.ko.md, design/CONTROL_SERVER.ko.md, design/UI_TEXT_AUDIT.ko.md, design/SETTINGS_AND_RECOVERY.ko.md, design/plan-data.json

개인용·비공개·비배포 Parsec 재현 프로그램을 Rust 중심으로 구현해줘. Parsec 원본 재현이 제품 목표다. 기능·설정·배치·문구·상태·아키텍처를 편의상 새로 만들거나 제외하지 않는다. 기준은 보관한 Windows Parsec 150-104a와 hash다. 최신 공식 문서나 다른 버전의 동작은 기준과 구분한다. 허용 차이는 parity-policy.json의 E01–E04와 사용자가 이후 명시한 변경뿐이다. 전체 선택은 과거 설계의 임의 변경을 승인한 것이 아니다. 같은 notparsec.exe에서 다른 PC 연결·내 PC 호스팅·설정을 제공한다. 내부 모듈 분리를 사용자용 EXE 분리로 바꾸지 않는다. 각 작업은 원본 근거 → 대응 기능/설정/UI → 구현 위치 → 차이/예외 → 동일 조건 비교 시험 순서로 수행한다. 근거가 없으면 미확인으로 기록하고 먼저 분석한다. 82개 기능·163개 설정·39개 UI 흐름은 현재 조사 색인이다. Parsec 전체를 완전히 조사했다는 뜻이 아니며, 원본에서 발견한 누락 기능은 근거와 함께 추가한다. 원본의 레이아웃·상태별 화면을 같은 DPI·크기·언어·버전으로 관찰하고 비교한다. 문자열 추출만으로 배치나 실제 동작을 검증했다고 하지 않는다. QUIC·기존 자체 GUI·fork 전환·파일 전송 확대는 원본 일치 미검증이다. 확인된 원본 동작 또는 명시 예외 없이 최종 사양으로 채택하지 않는다. 공개 코드·디컴파일 의사 코드·복구 코드·Rust 재작성을 구분하고 hash/함수/타입 추정/변경/차등 시험을 기록한다. 접근할 수 없는 원본 소스·서버 구조는 동일하다고 보장하지 않는다. 완료하려면 development-status.json의 parity가 matched 또는 exception_verified이고 원본 근거·비교 결과·예외 범위가 있어야 한다. 빌드/자체 테스트/통합 앱 실행만으로 Parsec 일치를 선언하지 않는다. 사용자 계정 가입·로그인·로그아웃은 구현하지 않는다. 접속 대상 PC별 비밀번호를 매 연결마다 입력하고 host가 검증한 뒤에만 영상·입력을 허용한다. 연결 관리 서버는 Ubuntu에서 실행한다. 현재 QUIC 인증·egui GUI·서버 API는 기존 구현이다. 원본과의 일치나 예외 범위를 확인한 뒤 사용하고 자체 선택을 원본 아키텍처로 취급하지 않는다. 아래 선택은 이번 작업 묶음이다. 최종 목표는 확인 가능한 원본 전체이며 미선택/MVP는 최종 제외 사유가 아니다. 확인된 구조 불일치의 교정을 우선한다. 공개 코드뿐 아니라 디컴파일 기반 복구 C/Rust 로직도 범위에 포함한다. 원본 hash·함수 주소·추정 타입·이용 조건·검증 상태를 기록하고, 검증한 로직부터 자체 모듈로 통합해줘. 원본 DLL 로딩이나 미검증 의사 코드의 즉시 링크를 기능 구현 완료로 취급하지 말고, Parsec의 계정/구독 검사를 변경하는 작업으로 대체하지 않는다. 하드웨어를 요구하는 검증은 mock/단일 PC 시험으로 완료 처리하지 말고 미검증 조건을 기록해줘. 기존 구현은 design/development-status.json과 VERIFICATION.md의 근거를 먼저 확인해 중복 작업을 피한다. 매 개발 작업 후 해당 기능의 구현·검증·통합 상태, 남은 작업, 근거와 확인일을 갱신하고 python design/build_plan.py로 HTML을 다시 생성해줘. F44/F45는 원본 대응 부품 조사다. 다른 제품으로의 전환이나 새로운 사용자 기능 도입을 허용하지 않는다.

선택 ID: F01, F02, F03, F04, F05, F06, F07, F08, F09, F10, F11, F12, F13, F14, F15, F16, F17, F18, F19, F20, F21, F22, F23, F24, F25, F46, F47, F80, F81, F82 기록상 완료: 없음 착수 가능한 항목: F01 차단 표시: 없음 완료 표시는 사용자 기록이므로 실제 코드·시험 근거를 확인할 것.

구현 기록 기준: 2026-09-21 / progress-7 같은 Windows notparsec.exe의 연결·호스팅, 공유 기기 프로필과 기존 데이터 보존 이전을 구현했습니다. 동일 앱의 양방향 loopback 인증을 검증했습니다. Ubuntu 서버는 별도로 유지합니다. 실제 두 PC·전체 원본 화면 대조·영상/오디오/입력은 남아 있습니다. 구현 기록 F01: doing — 11개 Cargo 패키지. Windows 사용자용 notparsec.exe에 양쪽 역할을 통합하고 Ubuntu 서버를 별도 유지했습니다. 새 release에서 역할별 EXE를 제외했습니다. 기존 v0.1.0-ci.1의 원격 CI/게시 검증을 보존하고 통합 앱용 CI 경로를 갱신했습니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 별도 clean 환경에서 재현 확인 / v0.1.0-ci.2 통합 앱 태그의 CI·게시 결과와 새 Windows artifact 실행 확인 구현 기록 F02: doing — RTX 3070·물리 픽셀 모니터 열거, hardware MFT 등록 목록과 NVENC API 버전 진단을 구현했습니다. 원본 대조: unreviewed 남은 작업: 실제 H.264 하드웨어 디코딩 시험 / 두 번째 PC와 실패 장치에서 지원 판정 확인 구현 기록 F03: doing — 467개 외부 Cargo package와 728개 상위 notice를 기록했습니다. WSS 의존성을 추가하고 Linux 대소문자 구분에 따른 notice 누락을 수정했습니다. 전체 대상·개발 의존성을 포함하며 실제 링크별 감사는 남아 있습니다. 원본 대조: unreviewed 남은 작업: 내장 native 코드·하위 라이선스 검토 / 실제 링크 단위의 출처 감사와 복구 코드 이용 조건 판정 구현 기록 F04: doing — 인증 메시지에 더해 40바이트 미디어 헤더·epoch·조각/프레임 상한·역순/중복/만료 거부를 구현했습니다. 원본 대조: unreviewed 남은 작업: 입력·세션 제어 wire 정의 / network/fuzz 및 버전 호환 시험 구현 기록 F05: doing — 캡처 획득 대기의 p50/p95와 재조립 완료·중복·만료·폐기·구형 프레임 계수를 추가했습니다. 원본 대조: unreviewed 남은 작업: 인코딩·송수신·디코딩·표시 단계 추적 / 통합 측정·고정 테스트 패턴·clock 오차 기록 구현 기록 F06: doing — 호스트 cert pin과 별도 Ed25519 장치 등록·API 키 인증·DPAPI 보호 저장을 구현했습니다. 원본 대조: unreviewed 남은 작업: 장치 키와 QUIC peer/session 연결 / 양쪽 권한·서버 철회 ACK/lease 통합 구현 기록 F07: doing — Desktop Duplication으로 실제 60프레임을 획득하고 GPU 내 복사/RAII 반환을 확인했습니다. 원본 대조: unreviewed 남은 작업: 지속 캡처 worker·encoder 연결 / access lost·hotplug·잠금·종료 실패 주입 시험 구현 기록 F10: doing — 실제 QUIC/TLS 연결과 인증 메시지 왕복, 0-RTT 비활성화까지 구현했습니다. 원본 대조: unreviewed 남은 작업: 미디어 datagram 경로·호스트 세션 승인 통합 / 서로 다른 물리 PC와 datagram loss/역순 시험 구현 기록 F11: doing — MTU 분할과 중복·역순 재조립, 상충 조각·구형 epoch·만료 frame 거부를 구현·시험했습니다. 원본 대조: unreviewed 남은 작업: 실제 QUIC datagram 및 decoder 연결 / 손실/역순 링크와 IDR 복구 통합 구현 기록 F14: doing — 재조립 대기를 4프레임/16MiB·100ms로 제한하고 만료 프레임의 재진입을 차단했습니다. 원본 대조: unreviewed 남은 작업: capture/encode/send/decode/present 큐 상한 / 실제 느린 링크에서 pacing·복구 검증 구현 기록 F24: doing — 동일 Desktop 객체에서 Computers와 Settings Client/Host를 제공하고 양방향 인증·취소·호스팅 수명을 시험했습니다. 전체 원본 화면 배치는 미검증입니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 실제 영상 창·입력과 통합 / 다중 DPI·접근성·다른 Windows PC 검증 구현 기록 F46: doing — 문자열·설정 테이블·함수 참조와 복구 후보를 추출했습니다. 독립 복구 함수의 Rust 통합은 아직 없습니다. 원본 대조: unreviewed 남은 작업: 복구 후보별 타입·fixture·실패 경계 확정 / 복구한 C/Rust 함수 실행 시험과 자체 모듈 통합 구현 기록 F47: doing — 비밀 없는 UI 설정 스키마 1·원자 저장·손상 복구와 163개 읽기 전용 설정 카탈로그를 구현했습니다. 원본 대조: unreviewed 남은 작업: 163개 실행 설정의 형식·범위·적용 시점 구현 / 실제 media/driver 설정 반영 검증 구현 기록 F80: validation — 비밀번호 초기 설정·변경, Argon2id, DPAPI 보호와 인증서 보존이 구현되어 단위·실제 CLI 시험을 통과했습니다. 원본 대조: unreviewed 남은 작업: 다른 Windows PC/사용자에서 초기 설정·보호 저장·복구 확인 / 완성된 장치 신뢰 흐름과 통합 검증 후 전체 완료 판정 구현 기록 F81: doing — 매 연결의 비밀번호 확인, 호스트 전체 실패 제한, 동시 검증 제한을 CLI에서 시험했습니다. 원본 대조: unreviewed 남은 작업: 실제 영상·입력 시작 전 인증 gate 연결 / 미전송·취소·relay 경로·연결 종료를 포함한 통합 검증 구현 기록 F82: doing — 계정 없는 동일 앱의 대상 PC 비밀번호 인증, 호스팅 설정, 기기 키/설정 보존 이전과 충돌 선택을 구현·시험했습니다. 원본 대조: different 남은 작업: PARSEC_PARITY: 같은 release hash의 실제 두 PC 검증·원본 화면/상태·서비스 수명 비교 (loopback만 확인) / 기기 선택에서 원격 영상 세션까지 연결 / IME·스크린리더·다른 PC에서 사용성 검증 위 구현 기록은 사용자 수동 상태와 별도이며 최신 코드·시험 결과로 확인할 것.

M0 기반과 검증 환경

M1 LAN 영상 연결

M2 실제 원격 조작

각 마일스톤이 끝나면 실제 완료한 ID, 검증 결과, 아직 미검증인 장치·조건을 보고해줘.