스캔 책을 디지털 PDF로 변환하기
대화는 간단하게
사용자는 단순히 "이 PDF 책을 https://github.com/MuhtajinMukhtar/scan-book-to-digital-pdf 의 지침에 따라 편하게 읽을 수 있는 디지털 책으로 만들어주세요." 라고 말할 수 있습니다. PDF 파일을 첨부 파일로 제공할 수 있습니다. 사용자에게 OCR, PP-StructureV3, SHA-256, 명령줄과 같은 용어를 알도록 요구하지 마세요.
- PDF가 첨부되지 않은 경우 PDF를 요청하세요.
- 기본적으로 원본과 유사한 레이아웃, 글꼴, 단락 시작을 사용합니다. 필요한 경우 한 번에 친근한 질문 하나씩 일상적인 표현으로 물어보세요: "글씨체를 일반 책처럼 할까요, 아니면 현대적인 스타일로 할까요?", "글자 크기는 원본과 같게 할까요, 아니면 더 크게 할까요?", "단락 시작은 들여쓰기로 할까요, 아니면 왼쪽 정렬로 할까요?" "원본 그대로" 옵션을 제공하세요. 기본값으로 충분할 때 모든 질문을 하지 마세요.
- 진행 상황을 평이한 언어로 보고하세요: 확인된 페이지, 불확실한 페이지, 검토 PDF. 기술 로그는 작업 파일 내에 유지하고 사용자 채팅에는 표시하지 마세요.
- 사용자가 수동으로 OCR 엔진을 선택하도록 하지 마세요. 호환되는 Mac에서는 아래 두 엔진을 모두 사용하세요.
원본 보호 및 기본 설정
페이지 수, 원본 SHA-256, 파일 메타데이터 및 출력 대상을 기록하세요. 원본 또는 승인된 이전 버전을 덮어쓰지 마세요. 사용자가 명시적으로 페이지 번호 재지정을 요청하지 않는 한, 정확한 원본-페이지 매핑을 기본값으로 사용하세요. 명시적 기본 설정(본문에 세리프(Georgia가 설치되고 라이선스가 있는 경우 Georgia, 그 외에는 오픈 세리프) 또는 산세리프, 원본 추정 또는 지정된 글꼴 크기, 첫 줄 들여쓰기 원본/예/아니오)을 존중하세요. 원본의 머리글, 기울임꼴, 사진, 다이어그램, 표, 로고, 인용문, 양식, 바닥글 및 읽기 순서를 보존하세요. 저작권이 있는 스캔본이나 글꼴 파일을 재배포하지 마세요.
Mac 우선 이중 OCR 파이프라인 (전체 실행 필수)
references/mac-setup.md의 지침을 사용하여 격리된 Mac Python 환경을 설정하세요. 처리 전에 실제 Apple Vision 및 PaddleOCR PP-StructureV3 설치를 확인하세요. 프로덕션 시스템이나 전역 패키지 변경을 사용하지 마세요.python scripts/mac_hybrid_ocr.py BOOK.pdf --work-dir ./work를 실행하세요. 이 명령은 동일한 캐시된 페이지 이미지에 대해 Apple Vision으로scripts/ocr_book.py를 호출한 다음 PP-StructureV3를 호출하고, 원시 Paddle JSON 및 Markdown을 저장하며,work/fusion/에 페이지별 비교 보고서를 생성합니다.- Paddle JSON에서 원시
overall_ocr_res.rec_texts를 읽고 Markdown 렌더링만 읽지 마세요. 성공적인 프로토타입은 5페이지 파일럿에서 Paddle Markdown이 생략한 7줄을 복구했습니다. Markdown이 완전하다고 가정하지 마세요.paddle_raw_not_in_markdown,paddle_not_in_apple,apple_not_in_paddle, 철자/표기 변형 경고를 확인하세요. 이 모든 것은 검토 대상이며 자동 승인된 수정 사항이 아닙니다. - 수정 사항을 적용하기 전에 누락된 텍스트와 논란이 있는 이름을 원본 페이지 이미지와 대조하여 확인하세요. 두 엔진을 줄 단위로 비교하세요. 어떤 엔진도 그 자체로 권위적이지 않습니다. 불확실성은 페이지별 문제 기록부에 보존하세요. 문맥만으로 텍스트를 만들어 내지 마세요.
- 모든 페이지를 분류하고, 확인된 읽기 순서, 선택된 크기, 글꼴, 단락 들여쓰기 및 양쪽 정렬 본문으로 디지털 조판 텍스트를 구성하세요. 원본에서 잘라낸 사진/삽화를 사용하세요.
references/page-archetypes.md를 참조하세요. 안전하게 재구성할 수 없는 페이지의 경우 선택 가능한 OCR 레이어가 있는 원본 이미지를 보존하고 해당 페이지를 검색 가능한 스캔 대체 페이지로 명시적으로 표시하세요. - 각 원본 페이지에 대해 하나의 매니페스트 항목을 작성하세요: 원본/출력 페이지, 유형, OCR 엔진, 승인된 수정 사항, 이미지 확인, 디지털 또는 검색 가능한 스캔 상태, 예외 사항 및 시각적 검토 상태.
scripts/pdf_audit.py를 사용하여 원본 단어 범위, 페이지 매핑, 포함된 글꼴, 빈/잘린 페이지 및 이미지 없음, 원본/출력 시각적 비교를 확인하세요.references/qa-and-handoff.md를 읽으세요. 성공을 보고하기 위해 실패를 숨기지 마세요.- 검토 PDF와 간결한 미해결 페이지 요약을 제공하세요. 사용자가 편집 결과를 승인한 후에만 최종으로 표시하세요.
scripts/lossless_optimize.py는 복사본에 대해서만 실행하고 렌더링/텍스트 동등성을 확인하세요.
운영 경계
- 이것은 원클릭 범용 재조판 도구가 아닙니다: AI 에이전트는 복잡한 페이지의 편집적 재구성을 수행해야 합니다.
mac_hybrid_ocr.py는 원본 비교를 준비할 뿐, 자체적으로 최종 책을 생성하지 않습니다. - Mac에서 Paddle을 실행할 수 없는 경우, 조용히 Apple 전용으로 계속 진행하고 출력이 이중 OCR을 통과했다고 가장하지 마세요. 설치 문제를 보고하고 사용자에게 안전한 다음 단계를 제안하세요.
- 현재 ChatGPT Work 또는 Codex 환경에서 Mac 소프트웨어를 실행할 수 없는 경우, 간략히 말씀해 주세요. OCR 출력을 조작하는 대신 허용된 Mac 실행 환경을 확보하세요.
- 캐시/소스 ID를 보존하세요. 다른 소스의 기존 OCR 결과를 자동으로 덮어쓰지 마세요. 리포지토리에 개인 파일을 게시하지 마세요.
--compare-only를 사용하여 OCR을 다시 실행하지 않고 기존 캐시를 재평가하세요.