# UI 텍스트 복구와 설계 누락 재검토 2026-09-21 정정: 아래는 원본 문자열·함수와 당시 설계 대조 이력이다. 과거 '대체/범위 제외/내부용'은 사용자의 예외 승인을 뜻하지 않는다. 현재 판정은 [Parsec 재현 계약](PARSEC_PARITY.ko.md)과 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 대응표에 기록한다. ## 확인 범위와 재현 - 대상 DLL SHA-256: `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f` - 코어의 전체 문자열 인덱스 **13,557개**, Ghidra 문자열 참조 **12,886건**을 입력으로 사용했다. - UI 컴포넌트 주소 범위, 확인한 화면 함수, 인접 문구·선택값 테이블, 짧은 DAT 포인터 문자열을 모아 **993개 후보**를 보존했다. **907개 함수 참조 / 26개 데이터 참조 / 60개 문자열만**으로 구분한다. - 후보에는 설정 키 85개, URL/API 39개, 내부 widget ID 9개, 진단·구현 22개, 서식·기호 47개, 화면 문구 후보 791개가 있다. 이는 분류 규칙에 따른 후보 수이며, 791개의 실제 표시를 검증한 것은 아니다. - 긴 tooltip 중간에서 시작한 **중복 조각 34개**는 `fragmentOf`로 표시한다. 단순 문자열 수를 고유 UI 문구 수로 제시하지 않는다. - 관련 **115개 함수**를 원본 파일·줄 번호·callee와 연결해 별도 C 파일로 보존하고, **39개 화면 흐름**을 설계와 대조했다. 모든 115개 함수의 모든 분기를 정밀 검증했다는 뜻은 아니다. - 부속 바이너리의 기존 문자열 report **18개 / 69,222개 레코드**도 인덱스화했다. 복사본·이전 버전 중복을 포함한 검사량이다. loader, service, Teams CLI, VDD/VUSB installer의 후보를 별도로 분류했다. - PE **18개**의 RT_STRING/RT_DIALOG를 검사했다. dialog에서 추출한 41개 snippet에는 글꼴명·control class·우연한 ASCII 조각도 포함된다. 설치 페이지 문구 41개를 복원했다는 뜻이 아니다. 재현은 워크스페이스 루트에서 다음 순서로 실행한다. `pefile`은 기존 설정 추출과 동일한 의존성이다. 원본 실행 파일은 실행하지 않는다. ```powershell 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](../analysis/parsec/research/ui/ui-texts.tsv). 전체 참조·함수 위치·부속 바이너리·리소스: [ui-text-evidence.json](../analysis/parsec/research/ui/ui-text-evidence.json). 화면별 판정: [ui-text-catalog.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 의사 코드 폴더](../analysis/parsec/research/ui/functions)에 있다. 원본 함수/변수 이름·클래스 구조·완전한 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·설치 화면 검증이 남는다. 현재 산출물은 설계와 정적 분석이며 원격 제어 앱 구현은 시작하지 않았다.