# Windows에서 Mac 제어: 휠·키보드 호환과 Parsec 디컴파일 분석 2026-09-26 · progress-36 · F18 / F20 / F51 / F82 · E05 ## 무엇을 맞췄는가 Windows 키 이름을 그대로 Mac에 보내는 것만으로는 같은 조작이 되지 않는다. **물리 키 위치**, **Control·Command 같은 modifier**, **복사·붙여넣기라는 동작**, **휠의 단위**를 구분해야 한다. 이번 수정은 Windows Parsec 150-104a의 `Swap Command and Ctrl for MacOS` 설정과, 이 Mac에 설치된 Parsec 150-101a의 실제 키·휠 처리 함수를 대조했다. 원본의 공개 API 호출·키 변환·반복 처리 근거를 바탕으로 notParsec의 Rust 코드를 수정했다. 원본과 다른 전송 형식·입력 주입 경로와 남은 시험은 완료로 표시하지 않는다. ## 바로 사용하는 설정 Settings → Client → **Swap Command and Ctrl for MacOS**를 추가했다. 원본 Windows 설정 테이블처럼 기본값은 켜짐이다. 기존 설정 파일에도 이 기본값을 적용하며 다른 선택은 보존한다. 변경은 다음 연결부터 적용한다. | Windows에서 누른 키 | 설정 켜짐: Mac에서 받는 키 | 설정 꺼짐 | |---|---|---| | Ctrl | Command ⌘ | Control ⌃ | | Windows 키 | Control ⌃ | Command ⌘ | | Alt | Option ⌥ | Option ⌥ | | Shift | Shift ⇧ | Shift ⇧ | | Ctrl+C / X / V / Z | Command+C / X / V / Z | Control+C / X / V / Z | | Backspace / Delete | 뒤로 지우기 / 앞으로 지우기 | 동일 | Windows 키·Alt+Tab 등 로컬 OS가 먼저 처리하는 키는 플로팅 메뉴의 **Immersive Mode → Keyboard 또는 Both**에서 전달한다. 기존 임시 토글은 **Ctrl+Shift+I**다. 이 단축키와 로컬 메뉴 탈출 조합은 원격 전송 전에 처리한다. Mac→Windows도 같은 설정으로 Command와 Control을 교환한다. Windows→Windows, Mac→Mac에는 적용하지 않는다. 붙여넣기의 의미도 구분했다. 교환을 켠 상태의 일반 붙여넣기는 클립보드 전달 뒤 호스트의 붙여넣기 단축키를 실행한다. 교환을 끄면 Ctrl+V를 임의로 Mac의 Command+V로 바꾸지 않고 실제 키 조합을 보낸다. 한/영 전환은 Mac의 입력 소스와 단축키 설정을 따른다. Windows 한/영키를 Mac 입력 소스 전환으로 자동 대응시키는 기능은 아직 없다. ## 가장 큰 실제 버그: Apple Silicon의 함수 호출 규약 기존 Rust 선언은 `CGEventCreateScrollWheelEvent`의 고정 인수를 세 개만 선언하고 첫 휠 값부터 가변 인수로 전달했다. Apple SDK의 실제 선언은 다음과 같다. ```c CGEventCreateScrollWheelEvent(source, units, wheelCount, int32_t wheel1, ...); ``` 첫 휠 값은 **네 번째 고정 인수**, 두 번째 휠 값부터 가변 인수다. Apple Silicon에서는 고정 인수와 가변 인수가 전달되는 위치가 다르다. 기존 선언으로 생성한 실제 Mac 이벤트를 읽으니 입력 `120`이 `1809097848`로 나타나 시험이 실패했다. 값 자체는 호출 시점에 따라 달라질 수 있다. 이는 단순 스크롤 감도 문제가 아니라 잘못된 함수 선언으로 인한 호출 오류다. 선언에 `first_wheel: i32`를 추가하고 Apple SDK·원본 ARM64 명령어와 대조했다. 수정 후 실제 CoreGraphics 이벤트의 세로·가로 픽셀 필드에 `120`, `-240`, `360`, `1`, `-1`이 정확히 유지된다. 시험은 이벤트를 생성하고 읽기만 하며 사용자 창에 키나 휠을 주입하지 않는다. ## 휠은 왜 픽셀과 두 축을 유지해야 하나 수정 전 경로는 다음과 같았다. ```text egui 휠 → y의 부호만 남겨 ±120 → 가로축 폐기 → Mac에서 /120 정수 나눗셈 → 한 줄 이벤트 → Apple Silicon에서는 잘못된 FFI 선언까지 겹침 ``` 수정 경로는 다음과 같다. ```text 클라이언트: Line / Point / Page 단위와 x·y 수집 → 휠 한 칸은 120, 정밀 터치패드는 논리 픽셀로 정규화 → 소수 이동량을 누적해 다음 이벤트에 반영 → 인증된 세션에서 두 축과 단위 전달 → Mac: CGEventCreateScrollWheelEvent(source, Pixel, 2, y, x) ``` Mac Parsec 150-101a에서도 `Pixel=0`, 축 수 `2`, 세로 다음 가로 값을 확인했다. 원본 Windows 이벤트 변환 함수는 휠 두 값을 보존한다. notParsec은 더 이상 Mac에서 휠 값을 120으로 나누지 않는다. 화면 밖·메뉴 조작 중에는 원격 휠 전송을 막고, 차단 시 누적 잔여량도 버린다. Windows 호스트는 세로 `WHEEL`, 가로 `HWHEEL` 이벤트로 변환한다. HWHEEL과 콘텐츠 이동 x의 부호 차이도 처리한다. Linux XTEST는 작은 이동을 누적한 뒤 버튼 4/5/6/7로 전달한다. 픽셀 입력을 휠만 지원하는 호스트에 전달할 때 쓰는 **50 논리 픽셀/줄**은 우리 egui 호환용 환산값이며 Parsec 원본 상수라고 주장하지 않는다. Mac 픽셀 이벤트에는 이 환산을 적용하지 않는다. ## 키 입력 처리 1. 클라이언트는 글자 자체와 물리 키 이벤트를 구분한다. 가능한 키는 `physical_key`를 사용한다. 2. 짧은 Ctrl+키 조합이 한 렌더 프레임 안에서 눌렸다 떼져도 각 이벤트 당시 modifier를 전달한다. 최종 프레임 상태만 보고 modifier를 잃던 문제를 수정했다. 3. 연결 초기화에서 인증된 상대 플랫폼을 받는다. 기기 이름이나 모니터 문자열로 Mac을 추정하지 않는다. 4. 교환 설정에 따라 키다운·키업과 모든 원격 화면에 같은 변환을 적용한다. 연결 중 매핑이 바뀌어 키가 눌린 채 남지 않도록 연결 시작 시 설정을 고정한다. 원본 함수는 이벤트 처리 때 설정을 읽으므로 적용 시점의 차이도 남아 있다. 5. Mac은 우리 VK 기반 키를 Carbon 키코드로 변환한다. 오른쪽 Command/Control/Option/Shift와 숫자패드 등의 수신 매핑을 보강했다. 좌우 modifier 중 하나를 떼어도 다른 쪽이 눌려 있으면 전체 flag를 유지한다. 6. 같은 키의 반복 keydown에 `kCGKeyboardEventAutorepeat=8` 필드를 설정한다. 원본의 held-key 상태·반복 flag 처리와 대조했다. 7. 포커스 이탈·메뉴·세션 종료에서는 `ReleaseAll`로 키와 버튼을 해제한다. Unicode 확정 문자열에는 Command/Control flag를 섞지 않는다. 현재 일반 GUI 수집 단계는 좌우 modifier와 숫자패드 Enter, 일부 특수 키를 완전히 구분하지 못한다. **Mac 수신 매핑 추가가 모든 키의 종단 간 전달 완료를 뜻하지 않는다.** IME 조합, ANSI/ISO/JIS 배치, dead key, Caps Lock 상태 동기화와 여러 클라이언트의 동시 조작은 추가 대조가 필요하다. ## 원본 버전·해시·함수 근거 Windows 기준은 계속 **150-104a**다. Mac 설치본 **150-101a**는 OS별 보조 근거이며 버전 차이를 숨기지 않는다. | 자료 | 식별과 근거 | |---|---| | Windows core | `parsecd-150-104a.dll` · SHA-256 `8c8c4299ddf503b2c25c0905b0a0820f3e8238c252e9ace37bf25964ef4a8f6f` | | 설정 UI·기본값 | `FUN_180012c50`, `client_macos_key_swap` 항목 `0x180339a20`, 기본 true | | Windows modifier 교환 | `FUN_18008d1c0`: HID `E0↔E3`, `E4↔E7`, 상대 OS 검사 | | Windows 이벤트 변환 | `FUN_18009ac10`: 키 식별자 변환과 휠 x/y 전달 | | Mac 설치본 | bundle `150.101.1`, `parsecd-150-101a.dylib` · universal SHA-256 `9cce85059c7f95f1a8e578b3c9f7200cb364520e557b5c85294802c8c596cdd5` | | Mac x86_64 slice | SHA-256 `04d7a5e797b9fdd24c737b82fd3185a2b2c16b8505cf487d3f2b14b4ba83b49d` | | Mac ARM64 slice | SHA-256 `2ff41665ab1ca6ad2c6159646b9c1143f2f932ce08c348342b71feadc5fbb9a9` | | Mac 입력 분배·휠 | x86_64 `0x191750` / ARM64 `0x144590` | | Mac CG 키 생성·반복 | x86_64 `0x191f80` / ARM64 `0x144d10` | | Mac IOHID 키 분기 | x86_64 `0x191520` / ARM64 `0x144328` | | Mac 키 변환표 | x86_64 `0x223c80`, 300개 uint16 항목. HID E0/E3/E4/E7 → Carbon 59/55/62/54 | Ghidra 12.1.3으로 두 Mac slice의 관련 함수와 호출 관계를 정적으로 분석했다. 원본 앱을 패치하거나 서비스·구독 검사를 변경하지 않았다. ARM64 의사 코드는 휠의 다섯 번째 가변 인수를 표시하지 못했지만, `0x14470c–0x14471c`의 명령어에서 **y는 w3, x는 stack**에 전달되는 것을 확인했다. 의사 코드를 그대로 복사하지 않고 SDK 선언과 실제 실행 시험으로 보완한 이유다. 원본 Mac 일반 사용자 경로에는 `IOHIDPostEvent`가 있고, 다른 분기에는 `CGEventCreateKeyboardEvent`와 main queue dispatch가 있다. 초기화 함수의 사용자 `root` 검사도 관찰했다. notParsec은 CoreGraphics 입력 경로를 유지한다. 원본의 IOHID 구조·이벤트 큐 flush·전체 내부 프로토콜을 그대로 복구했다고 주장하지 않는다. 자료의 구분: - **원본 바이너리:** 설치된 Parsec core의 읽기 전용 사본, hash로 식별. - **디컴파일 의사 코드:** `analysis/parsec/research/mac-input/{x86_64,arm64}`. 자동 추정 타입·분기이며 원본 C 소스가 아님. - **공개 소스:** 보관한 MIT libmatoya의 Windows `appw.c`, macOS `keymap.h`·`app.m`. 비교 자료이며 해당 제품 빌드의 전체 원본 소스가 아님. - **독립 Rust 구현:** `remote_input.rs`, `macos.rs`, `macos_keys.rs`, 세션·wire 변경. 우리 VK·메시지 형식을 사용함. [Parsec 공식 설정 설명](https://support.parsec.app/hc/en-us/articles/32361367389972-Swap-Command-and-Ctrl-for-MacOS)과 [고급 설정 표](https://support.parsec.app/hc/en-us/articles/32381443626516-All-Advanced-Configuration-Options)도 대조했다. 최신 웹 문서를 보관한 특정 버전의 바이너리 근거와 혼동하지 않는다. ## 적용·검증 범위 세션 형식은 `notparsec-remote/10`이다. 새 OS 정보와 2축 입력을 이해하지 못하는 구버전과 섞여 잘못 처리되지 않도록 버전을 올렸다. **Windows와 Mac 앱을 모두 새 버전으로 사용해야 한다.** Ubuntu 중계 서버는 암호화된 데이터 전달 역할을 유지한다. 게시 버전은 **Windows 1790454197 / Mac 1790453938**이다. Mac은 기존 고정 인증서로 서명했으며 권한을 임의로 초기화하지 않는다. 현재 Mac이 오프라인으로 전환되어 SSH 설치는 대기 중이다. Windows만 업데이트한 뒤 구버전 Mac에 연결하면 /10 호환 오류가 발생하므로 양쪽 업데이트 후 재연결한다. 빌드 번호·배포 해시·설치 후 권한과 시험 결과는 [검증 기록](evidence/mac-input-validation.json)에 기록한다. - Linux에서 입력 라우팅·설정 이전·프로토콜·세션·플랫폼 시험. - 실제 Apple Silicon에서 CoreGraphics 이벤트 생성 및 축·modifier·반복 필드 검사. 수정 전 실패와 수정 후 통과를 확인. - Windows release 빌드 및 PE 검사, Mac 네이티브 release·DMG·고정 서명 검사. - 실제 Windows 키보드에서 원격 Mac의 앱을 조작하는 종단 간 체감·IME·키 배치·스크롤 가속과 Parsec 동시 비교는 별도 확인이 필요하다. F18/F20/F51/F82는 부분 구현과 parity `different`를 유지한다. 이 문서는 완전한 Parsec 입력 호환 완료 선언이 아니다. [개발계획과 구현 상태](/document/plan) · [고정 인증서 서명](MAC_FIXED_SIGNING.ko.md) · [클립보드·Immersive](CLIPBOARD_AND_IMMERSIVE.ko.md)