# file-batch-renamer

**Repository Path**: aa361604324/file-batch-renamer

## Basic Information

- **Project Name**: file-batch-renamer
- **Description**: 批量文件整理和重命名小工具示例
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-16
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# file-batch-renamer

批量文件整理和重命名小工具示例。

适合场景：

- 下载了一批图片、PDF、附件，需要按表格重命名
- 文件名杂乱，需要补序号、客户名、日期、类型
- 需要把成功和失败的文件整理成日志

## 示例输入

`examples/rename_map.csv`

```csv
source,target
raw/a001.pdf,001_合同_A公司.pdf
raw/img_002.jpg,002_现场照片.jpg
```

## 运行

```bash
python3 scripts/batch_rename.py examples/rename_map.csv outputs --base-dir examples
```

默认会复制文件到输出目录，不会改动原文件。

如确认要移动原文件：

```bash
python3 scripts/batch_rename.py examples/rename_map.csv outputs --base-dir examples --move
```

## 验证

```bash
bash run_checks.sh
```

验证内容：

- 文件名安全清洗
- 重名自动追加序号
- 示例文件整理实跑

## 客户需要提供

- 原始文件压缩包或文件夹
- 改名规则或映射表
- 目标命名样例
- 是否按类型、日期、编号分文件夹

## 交付内容

- 整理后的文件夹
- 改名映射表
- 处理日志
- 可复用脚本

## 不处理

- 来源不明或涉嫌侵权的文件
- 需要破解、绕登录下载的附件
- 涉及隐私批量传播的材料