notParsec / 문서전체 문서

설명·설계 문서

UI 텍스트 복구와 설계 누락 재검토

design/UI_TEXT_AUDIT.ko.md

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

이 문서의 목차

2026-09-21 정정: 아래는 원본 문자열·함수와 당시 설계 대조 이력이다. 과거 '대체/범위 제외/내부용'은 사용자의 예외 승인을 뜻하지 않는다. 현재 판정은 Parsec 재현 계약과 v6 plan-data.json의 재검토 표시를 따른다. 배치·실제 표시·동작은 동일 조건 화면/행동 비교가 추가로 필요하다.

검토일 2026-09-20 · 설계 v2026-09-20.3 · 현재 설치본 코어 150-104a 기준.

Settings 외의 UI까지 확장해 **새 기능 7개(F64–F70)**를 추가하고 기존 기능 9개를 보강했다. 전체 기능은 63 → 70개, 기본 선택은 27개로 유지한다. 이전 139개 설정 스키마와 163개 설정·감사 항목은 그대로 보존한다. 새 항목 대부분은 설정 키가 아니라 화면의 동작·상태·오류 처리이므로 별도의 UI 대응표에 기록한다.

확인 범위와 재현

재현은 워크스페이스 루트에서 다음 순서로 실행한다. pefile은 기존 설정 추출과 동일한 의존성이다. 원본 실행 파일은 실행하지 않는다.

python design/extract_ui_evidence.py
python design/make_plan_data.py
python design/build_plan.py
node design/plan.test.cjs --write-brief

원문과 주소: ui-texts.tsv. 전체 참조·함수 위치·부속 바이너리·리소스: ui-text-evidence.json. 화면별 판정: ui-text-catalog.json.

실제로 빠져 있던 기능

신규 ID 누락한 동작 Rust 재구현 방향
F64 Computers 검색, 빈 목록·무검색 결과, Reload, 장치 상세 app::device-directory; 장치 신뢰·연결 상태와 목록 갱신의 generation 관리
F65 공유 링크 생성·복사·폐기, Peer ID 입력, 신뢰 요청·철회 core::invitation; 자체 장치 키에 묶인 만료·권한 토큰, 초대/세션 철회 정책
F66 채팅 입력·전송·자기 표시·줄 복사·Esc protocol::chat; reliable control stream, message ID·길이·rate limit, IME/포커스 복구
F67 승인 대기·영상 준비·무수신·취소·host/client 오류 core::connection-state; 명시적 상태, 취소 경합, 오프라인 오류 사전·재시도 정책
F68 15종 성능 그래프, console 자동 스크롤·복사 telemetry::series; bounded history, 측정 위치·단위·미수집 표시와 host/client 진단 export
F69 OS 권한·장치·driver의 문제를 해결하는 화면 platform-win::readiness; 권한 거부/관리자 제한/미설치/disabled/error/restart/version mismatch
F70 웹/주 UI 로드 실패, 이전 UI 복귀, loader 손상/호환 오류 app::recovery-ui; 제한된 재시도, 최소 native 복구 화면, 설정·세션 보존과 rollback

F06·F17·F24·F36·F51·F52·F59·F61·F63에는 신뢰 철회, 게스트 권한 토글, 설정 적용 시점, 화면 닫기와 세션 종료 구분, immersive 임시 해제, overlay 임시 숨김, 게임패드 매핑 문자열·raw min/max, 로그·업데이트, 전체 UI 감사 기준을 추가했다. 동일 요구를 별도 기능으로 중복 계산하지 않았다.

문자열을 넘어 확인한 동작과 복구 가능성

