2026-09-20 · 대상 Windows Parsec 150-104a · 원본 SHA-256 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f.
기존 45개 기능 계획은 모든 설정을 포함하지 않았다. Privacy Mode가 빠졌고 Virtual Displays는 헤드리스 기능으로만 묶여 있었다. 이번 계획은 63개 기능으로 확장하고, 공개 소스뿐 아니라 로컬 디컴파일에서 복구 가능한 자체 로직을 대상으로 포함한다. 실제 원격 프로그램·driver·계정 설정은 변경하지 않았다.
전수 점검 범위
config_schema_output_json에 대응하는 0x18004e9b0는 0x180332da0의 테이블을 496바이트 간격으로 139번 순회한다. 해당 PE 데이터와 함수의 필드 접근을 대조하여 139개 등록 레코드를 추출했다. 화면별 index를 지원하는 17개 레코드는 _1, _2를 포함해 총 173개 키로 확장된다. 이 중 61개 기본 키가 디컴파일된 네이티브 설정 UI 함수 0x180012c50에서 직접 참조된다.
139개 레코드 전부를 설명·분류·담당 기능·처리 방침에 연결했다. 공식 고급 설정 문서에서 추출한 66개 키 중 현재 테이블에 없는 것은 decoder_software 1개다. 이를 문서/버전 차이 항목으로 추가하고, 단축키 13개 및 driver·권한·앱 목록의 별도 저장 항목 10개를 더해 163개 감사 항목을 HTML에 넣었다. 화면별 파생 키는 각 기본 키의 상세 보기 안에 표시한다.
이 숫자는 확인한 테이블과 대조 자료의 범위다. 설치본 실행 UI의 모든 조건, 별도 웹 UI, 다른 OS, 향후 버전, 서버가 제공하는 정책까지 완전히 열거했다는 주장은 아니다. 단축키·게임패드 매핑·허용 앱 목록은 단일 config key와 일대일 대응하지 않는다. 데이터 표에는 사용자 설정과 내부 계정/세션 metadata를 구분했다. 비밀값의 실제 저장 내용은 수집하지 않았다.
원본 기본값을 해석할 때
추출한 값은 PE 테이블의 runtime 이전 기본값과 validator 범위다. 실제 프로그램 시작 시 하드웨어·설정 계층·UI·서버 정책이 바꾼 유효값이 아니다. 예를 들어 encoder_fps의 기초 기본값은 0이며 공식 문서는 60을 설명한다. 포트의 정수 schema 상한도 UI에서 허용하는 포트 범위보다 넓다. 이 차이를 오류로 덮거나 원본 테이블 값을 자체 앱의 기본값으로 바로 채택하지 않는다.
명시적인 SettingsSpec<T>에 자체 기본값, 범위, 지원 OS/장치, 적용 시점(즉시/새 프레임/재연결/재시작), 권한, 부작용, rollback을 둔다. 설정 변경은 validate → 필요한 자원 준비 → 적용 → 상태 재조회 → commit 순서다. 실패하면 기존 설정과 실행 상태를 유지한다. 인증서·비밀키는 일반 export와 분리한다.
이번에 세분화한 설정
| 영역 | 포함한 범위 | 기능 |
|---|---|---|
| Privacy | 물리 화면 차단, 최소 가상 화면, 활성 검증, 오류 정책, 마지막 연결 잠금, 정상·crash 복구 | F48 |
| Virtual Displays | 0–3 요청, owner 세션 수명, 물리 화면 부재 fallback, 자동 추가 창, 모니터 선택·방향·해상도 | F39, F49 |
| VDD 고급 | 사용자 width/height/hz, 부모 GPU, adapter 전환 정책 | F50 |
| Client | renderer·VSync·decoder 선택·실패 격리·zero-copy·overlay·경고·화면별 설정 | F52 |
| 화질 | HEVC·4:4:4·10-bit·Constant FPS·QP·VBV·IDR·slices·bitrate | F35, F58 |
| 오디오 | 장치·RAW/Opus·bitrate·버퍼·polling·echo 제외 앱·host mute | F53 |
| 역방향 장치 | 마이크 선택/mute·virtual mic, camera 선택/stop·virtual camera 수명 | F54, F55 |
| 입력 | Immersive·단축키·detach·HID·gamepad mapping·가상 mouse·pen/tablet·USB | F51, F59, F62 |
| 호스트 정책 | hosting·이름·최대 연결·idle·exclusive input·daisy-chain·owner 종료·잠금·절전 방지 | F57 |
| 앱 허용 | Approved Apps 목록·영상과 입력 제한·클립보드 | F37, F56 |
| 네트워크 | 포트·UPnP·혼잡 정책·relay 주소/강제/선택·CGNAT·proxy | F60 |
| 앱/내부 상태 | logging·dump·crash handler·UI/channel·계정·staff/internal 처리 방침 | F46, F61 |
원본에서 Warp/Teams 항목으로 분류된 기능도 자체 앱에서는 독립 기능으로 설계한다. 원본 제품의 구독 검사나 계정 응답을 변경하는 방식으로 구현하지 않는다.
Privacy Mode 설계
원본 UI는 driver 상태, owner 연결, 가상 화면 수, privacy 활성 여부를 함께 확인한다. 설치본에는 가상 화면 수가 0일 때 Privacy가 1로 바꾼다는 UI 상태가 있으며, 가상 화면을 명시적으로 사용하면 fallback 옵션은 비활성화된다. 가상 화면 UI에는 0·1·2·3 선택을 구성하는 코드가 있다. 공식 고급 설정 문서는 0–2를 설명하지만 VDD 개요는 최대 3개를 설명한다. 자체 구현은 driver capability와 실제 시험으로 상한을 확정한다.
제안하는 자체 상태 전이는 다음과 같다. 상태 이름과 journal/watchdog은 새 설계이며 원본 심볼이 아니다.
Off → PreparingVirtual → SavingTopology → Switching → Verifying → Active
실패 → StoppingMedia → Locking → Restoring → Failed
정상 종료 → ReleasingInput → Locking → Restoring → RemovingVirtual → Off
crash/restart → RecoveryJournal 검사 → Locking → 가능한 물리 topology 복원
DisplayTopologySnapshot은 adapter/target 식별자, mode·회전·위치·주사율을 저장한다. PrivacyLease는 생성한 virtual target, 원래 topology, 승인된 owner session, 현재 generation을 가진다. layout이 바뀌면 오래된 snapshot을 무조건 덮어쓰지 않고 현재 장치 집합과 대조한다.
가상 화면 준비와 capture 가능 여부를 확인한 뒤 물리 경로를 비활성화한다. 적용 후 QueryDisplayConfig로 다시 확인해야 Active로 표시한다. Privacy를 요구한 세션에서 실패하면 내용을 전송한 채 성공처럼 계속하지 않는다. 비활성화·접속 끊김·충돌·hotplug에 대한 표시와 복구 경로가 필요하다. 로컬 복구 수단과 watchdog은 화면이 영구적으로 꺼진 채 남는 것을 막는다.
원본 종료 함수는 저장한 topology를 적용한 뒤 조건부 LockWorkStation과 가상 장치 정리를 수행한다. 자체 설계에서는 잠금 완료를 먼저 확인하고 물리 출력을 복원하여 노출 구간을 줄이는 것을 목표로 한다. 이는 관찰한 원본 순서와 구분한 개선 제안이다. secure desktop 처리와 watchdog의 실제 권한·동작은 구현 시험으로 검증한다.
복구할 코드와 확인 수준
| 근거 함수 / 자료 | 복구 가능한 내용 | 현재 확인 수준·남은 작업 |
|---|---|---|
18004e9b0 + 180332da0 table |
key/type, 기초 default, validator bounds, per-stream 파생 규칙 | 139개 실제 추출. runtime override는 미실행 |
180012c50 |
네이티브 UI의 선택지·비활성 조건·설정 writer 호출 | 직접 읽음. 타입과 하드웨어/계정 조건 전체는 추가 검증 |
180050350, 1800511e0, 180052b80 |
client/host config 구조와 읽기/쓰기 필드 대응 | 함수 추출. 원래 struct 이름과 layout 계약 추가 복구 |
1800605c0, 180060870 |
topology snapshot, 크기·회전·주사율 적용 | Query/SetDisplayConfig 호출과 sentinel 분기 확인 |
1800bc4d0, 1800bc670 |
virtual adapter 식별과 가상 경로 topology 구성·재시도 | 코드 확인. magic flags는 SDK 상수와 대조해야 함 |
1800bc9b0 |
로그인 상태·가상 화면 준비·Privacy 전이·실패 처리 | worker 루프·callback·오류 상태 확인. crash 안전성 입증 아님 |
1800a6b70 |
마지막 연결 종료의 topology 복구·잠금·VDD/mouse/tablet 정리 | 직접 호출 순서 확인. 필드 의미 일부 미확정 |
18003d430, 18003cfa0, 18003beb0 |
BUD 분할/재조립·nonce/tag 전달·ring 경계 | 이전 분석의 근거. 혼잡 제어·wire 전체 복원 아님 |
18009b410, SCTP/DTLS 함수군 |
backend 선택과 읽기/쓰기/종료 계약 | 이전 분석에서 호출 관계 확인. 새 기본 backend는 QUIC |
1800d83a0, Opus wrapper |
audio queue·underrun·codec 입력 형태 | 공개 소스 일치 부분과 설치본 추가 분기 분리 |
VDD MM_*, VUSB, wcam 경계 |
device 열기·수명·오류 코드·콜백 계약 | export·호출 단서 기반. driver 전체 ABI·서명·소스는 미복원 |
이번에 추가 추출한 11개 함수의 의사 코드는 research/settings에 있다. 이전 전송·오디오 근거는 검토 함수 목록에서 이어진다.
복구 작업대는 원본 함수별 Evidence → Typed model → Recovered implementation → Behavioral fixtures → Integration 상태를 관리한다. 원본 함수 이름을 모르는 경우 주소를 그대로 보존한다. 정적 타입 추정, 컴파일 성공, 실제 동작 일치를 별개의 결과로 기록한다. 단순히 Ghidra C를 컴파일하기 위해 포인터를 정수로 강제 변환하는 방식은 완료 기준이 아니다.
공개 코드와 달리 전용 코드의 복구 가능성이 곧 이용 허락을 뜻하지는 않는다. 이번 계획은 이를 기술적 복구 대상으로 포함하고 출처와 이용 조건을 별도 기록한다. 기존의 “디컴파일은 분석 자료로만 사용” 제한은 “검증한 복구 C/Rust 로직의 통합 후보까지 포함”으로 바꿨다. 비공개 목적 자체로 권한이 자동 확정됐다고 표시하지 않는다.
검증과 재현
python design/extract_settings_evidence.py
python design/make_plan_data.py
python design/build_plan.py
node design/plan.test.cjs --write-brief
PE hash가 다르면 추출기는 중단한다. 특정 150-104a 테이블 주소를 다른 버전에 적용하지 않는다. documented-setting-keys.json은 공식 문서에서 확인한 식별자 목록이고, 전체 도움말 복사본은 아니다.
참고: 고급 설정, Windows 앱, Privacy, VDD 고급 설정, SendSAS 조건.