uv-rules

namingpaper 是一款专为研究人员和学者设计的命令行工具 (CLI)，旨在整理杂乱的 PDF 文件库。它通过大型语言模型自动从文档内容中提取作者、年份、期刊名称和标题，省去手动命名的繁琐过程。该工具专注于可靠性，默认开启试运行 (dry-run) 模式，确保文件操作安全可控。

• 利用 AI 自动从学术 PDF 提取元数据（作者、年份、期刊、标题）。

• 支持多种 AI 提供商：Anthropic Claude、OpenAI、Google Gemini 以及本地的 Ollama 模型。

• 具备批量处理功能，可通过单一指令处理整个目录结构。

• 提供可自定义的文件名模板，并支持 JFE、AER、QJE 等常见期刊缩写。

• 包含碰撞处理策略：跳过、递增编号或覆盖文件。

• 通过试运行模式、确认提示及复制到输出目录等功能确保操作安全。

• 需要 Python 3.11+，建议使用 uv 进行依赖管理。

• 使用 rename 指令处理单个文件，使用 batch 指令处理大型集合。

• 通过环境变量 (NAMINGPAPER_...) 或 ~/.namingpaper/config.toml 设置 API 密钥。

• 确认预览结果后，使用 --execute 指令应用变更。

• 若使用默认的 Ollama 提供商，请确保本地 Ollama 服务已启动。

• 可通过 pipx 安装与管理。