함수 디컴파일에서 확인한 내용 복구에 활용할 수 있는 계약 / 남은 확인
1800203b0 채팅 입력 버퍼, 비어 있지 않은 입력에서 callback 호출 후 입력 초기화, line copy와 Esc 안내 입력→전송 이벤트, focus/수명 계약. buffer 인수 0x400은 원본 프로토콜의 정확한 최대 메시지 길이 증거가 아니다. callback 이후 wire 포맷은 별도 추적
180029f40 CONNECTED/WAITING 상태, switch 1–3에서 입력 권한 토글, case 4 퇴장 호출, 5/6 승인·거절 호출 GuestState와 PermissionBits 명세·실패 시 원상 복귀. 원본 구조체 offset을 Rust layout으로 그대로 확정하지 않음
18000c870 개별 장치 권한과 무승인 접속 선택, 타인 접속 중 변경 제한, friendship API 요청 저장 신뢰와 세션별 권한 분리. 자체 장치 pairing에 맞게 대체
18002ad10 공유 카드와 Share/Stop Sharing, 폐기 알림·클립보드 전달, daisy-chain 제한 초대 발급/폐기 상태·표시 순서. 서버 토큰 발급 알고리즘은 이 UI 함수에서 복원되지 않음
18000f350, 18000fcb0 mapping 복사·Unmap·Reset, raw 입력 및 min/max 표시 매핑 serialization/검증·raw 진단 UI. min/max를 자동 calibration 기능으로 확대 해석하지 않음
1800282c0 15개 trace의 이름·단위 종류·표시 속성 초기화와 샘플 위치 자체 telemetry field와 trace의 대응표. 원본 offset/단위 변환은 측정 지점까지 확인한 뒤 확정
18002d910, 1800365f0 error title/label/warning 파싱, 숫자 코드와 Read More/Dismiss 합성 안정된 자체 오류 ID·심각도·복구 동작. 서버 사전이 없을 때 fallback
180037040, 180037700 로딩/재시도 안내와 Revert to Old UI, client_web_ui 변경·이벤트 주 UI 장애에서 fallback 상태와 설정 보존. native-only 구현이면 동일 상태를 자체 최소 UI로 대체

위 함수는 복구 C 의사 코드 폴더에 있다. 원본 함수/변수 이름·클래스 구조·완전한 source tree를 복원한 결과가 아니다. F46에서 타입·소유권·thread·callback 계약을 좁혀 독립 harness로 검증한 뒤 Rust 재구현 또는 격리된 C 복구 후보로 사용한다.

15개 graph: Host/Client Video Total, P2P Network Latency/Bitrate, Host/Client Audio Total, Host Video Capture/Encode, Client Video Decode, Host/Client Video Frame Time, Host Audio Encode, Client Audio Decode, Host/Client Audio Frame Time. 원본의 total과 frame time을 동일한 end-to-end latency라고 표시하지 않는다.

Privacy·Virtual Displays 재점검

Privacy 설정 자체는 기존 F48에 있었다. 이번에는 소유자 아닌 연결로 비활성, display 오류로 비활성, 안전 해상도로 fallback, software encoder 사용이라는 안내를 각각 확인했다. 옵션을 켰다는 이유로 성공 상태를 표시하지 않도록 F48/F52/F67 완료 기준에 연결한다.

Virtual Displays 수·fallback·사용자 mode·GPU 설정은 F49/F50에 이미 있다. 추가 화면 열기/현재 화면 표시/순환 전환/창 닫기는 F36, driver disabled/error/restart·update/downgrade는 F69로 연결한다. 한 메뉴에 나타난다고 동일 모듈이나 동일 수명으로 취급하지 않는다.

Settings와 모든 네이티브 UI 흐름의 대응표

아래 판정은 개발 전 설계 포함 여부다. 구현 완료 상태가 아니다. functionGroups는 함수 단위의 문맥 연결이며, Settings의 큰 함수에 함께 속한다고 특정 문자열이 모든 설정 화면에 표시된다는 의미는 아니다. 예시는 해당 함수의 직접 string xref가 있는 항목으로만 선택했다.

