notParsec / 문서전체 문서

생성 코드·템플릿

settings_catalog.py

design/settings_catalog.py

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

"""Join recovered configuration records with explicit design disposition."""
import json
from pathlib import Path
ROOT=Path(__file__).resolve().parent

def catalogue():
    ev=json.loads((ROOT.parent/'analysis/parsec/research/settings/settings-evidence.json').read_text(encoding='utf-8'))
    specs={}
    def group(category,feature,rows,handling='구현'):
        for row in rows.strip().splitlines():
            key,label,desc=row.split('|',2)
            specs[key]=dict(label=label,description=desc,category=category,feature=feature,handling=handling)
    group('클라이언트 영상','F52','''client_renderer|렌더러|D3D11 기본, D3D12/Vulkan은 별도 지원 검증.
client_vsync|VSync|화면 찢어짐과 표시 대기 시간의 균형을 조절.
client_windowed|창 모드|전체 화면 또는 창으로 연결.
client_overlay|오버레이|세션 메뉴 표시 여부.
client_overlay_warnings|성능 경고|네트워크·decode 부하 경고 표시.
client_overlay_button_x|오버레이 X 위치|화면 크기·DPI 변경에도 유효 위치로 보정.
client_overlay_button_y|오버레이 Y 위치|화면 크기·DPI 변경에도 유효 위치로 보정.
client_decoder_index|디코더 선택|장치별 decoder 목록과 software 진단 경로.
client_bad_decoders|실패 디코더 격리|실패한 decoder의 재시도·목록 초기화.
client_zero_copy|GPU 출력 유지|decode texture를 GPU에서 표시하는 경로 진단.
client_resolution_x|클라이언트 요청 가로 해상도|화면별 연결 요청 크기. host 해상도 변경 정책과 구분.
client_resolution_y|클라이언트 요청 세로 해상도|화면별 연결 요청 크기. host 해상도 변경 정책과 구분.
client_png_cursor|커서 이미지 경로|커서 전송 형식 후보; 구체적 협상은 호출부 복구 후 확정.
client_soft_button|소프트 버튼|내부 또는 플랫폼별 버튼 동작으로 추정; 동작 확인 후 노출.
client_poll|클라이언트 polling|단위·동작을 호출부에서 추가 확인할 고급 옵션.''')
    group('고급 화질','F58','''client_decoder_h265|H.265 선호|지원 조합에서 HEVC를 협상하고 fallback 표시.
client_decoder_444|4:4:4 선호|chroma subsampling과 decoder 지원을 별도 협상.
client_decoder_10bit|10-bit|높은 bit depth를 협상하며 HDR 여부와 구분.
encoder_bitrate|대역폭 상한|encoder와 전체 연결의 전송 예산.
encoder_fps|영상 FPS|캡처·encode pacing과 화면 주사율 정책을 연결.
host_full_fps|Constant FPS|정적인 데스크톱에서도 정해진 cadence로 프레임 생성.
encoder_min_qp|품질·최소 QP|낮은 지연/균형/높은 품질 정책과 codec별 QP 매핑.
encoder_max_qp|최대 QP|codec별 유효 범위와 화질 하한 검사.
encoder_vbv_max|VBV 최대|전송 버퍼·rate-control 상한; 단위는 backend에서 확정.
encoder_vbv_initial|VBV 초기값|초기 rate-control 버퍼 정책.
encoder_vbv_multi|VBV 배수|복구 후 의미와 backend 변환을 검증할 고급 옵션.
host_encoder_min_bitrate|최소 bitrate|동적 bitrate 하한과 화질 유지 정책.
encoder_idr_interval|IDR 간격|주기적 keyframe과 손실 복구 요청의 상호작용.
encoder_slices|인코더 slice 수|codec 지원·처리 비용·지연을 측정해 제한.
host_software_encode|소프트웨어 인코딩|명시적으로 선택하는 호환성 경로와 CPU 부하 진단.
encoder_allow_high_res|고해상도 허용|encoder·decoder·표시 장치의 한도와 함께 검증.''')
    group('디스플레이','F49','''client_automatic_displays|추가 화면 자동 열기|사용 가능한 원격 화면을 클라이언트 창으로 자동 표시.
server_resolution_x|호스트 가로 해상도|유지/클라이언트 맞춤/명시 크기를 구분.
server_resolution_y|호스트 세로 해상도|유지/클라이언트 맞춤/명시 크기를 구분.
host_output|캡처 모니터|안정적인 display ID와 adapter로 대상 선택.
host_rotated|화면 방향|회전과 좌표·DPI 변환을 함께 적용.
host_virtual_monitors|Virtual Displays 수|0–3 요청, owner 세션 수명, driver capability 검증.
host_virtual_monitor_fallback|가상 화면 fallback|물리 출력이 없을 때 단일 가상 화면을 제공.
host_aspect_16x10|16:10 비율 처리|실제 변환 경로 확인 후 자체 aspect 정책으로 연결.
host_frame_flip|프레임 뒤집기|방향 보정 인수의 축·적용 시점 추가 복구.
host_capture_timeout|캡처 timeout|무변화 화면과 실제 캡처 실패를 구분하는 대기 한도.''')
    group('프라이버시','F48','''host_privacy_mode|Privacy Mode|물리 출력 비활성, 검증된 가상 출력으로 작업, 종료 잠금·복구.
host_privacy_kick|Privacy 실패/접속 정책|이름만으로 기본 동작을 단정하지 않고 세션 호출부의 분기를 복구.''')
    group('호스트 정책','F57','''app_host|Hosting Enabled|새 연결 수락과 현재 세션 처리 정책.
app_client|클라이언트 역할|연결을 시작하는 기능의 허용 여부.
host_name|호스트 이름|사용자 지정 이름과 OS 이름 fallback.
host_idle_kick_time|Idle Kick Timer|입력 기준 idle 시간과 0=비활성 의미를 검증.
host_lock_desktop|종료 후 잠금|마지막 연결 종료 시 잠금; Privacy의 강제 정책과 구분.
host_protective_mode|Owner 종료 시 guest 퇴장|owner/guest 세션을 구분해 종료 정책 적용.
host_exclusive_input|독점 입력|동시에 입력 가능한 client와 로컬 우선권 관리.
host_exclusive_timeout|독점 입력 timeout|입력 소유권을 넘기는 시간 정책.
host_prevent_sleep|절전 방지|hosting 또는 active-session 수명에 맞춰 전원 요청 해제.
server_max_clients|최대 접속 수|첫 버전 1, 확장 시 권한·미디어 예산 함께 제한.
app_daisychaining|Daisy-Chaining|host/client 동시 역할 허용을 owner/guest별로 결정.''')
    group('앱 허용·전송','F56','''host_require_whitelist|Approved Apps 사용|허용되지 않은 앱의 화면과 입력을 함께 차단.''')
    group('앱 허용·전송','F37','''app_copy_paste|클립보드|세션별 허용·방향·크기 제한과 echo 방지.''')
    group('키보드·단축키','F51','''client_immersive|Immersive Mode|끔/키보드/마우스/둘 다; 탈출 키 제공.
client_hid_compatibility|HID 호환성 옵션|세션 메뉴의 장치 호환성 선택과 실제 입력 경로 연결.
client_macos_key_swap|Command/Ctrl 교환|macOS 상호 연결용; Windows 간 연결에는 비활성.
app_hid_keyboard|macOS HID 키보드|원본의 플랫폼 한정 옵션; Windows에서는 대응 경로 설명.''')
    specs['app_hid_keyboard']['handling']='플랫폼 제외'
    specs['client_macos_key_swap']['handling']='플랫폼 제외'
    group('오디오','F53','''host_audio_id|캡처 오디오 장치|장치 ID와 기본 장치 추적.
host_audio_cancel|Echo Cancelling|앱별 제외·기존/신규 방식의 효과를 구분.
echo_app_selection|Echo 제외 앱|오디오에서 제외할 프로세스 지정.
network_raw_audio|오디오 코덱|Opus 또는 협상된 RAW PCM.
client_audio_min_buffer_ms|오디오 최소 버퍼|재생 지연 하한; 최대값과 관계 검증.
client_audio_max_buffer_ms|오디오 최대 버퍼|jitter 허용 상한과 underrun 복구.
client_audio_poll_rate|재생 polling|단위·thread 동작 확인 후 노출.
host_audio_poll_rate|캡처 polling|단위·thread 동작 확인 후 노출.
host_audio_bitrate|오디오 bitrate|Opus 설정과 실제 네트워크 예산.
server_admin_mute|호스트 로컬 음소거|원격 오디오 전송과 로컬 재생을 구분하고 종료 시 복원.''')
    group('마이크','F54','''client_mic_passthrough|마이크 전달|client 수집과 host 가상 입력이 모두 준비될 때 시작.
client_mic_id|마이크 선택|기본/특정 장치 선택과 분리 시 처리.
client_mic_muted|마이크 음소거|세션 중 mute 상태를 전송·표시.
host_virtual_microphone|가상 마이크|host 입력 장치 수명과 세션 연결.''')
    group('카메라','F55','''client_wcam_passthrough|카메라 전달|client의 선택 카메라를 host로 전달.
client_wcam_id|카메라 선택|장치 ID와 format 협상.
client_wcam_stopped|카메라 중지|세션 중 수집과 전송을 중지.
host_virtual_camera|가상 카메라|끔/세션/지속 장치 정책과 Windows 지원 확인.''')
    group('게임패드·HID','F59','''host_gamepad_mode|가상 패드 backend|지원되는 driver와 fallback을 명시적으로 선택.
host_gamepad_type|가상 패드 종류|Xbox/DS4/DualSense 지원 기능을 구분.
host_virtual_mouse|가상 마우스|물리 마우스 없는 host의 cursor 유지용 장치.''')
    group('펜·USB','F62','''client_enhanced_pen|Enhanced Pen|pressure/tilt/rotation 등 Windows Ink 입력.
host_virtual_tablet|Virtual Tablet|Ink 주입과 구분되는 가상 태블릿 장치.
client_usb_passthrough|USB/Yubikey 전달|지원 장치와 libusb backend의 명시적 선택.
client_usb_passthrough_id|USB 장치 선택|선택한 장치의 ID로 전달 범위 고정.
host_virtual_usb_passthrough|가상 USB 보안키|client가 제공하는 실제 장치와 연결된 host 가상 장치.
host_virtual_usb_tracing|USB 진단 trace|장치 전달 문제를 추적하며 민감 payload는 기록하지 않음.
app_filter_usb|USB 필터|원본의 정확한 필터 의미는 추가 복구 후 노출.''')
    group('네트워크','F60','''network_client_start_port|Client UDP 포트|자동 또는 명시 포트; 바인딩 실패·충돌 처리.
network_server_start_port|Host UDP 포트|listener 주소·포트와 세션 자원 관리.
network_upnp|UPnP|사용자 선택한 router mapping과 종료 정리.
network_cg_level|혼잡 알고리즘|원본 알고리즘과 자체 QUIC 혼잡 제어를 구분.
app_stun_address|Host relay 후보|이름은 STUN이나 공식 문서에서는 relay 주소 용도로 설명; 자체 서버 schema로 대체.
app_client_stun_address|Client relay 후보|다중 주소 목록과 실패 순서.
app_force_relay|Relay 강제|직접 연결/인터넷만 relay/전체 relay 정책.
network_fast_relay_ping|Relay 선택 방식|지연 측정 기반 또는 순서/랜덤 선택.
network_rfc6598_is_local|CGNAT 로컬 판정|공유 주소 공간 처리 정책을 실제 topology와 검증.
network_protocol|원본 transport selector|BUD/SCTP 선택 의미 복구; 자체 QUIC과 wire 호환으로 취급하지 않음.
network_video_container|원본 영상 container|codec 데이터 포장·수신 경계 추가 복구.
app_proxy|Proxy 모드|제어 연결의 proxy 사용 여부.
app_proxy_address|Proxy 주소|제어 서버 요청용 endpoint.
app_proxy_path|Proxy 경로|proxy 연결 형식의 경로 필드.
app_proxy_port|Proxy 포트|범위·미설정·접속 실패 처리.
app_proxy_scheme|Proxy scheme|지원 scheme 검사와 인증 정보 분리.''')
    group('앱·진단','F61','''app_log_level|로그 수준|진단 정보량과 성능 비용.
app_write_minidump|Crash dump|크기·보관·민감 정보 처리 정책.
app_no_crashhandler|Crash handler|진단 중 handler 선택; 정상 사용에는 복구 경로 유지.
app_debug|Debug console|디버그 출력과 일반 로그를 구분.
app_silent|Silent 실행|창 표시 없는 실행과 명확한 연결 표시 정책.
client_web_ui|Web UI 선택|자체 egui UI와 대안 비교; Parsec 웹 UI 배포물을 재사용하는 설정 아님.
app_visibility|앱 표시 범위|UI 표시·노출 의미 추가 복구.
app_filter|앱 목록 필터|필터의 실제 적용 대상 추가 확인.
app_friends|Friends 메뉴|자체 trusted devices/권한 목록으로 대체.
app_watermark|워터마크|세션 식별 정보를 표시하는 자체 옵션.''')
    internal='''app_changelog_ver|Changelog 상태|버전별 안내 표시 상태.
app_flags|앱 내부 flags|bit 의미를 복구할 내부 상태, 직접 사용자 옵션으로 노출하지 않음.
app_run_level|앱 실행 수준|프로세스 수명/권한 모델에 대응하는 내부 값.
app_host_peer_id|Host peer 식별자|자체 장치 식별자로 대체.
app_saml_team_id|SAML 조직 ID|Parsec 조직 계정 연결용; 개인 앱의 필수 설정 아님.
session_id|세션 ID|runtime이 생성하는 식별자; 사용자가 설정하는 값 아님.
app_environment|Backend 환경|Parsec 운영 환경 선택을 자체 서비스 설정으로 대체.
ws_host|WebSocket endpoint|자체 rendezvous 선택 시 대체.
app_channel|배포 채널|원본 staff/업데이트 선택 상태; 자체 배포 정책으로 대체.
app_ui_channel|UI 배포 채널|원본 UI 배포 상태; 자체 UI 버전으로 대체.
app_block_hash|내부 hash 필터|정확한 의미 추가 복구, 제품에 그대로 적용하지 않음.
app_custom_address|사용자 지정 서버|원본 주소 동작 추가 복구, 자체 endpoint schema로 대체.
ws_secret|WebSocket 비밀값|runtime credential 필드명만 기록; 기존 값은 수집하지 않음.
ws_desc|세션 설명|원본 서버 metadata; 자체 모델로 대체.
ws_gameID|게임 metadata|원본 서버 metadata; 개인용 기능과 분리.
ws_public|공개 목록 상태|개인 앱은 공개 listing을 기본 제공하지 않음.
connection_name|연결 이름|세션 metadata.
host_secret|호스트 비밀값|runtime credential 필드명만 기록; 기존 값은 수집하지 않음.
peer_id|Peer ID|자체 장치 식별자로 대체.
ignore_downtime|서버 중단 처리|원본 서비스 상태 처리 로직의 분석 항목.
downtime_poll_is_dynamic|중단 polling 방식|원본 서버 polling 정책; 자체 서비스에 필요할 때 재설계.
downtime_poll_period|중단 polling 주기|원본 서버 상태 polling 주기.
app_can_logout|로그아웃 허용|원본 계정/관리 정책의 UI 상태.
app_new_ui_prompt|새 UI 안내|안내 상태이며 원격 엔진 필수 옵션 아님.
app_alt_fs|대체 저장 경로|정확한 적용 범위를 복구할 내부 설정.'''
    group('내부·계정','F46',internal,'내부/대체')
    records=[]
    for r in ev['registry']:
        spec=specs.get(r['key'],dict(label=r['key'],description='등록된 키지만 의미를 추가 복구해야 함.',category='미확정',feature='F46',handling='미확정'))
        records.append(dict(id=r['key'],**spec,origin='복구 스키마',evidence='UI 호출 확인' if r['uiReference'] else '등록 테이블 확인',
                            type=r['type'],perStream=r['perStream'],variants=r['variants'],address=r['tableVA'],
                            references=r['references'],documented=any(r['key'] in w['configKeys'] for w in ev['web'])))
    existing={r['id'] for r in records}
    for k in sorted(set(k for w in ev['web'] for k in w['configKeys'])-existing):
        records.append(dict(id=k,label='문서의 소프트웨어 decoder 옵션' if k=='decoder_software' else k,
            description='공식 고급 옵션 문서에 있지만 150-104a의 등록 테이블에는 없음. client_decoder_index와의 alias/migration 관계를 검증.',
            category='문서·버전 차이',feature='F52',handling='별도 검증',origin='공식 문서',evidence='문서 확인·현재 스키마 부재',type='미확정',perStream=False,variants=[],references=[],documented=True))
    extras=[
      ('vdd.custom_modes','사용자 해상도 목록','width/height/hz와 목록 상한을 검증. 원본 문서는 5개 슬롯을 설명.','F50','VDD 고급'),
      ('vdd.parent_gpu','부모 GPU 선택','vendor/LUID 기준으로 GPU 선택과 재연결·rollback.','F50','VDD 고급'),
      ('vdd.adapter_change','부모 GPU 변경 허용','고정/자동 adapter 전환을 자체 driver 정책으로 정의.','F50','VDD 고급'),
      ('approved.list','Approved Apps 목록','허용 process/window 목록 저장·삭제·재검증.','F56','앱 허용·전송'),
      ('gamepad.mapping','버튼·축 매핑','장치별 Map/Unmap/Reset/Raw Data를 각각 제공.','F59','게임패드·HID'),
      ('permissions.keyboard','키보드 권한','세션과 신뢰 장치별 허용·회수.','F57','호스트 정책'),
      ('permissions.mouse','마우스 권한','세션과 신뢰 장치별 허용·회수.','F57','호스트 정책'),
      ('permissions.gamepad','패드 권한','세션과 신뢰 장치별 허용·회수.','F57','호스트 정책'),
      ('permissions.unattended','승인 없는 신뢰 장치 접속','명시적으로 등록한 개인 장치의 무인 접속 정책.','F57','호스트 정책'),
      ('account.management','계정·로그아웃·구독','Parsec 웹 계정 링크 대신 로컬 신뢰 장치·키 관리로 대체.','F61','내부·계정'),
    ]
    actions=[('disconnect','연결 종료'),('menu','세션 메뉴'),('chat','채팅'),('switch_display','화면 전환'),('add_screen','화면 추가'),('enhanced_pen','Pen 전환'),('sas','Ctrl+Alt+Del'),('window','창/전체 화면'),('immersive','Immersive 전환'),('ignore','단축키 전달 제외'),('detach_mouse','마우스 탈출'),('accept_all','대기 연결 승인'),('kick_all','연결 모두 종료')]
    extras += [('hotkey.'+k,label,'키 조합 지정·해제·충돌 검사. 동작 자체의 권한·지원 기능을 확인.','F51','키보드·단축키') for k,label in actions]
    for key,label,desc,feature,cat in extras:
        records.append(dict(id=key,label=label,description=desc,category=cat,feature=feature,handling='내부/대체' if cat=='내부·계정' else '구현',
                            origin='문서·UI 별도 저장',evidence='설정 탭/driver 문서 대조',type='자체 schema 설계',perStream=False,variants=[],references=[],documented=True))
    missing=[r['id'] for r in records if r['category']=='미확정']
    assert not missing,missing
    result=dict(schemaVersion=1,registryCount=len(ev['registry']),expandedRegistryCount=sum(len(r['variants']) for r in ev['registry']),
                uiReferencedCount=sum(r['uiReference'] for r in ev['registry']),documentedKeyCount=len(ev['web'][0]['configKeys']),
                settings=records,sources=ev['web'],
                coverage='150-104a의 139개 등록 레코드 전수 매핑. 실행 UI·웹 UI·다른 OS/버전의 모든 옵션을 완전 검증한 것은 아님.')
    (ROOT/'settings-catalog.json').write_text(json.dumps(result,ensure_ascii=False,indent=2),encoding='utf-8')
    return result

if __name__=='__main__':
    c=catalogue();print(len(c['settings']),'catalogue rows;',c['registryCount'],'registry records;',c['expandedRegistryCount'],'expanded keys')