How steven-jianhao-li/zotero-ai-butler works
Zotero AI Butler is a Zotero plugin for analyzing papers and managing AI-generated research artifacts. Users trigger analysis manually, through automatic scanning, or by selecting unprocessed library items; tasks are queued, paper content is extracted, and configured language models generate notes and other outputs. The plugin also provides deep reading, literature reviews, image summaries, mind maps, and an in-reader note/chat experience. The graph combines README-documented capabilities with sampled source references; several feature implementations were not excerpted, so their internal links are omitted.
Main entry points: taskQueue.ts Task queue · noteGenerator.ts Note generation · llmService.ts LLM middleware · MainWindow.ts Main window
Components 25
Zotero entry
- Plugin startup
src/addon.ts - Zotero hooks
src/hooks.ts
Paper workflow
- Task queue
src/modules/taskQueue.ts - Automatic scanning
src/modules/autoScanManager.ts - Content extraction
src/modules/contentExtractor.ts - PDF extraction
src/modules/pdfExtractor.ts - Note generation
src/modules/noteGenerator.ts - Note formatting
src/modules/noteMarkdown.ts - Zotero notes
src/modules/aiNoteService.ts
Model services
- LLM middleware
src/modules/llmService.ts - Endpoint management
src/modules/llmEndpointManager.ts - Provider implementations
src/modules/llmproviders
Research features
- Deep reading
src/modules/deepReadEngine.ts - Literature reviews
src/modules/literatureReviewService.ts - Image summaries
src/modules/imageSummaryService.ts - Mind maps
src/modules/mindmapService.ts
Plugin interface
- Reader sidebar
src/modules/ItemPaneSection.ts - Main window
src/modules/views/MainWindow.ts - Summary view
src/modules/views/SummaryView.ts - Review view
src/modules/views/LiteratureReviewView.ts - Preferences
src/utils/prefs.ts - Prompt management
src/utils/prompts.ts
Other components
- Researcher
- Zotero library
- Configured model API
Connections 25
- Researcher → Zotero library: adds papers
- Zotero library → Zotero hooks: triggers plugin
src/hooks.ts - Zotero hooks → Task queue: enqueues analysis
src/hooks.ts - Zotero hooks → Main window: opens dashboard
src/hooks.ts - Automatic scanning → Task queue: enqueues papers
src/modules/autoScanManager.ts - Task queue → Content extraction: requests content
src/modules/taskQueue.ts - Content extraction → PDF extraction: extracts PDFs
src/modules/contentExtractor.ts - Task queue → Note generation: runs summaries
src/modules/taskQueue.ts - Note generation → LLM middleware: requests generation
- Note generation → Note formatting: formats output
- Task queue → Image summaries: runs image summary
src/modules/taskQueue.ts - Task queue → Mind maps: runs mind maps
src/modules/taskQueue.ts - Task queue → Literature reviews: runs reviews
src/modules/taskQueue.ts - Review view → Literature reviews: configures reviews
src/modules/views/LiteratureReviewView.ts - Main window → Summary view: shows summary
src/modules/views/MainWindow.ts - Main window → Review view: shows reviews
src/modules/views/MainWindow.ts - Reader sidebar → Zotero notes: shows AI notes
src/modules/ItemPaneSection.ts - LLM middleware → Endpoint management: resolves endpoints
src/modules/llmService.ts - LLM middleware → Provider implementations: dispatches requests
src/modules/llmService.ts - Provider implementations → Configured model API: sends model requests
- LLM middleware → Content extraction: extracts model input
src/modules/llmService.ts - Endpoint management → Preferences: reads configuration
src/modules/llmEndpointManager.ts - Note generation → Prompt management: uses prompts
- Researcher → Main window: manages tasks
- Researcher → Reader sidebar: reads and asks