TL;DR

Codex-QQ-Skin은 macOS용 App과 Windows용 설치기를 제공하는 독립형 데스크탑 스킨 생성기이며 Codex/ChatGPT 데스크탑에 QQ 복고풍과 사용자 맞춤 스킨을 로컬로 주입한다. 주입 방식은 127.0.0.1을 통한 Chromium DevTools Protocol로 CSS와 비상호작용 장식을 삽입하는 형태이고 공식 앱 바이너리나 app.asar를 변경하지 않는다. 미서명 앱으로 Gatekeeper/SmartScreen 경고가 발생할 수 있으며 README는 Release에서 SHA-256을 확인하고 내려받으라고 권고한다. 로컬 세션 파일을 읽어 토큰 통계를 만들되 프롬프트나 API Key를 업로드하지 않는다고 명시되어 있다. 현재 깃허브 스타는 391개, 포크는 33개로 활동 중인 레포지토리이다.

핵심 포인트

• 레포는 독립 실행형 데스크탑 스킨 생성기이자 설치기로, macOS App과 네이티브 C# Windows 설치기를 동시에 제공한다. Codex/ChatGPT 데스크톱 클라이언트에 적용되는 스킨을 로컬에서 생성·관리하며 JavaScript 기반 코드와 미리 정의된 presets를 포함한다. 깃허브 Release에서 빌드된 앱/설치자를 내려받아 설치하는 워크플로를 따른다.
• 동작 방식은 Chromium DevTools Protocol(CDP)을 로컬 loopback(127.0.0.1)으로 통해 renderer에 CSS와 투명 외형 등 비상호작용적 장식을 주입하는 방식이다. 공식 설치 디렉터리나 app.asar를 수정하지 않도록 설계되어 있고 WebSocket은 로컬 엔드포인트만 수락하도록 검증 로직을 둔다. 이 때문에 코드 서명이 없는 바이너리 경고가 있어도 앱 내부 파일을 직접 변조하는 방식은 사용하지 않는다는 보장이 있다.
• 주요 기능으로는 키워드로 레이어드 스킨을 자동 생성하는 'Codex 深度皮肤助手', 이미지 업로드로 자동 분석해 맞춤 스킨을 만드는 기능, 세 가지 모드(원래(native), QQ 스타일, 사용자(custom))의 즉시 전환, 로컬에 저장되는 스킨 라이브러리와 Codex 토큰 통계 기능이 포함된다. 파트너 룸과 프로젝트 블라인드박스는 GitHub 공개 리포지토리 검색 결과를 6시간 단위로 캐시해 표시하며 설명은 자동으로 중국어로 번역하거나 대체 텍스트를 사용한다. 오디오 피드백과 테마별 성능 최적화(예: 비주얼 레이어 해상도·프레임 제한)도 설정으로 제어된다.
• 설치·보안 관련 제약은 명확히 문서화되어 있다. macOS App은 Apple Developer ID로 서명·공증되지 않았고 Windows EXE 또한 상업적 코드 서명이 없어 Gatekeeper/SmartScreen 경고가 발생할 수 있으며 README는 Release에서 내려받아 SHA-256을 확인하라고 권고한다. 또한 동작을 위해 공식 Codex/ChatGPT 데스크탑이 사전 실행·종료된 상태여야 하고 로컬 세션(~/.codex/sessions, archived_sessions)을 읽어 통계를 만든다.