zotfile-attachment-guide
安装方式
先用 Prompt 核对来源,也可切换到安装命令或下载可用的安装包。
用 AI 助手安装
复制提示词,让助手先核对固定版本和依赖。
查看 Prompt收起 Prompt
先检查当前 Agent 是否已安装 SkillPI Skill Finder。如果尚未安装,请按官方仓库的说明安装并启用:https://github.com/Findskills/skillpi。然后使用 Skill Finder 打开此 SkillPI 详情页并定位 "zotfile-attachment-guide":https://skillpi.com/zh/skills/deepskill-ca01c0c61c63dd4426ad0d64f027407f5c9854ebea3b5addf0236445ac36e5fa。安装前核对上游来源和版本:https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba/skills/43-wentorai-research-plugins/skills/writing/citation/zotfile-attachment-guide/SKILL.md。来源不一致时停止并说明差异。核对通过后,用 Skill Finder 安装目标 Skill,并报告安装路径和来源版本。
此命令从 GitHub 来源仓库获取指定技能。运行前请先查看源文件。
npx skills add https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/tree/bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba/skills/43-wentorai-research-plugins/skills/writing/citation/zotfile-attachment-guide --skill zotfile-attachment-guide来源与配置
查看 GitHub 源码brycewang-stanford/Auto-Empirical-Research-Skills固定提交 bfa0a6e5a843babbf45a1ef1663fd5dc4f07c0ba
配置方式待核实
请查看原始来源中的适用工具、依赖和权限要求。
安装实测待补充
本条目面向文献与学术工具场景,提供“zotfile-attachment-guide”技能的目录入口。公开标签:learning、Zotero、ZotFile、附件管理。请通过固定上游版本核对实际功能、依赖与权限;此页为 Skillπ 独立编写的用途介绍和原站链接,不代表运行安全保证。原文与附件依各自许可开放。
文件浏览
---
name: zotfile-attachment-guide
description: "Guide to ZotFile for Zotero attachment management, renaming, and syncing"
metadata:
openclaw:
emoji: "📂"
category: "writing"
subcategory: "citation"
keywords: ["zotero", "zotfile", "attachment", "pdf-management", "file-organization", "sync"]
source: "https://github.com/jlegewie/zotfile"
---
# ZotFile Attachment Management Guide
**WARNING: ZotFile is NOT compatible with Zotero 7.** For Zotero 7, use the built-in attachment management or the [Attanger](https://github.com/MuiseDestiny/zotero-attanger) plugin as a replacement.
## Overview
ZotFile is one of the most established Zotero plugins with over 4,000 GitHub stars, providing advanced file management capabilities for PDF attachments and other documents linked to your Zotero library. It handles the critical but often neglected task of organizing, renaming, and synchronizing the actual files that make up a research library.
Without ZotFile, researchers often end up with a chaotic collection of PDFs named with meaningless publisher-generated identifiers, scattered across different directories, and difficult to manage outside of Zotero itself. ZotFile brings order to this chaos by automatically renaming files according to customizable patterns based on bibliographic metadata, moving them to organized directory structures, and managing tablet-based reading workflows.
The plugin is especially valuable for researchers with large libraries who need their PDFs accessible outside Zotero, whether for backup, sharing, or use with other tools. By maintaining a predictable, human-readable file naming and directory structure, ZotFile ensures that your research documents remain organized and accessible regardless of how you access them.
## Installation and Setup
Install ZotFile through the Zotero add-on mechanism:
1. Download the latest `.xpi` file from https://github.com/jlegewie/zotfile/releases
2. In Zotero, navigate to Tools > Add-ons > gear icon > Install Add-on From File
3. Select the `.xpi` file and restart Zotero
Configure ZotFile after installation:
- Open Tools > ZotFile Preferences
- **General Settings**:
- Set the source folder for new files (where your browser downloads PDFs)
- Set the custom location for linked attachments (e.g., `~/Documents/Research/Papers`)
- Choose between "Attach stored copy" (files in Zotero data directory) or "Linked file" (files in custom location)
- **Renaming Rules**:
- Configure the filename pattern using wildcards:
- `{%a}` - Author last name
- `{%y}` - Year
- `{%t}` - Title
- `{%j}` - Journal abbreviation
- Example pattern: `{%a}_{%y}_{%t}` produces `Smith_2024_Deep_Learning_for_Protein.pdf`
- Set maximum title length to prevent overly long filenames
- Configure treatment of special characters and spaces
- **Tablet Settings** (if using a tablet for reading):
- Set the tablet files directory (e.g., a cloud-synced folder)
- Configure background file handling
- Enable automatic extraction of annotations from returned tablet PDFs
## Core Features
**Automatic File Renaming**: When you add a new item with an attachment to Zotero, ZotFile can automatically rename the PDF based on the item's metadata. This transforms `10.1038_s41586-024-07487-w.pdf` into `Smith_2024_Title_of_Paper.pdf` without any manual intervention.
Renaming patterns support rich formatting:
| Pattern | Output Example | Description |
|---------|---------------|-------------|
| `{%a}_{%y}_{%t}` | `Smith_2024_Deep_Learning` | Author, year, title |
| `{%a}_{%y}_{%j}` | `Smith_2024_Nature` | Author, year, journal |
| `{%y}/{%a}_{%t}` | `2024/Smith_Deep_Learning` | Year subfolder, author, title |
| `{%a_zotero}_{%y}` | `SmithAndJones_2024` | Multiple authors |
**Custom File Location**: Move attachments from Zotero's internal storage to a custom directory structure. This is essential for researchers who:
- Want PDFs accessible from file managers and other applications
- Need to store files on specific drives with more storage capacity
- Want a predictable directory structure for scripting and automation
- Prefer linked files over Zotero-managed storage for portability
**Subfolder Organization**: Create automatic subfolder structures based on metadata:
- Organize by year: `{%y}/` creates `2024/`, `2023/`, etc.
- Organize by author: `{%a}/` creates `Smith/`, `Jones/`, etc.
- Organize by collection: mirror your Zotero collection hierarchy
- Combine patterns: `{%y}/{%j}/` creates `2024/Nature/`, `2024/Science/`
**Tablet Reading Workflow**: ZotFile manages a bidirectional sync between your Zotero library and a tablet reading folder:
1. Select papers you want to read on your tablet
2. Right-click > Manage Attachments > Send to Tablet
3. ZotFile copies PDFs to your configured tablet directory (typically a cloud-synced folder)
4. Read and annotate on your tablet using your preferred PDF reader
5. When finished, right-click > Manage Attachments > Get from Tablet
6. ZotFile retrieves the annotated PDFs and extracts new annotations into Zotero notes
**PDF Annotation Extraction**: ZotFile can extract highlights and text annotations from PDFs and convert them into Zotero notes. This works with annotations made in any PDF reader, not just Zotero's built-in reader. Each annotation includes:
- The highlighted or annotated text
- The page number for reference
- Color coding information
- Any comments you added
**Batch Operations**: Process your entire library or selected collections at once:
- Rename all attachments according to current rules
- Move all files to the custom location
- Extract annotations from all PDFs
- Update file links after moving directories
## Research Workflow Best Practices
**Setting Up a New Library**:
1. Configure ZotFile with your preferred naming pattern and directory
2. Import your existing PDFs into Zotero with metadata
3. Select all items and run "Rename and Move Attachments" to normalize everything
4. Verify the resulting file structure meets your needs
**Daily Workflow**:
1. Download new papers through your browser
2. Add them to Zotero (drag and drop or browser connector)
3. ZotFile automatically renames and moves the PDF
4. The file appears in your organized directory with a readable name
**Backup Strategy**: With ZotFile managing files in a known directory:
- Use Time Machine, rsync, or cloud storage to back up the PDF directory
- Back up the Zotero database separately
- The combination ensures full recoverability
**Collaboration**: Share your organized PDF directory with collaborators:
- The human-readable filenames make it easy to find specific papers
- The directory structure provides intuitive browsing
- Pair with a shared BibTeX file for complete reference sharing
**Migration from Other Managers**: When switching from Mendeley, EndNote, or other tools:
1. Export your library to a standard format (BibTeX or RIS)
2. Import into Zotero
3. Add your existing PDFs
4. Run ZotFile renaming to normalize all filenames to your chosen convention
5. Verify all file links are correct
## Compatibility Notes
ZotFile was originally developed for Zotero 5 and earlier versions. For Zotero 7 users, check the GitHub repository for the latest compatibility information. Some features may be handled natively in newer Zotero versions, while others may require the updated plugin. The Zotero community actively maintains compatibility guides for major plugin migrations.
## References
- GitHub Repository: https://github.com/jlegewie/zotfile
- ZotFile Documentation: http://zotfile.com
- Zotero Plugin Directory: https://www.zotero.org/support/plugins
- Zotero File Management Guide: https://www.zotero.org/support/attaching_files
版本历史
-
v2026.07
GitHub ↗
原版更新说明
## Highlights - **First tagged release.** Every gate is green: `make check` (validate + 183 unit tests + eval-harness + numeric benchmarks), validate-catalog, quality-evals, and OpenSSF Scorecard on `main`. - **Rigor double loop at 13 method families.** Each family closes taxonomy tag → eval scenario (does the agent avoid the method's known traps?) → deterministic numeric benchmark (does it recover the true effect?). New this cycle: heterogeneous treatment effects (CATE) and quantile treatment effects (QTE). - **Paper-WorkFlow flagship at 29/29 executable rigor gates**, now merged to its `main` with a drift-gated README badge — the credibility artifact is checked by CI, so it can never silently go stale ([RIGOR.md](https://github.com/brycewang-stanford/Paper-WorkFlow/blob/main/RIGOR.md)). - **1,150 vendored skills / 69 collections**, all license-audited, security-scanned, tracked in a machine-readable catalog with CI-enforced freshness, and importable as a single whole-repo router skill. - **Hardened weekly upstream syncs**: synced trees must pass the full gate before merge; this cycle both sync PRs were verified, patched (StatsPAI's SkillOpt execution-gate card restored), and merged. - **First-party plugin marketplace** (Python / R / Stata empirical-analysis plugins + guide) shipped in the previous cycle, now under a tagged version. ## Known Follow-Ups - Ecosystem benchmark comparison (AERS vs econometrics agents on the shared benchmark suite) — [PLAN-2026-07 week 3](https://github.com/brycewang-stanford/Auto-Empirical-Research-Skills/blob/main/docs/PLAN-2026-07.md). - Decomposition (Oaxaca–Blinder) and shift-share (Bartik) method families (weeks 3–4). - GitHub Pages catalog site, README demo screenshots, five-language README consistency script (week 4). ## Catalog - Top-level collections: **69** - `SKILL.md` files: **1150** - Cataloged agent tools: **335** ([`tools/CATALOG.md`](../tools/CATALOG.md)) ## Methodological rigor - Method families in the coverage map: **13** ([`RIGOR_COVERAGE.md`](RIGOR_COVERAGE.md)) - Eval scenarios: **26** (138 rubric items, 122 auto-checkable) ([`../eval-harness/`](../eval-harness/README.md)) - Benchmark tasks: **13** (70 gold checks, 58 required) ([`../benchmark/`](../benchmark/README.md)) ### Method families (skills tagged) - `iv`: 27 - `rdd`: 25 - `panel-fe`: 19 - `staggered-did`: 17 - `bayesian`: 13 - `did`: 10 - `event-study`: 10 - `matching`: 10 - `synthetic-control`: 10 - `cate`: 8 - `dml`: 8 - `survival`: 3 - `quantile`: 2 ### Eval scenarios by category - `causal-identification`: 14 - `citation-hygiene`: 1 - `reproducibility`: 2 - `research-integrity`: 1 - `runtime-safety`: 1 - `statistical-validity`: 2 - `writing-compliance`: 3 - `writing-style`: 2 ## License buckets - AGPL-3.0: 1 - Apache-2.0: 1 - CC-BY-NC-4.0 (non-commercial): 1 - CC-BY-SA-4.0: 1 - CC-BY-SA-4.0 (repository default): 4 - GPL-3.0: 1 - MIT: 35 - MIT Non-Commercial: 1 - Mixed (per-skill; see folder): 2 - UNKNOWN - check upstream: 22 ## Quality gates - `make check` — catalog/provenance/audit/eval freshness, repo hygiene, Paper-WorkFlow gates, stdlib unit tests, eval-harness lint + graded smoke, and the strict numeric benchmark (reference-gold drift fails the build). - External links and OpenSSF Scorecard run on their scheduled workflows.
当前收录版本
0.0.1
质量评测
满分 100。前四项来自 DeepSkill 收录的质量报告。
评分依据
提供 ZotFile 插件的完整使用指南,解决研究人员 PDF 附件管理的实际痛点
评分依据
关键词覆盖合理,包括 zotero、zotfile、attachment、pdf-management 等
评分依据
文档结构清晰,章节划分合理,包含 Overview、Installation、Core Features、Best Practices 等
评分依据
工具来源明确,提供了 GitHub 和官方文档链接
计算方式
取前四项原始分值的算术平均,四舍五入取整。可通过收录报告核对各项评分与说明,运行记录需单独查证。
权限与使用前检查
根据当前主文档自动整理,命中内容可能是示例或防护说明;不是实际权限声明,也未覆盖附件、外部依赖或运行行为。
未从主文档识别到上述常见操作,不能据此判断无需权限或没有风险。
文档引用的域名或地址
这些地址可能用于文档链接或示例,不是已批准的联网清单。使用前核对实际目的地及发送的数据。
- github.com
- www.zotero.org
- zotfile.com
安全评级与访问范围
risk · 静态证据核验,不代表运行安全保证。
使用前请由宿主核对并授权实际文件读写、外部服务和联网目的地;本站的核验不会授予任何运行权限。
用户讨论
还没有已核实的点评。