notParsec / 문서전체 문서

설명·설계 문서

Windows 설치·트레이·커서·업데이트 정리

design/WINDOWS_INSTALL_TRAY_UPDATES.ko.md

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

이 문서의 목차

2026-09-26 · Windows Parsec 150-104a 대조 · 독립 Rust 구현

이번 변경의 범위

항목 코드에 반영한 동작 남은 확인/구현
Windows 커서 중복 DXGI의 별도 포인터 여부와 OS 커서 상태를 프레임에 연결한다. 영상에 커서가 포함된 프레임에서만 Windows 뷰어의 로컬 커서를 숨긴다. 두 Windows PC의 실제 GPU·커서 모양·다중 모니터 대조
EXE 설치 받은 EXE에서 설치 위치를 선택한다. 기본값은 %LOCALAPPDATA%\Programs\notParsec. 같은 EXE를 복사하고 시작 메뉴·Windows 설치된 앱·제거 명령을 등록한다. Windows 실제 설치/제거/경로 변경·재로그인 시험
자동 시작 설치 옵션과 트레이 체크 메뉴로 현재 Windows 사용자의 로그인 시 숨김 실행을 등록한다. 로그인 전 부팅 서비스와는 다르다.
트레이 좌클릭으로 창 열기, 자동 시작 체크, 재시작, 종료. 창의 X는 뷰어 연결을 닫고 접속 대기를 트레이에 남긴다. Explorer 재시작 시 아이콘을 재등록한다. Reset gamepads는 원본 항목을 비활성으로 표시한다. 게임패드 기능 구현은 별도다.
앱 업데이트 준비 중 접속 다운로드·준비 화면에서도 접속 대기를 계속한다. 제어 중에는 교체/종료를 보류한다. 유휴 교체 예약과 새 접속 수락을 원자적으로 조정한다. EXE 교체 자체는 프로세스 재시작을 수반한다. 활성 세션 무중단 인계는 구현하지 않았다.
임시 파일 정리 실행 확인·복구 상태·파일 잠금을 검사하고 보조 EXE 종료 뒤 정리한다. 실패 시 재시도한다. Windows 실제 잠금/백신 간섭·전원 중단 재현
로그인·UAC·Windows 업데이트 화면 접근 이번 일반 사용자 앱/트레이 구현의 지원 범위가 아니다. 관리자 설치 서비스·활성 세션 에이전트·보안 데스크톱 전환 필요. F40은 완료로 표시하지 않는다.

설치 방법과 앱 인식

관리 웹의 Windows **다운로드 (.exe)**로 받은 notparsec.exe를 실행한다. 설치 위치와 로그인 시 자동 시작을 확인한 다음 설치 후 실행을 누른다. 설치된 앱은 시작 메뉴에서 실행한다. 이전 앱이 실행 중이면 먼저 종료한다. 기존 버전에 트레이가 없으면 앱 창을 닫으면 된다.

연결/호스팅을 별도 사용자 앱으로 나누지 않는다. 다운로드·설치본·업데이트 대상은 같은 빌드의 통합 EXE다. 설치된 파일을 실행하면 앱이 열리며, 다운로드 위치에서 실행하면 설치 화면이 열린다. 내부 업데이트 실행과 명시적 gui 명령은 설치 화면을 거치지 않는다. 원래 기기 등록·인증서·호스팅 비밀번호·환경설정은 %LOCALAPPDATA%\notParsec\desktop에 남겨 둔다.

Windows의 사용자별 시작 메뉴 바로가기와 HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\notParsec을 등록한다. EXE에는 앱 아이콘과 제품/파일 정보 리소스도 포함한다. 이는 Windows 설치 목록 등록이며 Microsoft Store 등록이나 Windows Authenticode 인증서 서명 완료를 의미하지 않는다. Mac 고정 인증서 작업과 구별한다.

현재 사용자를 위한 설치이므로 Program Files에 SYSTEM 서비스를 설치했다고 설명하지 않는다. 제거는 Windows의 설정 → 앱 → 설치된 앱 → notParsec에서 수행한다. 기기 등록과 사용자 설정은 보존한다. 재시작·종료는 트레이 메뉴에 있으며 접속받는 중에는 실행을 보류한다.

커서가 두 개 보이는 이유와 처리

