File Processor - 文件处理技能

概述

此技能提供文件重命名和格式转换功能，用于批量处理文件的命名和格式。支持批量重命名操作和多种文件格式之间的转换。

使用时机

当用户需要以下操作时使用此技能：

文件重命名：

• - 批量为文件添加前缀或后缀
• 替换文件名中的部分文本
• 按编号规则重命名文件
• 使用正则表达式进行复杂重命名
• 重命名单个文件

格式转换：

• - 图片格式转换 (JPG/PNG/WebP/BMP/TIFF 互转)
• PDF 转为图片
• 多张图片合并为 PDF
• Word 文档 (DOCX) 转为 PDF
• Markdown 文档转为 PDF

工作流程

文件重命名流程

1. 1. 确定重命名类型

- 添加前缀/后缀：使用 addprefix() 或 addsuffix() - 替换文本：使用 replace_text() - 编号重命名：使用 renamewithnumbering() - 正则表达式：使用 renamewithregex()

1. 2. 执行重命名

- 创建 FileRenamer 实例，指定目录路径 - 调用相应的重命名方法 - 执行 execute() 完成重命名

1. 3. 验证结果

- 检查文件是否按预期重命名 - 确认无命名冲突

格式转换流程

1. 1. 确定转换类型

- 图片格式转换：使用 convert_images() - PDF 转图片：使用 convertpdfto_images() - 图片转 PDF：使用 convertimagesto_pdf() - DOCX 转 PDF：使用 convertdocxto_pdf() - Markdown 转 PDF：使用 convertmarkdownto_pdf()

1. 2. 执行转换

- 创建 FormatConverter 实例 - 调用相应的转换方法 - 执行 execute() 完成转换

1. 3. 验证结果

- 检查转换后的文件格式和质量 - 确认文件完整性

使用方法

文件重命名

1. 批量添加前缀

python
from scripts.rename_files import FileRenamer

为所有文件添加前缀

renamer = FileRenamer(/path/to/directory) renamer.addprefix(new) renamer.execute()

2. 批量添加后缀

python

为所有文件添加后缀（在扩展名前）

renamer = FileRenamer(/path/to/directory)
renamer.addsuffix(backup)
renamer.execute()

3. 替换文件名中的文本

python

将文件名中的 old 替换为 new

renamer = FileRenamer(/path/to/directory)
renamer.replace_text(old, new)
renamer.execute()

4. 按编号规则重命名

python

将文件按名称排序，重命名为 photo001.jpg, photo002.jpg 等

renamer = FileRenamer(/path/to/directory)
renamer.renamewithnumbering(
pattern=photo_{}.jpg,
start_num=1,
digits=3,
sort_by=name # 也可为 size 或 date
)
renamer.execute()

5. 使用正则表达式重命名

python

使用正则表达式重命名

renamer = FileRenamer(/path/to/directory)

例如：将 IMG1234.jpg 改为 image1234.jpg

renamer.renamewithregex(rIMG(\d+), rimage\1)
renamer.execute()

6. 预览模式（不实际执行）

python

使用 dry_run 模式预览重命名效果

renamer = FileRenamer(/path/to/directory, dry_run=True)
renamer.addprefix(test)
renamer.execute() # 只显示预览，不实际重命名

格式转换

1. 图片格式转换

python
from scripts.convert_format import FormatConverter

将目录中的所有 JPG 图片转换为 PNG 格式

converter = FormatConverter() converter.convert_images( directory=/path/to/images, target_format=png, quality=95 ) converter.execute()

2. PDF 转图片

python

将 PDF 转换为 PNG 图片

converter = FormatConverter()
converter.convertpdfto_images(
pdf_path=/path/to/file.pdf,
output_dir=/path/to/output,
format=png,
dpi=300
)
converter.execute()

3. 图片转 PDF

python

将目录中的图片合并为一个 PDF

converter = FormatConverter()
converter.convertimagesto_pdf(
directory=/path/to/images,
output_pdf=/path/to/output.pdf,
sort=True # 按名称排序
)
converter.execute()

4. DOCX 转 PDF

python

将 Word 文档转换为 PDF

converter = FormatConverter()
converter.convertdocxto_pdf(
docx_path=/path/to/document.docx,
output_pdf=/path/to/output.pdf
)
converter.execute()

5. Markdown 转 PDF

python

将 Markdown 文档转换为 PDF

converter = FormatConverter()
converter.convertmarkdownto_pdf(
md_path=/path/to/document.md,
output_pdf=/path/to/output.pdf
)
converter.execute()

脚本使用说明

rename_files.py

文件重命名工具，提供以下命令行功能：

bash

添加前缀

python renamefiles.py /path/to/directory prefix newprefix

添加后缀

python renamefiles.py /path/to/directory suffix backup

替换文本

python rename_files.py /path/to/directory replace old new

编号重命名

python renamefiles.py /path/to/directory numbering photo{}.jpg --start 1 --digits 3 --sort name

正则表达式重命名

python renamefiles.py /path/to/directory regex IMG(\d+) image_\1

预览模式（不实际执行）

python renamefiles.py /path/to/directory prefix test --dry-run

convert_format.py

文件格式转换工具，提供以下命令行功能：

bash

图片格式转换

python convert_format.py images /path/to/images png --quality 95

PDF 转图片

python convert_format.py pdf-to-images /path/to/file.pdf /path/to/output --format png --dpi 300

图片转 PDF

python convert_format.py images-to-pdf /path/to/images /path/to/output.pdf

DOCX 转 PDF

python convert_format.py docx-to-pdf /path/to/document.docx /path/to/output.pdf

Markdown 转 PDF

python convert_format.py md-to-pdf /path/to/document.md /path/to/output.pdf

预览模式

python convert_format.py images /path/to/images png --dry-run

依赖要求

文件重命名：

• - Python 3.6+
• 无额外依赖（仅使用标准库）

格式转换：

• - Python 3.6+
• Pillow：图片处理 (pip install Pillow)
• pdf2image：PDF 转图片 (pip install pdf2image)
• docx2pdf：DOCX 转 PDF (pip install docx2pdf)
• markdown + weasyprint：Markdown 转 PDF (pip install markdown weasyprint)

注意：pdf2image 需要 Poppler 库在 Windows 上。可以从 https://github.com/oschwartz10612/poppler-windows/releases/ 下载并安装。

最佳实践

1. 1. 使用预览模式：在执行批量操作前，先使用 dry_run=True 预览结果
2. 备份重要文件：执行批量重命名或转换前，先备份重要文件
3. 检查依赖：执行格式转换前，确保已安装所需的 Python 库
4. 验证结果：执行完成后，检查文件是否符合预期
5. 处理冲突：脚本会自动跳过会产生命名冲突的重命名操作

常见问题

Q：重命名操作可以撤销吗？
A：重命名操作是不可逆的。建议先使用 dry_run=True 预览，确认无误后再执行。

Q：如何处理嵌套目录中的文件？
A：当前脚本仅处理指定目录中的文件，不递归处理子目录。如需处理子目录，需要手动遍历。

Q：图片转换会保持原质量吗？
A：可以通过 quality 参数控制图片质量（1-100），默认为 95。

Q：PDF 转图片需要安装什么？
A：需要安装 pdf2image 库和 Poppler 库。Poppler 在 Windows 上需要单独下载安装。

Q：支持哪些图片格式？
A：