화면 판정 · 담당 복구 원문 예 · 함수 설계 처리
U01 Settings · 탭과 즉시/재시작 적용 보강 · F24, F47, F63 CLIENT SETTINGS · 1800192e0 Client/Host/Approved Apps/Network/Hotkeys/Gamepad/Experimental/Account 및 조건부 Secret를 확인. 주 화면 설정과 보조 화면 overlay 설정의 저장 범위를 구분한다.
U02 Settings · 영상·renderer·decoder 기존 대응 · F35, F47, F52, F58 Renderer · 180012c50 기존 스키마와 대응. crash로 격리된 decoder 재활성·재시작 및 backend 미지원 상태까지 명세한다.
U03 Settings · Privacy / Virtual Displays 보강 · F48, F49, F50 Privacy Mode · 180012c50 소유자 아닌 연결과 display 오류로 Privacy가 비활성인 경우를 분리한다. 옵션 ON과 실제 물리 화면 차단 성공은 다른 상태다.
U04 Settings · 호스트 정책·허용 앱 기존 대응 · F56, F57 APPROVED APPS · 180012c50 허용 앱 목록·입력 배타성·idle kick·동시 연결/중첩 연결 제한은 정책 모듈에 대응. 비허용 앱 대기 화면도 U18에서 연결한다.
U05 Settings · 오디오·마이크·카메라 기존 대응 · F53, F54, F55 Microphone permission required: · 180012c50 장치 선택, mute, passthrough, session/persistent 가상 장치 수명은 기존 항목에 대응. 권한·설치 문제의 해결 화면은 F69로 보강한다.
U06 Settings · 네트워크 기존 대응 · F60 NETWORK SETTINGS · 180012c50 포트와 UPnP 등의 설정 스키마 및 자체 전송 방식의 적용 정책으로 대응한다.
U07 Settings · Hotkeys / Immersive 보강 · F51 Press key combination or Enter to clear. · 1800113e0 충돌 검사, Enter로 매핑 삭제, 재지정 중 입력 격리, OS 입력 권한 안내를 명시한다. macOS 권한 UI는 Windows 첫 버전의 제외 사유를 기록한다.
U08 Settings · Gamepad 매핑 진단 보강 · F59 Copy Map String · 18000f350 버튼별 입력 대기/Pressed/Unmap, mapping 문자열 복사, raw 축 값·관측 min/max, 장치 없음과 reset를 보강. min/max 표시는 자동 보정 기능의 증거가 아니다.
U09 Settings · 펜·USB·라이브러리 선택 기존 대응 · F62, F69 Click to download LibUSB, or select Self-Managed above to use an external LibUSB library. · 180011930 USB backend 선택·사용자 라이브러리 실패·재시작 안내와 펜/보안키 조건을 대응. 외부 DLL 경로는 자체 명시 경로·ABI 확인 방식으로 설계한다.
U10 Driver · 버전·설치 상태 보강 · F49, F62, F69 Driver Update Required. · 180019d80 미설치/unknown/disabled/error/restart와 버전 불일치 구분, 재검색·설치 후 확인·rollback을 하나의 장치 준비 흐름으로 추가한다.
U11 Computers · 목록·검색·갱신 신규 · F64 Search Hosts and Computers · 18000c050 이전 F24의 기본 UI 설명에 없던 검색/빈 목록/필터 초기화/갱신/본인·공유 호스트 구별과 상세 버전 표시를 독립 항목으로 추가한다.
U12 Computers · 공유·링크 폐기·Peer ID 신규 · F65 Stop Sharing · 18002ad10 초대 생성·복사·입력·폐기와 폐기 후 연결 차단을 설계한다. Parsec 공유 서버가 아닌 자체 장치 신뢰/초대 토큰으로 재구현한다.
U13 Friends · 추가·요청·신뢰 철회 대체 · F06, F65 INCOMING · 18000d400 개인용에서는 공개 친구 검색 대신 신뢰 장치·초대 요청의 수신/발신/취소·승인·철회로 대체. 철회가 기존 세션과 저장 권한에 미치는 정책을 명시한다.
U14 Friends · 장치별 자동 승인 권한 보강 · F06, F17, F57 Can connect without your approval (careful!) · 18000c870 키보드/마우스/게임패드 권한과 무승인 접속 권한을 별도로 보관. 타인 접속 중 권한 상승 제한과 신뢰 철회 확인 화면을 보강한다.
U15 Guests · 승인·거절·퇴장·권한 토글 보강 · F17, F57 WAITING TO CONNECT · 180029f40 decompiled switch에서 권한 3개 갱신, 연결 종료, 승인/거절 호출을 확인. 원격 세션 중 접근 가능한 손님 목록·지연 표시·권한 변경 UI를 보강한다.
U16 접속 · 대기·취소·호스트 전용 모드 신규 · F67, F57 Waiting to connect... · 18002ce40 대기 취소와 실패 재시도, host-only·daisy chaining 제한 사유를 상태 머신에 추가한다. UI를 닫는 것과 접속 요청 취소를 구분한다.
U17 접속 · 영상 준비·무수신·실패 신규 · F67 Parsec is getting things ready for you. · 18001fc80 연결 성공/첫 프레임 대기/수신 중단/decoder 실패/host·client 오류를 분리하고 원인에 맞는 재시도·로그 열기를 제공한다.
U18 접속 · 승인·Approved Apps 대기 보강 · F56, F67 The host is doing something else right now. · 18001f740 승인 대기와 허용 앱 부재를 영상 고장으로 표현하지 않도록 별도 상태·설명을 설계한다. 문자열의 may는 실제 원인 확정과 다르다.
U19 세션 · 채팅 입력·표시·복사 신규 · F66 Press ESC to leave chat · 1800203b0 문자열만이 아니라 입력 buffer, 비어 있지 않은 입력의 callback 전송, line copy를 확인. 신뢰성 있는 control channel·메시지 제한·IME·포커스 복구가 필요하다.
U20 Overlay · 기본 메뉴·화면 닫기 보강 · F36, F51, F52 Hide Button · 180021930 세션 한정 버튼 숨김과 영구 설정을 분리. 보조 화면 닫기와 전체 연결 종료, 소리 ON/OFF, cursor warp 옵션을 구체화한다.
U21 Overlay · Immersive 임시 토글 보강 · F51 Temporarily disable or re-enable the immersive mode selected below. · 180023110 저장한 immersive 모드를 유지하는 임시 해제, 버튼 hover를 통한 마우스 탈출과 gamepad 메뉴 제스처를 보강한다.
U22 Overlay · 화면 추가·전환 보강 · F36, F49 Add Screens · 180023f40 기존 화면 선택, 가상 화면 생성, 스트림 창 추가를 별개 동작으로 명세하고 현재 화면·상한·추가 실패를 표시한다.
U23 Overlay · 실시간 영상 설정·fallback 보강 · F35, F52, F58 Orientation · 1800241b0 per-stream 해상도/회전/대역폭/codec/decoder/4:4:4/10-bit/constant FPS. 요청값과 협상 결과, 낮은 해상도 fallback, crash decoder 복구를 표시한다.
U24 Overlay · 마이크·카메라·USB 선택 기존 대응 · F54, F55, F62 Microphone ON · 180022240 장치 선택·전달 여부·mute/stop를 독립 제어. 장치 이름은 runtime 데이터이므로 정적 문자열 수에 포함되지 않는다.
U25 Overlay · 성능 수치·미디어 정보 보강 · F05, F52, F68 Basic Performance · 180025b20 현재 codec/chroma/bit depth/range/해상도/음성 채널·raw/Opus, 지연·Mbps·queue를 표시. 지원 표시는 실제 출력 결과와 연결한다.
U26 Overlay · 성능 그래프 15종 신규 · F68 Host: Video Total · 1800282c0 15개 trace 초기화와 ms/Mbps 계열을 확인. 이전 telemetry 수집 계획에 없던 그래프 선택·시간축·기록 상태 표시를 추가한다.
U27 Overlay · 성능·Privacy 경고 보강 · F48, F52, F67 Decoder failure, queued_frames · 180028830 decoder 처리 지연·network·해상도 fallback·software encode·Privacy 실패를 각각 구분. 경고 표시 OFF가 실제 장애 상태를 지우지 않는다.
U28 Console · 자동 스크롤·복사·로그 열기 보강 · F61, F68 Scroll to bottom on new line · 180029c90 console 자동 스크롤·전체 복사·host/client 로그 구별·진단 내보내기를 보강. support 전송은 자체 수동 export로 대체한다.
U29 오류 모달 · 코드·설명·도움말 신규 · F67 Read More · 18002d910 정적 코드와 원격 title/label/warning을 합성하는 모달. 자체 안정된 오류 enum과 오프라인 기본 설명, 세부 코드 복사를 설계한다.
U30 로그인 · 비밀번호·MFA·재시도 대체 · F06, F67 Please supply a valid six digit MFA code. · 18001b270 Parsec 계정 복제 대신 장치 pairing과 인증 실패/잠금/재시도·자체 키 복구 흐름으로 대체한다. MFA/비밀번호 서버 구현을 이미 완료한 기능으로 간주하지 않는다.
U31 계정 · Client-mode 재인증·로그아웃 보강 · F06, F57, F61 Authentication Required · 18002f860 수신 hosting 허용과 발신 접속 인증을 분리. 활성 세션 중 신뢰 해제/로그아웃 처리, SSO timeout의 개인용 대체 정책을 명시한다.
U32 계정 · 이메일 확인·재발송 범위 제외 · F63 Re-send · 180037eb0 Parsec 서비스 계정에 종속된 화면. 개인용 장치 pairing에서는 이메일을 수집하지 않으므로 제외 사유를 기록한다.
U33 Teams · SAML·컴퓨터 프로비저닝 범위 제외 · F63 Team Computer Key · 18001b580 기업 계정·관리자 포털·SAML 서버는 개인 장치용 범위 밖이다. 원본 UI 존재와 자체 구현 여부를 구분한다.
U34 Warp · 구독·체험판·업셀 범위 제외 · F63 Start Free Trial###%d · 180010cf0 요금제 UI는 제외하고 실제 기능의 장치 capability 표시로 대체. 원본 entitlement 동작을 변경하는 작업은 없다.
U35 Secret · staff 설정·강제 crash 내부용 · F46, F61, F63 Cohort Channel · 180012c50 직원용 채널/서비스 downtime 무시/의도적 crash는 일반 사용자 옵션으로 추가하지 않는다. 필요 시 자체 개발 build의 failure injection 시험으로만 관리한다.
U36 업데이트 · 변경 내역·loader 경고 보강 · F30, F61, F70 PARSEC HAS UPDATED! · 180030f40 변경 내역과 loader/engine 버전 불일치·자동 업데이트 중단 경고를 추가. 현재 서버 changelog 내용은 로컬 바이너리에 없다.
U37 웹 UI · 로딩 실패·재시도·fallback 신규 · F70 Revert to Old UI · 180037040 렌더러/UI 로드 실패에서 설정과 연결 종료를 조작할 수 있는 최소 native 복구 화면을 설계한다. 웹 UI를 쓰지 않아도 상태 보존·복구 요구는 유지한다.
U38 공통 UI · 메뉴·입력·클립보드·도움말 기존 대응 · F24, F37, F61 Paste · 18000a600 원본 ImGui popup ID와 사용자 문구를 구별. focus·Esc·복사/붙여넣기·정보/credits의 자체 UI 동작을 체크한다.
U39 원격 데이터 · 오류 사전·웹 UI·공지 미복원 · F63, F67, F70 /data/errors/codes.json · 18002e460 URL과 소비 경로만 로컬에서 확인했다. 서버 JSON 원문·웹 UI 번들·계정별 공지·실시간 장치명은 미복원. 실행 화면과 데이터 snapshot 검증이 추가로 필요하다.