Windows Desktop Duplication은 커서를 화면 픽셀에 포함해 주는 경우와 별도 포인터로 제공하는 경우가 있다. 수신 앱이 언제나 로컬 커서를 표시하면 전자에서 두 개가 보일 수 있다. 반대로 모든 Windows 연결에서 로컬 커서를 숨기면 후자에서 커서가 사라진다.

캡처에서 LastMouseUpdateTime이 0이 아닐 때만 PointerPosition.Visible을 갱신한다. 값이 0이면 이전 포인터 상태를 보존한다. OS 커서가 보이고 선택한 출력 안에 있으면서 별도 포인터가 아닐 때 프레임의 cursor_embedded를 설정한다. 인코더/디코더의 timestamp별 기록에 연결해 프레임과 표시 정책이 엇갈리지 않게 한다. 메뉴가 입력을 소유하거나 포인터가 영상 밖에 있으면 로컬 커서는 정상 표시한다. Microsoft DXGI 프레임 정보, Microsoft Desktop Duplication.

자체 프로토콜 /11의 비디오 플래그에 이 표시를 추가했다. TLS 협상은 /11, /10 순서로 지원하며 /10 수신자에게는 새 플래그를 보내지 않는다. 따라서 이전 /10 Mac과도 기존 방식으로 접속할 수 있다. 구버전 Windows 호스트에서 오는 영상에는 표시 정보가 없으므로 중복 수정 검증에는 양쪽 Windows 앱 업데이트가 필요하다. Parsec BUD 패킷 형식을 복원한 것이 아니다.

Parsec 코어 FUN_1800ddfa0의 app_set_rgba_cursor·hotspot·CreateIconIndirect는 별도 커서 객체를 만드는 근거다. 이번 수정은 중복 표시를 막는 것이며 원본의 커서 shape/hotspot 전송, 로컬 예측, 특수 커서 전체를 완성한 것은 아니다.

업데이트 파일 수명과 복구 보호

실행파일 옆에 파일을 계속 쌓던 방식에서, 설치 폴더의 updates/<설치 경로 식별값>/을 사용하도록 바꿨다. 다운로드, 작업 계획, 보조 EXE, 이전 EXE, 실행 확인, 시작/오류 기록을 이 폴더에 둔다. 설치 파일과 같은 볼륨에 두어 교체와 복구에 원자적인 파일 이름 변경을 사용할 수 있게 한다. 단순 숨김 처리가 아니다.

  1. 다운로드 시작부터 적용 준비가 끝날 때까지 active.lock 파일 잠금을 소유한다. 다른 앱 인스턴스·정리 작업은 이 잠금을 획득하지 못하면 작업하지 않는다.
  2. 크기와 SHA-256을 확인한 뒤 교체 계획을 기록하고 별도 복사한 동일 EXE를 업데이트 보조 모드로 실행한다.
  3. 보조 프로그램은 기존 앱 종료를 기다린 후 잠금을 획득하고 대상·경로·해시·빌드를 재검증한다. 이전 파일은 복구용으로 남긴다.
  4. 새 앱이 실제 첫 D3D11 화면 처리를 끝내야 빌드 번호가 포함된 실행 확인을 기록한다. 제한 시간 안에 확인이 없거나 프로세스가 실패하면 이전 EXE를 복구한다.
  5. 정상 실행 확인 또는 완료된 복구가 확인된 작업만 정리한다. 실행 중인 보조 EXE를 삭제할 수 없으면 작업 계획을 남긴다. 새 앱의 지연 정리가 보조 종료 후 다시 시도한다.
  6. 재시도는 시작 직후, 2초 뒤, 추가 10초 뒤, 추가 30초 뒤다. 잠금/백신 간섭 때문에 계속 실패하면 다음 앱 시작에서 다시 시도한다. 손상된 계획·미확인 복구 파일은 임의로 삭제하지 않는다.
  7. 계획에 속하지 않는 오래된 다운로드는 7일 보존한다. 예전 버전의 실행파일 옆 계획은 최소 24시간이 지난 뒤 실행 확인/복구 상태를 검사한다. 오래된 보조 EXE도 대응하는 계획·백업이 없고 7일이 지나야 정리한다. 다른 설치 경로의 계획에 속한 파일은 보호한다.

