Rice-dog/code-codex

Code‑Codex – Codex Desktop용 로컬 파일 트리 애드온

개요 – Code‑Codex는 공식 Codex/ChatGPT Desktop 클라이언트(OpenAI 채팅 모델용 GUI)에 플러그인되는 커뮤니티 제작 Windows 도우미입니다. 네이티브 파일 트리 사이드바, 구문 강조 코드 미리보기 창, 제한된 편집 기능, 추가 미리보기 및 시각 효과를 위한 플러그인 마켓플레이스를 추가합니다. 이 프로젝트는 OpenAI와 완전히 독립적입니다.

주요 구성 요소

런처 및 브리지 – 공식 Codex 클라이언트를 시작하고 TypeScript 기반 탐색기 UI를 주입하며 제한된 작업 영역 API를 중재하는 작은 Windows 실행 파일(code‑codex‑launcher.exe).
탐색기 UI – 접을 수 있는 파일 트리, 드래그 앤 드롭 파일 작업, 오른쪽 클릭 컨텍스트 메뉴(새로 만들기, 이름 바꾸기, 삭제, 탐색기에 표시, 새로 고침), 열린 파일의 탭 모음을 표시하는 주입된 TypeScript UI.
미리보기 및 편집 – 구문 강조, 축소판 탐색, 경량 편집기 토글이 있는 내장 텍스트 미리보기. Markdown, CSV, PDF, Jupyter 노트북, Office 문서, 이미지, 비디오, 오디오 및 3D glTF/GLB 모델은 선택적 플러그인으로 처리됩니다.
플러그인 시스템 – 24개의 플러그인이 모양, 파일 미리보기 및 도구로 그룹화된 "미리보기 마켓". 플러그인은 주문형으로 다운로드되고 SHA-256으로 검증되며 <install‑dir>/plugins/…에 저장됩니다. 타사 스크립트는 설치할 수 없습니다.
모양 플러그인 – Codex 배경을 대체하고 활성화되면 클라이언트를 자동으로 다크 모드로 전환하는 WebGL 시각 효과(입자 이미지, 블랙홀, 오로라, 은하수 등) 모음.
도구 플러그인 – 브랜치, 커밋, 변경된 파일 및 색상 구분 diff를 표시하는 읽기 전용 Git 기록 뷰어.

설치

사전 빌드된 바이너리 – Windows 10 x64 설치 프로그램(.exe), MSI 또는 휴대용 ZIP이 GitHub 릴리스 페이지에서 제공됩니다. 설치 프로그램은 SHA-256 체크섬으로 다운로드를 검증하고 기존 Codex 바로 가기를 백업하며 파일을 %LOCALAPPDATA%\Programs\Code‑Codex(사용자 지정 폴더 선택 가능)에 씁니다. 또한 안전한 정리를 위해 이전 버전을 유지합니다.
소스에서 빌드 – Windows 11 x64, Rust 1.85+, MSVC 도구 체인, Node ≥ 20, Visual Studio Build Tools가 필요합니다. scripts/build.ps1은 실행 파일을 생성하고 scripts/package.ps1은 설치 프로그램 자산을 만듭니다.

사용 흐름

Code‑Codex를 실행합니다(또는 Codex의 Code‑Codex 메뉴 사용). 파일 트리가 사이드바에 나타납니다.
탐색기에서 트리로 파일/폴더를 끌어다 놓거나 컨텍스트 메뉴를 사용하여 관리합니다.
파일을 클릭하여 미리보기 탭을 엽니다. 편집기 토글을 활성화하여 빠른 편집을 수행합니다.
트리 하단의 미리보기 마켓을 열고 필요한 플러그인(예: Markdown 미리보기 또는 입자 배경)을 다운로드하여 활성화합니다.
메뉴를 통해 업데이트를 확인합니다. 설치 프로그램은 설정을 유지하면서 새 버전을 다운로드합니다.

데이터 레이아웃

<install‑dir>/
  data/                # 사용자 설정, 플러그인 매개변수, 미디어
  plugins/<type>/<id>/<ver>/  # 검증된 플러그인 코드 및 자산
  logs/runtime/       # 최근 실행 로그(각 ≤5 MiB)
  logs/diagnostics/  # 충돌 및 자체 검사 보고서
  logs/install/       # 설치 프로그램 로그
  logs/update/        # 업데이트 이벤트
  temp/                # 업데이트 중 임시 파일
  backups/             # 마이그레이션 기록

제거 프로그램(Uninstall‑CodeCodex.exe 또는 PowerShell 스크립트)은 원래 Codex 바로 가기를 복원하고 선택적으로 모든 Code‑Codex 데이터를 제거합니다.

대상 사용자 – Codex Desktop 클라이언트를 이미 사용하고 있으며 채팅 UI를 벗어나지 않고 로컬 프로젝트 탐색기, 더 풍부한 파일 미리보기 및 선택적 시각적 사용자 지정을 원하는 개발자.

라이선스 – MIT(THIRD_PARTY_NOTICES_ZH_CN.md에 타사 고지 포함).

Rice-dog/code-codex

Code‑Codex – Codex Desktop용 로컬 파일 트리 애드온

관련