ai-renamer 是一个 Node.js 命令行工具,旨在通过人工智能技术根据文件内容自动重命名文件。它利用 Ollama 或 LM Studio 提供的本地大语言模型(如 Llava、Gemma、Llama 等)来分析文件内容,并生成更合适的文件名。
主要能力
- 智能重命名:基于文件内容(如图片、视频)自动生成描述性文件名。
- 多模型支持:兼容 Ollama 和 LM Studio 中的多种 LLM,包括 Llava、Gemma、Llama 等。
- 多提供商:默认使用 Ollama,也可配置为 LM Studio 或 OpenAI。
- 自动模型选择:首次启动时自动尝试选择 Llava 模型;对于 LM Studio,自动选择已加载的模型;对于 OpenAI,自动选择 gpt-4o 模型。
- 配置持久化:通过命令行标志设置的参数会保存到 ~/ai-renamer.json(Mac 为 /Users/your-user-name/ai-renamer.json),后续无需重复设置。
- 自定义端口:如果 Ollama 或 LM Studio 使用非默认端口,可指定基础 URL。
- 大小写风格:使用 change-case 库处理文件名的大小写样式。
使用方式
- 确保系统已安装 Ollama 或 LM Studio,并至少安装一个 LLM(如 Llava、Gemma、Llama 等)。如需重命名视频,还需安装 ffmpeg。
- 通过 npx 运行:
npx ai-renamer /images。首次启动会自动选择 Llava 模型,若失败可手动指定模型。 - 使用 LM Studio:设置提供商为
lm-studio,工具会自动选择 LM Studio 中已加载的模型。 - 使用 OpenAI:设置提供商为
openai并提供 API 密钥,工具会自动选择 gpt-4o 模型,也可通过--model标志指定其他模型。 - 自定义端口:通过基础 URL 参数指定 Ollama 或 LM Studio 的地址。
- 配置保存:使用过的标志值会保存到磁盘,后续运行自动读取。
适用场景
- 整理大量图片或视频文件,需要根据内容生成有意义的文件名。
- 本地隐私敏感场景,使用 Ollama 或 LM Studio 在本地运行模型。
- 希望利用 OpenAI 等云端模型进行文件重命名。
限制
- 需要预先安装 Ollama 或 LM Studio 以及至少一个 LLM。
- 重命名视频需要额外安装 ffmpeg。
- 使用 OpenAI 需要提供 API 密钥,可能产生费用(具体费用未提供)。
- 工具为命令行界面,无图形界面;桌面应用需访问 airenamer.app(未提供详细信息)。
- 模型效果取决于所选 LLM 的能力,未提供具体准确率或性能数据。