企业官网建设流程全解析

ai-renamer 快速上手：从满文件夹 IMG 文件到 AI 文件重命名的 5 分钟

【免费下载链接】ai-renamerA Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents项目地址: https://gitcode.com/gh_mirrors/ai/ai-renamer

手机相册导出来一文件夹 IMG_20240612，录屏全是 ScreenRecording，逐个点开看内容不现实。ai-renamer 做的事就一件：让本地大模型读文件内容，把文件名改成有意义的，比如一张夕阳照片变成 sunset-over-sea。装好依赖、跑通第一次 AI 文件重命名，5 分钟够了。

跑通它需要哪些东西

工具本身不带模型，它只是调用你机器上的模型服务，所以先把下面几样备齐：

装好它

装它只需要一条命令：

npm install -g ai-renamer

跑ai-renamer --help验证：打印出参数列表就算装好了。不想装也行，之后每次用npx ai-renamer代替ai-renamer运行。

第一条命令跑起来

最小命令就是工具名加一个路径，指向你要重命名的文件夹或单个文件：

ai-renamer ~/photos

首次启动它会自动连 Ollama，拉取模型列表并优先挑 Llava，终端会先打印 provider、模型、Base URL 等本次用的参数，再逐个文件重命名。

重命名一整张相册：想统一命名风格时，用--case指定大小写样式（camelCase、snakeCase、kebabCase 等都支持）：

ai-renamer ~/photos --case=camelCase

只处理视频：视频靠 ffmpeg 抽帧（默认 3 帧），长视频可以适当多抽几帧让判断更准：

ai-renamer ~/videos --frames=5

换 provider 或指定模型：本地跑 LM Studio、或者改用 OpenAI 云模型，写法见下表：

配置与进阶 📋

传过一次的标志值不会白传：provider、model、base URL、API key 等都会被写入~/ai-renamer.json（Mac 上是/Users/你的用户名/ai-renamer.json）。你改过一次，就再也不用重复传--provider了，脚本直接从配置文件取值。换端口、换模型时再传一次新值，配置会被覆盖。不想走命令行也可以直接编辑这个 JSON 文件，字段名如defaultBaseURL、defaultModel、defaultApiKey。

命名行为说明

模型先按提示词生成不带扩展名、不含特殊字符的短描述，再交给change-case库按你指定的 case 统一成风格。默认样式是 kebabCase，默认最长 20 字符，效果大致是：

IMG_20240612_093045.jpg → sunset-over-sea.jpg ScreenRecording2024-06-15.mp4 → developer-presenting-new-app.mp4

卡住了先看这里

• 提示连不上 Ollama 或找不到模型 → 确认 Ollama 服务正在运行，再看终端Available models一行实际列出了哪些模型。
• 视频处理失败 → 终端执行ffmpeg -version，没装就先装上。
• 生成的名字太短或跑题 → 加--custom-prompt引导模型，例如"Only describe the background"。
• 文件名大小写风格不对 → 重新传一次--case=camelCase，新值会覆盖旧配置。
• 不确定支持哪些参数 →ai-renamer --help里全有，--frames、--chars、--language都能调。

它覆盖图片、视频、PDF 以及代码和文本文件，一批难认的文件名可以变成能按语义检索的。想再进一步，试试加--include-subdirectories=true，让子目录里的文件一起被处理。

【免费下载链接】ai-renamerA Node.js CLI that uses Ollama and LM Studio models (Llava, Gemma, Llama etc.) to intelligently rename files by their contents项目地址: https://gitcode.com/gh_mirrors/ai/ai-renamer