steven-jianhao-li/zotero-AI-Butler

【Zotero AI 管家】调用大模型，自动精读论文库里的论文，总结为Zotero笔记。支持主流大模型平台！您只需像往常一样把文献丢进 Zotero，管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！

📚 Zotero‑AI‑Butler란 무엇인가요?

참고문헌 관리자 내에서 대규모 언어 모델(LLM)을 호출할 수 있는 무료 오픈소스 Zotero 플러그인입니다. Zotero에 추가한 PDF를 자동으로 읽고, 구성한 모델(Gemini, OpenAI, Claude 등)로 보내고, 구조화된 Markdown 노트, 마인드맵, 한 페이지 "포스터" 이미지, 심지어 문헌 검토 초안까지 다시 작성합니다. 요컨대, Zotero를 AI 연구 어시스턴트로 바꿔줍니다.

🎯 핵심 기능(README 설명 기준)

기능	설명	트리거 방법
AI Butler Agent (v5.0)	라이브러리를 검색하고 증거를 추출하며 모델 생성 답변으로 응답하여 연구 질문에 답합니다.	Butler 대시보드에서 Agent 탭을 열고 쿼리를 입력합니다.
자동 노트 생성	새 PDF가 추가되면 플러그인은 전체 문서(멀티모달 모델용 Base64)를 추출하고 LLM에 명확한 Markdown 요약을 생성하도록 요청하여 Zotero 노트로 저장합니다.	설정에서 새 항목 자동 스캔을 활성화하거나 수동 스캔을 실행합니다.
심층 읽기 / 다중 라운드 요약	논문을 섹션(배경, 방법, 실험, 결론)으로 나누고 여러 모델 호출을 실행한 다음 결과를 상세 노트로 병합합니다.	오른쪽 클릭 → AI Butler 다중 라운드 재읽기 → 다중 라운드 스플라이스 또는 다중 라운드 요약 선택.
단일 이미지 요약	논문의 핵심 요점을 시각화하는 단일 학술 포스터 스타일 이미지("Nano Banana Pro" 서비스 통해)를 생성합니다.	오른쪽 클릭 → 단일 이미지로 요약(API 키 필요).
마인드맵 내보내기	논문 구조의 대화형 계층 맵을 생성합니다. 다른 도구용으로 PNG 또는 OPML로 내보낼 수 있습니다.	오른쪽 클릭 → 마인드맵 생성.
일괄 문헌 검토	컬렉션/폴더를 선택하면 플러그인이 모든 소스 PDF에 연결되는 결합 검토 문서를 작성합니다.	컬렉션 오른쪽 클릭 → AI Butler 문헌 검토.
사이드바 미리보기	PDF 옆에 AI 생성 노트를 표시하며, KaTeX를 통한 LaTeX 렌더링, 접을 수 있는 섹션, 글꼴 크기 조정, 후속 질문을 위한 빠른 질문 상자를 제공합니다.	사이드바를 열거나 AI‑Butler 아이콘을 클릭합니다.
프롬프트 템플릿 관리자	단일 샷, 다중 라운드 또는 최종 요약 호출을 위한 내장 및 사용자 정의 프롬프트 세트. 변수 대체의 실시간 미리보기.	설정 → 프롬프트 템플릿.
다중 모델 지원	Google Gemini, OpenAI(gpt‑5 포함), Anthropic Claude, SiliconFlow 호환 API, Volcano‑Argo, Ollama 등에서 작동합니다.	설정 → API 구성.
테마 및 UI 적응	Zotero의 라이트/다크 모드와 일치. 선택 가능한 노트 렌더링 테마(GitHub, Redstriking) 및 사용자 정의 CSS.	설정 → UI 테마.

🛠️ 내부 작동 방식(높은 수준, README에서)

PDF 처리 – 플러그인은 일반 텍스트를 추출하거나 전체 파일을 Base64 인코딩 blob으로 보내 멀티모달 모델(예: Gemini 2.5 Pro)이 그림, 표, 방정식을 볼 수 있도록 합니다.
작업 큐 – 논문은 생산자‑소비자 큐에 배치됩니다. 작업 큐 페이지에서 상태(대기 중, 실행 중, 완료, 실패)를 볼 수 있습니다.
프롬프트 기반 LLM 호출 – 각 기능은 프롬프트 템플릿에 해당합니다. 플러그인은 {{title}}, {{authors}} 등의 변수를 대체한 다음 구성된 API를 호출합니다.
결과 저장 – LLM의 응답은 동일한 항목에 첨부된 Zotero 노트로 저장되며, 선택적으로 사이드바에 표시되거나 이미지/OPML로 내보낼 수 있습니다.
구성 – API 키는 로컬에 저장됩니다. 플러그인은 참고문헌이나 키를 제3자 서버로 전달하지 않습니다.

🚀 시작하기

설치 – Releases 페이지에서 최신 .xpi를 다운로드하고 Zotero의 도구 → 부가 기능 창으로 끌어다 놓습니다.
LLM 구성 – AI Butler → 설정 → API를 열고 Gemini, OpenAI, Claude 등의 키를 붙여넣습니다. 연결 테스트를 클릭합니다.
자동 스캔 활성화(선택 사항) – 설정 → 인터페이스 → 새 문헌 자동 스캔을 체크합니다.
작업 실행 – PDF를 오른쪽 클릭 → AI Butler로 요약(또는 대시보드의 일괄 스캐너 사용).

🎓 누가 혜택을 받나요?

연구자 및 학생: 텍스트를 채팅 창에 수동으로 복사하지 않고 빠르고 일관된 논문 요약이 필요한 분.
문헌 검토 작성자: 소스 PDF에 이미 연결된 초기 초안이 필요한 분.
Zotero를 사용하는 모든 사람: AI 강화 노트 작성, 마인드맵 또는 시각적 초록을 원하는 분.

⚠️ 제한 사항 및 고려 사항(README 기준)

자체 API 키를 제공해야 합니다 – 플러그인은 모델을 호스팅하지 않습니다.
토큰 비용 – 다중 라운드 또는 이미지 생성 모드는 많은 토큰을 소비할 수 있습니다. README는 높은 API 비용을 경고합니다.
성능 – 자동 스캔은 Zotero 속도 저하를 방지하기 위해 기본적으로 비활성화되어 있습니다. 활성화해야 합니다.
모델 호환성 – Base64 모드는 멀티모달 모델에서만 작동합니다. 텍스트 전용 모델은 일반 텍스트 추출 경로가 필요합니다.
개인정보 보호 – 모든 요청은 사용자 머신에서 모델 엔드포인트로 직접 전송됩니다. 플러그인은 데이터 수집을 하지 않는다고 주장합니다.

📚 추가 자료

전체 사용자 가이드: https://steven-jianhao-li.github.io/zotero-AI-Butler/
Agent 사용 세부 정보: docs/agent.md
제공된 BibTeX 항목(DOI 10.5281/zenodo.20457937)으로 소프트웨어를 인용하세요.

Zotero‑AI‑Butler는 Zotero 생태계 내에 존재하는 진정한 기능이 풍부한 AI 강화 연구 도구로, 참고문헌을 대화형 모델 기반 학습 파트너로 바꿔줍니다.