부속 실행 파일과 복원 한계

parsecd.exe의 loader 문구 14개를 별도 추출했다. Recovery/Skel/Client lockfile·copy·signature·recursive 오류와 기기 비호환/재설치 안내가 있다. 140005470, 1400059a0의 참조와 14000af90의 MessageBoxW 경계를 통해 일반 codec 로그와 구별한다. F70/F30에 대응한다.

teams.exe의 Teams Computer Error 8개는 argument/HTTP/JSON/암호화/파일 쓰기 진단이며 일반 사용자 GUI 옵션으로 분류하지 않는다. pservice.exe에는 검사한 패턴에서 추가 사용자 화면 문구를 찾지 못했다. 이는 서비스의 모든 로그·동적 UI 부재를 증명하지 않는다.

VDD/VUSB installer에서 각각 4개 stub/로딩·무결성·임시 파일 오류 후보와 PE dialog 리소스를 확인했다. NSIS 압축 language table과 설치 페이지 전체 문구는 아직 미복원이다. 설치본 .exe의 네이티브 stub 디컴파일만으로 installer script의 모든 화면을 얻었다고 주장하지 않는다.

다음은 여전히 미확인 범위다.

  1. /data/errors/codes.json·/data/changelog/content.json 등 서버 데이터의 실제 문구와 계정/시간별 공지.
  2. 원격 웹 UI bundle 안의 별도 문구·메뉴와 그 조건. 로컬 native UI의 존재만으로 현재 실제 표시 UI 전체와 일치하지 않는다.
  3. 실행 중 생성되는 장치명·사용자명·서버 메시지·localization·format 조합과 조건별 표시 여부.
  4. 압축 설치 페이지, 미해석 data table/indirect 호출, 이전 버전과 다른 OS 전용 기능. Windows DLL에 macOS 설명이 들어 있다고 Windows 기능으로 계산하지 않는다.
  5. Disable Cursor Warp의 정확한 입력 handler 효과 등 label에서 의미를 확정할 수 없는 분기. 기능 목록에는 남기고 추가 추적 조건을 표시했다.

따라서 로컬 네이티브 UI 근거에 대한 설계 누락은 보강했지만, 모든 실행 UI의 100% 복구·동등성은 아직 확인되지 않았다. F63의 완료 조건에는 화면별 runtime 증거·서버/웹 리소스 snapshot·설치 화면 검증이 남는다. 현재 산출물은 설계와 정적 분석이며 원격 제어 앱 구현은 시작하지 않았다.