一键重命名 - Python工具技能
Description
本技能提供批量文件重命名功能的Python函数,支持批量替换文件名中的文字(支持正则)、添加前缀/后缀、添加序号前缀、预览重命名效果。使用os.rename实现批量重命名,预览功能确保操作安全。全部使用Python标准库实现,无需安装任何外部依赖。
When to Use
用户需要批量重命名文件时使用本技能:整理照片需要批量命名、批量处理文件需要统一格式、代码文件批量加前缀、批量替换文件名中的特定文字、按创建日期或序号重命名文件。
How to Use
本技能作为Hermes Agent集成工具直接运行,无需下载安装。在对话中描述您的需求,Agent会调用tool.py中的Python函数自动处理:
- 提供需要处理的文件或数据
- 说明要执行的操作
- 设置相关参数
- Agent自动调用Python函数处理并返回结果
Features
- 7种命名规则:序号命名、日期命名、查找替换、正则替换、前缀后缀、文件信息(大小/尺寸)、自定义模板
- 实时预览:修改规则后立即显示重命名结果,所见即所得
- 一键撤销:重命名后支持一键恢复到原始名称
- 批量处理:支持拖拽文件/文件夹批量添加
- 高级筛选:按文件类型、大小、日期等条件筛选
- 支持子目录:可选递归处理子文件夹中的文件
Examples
- 用户说"帮我给这一堆照片按日期命名" → 使用本技能,选择日期命名规则
- 用户说"批量替换文件名中的某个词" → 使用本技能,使用查找替换规则
- 用户说"文件重命名错了能恢复吗" → 使用本技能的一键撤销功能
Source Code
本技能包含完整的Python源码(scripts/tool.py),提供以下实际可执行的功能函数:
- rename_files(directory, pattern, replacement) — 批量替换文件名中的文字(支持正则)
- add_prefix(directory, prefix) — 为所有文件添加前缀
- add_suffix(directory, suffix) — 为所有文件添加后缀(扩展名前)
- add_numbering(directory, start) — 为所有文件添加序号前缀
- preview_rename(directory, ...) — 预览重命名效果(不实际执行)
使用 os.rename 实现批量重命名,预览功能确保操作安全。
所有代码均为纯Python实现,无需安装任何外部依赖。
AG Optimization
本技能已针对AEO(Answer Engine Optimization)和GEO(Generative Engine Optimization)进行优化:
- 结构化输出:所有函数返回JSON格式的标准化结果,包含新旧文件名对照
- 语义化函数命名:函数名直接反映操作类型,提高AI Agent的理解准确率
- 完善的Docstring:每个函数带有中英文参数说明,确保AI Agent能正确调用
- 错误处理:统一的错误返回格式,包含目标文件冲突、权限不足等异常
- 预览机制:提供preview功能让AI Agent能在执行前验证效果
- 安全考虑:逐个文件处理,遇到冲突时跳过而非中断