실행 확인 없이 새 EXE가 있다는 사실만으로 백업을 삭제하지 않는다. 다음 실행에서도 복구용 백업과 대상의 관계가 불명확하면 보존한다. 정상 실행한 더 최신 빌드가 같은 경로에 있으면 이전 작업은 대체된 것으로 판단할 수 있다. 일정한 크기의 상태/오류 기록과 잠금 파일은 진단을 위해 남을 수 있다.

기존 notparsec.update-failed.json 형식은 읽을 수 있도록 유지한다. 새 버전은 전용 폴더에 기록한다. 알 수 없는 파일을 이름 패턴만으로 일괄 제거하지 않는다.

원본 Parsec 대조

기준 Windows Parsec 150-104a 코어 SHA-256은 8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f다. 보관 자료는 디컴파일 의사 코드이며 원본 소스 전체가 아니다.

원본 근거 확인한 책임/동작 notParsec 반영과 차이
FUN_180094b00 → FUN_1800db6d0 Reset gamepads / Run when my computer starts / Restart / 종료 ID 4 등록 순서·자동 시작 체크·재시작/종료 반영. 게임패드 초기화는 미구현
FUN_1800de230 Shell_NotifyIconW 연계, 좌/우 클릭, 팝업 메뉴 Windows 알림 영역·클릭·메뉴·재등록을 독립 Rust로 작성
FUN_18008d1c0 종료 ID 4의 활성 호스팅 거부 활성 접속 중 종료/재시작을 보류. GUI와 호스트 수명이 아직 같은 프로세스인 차이 때문에 재시작도 보류
FUN_1800ddfa0 RGBA 커서·hotspot·CreateIconIndirect 중복 표시만 교정. 전체 원본 커서 프로토콜과는 차이가 남음
pservice.exe!FUN_140002140 활성 콘솔 세션, 토큰/환경, CreateProcessAsUserW, winsta0\default 서비스 책임 분석 근거. 이번 로그인 자동 시작과 동일하다고 표시하지 않음

서비스 바이너리 SHA-256: 566f3dfd079b1c3129aae68645f0005a869544078aa86b0a14864a36ad7aa9cf. 트레이 기반 공개 소스인 analysis/parsec/sources/libmatoya/src/windows/appw.c도 참고했으나 보관 Windows 코어와 같은 버전의 원본 소스라고 간주하지 않는다.

현재 공식 Parsec 설명도 사용자별/컴퓨터별 설치와 서비스의 관리자 프로그램·잠금 화면·UAC 접근 역할을 구별한다. 이 문서는 현재 자료이므로 150-104a 바이너리 근거와 분리한다. Parsec Windows 설치와 서비스 설명.

로그인 전·UAC·Windows 업데이트 화면은 왜 별도인가

일반 사용자 앱의 자동 시작은 로그인 후 실행이다. 로그인 전 접속에는 관리자 설치 Windows 서비스와 활성 세션의 캡처/입력 에이전트가 필요하다. 현재 DPAPI 인증 정보는 Windows 사용자에게 묶여 있으므로 SYSTEM 서비스가 기존 파일을 그대로 읽도록만 바꿔서는 동작하지 않는다. 자격 증명 이전, 서비스 IPC 권한, 세션 전환, 보안 데스크톱 캡처 재생성, 업데이트 시 에이전트 수명까지 함께 구현·시험해야 한다.

UAC 보호를 끄거나 Windows 로그인 인증을 우회하는 것으로 대체하지 않는다. OS가 재부팅하는 동안이나 Windows 사용자 프로세스를 실행하지 않는 부팅 단계에서는 일반 원격 앱도 화면/입력을 제공할 수 없다. 부팅 후 서비스가 다시 준비된 시점과 구별해야 한다.

검증 기록

2026-09-29 · 설치 후 실행의 0x80070057 조사 (progress-43)

수정본 Windows 빌드 1790647517을 게시했다. 서버 EXE와 manifest의 SHA-256 일치·공개 문서 HTTP 200을 확인했다. 사용자는 기존 앱을 트레이에서 종료한 뒤 관리 웹에서 새 EXE를 받아 다시 설치한다. 기존 기기 등록과 설정은 유지한다. 실제 재설치 성공 여부는 아직 확인되지 않았다.

