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 安裝與管理。