KOOHAWN/AI_PDF_TOOLKIt

1---2title: AI PDF Toolkit3emoji: 📄4colorFrom: blue5colorTo: purple6sdk: docker7pinned: false8app_port: 78609---10 11# 디자인 통합 작업 허브12 13PDF, AI, PSD, 이미지 파일을 한 곳에서 정리하고 검수하는 디자인/인쇄 작업용 데스크톱 및 웹 툴킷입니다.  14메인 화면은 작업 허브 형태로 구성되어 있으며, PDF 병합, 인쇄용 변환, PDF 비교, 파일 뷰어, 이미지 작업 기능으로 바로 진입할 수 있습니다.15 16## 주요 기능17 18- **PDF 병합**: PDF, PDF 호환 AI, 이미지, SVG 파일을 순서대로 하나의 PDF로 병합합니다.19- **인쇄용 변환**: Ghostscript 기반으로 PDF/AI 파일을 인쇄 전달용 PDF 패키지로 변환합니다.20- **PDF 비교**: 원본과 수정본 PDF를 대조해 텍스트, 숫자, 도면, 레이아웃 변경 후보를 검수합니다.21- **뷰어**: AI, EPS, SVG, PDF, PSD, PSB 파일을 열어 확대 검수합니다.22- **PSD/PSB 검사**: PSD/PSB 레이어와 텍스트를 탐색하고, 선택한 레이어 위치를 미리보기 위에 표시합니다.23- **이미지 툴킷**: 이미지 크기 변경, 이어붙이기, 긴 이미지 자르기, HTML 이미지 링크 수집을 처리합니다.24 25## 화면 구성26 27- **홈**: 디자인 통합 작업 허브. 모든 기능을 카테고리별로 바로 실행합니다.28- **PDF 병합**: 파일 드래그 앤 드롭, 병합 순서 관리, 결과 PDF 저장.29- **인쇄용 변환**: 원본/인쇄용 산출물 패키지 생성.30- **PDF 비교**: 정밀 대조 모드와 빠른 육안 검수 모드 제공.31- **뷰어**: PDF 원본/이미지 렌더 모드, PSD/PSB 레이어 검색 및 선택 해제.32- **이미지 툴킷**: 작업 옵션, 업로드 목록, 대형 미리보기 대지, 결과 목록으로 구성.33 34## 기술 스택35 36- React 1937- Vite38- TypeScript39- Electron40- Express41- pdf-lib42- pdfjs-dist43- Ghostscript44- MuPDF45- Tesseract.js46- OpenCV.js47- sharp48- ag-psd49- JSZip50 51## 로컬 실행52 53### 1. 의존성 설치54 55```bash56npm install57```58 59### 2. 웹 개발 서버 실행60 61```bash62npm run dev63```64 65기본 개발 서버는 `http://localhost:3000`에서 실행됩니다.66 67### 3. API 서버 실행68 69```bash70npm run server71```72 73기본 API 서버는 `http://localhost:8080`에서 실행됩니다.74 75### 4. Electron 실행76 77```bash78npm run electron:start79```80 81## 빌드82 83```bash84npm run build85```86 87Electron 패키징은 아래 명령을 사용합니다.88 89```bash90npm run electron:build91```92 93## 검증 명령94 95```bash96npm run lint97npm run build98node --check server.cjs99node --check main.cjs100node --check workers/compare.worker.cjs101node --check workers/image.worker.cjs102```103 104## 주요 폴더105 106```text107smart-pdf-&-ai-merger/108├─ src/109│  ├─ App.tsx110│  └─ features/111│     ├─ compare/112│     │  └─ CompareTab.tsx113│     ├─ illustrator/114│     │  └─ IllustratorViewerTab.tsx115│     └─ images/116│        ├─ ImageToolkitTab.tsx117│        ├─ imageClient.ts118│        └─ types.ts119├─ workers/120│  ├─ compare.worker.cjs121│  └─ image.worker.cjs122├─ lib/123│  ├─ imageProcessor.cjs124│  └─ htmlImageCollector.cjs125├─ main.cjs126├─ preload.cjs127├─ server.cjs128└─ package.json129```130 131## 배포 메모132 133이 프로젝트는 Hugging Face Spaces Docker 환경을 고려한 README front matter를 유지합니다.  134`README.md` 상단의 YAML 설정은 배포 설정에 사용될 수 있으므로 삭제하지 마세요.135 136GitHub에 `main` 브랜치가 푸시되면 연결된 배포 워크플로가 있는 경우 자동 배포가 이어질 수 있습니다.137 138## 주의 사항139 140- `node_modules/`, `dist/`, `release/`, 로그 파일, `temp_uploads/`는 Git에 포함하지 않습니다.141- `kor.traineddata`, `eng.traineddata`는 OCR 기능에 필요합니다.142- Windows 경로에 `&`가 포함되어 있으므로 npm 스크립트가 불안정할 때는 `node .\node_modules\...\bin` 형태의 직접 실행이 더 안정적입니다.143