Release v0.3.0

🚀 Enhancements

• Add --ignore-duplicates option to import_arxiv.py (5fda490)
• Add --list-collections option to browse Zotero collections (630a64f)
• Support path syntax for --collection to disambiguate same-name collections (9c92e51)
• Collection cache via stdout redirect and skill guidance (15441d8)

🩹 Fixes

• Add PDF upload via saveAttachment and fix prettier lint (7826bd1)
• Use updateSession to target collection instead of ignored payload field (6e58004)
• Correct repository URL in package.json for release CI (32ef583)

💅 Refactors

• Simplify SKILL.md and resolve_collection matching logic (089e42a)

📖 Documentation

• Restructure README and optimize read-paper skill (0140e95)

🏡 Chore

• Bump version to 0.3.0 for release (f62c64b)

❤️ Contributors

• X1AOX1A

Release Manifest

This release is used to host update.json, please do not delete or modify it!
Updated in UTC 2026-05-21T09:19:46.541Z for version 0.3.0

ZoFiles v0.2.0

What's New

Allin — flat view of all papers in a collection hierarchy

• Allin/ now aggregates all papers from the current collection and every descendant, not just direct items
• Created whenever a collection has subcollections (even if the parent has no direct papers)

Collection tree refresh

• Added Refresh button in preferences to reload the collection tree after reorganizing collections in Zotero

Export root rebase

• When changing the export root path, ZoFiles now offers to update the index automatically — no full rebuild needed after moving the directory

Other

• Added pre-commit checklist to CLAUDE.md
• Ignored tsconfig.tsbuildinfo build artifact

ZoFiles v0.1.0

ZoFiles v0.1.0 — Initial Release

Export Zotero papers to organized filesystem folders with per-paper content.

Features

• 📁 Collection mirroring — Zotero collection tree → real directory tree
• 📄 Rich content export — PDF, full-text Markdown, BibTeX, Kimi AI review, notes, arXiv ID
• 🔄 Auto-sync — event-driven export on add/modify/move/delete
• ⚡ Incremental rebuild — only processes new/changed items
• 🔗 Link back — optionally create linked attachments in Zotero
• 🌐 Localization — English & 中文

Install

1. Download zo-files.xpi below
2. In Zotero: Tools → Add-ons → ⚙️ → Install Add-on From File
3. Select the downloaded .xpi file
4. Go to Zotero → Settings → ZoFiles to configure export root and run initial rebuild

Requirements

• Zotero 7 or 8
• Papers must have extractable arXiv IDs