guaguastandup/zotero-pdf2zh

Zotero PDF2zh – Zotero 내장 AI PDF 번역 도구

소개

• Zotero 라이브러리에서 직접 PDF 논문을 번역할 수 있는 Zotero 플러그인(및 경량 Python 서버)입니다.
• 오픈 소스 PDFMathTranslate / PDFMathTranslate-next 엔진을 사용하여 LLM API(OpenAI, DeepSeek, SiliconFlow 등)를 호출하며, 수식, 레이아웃, 선택적 이중 언어 사이드 바이 사이드 뷰를 유지하면서 중국어 번역을 생성합니다.

주요 기능

기능	설명
두 가지 번역 백엔드	pdf2zh(구버전, 빠름, 사용자 정의 폰트) 및 pdf2zh_next(활발한 유지보수, 표/OCR 지원, 용어 추출).
이중 언어 PDF 출력	원문과 번역문이 좌우 또는 상하로 배치된 새로운 PDF를 생성합니다.
크롭 및 비교 모드	2단 논문의 페이지를 반으로 잘라 이어 붙여 휴대폰에서 읽기 쉽게 만듭니다.
일괄 번역	Zotero에서 여러 항목을 선택하여 한 번에 번역합니다.
진행 상황 UI	웹 대시보드 (http://127.0.0.1:8890)에서 작업 상태와 기록을 확인하고 결과를 다운로드할 수 있습니다.
LLM 서비스 관리	플러그인 내 UI를 통해 다양한 공급자(OpenAI 호환, DeepSeek-V4, SiliconFlow-free, Bing/Google, Zhipu, Aliyun DashScope 등)의 API 키/URL을 추가하고 속도 제한 (qps, poolsize)을 설정할 수 있습니다.
Docker / Homebrew / Windows-exe	Python 서버는 Windows 실행 파일 및 Docker 이미지를 포함한 다양한 배포 옵션을 제공합니다.
자동 업데이트	플러그인은 새 릴리스를 확인하며, 서버는 GitHub나 Gitee에서 업데이트를 가져오고 Python 패키지 자체를 업데이트할 수도 있습니다.

작동 방식

1. 플러그인 설치 (.xpi) – Zotero(버전 7-10 지원)에 설치합니다.
2. 컴패니언 서버 실행 – 번역 엔진을 로드하고 설정한 LLM API와 통신하는 작은 Python 스크립트(server.py)입니다. 번역 중에는 서버가 계속 실행되어야 합니다.
3. LLM 설정 – 플러그인의 “LLM API 설정” 패널에서 URL, API 키, 모델 이름, 선택적 *_enable_json_mode를 입력합니다.
4. PDF 우클릭 (또는 Zotero 항목) → 4가지 작업 중 선택:
   • Translate PDF – 번역된 PDF 생성.
   • Crop PDF – 모바일 읽기를 위해 넓은 논문을 반으로 자름.
   • Compare PDF – 이중 언어 사이드 바이 사이드 뷰.
   • Crop-compare PDF – 크롭 후 비교(2단 논문용).
5. 진행 상황 확인 – Zotero 상태 표시줄이나 웹 대시보드에서 확인하며, 완료되면 새 PDF가 라이브러리에 나타납니다.

설치 퀵스타트

• Python 3.12와 Zotero를 설치합니다.
• 가상 환경 관리자(uv 권장, 또는 Conda)를 설치합니다.
• server.zip 릴리스를 다운로드하여 zotero-pdf2zh/server에 압축을 풉니다.
• 서버를 시작합니다(예: uv run --python 3.12 --with-requirements requirements.txt server.py 또는 Conda 대응 명령).
• Zotero → 도구 → 부가 기능에서 .xpi 플러그인을 설치합니다.
• 플러그인 환경 설정을 열고 “연결 확인” 버튼을 테스트한 뒤 LLM API를 추가하면 번역 준비가 완료됩니다.

대상 사용자

• Zotero에 논문을 저장하고 참조 관리자를 떠나지 않고 중국어 번역이 필요한 연구자 및 학생.
• 원본 PDF 레이아웃(수식, 표)을 유지하면서 읽기 쉬운 이중 언어 버전을 원하는 사용자.

제한 사항 / 참고 사항

• 서버가 계속 실행되어야 합니다. 터미널을 닫으면 번역이 중단됩니다.
• 무료 서비스(예: SiliconFlow-free)는 일부 구절을 놓칠 수 있으므로, 고품질 번역을 위해서는 유료 LLM 키를 사용하십시오.
• Windows 사용자는 프로젝트를 시스템 드라이브에 두지 않는 것이 좋으며, 터미널을 관리자 권한으로 실행해야 할 수도 있습니다.
• 본 프로젝트는 대대적인 재작성 중입니다(2026년 8월 기준). 현재 버전은 안정적이지만 새 릴리스 전까지 기여는 일시 중단되었습니다.

---

요약: Zotero PDF2zh는 실용적인 오픈 소스 Zotero 플러그인과 경량 Python 서버의 조합입니다. LLM API를 사용하여 PDF를 중국어로 번역하고 포맷을 유지하며, 이중 언어 PDF 생성, 일괄 처리, 웹 UI를 통한 진행 상황 모니터링을 제공합니다. 다양한 배포 방법과 LLM 공급자를 지원하여 Zotero 내에서의 AI 보조 학술 읽기를 실용적으로 만들어 줍니다.