사용자가 일반 설치 화면의 설치 후 실행에서 “매개 변수가 틀립니다. (0x80070057)”를 보고했다. Host 설정의 서비스 설치 단계에서 발생한 오류는 아니다. 구버전은 Windows API 오류에 단계 설명을 붙이지 않아 이 보고만으로 정확히 실패한 호출을 확정할 수 없다.

코드에서 발견한 문제는 파일 시스템용 경로를 Shell에도 전달한다는 점이다. std::fs::canonicalize()는 Windows에서 C:\…를 \\?\C:\… 같은 확장 경로로 바꾼다. 기존 설치 코드는 이를 IShellLinkW::SetPath, 작업 폴더, 자동 시작 및 제거 명령에 그대로 사용했다. Rust는 이 형식이 다른 프로그램과 호환되지 않을 수 있다고 설명하며, Microsoft도 파일 시스템 namespace와 Windows Shell의 경로 지원을 구별한다. 따라서 바로가기 등록의 경로 형식 불일치는 유력한 원인이다. 실제 Windows에서 동일 HRESULT를 재현한 결과로 기록하지 않는다. Rust canonicalize, Microsoft 파일 경로와 namespace.

수정한 처리:

  1. 파일 복사·동일 파일 확인에는 canonical 경로를 유지한다. Shell 경계에서는 드라이브 경로와 UNC 공유 경로로 변환한다. 변환 전후 canonical 경로가 같은지도 확인한다.
  2. 끝의 점/공백, 상대 요소, 장치 namespace 등 의미가 달라질 수 있는 경로를 무조건 잘라내지 않는다. Shell에서 지원하지 않는 설치 경로는 설명과 함께 거부한다. 한글·공백·UNC는 보존한다.
  3. 시작 메뉴 대상과 작업 폴더·저장 위치, 앱 등록·제거·로그인 자동 시작에 일반 경로를 사용한다. 기존 설치 레지스트리의 확장 경로도 다시 설치할 때 일반 표기로 복구한다.
  4. Shell 경로 및 자동 시작 명령의 길이를 복사·등록 전에 검사한다. Run 명령은 인수와 따옴표까지 260 UTF-16 단위 이내여야 한다. Microsoft Run/RunOnce 규약.
  5. COM 초기화·바로가기 대상/작업 폴더/저장·설치된 앱/자동 시작 등록·앱 실행에 실패 단계와 원래 오류를 붙인다. 설치 화면에서 긴 오류를 스크롤하고 선택·복사할 수 있다.
  6. 바로가기와 레지스트리 작업이 성공한 뒤 설치 완료 위치를 기록한다. 기존 기기 ID·비밀번호·설정은 변경하지 않는다.

이번 코드는 독립 Rust 수정이며 원본 Parsec 설치 코드를 복원한 것이 아니다. 비교 기준은 위의 150-104a와 hash를 유지한다. FUN_1800db6d0/FUN_1800de230의 자동 시작·트레이 책임과 대응하지만 원본 설치기의 내부 경로 정규화 방식은 미확인이다. F24/F61/F70은 부분 구현·different를 유지한다.

검증: Linux 플랫폼 단위 시험 13개(새 경로 회귀 3개 포함), Windows 교차 Clippy, Windows 전용 바로가기 왕복 시험의 타입 검사를 통과했다. 네이티브 Windows에서 실행하도록 마련한 한글/공백 경로 → .lnk 저장/재로딩 시험은 이 Linux 환경에서 실행하지 않았다. 실제 사용자의 재설치·시작 메뉴·재로그인·제거 및 Parsec 동일 조건 대조는 대기 상태다. 빌드·게시 결과와 남은 검증은 설치 오류 검증 기록에 기록한다.

자동 시험과 Windows 크로스 빌드는 검증 JSON에 기록한다. Windows 실기기의 설치 목록·트레이·재로그인·GPU 커서와 업데이트 파일 잠금은 이 Linux 서버에서 확인했다고 주장하지 않는다. 원본 동일 조건 대조가 남아 있으므로 F07/F20/F24/F40/F61/F70의 parity는 different/부분 구현으로 유지한다.

게시 확인: Windows 빌드 1790457295. 서버에 설치된 EXE와 업데이트 manifest의 SHA-256이 일치하며, 공개 다운로드 안내·문서·준비 상태의 HTTP 200 응답을 확인했다. 상세 hash와 검증 한계는 검증 기록에 있다.