前言¶
旅行或活动结束，手机里往往是一串 IMG_xxxx、DSC_xxxx 文件名，按时间翻找、按地点归档都不顺手。手工在资源管理器里逐个改名，几十张还能忍，上百张就容易出错。下面介绍 SkillHub 上的社区 Skill「批量重命名照片」（@user_f8ee4625/photo-renamer-tool），让 Agent 按约定规则在本地文件夹里批量改名，把「日期 + 地点 + 序号」落到文件名上。
这是什么¶
「批量重命名照片」是面向办公与日常整理场景的 Agent Skill，坐标为 @user_f8ee4625/photo-renamer-tool，当前版本 1.0.0，来源为 community，分类 office-efficiency，由 SkillHub 用户 user_f8ee4625 发布；技能包内作者标识为 jm-jsjkxyjs02-wzy-704。它解决的是：同一目录下多张照片命名杂乱、需要按拍摄日期与地点统一成可读文件名的问题。标签标明 requires_api_key=false，不依赖外部 API Key。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 917 次，安装计数 0。
核心功能¶
依据技能包内 SKILL.md 与 photo_renamer.js，已核实能力如下：
- 读取 EXIF 拍摄日期：从图片 EXIF 的
DateTimeOriginal生成YYYY-MM-DD；读取失败时脚本会回退到文件修改时间（mtime）。 - 统一命名格式：
YYYY-MM-DD_地点_序号，序号为三位补零（如001、002）。 - 批量处理目录：对指定文件夹内符合扩展名的图片逐个重命名，并输出处理数量与部分改名对照。
- 支持格式：
.jpg、.jpeg、.png、.heic。 - 必填参数：
targetDir（照片目录）、location（地点字符串，如「北京」「长城」）。
技能说明中的示例结果形如：2026-05-01_北京_001.jpg。
安装与启用¶
安装前需有 SkillHub CLI。官方安装说明见 skillhub.cn/install/skillhub.md。
检查是否已安装：
command -v skillhub && skillhub --version
未安装时可执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
将 Skill 装进当前 Agent 的 skills 目录（必须使用 --dir，否则默认落在 ./skills/ 且可能不被识别）。在 Cursor 上常用路径为 ~/.cursor/skills/：
skillhub install photo-renamer-tool --namespace user_f8ee4625 --dir ~/.cursor/skills/
也可在对话中让 AI 按官方指引安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f8ee4625/photo-renamer-tool`。
Claude Code、Codex 等等效路径分别为 ~/.claude/skills/、~/.codex/skills/ 或项目下的 .agents/skills/，安装命令中的 --dir 换成对应目录即可。
技能脚本依赖 Node.js 与 exif-parser（脚本注释：npm install exif-parser）。安装 Skill 后若执行改名脚本报缺模块，需在技能目录或项目环境中自行安装该依赖。
安装或修改 skills 后，按你所用客户端要求重启或刷新 Agent，使新 Skill 被加载。
典型用法¶
自然语言（与 SKILL.md 示例一致）
用户可以说：
帮我把 D:\旅行照片 里的文件按日期重命名，地点写北京
Agent 应解析出文件夹路径与地点，并调用技能入口，传入 targetDir 与 location。
参数约定
| 参数 | 含义 |
|---|---|
targetDir |
照片所在文件夹路径（必填） |
location |
拍摄地点名称（必填） |
缺参时脚本返回提示，例如要求提供「文件夹路径」与「地点」。
预期结果
目录内图片被重命名为 日期_地点_序号.扩展名，技能说明中给出的形态为 2026-05-01_北京_001.jpg，并按说明按拍摄相关时间排序后编号。
适用场景与注意¶
适合谁
- 旅行、团建、活动后需要把一文件夹照片改成「日期 + 地点 + 序号」的人。
- 已在 Cursor、Claude Code 等支持 Skill 的环境工作，希望用对话指定目录和地点、由 Agent 驱动本地脚本的用户。
限制与注意
- 仅处理上述四种扩展名；其他格式会被忽略。
- 重命名是原地覆盖式改名（
fs.renameSync），操作前请备份或确认目录无误；脚本不提供 dry-run。 - EXIF 缺失时日期可能来自文件时间，与真实拍摄日可能不一致。
- 技能包为社区来源，维护节奏以 SkillHub 页面与发布者为准；下载接口需使用
photo-renamer-tool与namespace=user_f8ee4625形式（skillhub search photo-renamer会给出等价安装命令）。
结尾¶
「批量重命名照片」把 EXIF 日期、地点与序号固化到文件名里，适合整理杂乱相册目录，且无需 API Key。需要查看版本与安装入口时，可打开 SkillHub 页面：
- https://www.skillhub.cn/skills/user_f8ee4625/photo-renamer-tool
- https://api.skillhub.cn/user_f8ee4625/photo-renamer-tool
