What's New

⏸ Pause/Play and Cancel During Indexing

Long-running indexing operations now have full control buttons in the progress window:

• Pause (⏸) and resume (▶) buttons — pauses at batch boundaries with all progress saved
• Cancel (✕) button — stops gracefully with a quiet notification (no error alert)
• ETA calculation accounts for paused time

⏱ Configurable Auto-Index Delay (closes #21)

Control how long ZotSeek waits after the last item is added before auto-indexing starts:

• Default: 10 seconds (configurable from 1–300 seconds in Settings → ZotSeek)
• Each new item resets the countdown, preventing indexing during bulk imports
• Useful when importing large batches via browser connector or RSS feeds

🛡 Resilient Embedding (fixes #19)

Single chunk embedding failures no longer crash the entire indexing operation:

• Each chunk gets one automatic retry before being skipped
• Skipped chunks are logged and reported in the progress window
• Remaining items continue indexing normally
• Applies to both manual and auto-indexing

Changed

• Auto-index batch timer now uses proper debounce (resets on each new item instead of firing after the first)

Installation

1. Download zotseek-1.10.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

No action required. Existing indexes and settings are preserved.

Full Changelog: v1.9.0...v1.10.0

What's New

🚫 Tag-Based Exclusion

Exclude specific items from indexing by tagging them:

• Default tag: zotseek-exclude (configurable in Settings → ZotSeek → Advanced Settings)
• Works during manual indexing (Update Library Index, Index Selected, Index Collection)
• Works during auto-indexing of new items
• Leave the tag name empty to disable exclusion

Tip: Use Zotero's Advanced Search (Edit → Advanced Search) to find items by title, type, or collection, then bulk-tag them. This is more flexible than regex-based filtering since it leverages Zotero's native search capabilities.

🗑️ Auto-Cleanup on Delete/Trash

Embeddings are now automatically removed when items are deleted or trashed:

• Prevents ghost search results from orphaned data
• Always active regardless of auto-index setting (data integrity concern)

📄 "Remove from ZotSeek Index" Context Menu

New right-click menu item to manually remove items from the search index:

• Supports multi-select (remove several items at once)
• Shows quick notification with count of removed items
• Safe to use on non-indexed items (no-op, no error)

Installation

1. Download zotseek-1.9.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

No action required. Existing indexes are fully compatible.

Full Changelog: v1.8.0...v1.9.0

What's New

🎯 Multi-Select in Search Results

Select multiple items in search results using standard shortcuts:

• Shift+click to select a range of items
• Cmd/Ctrl+click to toggle individual items
• "Open Selected" button selects all items in Zotero library when multiple are selected

📋 Right-Click Context Menu

Batch operations on selected results:

• Show in Library — Selects item(s) in the main Zotero pane
• Add to Collection — Submenu to add selected items to any collection

🌙 Dark Mode Improvements

Better text contrast on selected rows in both light and dark modes.

🐛 Bug Fix: Database Persistence

Fixed database being wiped on plugin reload during development. The database is now only deleted on true uninstall, not on upgrade or reload.

Installation

1. Download zotseek-1.8.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

No action required. Your existing index will be preserved.

Full Changelog: v1.7.0...v1.8.0

What's New

🔀 Multi-Query Search

Combine up to 4 search queries with AND/OR logic to find papers at the intersection of multiple topics:

• Click "+" to add additional query fields (up to 4 total)
• AND mode: Find papers matching ALL queries (intersection)
• OR mode: Find papers matching ANY query (union)

Per-query scores shown in Match column: e.g., 73% (77|73|68) shows combined score and individual query scores.

⚡ Improved Progress Window

• Dynamic height that adjusts to content (min: 120px, max: 400px)
• Checkpoint messages now display in reverse order (newest first)
• Window stays within main Zotero window bounds

Installation

1. Download zotseek-1.7.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

No action required. Your existing index and settings will be preserved.

Full Changelog: v1.6.0...v1.7.0

What's New

💾 Crash-Resilient Indexing

Indexing now saves progress every 25 items:

• Resume safely after crash by re-running "Update Index"
• Already-indexed items are automatically skipped
• No need to start over from scratch

⚙️ Redesigned Settings Panel

Modern, visual preferences UI:

• Index statistics as colorful cards (Papers, Chunks, Storage)
• Indexing mode selection with visual radio-style cards
• Organized sections with clear visual hierarchy
• Action buttons color-coded (green = recommended, yellow = destructive)

🔧 Settings Button in Search Dialog

Quick access to ZotSeek preferences directly from the search dialog (bottom-left corner).

🏷️ Improved Alerts

Dialogs now show "ZotSeek" title instead of generic "[JavaScript Application]".

Installation

1. Download zotseek-1.6.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

Full Changelog: v1.5.0...v1.6.0

What's New

🔄 Auto-Index New Items

Automatically index papers when you add them to your library:

• Enable in Settings → ZotSeek → "Auto-index new items"
• Waits for PDF attachments with automatic retry
• Batches items during bulk imports
• Shows live progress indicator

📊 Column Sorting

Click column headers to sort search results:

• Sort by Match %, Year, Title, Authors, or Source
• Smart defaults (Match/Year descending, text ascending)
• Visual indicators (▲/▼) show sort direction

Installation

1. Download zotseek-1.5.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

Full Changelog: v1.4.0...v1.5.0

What's New

📦 Zotero 7 Support

Now compatible with both Zotero 7 (stable) and Zotero 8 (beta):

• Extended compatibility from strict_min_version: 6.999
• Same feature set across both versions
• Automatic performance optimization per version

📄 Full Paper Mode is Now Default

Full Document indexing is now the default for better search quality:

• Indexes paragraph-level content from PDFs with exact page numbers
• Best for finding specific passages and deep content search
• Can still switch to Abstract mode for faster indexing

⚡ Version-Aware Optimizations

The plugin automatically detects your Zotero version and optimizes settings:

⚠️ Zotero 7 Performance Note: Full Document indexing is ~8-10x slower on Zotero 7 (Firefox 115) compared to Zotero 8 (Firefox 140+) due to WASM SIMD performance differences. For faster indexing on Zotero 7, use Abstract mode or keep Max Tokens ≤1000.

🔧 Automated Release Workflow

New npm run release command for developers:

• Interactive version bumping via bumpp
• Auto-generates update.json from package.json
• Builds and packages XPI in one command

Installation

1. Download zotseek-1.4.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

No action required. The plugin will use optimized defaults based on your Zotero version.

If you previously had custom settings, they will be preserved. Consider adjusting:

• Zotero 7 users: Lower Max Tokens to ≤1000 for better performance
• Zotero 8 users: Can use higher values (2000+) without issues

Full Changelog: v1.3.0...v1.4.0

What's New

📄 Search from PDF Selection

Select text in any PDF and right-click to find related documents:

• Appears in context menu: "Find Related Documents"
• Opens ZotSeek search dialog pre-filled with your selection
• Automatically excludes the current document from results
• Great for exploring concepts while reading

⚡ GPU Acceleration (Experimental)

Automatic WebGPU detection for faster indexing:

Check debug console for "Model loaded on GPU" or "Model loaded on CPU".

Note: Waiting for Zotero/Firefox to enable WebGPU (Firefox 141+ on Windows, macOS/Linux coming)

🐛 Scrolling Fix for Windows

Fixed VirtualizedTable scrolling in search dialogs:

• Results list now scrolls properly when content exceeds visible area
• Affects both ZotSeek search and "Find Similar Documents" dialogs

Installation

1. Download zotseek-1.3.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

Upgrade Notes

No action required. The new PDF selection feature is available immediately in the reader context menu.

Full Changelog: v1.2.0...v1.3.0

What's New

📍 Result Granularity Toggle

Switch between two search result views in Full Document mode:

In By Location mode, clicking a result opens the PDF directly to the matching page.

🚫 References Filtering

Bibliography sections are now automatically excluded from indexing:

• Detects headers: "References", "Bibliography", "Works Cited"
• Recognizes citation patterns: [1], Smith, J. (2021)., DOI links
• Keeps search results focused on actual paper content

🔒 Privacy Documentation

Added a dedicated Privacy & Security section confirming:

• AI model is bundled (no API calls)
• All processing happens locally
• Zero network requests for search/indexing
• Your research never leaves your machine

Installation

1. Download zotseek-1.2.0.xpi below
2. In Zotero: Tools → Plugins → ⚙️ → Install Plugin From File
3. Select the downloaded .xpi file
4. Restart Zotero

⚠️ Upgrade Notes

If using Full Document indexing mode:

1. Increase Max Chunks per Paper — The new paragraph-level chunking creates more chunks per document. Go to Zotero → Settings → ZotSeek and increase "Max Chunks per Paper" (recommended: 50-100) to fully index longer papers.

2. Rebuild your index — Clear and re-index your library to apply references filtering and capture the new location metadata.

Full Changelog: v1.1.0...v1.2.0

What's Changed

Changed

• Database Storage - Moved from tables in Zotero's main database to separate zotseek.sqlite file
  • Uses SQLite ATTACH DATABASE pattern (inspired by Better BibTeX)
  • Keeps Zotero's main database clean and unbloated
  • Automatic migration from old schema (no user action required)
• Menu Label - Renamed "Index for ZotSeek" to "Index Selected for ZotSeek" for clarity

Added

• Database Path Display - Settings panel now shows the database file location
• Uninstall Cleanup - Automatically removes database file and preferences on plugin uninstall

Technical

• Database file stored at: <Zotero Data Directory>/zotseek.sqlite
• Migration copies data from old zs_ tables, then drops them and runs VACUUM

Installation

Download zotseek-1.1.0.xpi and install via: Zotero → Tools → Add-ons → Install Add-on From File

Full Changelog: CHANGELOG.md