这个目录包含了用于文件操作的实用脚本。
这个脚本可以帮助你自动整理杂乱的文件夹，将文件按类型分类到不同的子文件夹中。
- 支持多种常见文件类型的自动分类（图片、文档、音频、视频等）
- 生成详细的整理报告
- 可选择只生成报告而不移动文件
- 支持排除指定目录
- 可选择是否处理隐藏文件
基本用法（整理当前目录）：
python organize_files.py整理指定目录：
python organize_files.py D:\Downloads仅生成报告而不移动文件：
python organize_files.py -r排除某些目录：
python organize_files.py -e 图片 文档包含隐藏文件：
python organize_files.py --include-hiddenusage: organize_files.py [-h] [-r] [-e EXCLUDE [EXCLUDE ...]] [--include-hidden] [directory]
文件整理工具 - 按类型整理文件
positional arguments:
directory 要整理的目录路径，默认为当前目录
options:
-h, --help 显示帮助信息并退出
-r, --report-only 仅生成报告，不移动文件
-e EXCLUDE [EXCLUDE ...], --exclude EXCLUDE [EXCLUDE ...]
排除的目录名列表
--include-hidden 包括隐藏文件
这个脚本提供了多种方式来批量重命名文件，支持多种重命名模式、文件筛选、预览和撤销功能。
- 多种重命名模式:
- 添加前缀/后缀
- 添加序列号
- 添加日期时间（文件修改时间或当前时间）
- 正则表达式替换
- 更改文件名大小写
- 替换空格为指定字符
- 高级文件筛选:
- 按文件扩展名筛选
- 按文件大小范围筛选
- 使用正则表达式排除文件
- 安全操作:
- 预览重命名效果
- 检测和提示命名冲突
- 自动备份被覆盖的文件
- 操作历史:
- 保存重命名操作历史
- 支持撤销之前的重命名操作
添加前缀：
python batch_rename.py --add-prefix "New_" 添加后缀（在扩展名前）：
python batch_rename.py --add-suffix "_edited" --before-ext添加序列号：
python batch_rename.py --add-sequence --start-num 1 --padding 3按修改日期重命名：
python batch_rename.py --add-date --use-file-time正则表达式替换：
python batch_rename.py --replace "(\d+)" "num_$1"更改文件名大小写：
python batch_rename.py --change-case upper替换文件名中的空格：
python batch_rename.py --replace-spaces "_"仅处理特定扩展名：
python batch_rename.py --add-prefix "Image_" -e jpg png gif递归处理子目录：
python batch_rename.py --add-date -r预览而不实际重命名：
python batch_rename.py --add-sequence --dry-run筛选大小范围的文件：
python batch_rename.py --add-prefix "Large_" --min-size 1048576查看历史重命名操作：
python batch_rename.py --list-history撤销之前的重命名操作：
python batch_rename.py --undo 1usage: batch_rename.py [-h] [-r] [--dry-run] [-e EXTENSIONS [EXTENSIONS ...]]
[--min-size MIN_SIZE] [--max-size MAX_SIZE]
[--exclude EXCLUDE] [--add-prefix PREFIX | --add-suffix SUFFIX |
--add-sequence | --add-date | --replace PATTERN REPLACEMENT |
--change-case {upper,lower,title,capitalize} |
--replace-spaces [CHAR] | --list-history | --undo ID]
[--before-ext] [--start-num START_NUM]
[--padding PADDING] [--seq-position {prefix,suffix}]
[--date-format DATE_FORMAT] [--use-file-time]
[--date-position {prefix,suffix}]
[directory]
批量文件重命名工具
positional arguments:
directory 要处理的目录路径，默认为当前目录
options:
-h, --help 显示帮助信息并退出
-r, --recursive 递归处理子目录
--dry-run 模拟运行，不实际重命名文件
文件筛选选项:
-e, --extensions EXTENSIONS [EXTENSIONS ...]
要处理的文件扩展名列表，如 '.jpg .png'
--min-size MIN_SIZE 最小文件大小（字节）
--max-size MAX_SIZE 最大文件大小（字节）
--exclude EXCLUDE 排除的文件名模式（正则表达式）
重命名操作（仅选择一种）:
--add-prefix PREFIX 添加前缀
--add-suffix SUFFIX 添加后缀
--before-ext 在扩展名前添加后缀，与--add-suffix一起使用
--add-sequence 添加序列号
--start-num START_NUM 序列号起始值
--padding PADDING 序列号位数（补零）
--seq-position {prefix,suffix}
序列号位置，前缀或后缀
--add-date 添加日期时间
--date-format DATE_FORMAT
日期时间格式
--use-file-time 使用文件修改时间（否则使用当前时间）
--date-position {prefix,suffix}
日期位置，前缀或后缀
--replace PATTERN REPLACEMENT
替换文件名中的内容（使用正则表达式）
--change-case {upper,lower,title,capitalize}
更改文件名大小写
--replace-spaces [CHAR]
替换文件名中的空格（默认替换为下划线）
--list-history 显示历史重命名记录
--undo ID 撤销指定的重命名操作（使用--list-history查看可用ID）
这个脚本提供了强大的文件搜索功能，支持按多种条件查找文件，并可以对结果进行排序和格式化输出。
- 多条件搜索:
- 按文件名搜索（支持通配符和正则表达式）
- 按文件扩展名搜索
- 按文件大小范围搜索
- 按文件日期范围搜索（修改日期、创建日期、访问日期）
- 按文件内容搜索（支持文本模式和正则表达式）
- 高级过滤:
- 包含/排除隐藏文件
- 仅文件或仅目录过滤
- 结果数量限制
- 结果处理:
- 多种排序方式（名称、大小、日期、扩展名、路径）
- 多种输出格式（列表、表格、CSV）
- 内容匹配行显示（带上下文）
- 结果保存到文件
按文件名搜索（支持通配符）：
python file_finder.py -n "*.txt"按文件扩展名搜索：
python file_finder.py -e jpg png gif按文件内容搜索：
python file_finder.py -c "搜索文本"按文件大小搜索：
python file_finder.py --min-size 1MB --max-size 10MB按修改日期搜索：
python file_finder.py --min-date "2023-01-01" --max-date "2023-12-31"使用正则表达式搜索文件名：
python file_finder.py -n ".*[0-9]{4}.*\.jpg" --regex搜索特定内容并显示上下文行：
python file_finder.py -c "import os" --context-lines 2搜索大文件并按大小排序：
python file_finder.py --min-size 100MB --sort-by size --reverse搜索最近修改的文件：
python file_finder.py --min-date "2023-12-01" --sort-by modified --reverse以表格格式显示详细结果：
python file_finder.py -n "*.py" --format table -d保存搜索结果到CSV文件：
python file_finder.py -n "*.doc*" -o results.csv --format csv -dusage: file_finder.py [-h] [-r] [--no-recursive] [-n NAME] [--regex] [-i]
[-e EXTENSION [EXTENSION ...]] [--min-size MIN_SIZE]
[--max-size MAX_SIZE] [--min-date MIN_DATE]
[--max-date MAX_DATE]
[--time-type {modified,created,accessed}]
[-c CONTENT] [--max-content-size MAX_CONTENT_SIZE]
[--include-binary] [--context-lines CONTEXT_LINES]
[--include-hidden] [--only-files] [--only-dirs]
[--limit LIMIT]
[--sort-by {name,size,modified,created,extension,path}]
[--reverse] [--format {list,table,csv}] [-d]
[--show-matches] [-o OUTPUT]
[search_path]
文件搜索工具 - 按各种条件搜索文件
positional arguments:
search_path 搜索起始路径，默认为当前目录
options:
-h, --help 显示帮助信息并退出
-r, --recursive 递归搜索子目录（默认启用）
--no-recursive 不递归搜索子目录
搜索条件（至少指定一个）:
-n, --name NAME 按文件名搜索，支持通配符（如 *.txt）
--regex 将名称或内容参数解释为正则表达式
-i, --ignore-case 忽略大小写
-e, --extension EXTENSION [EXTENSION ...]
按文件扩展名搜索（如 txt py）
--min-size MIN_SIZE 最小文件大小（如 1KB、2MB）
--max-size MAX_SIZE 最大文件大小（如 5MB、1GB）
--min-date MIN_DATE 最早日期（YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS）
--max-date MAX_DATE 最晚日期（YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS）
--time-type {modified,created,accessed}
时间类型（默认: modified）
-c, --content CONTENT
按文件内容搜索
--max-content-size MAX_CONTENT_SIZE
内容搜索的最大文件大小（默认: 10MB）
--include-binary 包含二进制文件在内容搜索中
--context-lines CONTEXT_LINES
显示匹配行周围的上下文行数
结果过滤:
--include-hidden 包含隐藏文件
--only-files 只包含文件，不包含目录
--only-dirs 只包含目录，不包含文件
--limit LIMIT 限制结果数量（0表示不限制）
结果排序:
--sort-by {name,size,modified,created,extension,path}
排序关键字（默认: name）
--reverse 倒序排列
输出选项:
--format {list,table,csv}
输出格式（默认: list）
-d, --details 显示详细信息
--show-matches 显示内容匹配行
-o, --output OUTPUT 将结果保存到文件
这个脚本提供了强大的文件和目录比较功能，可以识别并显示文件之间的差异，以及比较目录结构和内容。
- 文件比较:
- 支持文本文件行级比较
- 支持二进制文件比较
- 可选择忽略空白字符、大小写和空行
- 显示上下文差异
- 针对大文件优化的比较方法
- 目录比较:
- 识别仅存在于一侧的文件和目录
- 比较两侧都存在的文件内容
- 递归比较子目录
- 支持忽略特定文件或目录
- 差异报告:
- 文本格式报告（控制台友好）
- HTML格式报告（带颜色高亮）
- JSON格式报告（便于程序处理）
- 可保存报告到文件
比较两个文件：
python file_compare.py file1.txt file2.txt比较两个目录：
python file_compare.py dir1 dir2生成HTML格式报告：
python file_compare.py file1.py file2.py --format html -o report.html忽略空白字符和大小写：
python file_compare.py file1.txt file2.txt -w -i比较目录时忽略某些文件：
python file_compare.py project1 project2 --ignore "*.pyc" "*.log" "__pycache__"只显示摘要信息：
python file_compare.py dir1 dir2 -q显示更多上下文行：
python file_compare.py file1.py file2.py --context-lines 5不递归比较子目录：
python file_compare.py dir1 dir2 --no-recursive生成JSON格式报告：
python file_compare.py dir1 dir2 --format json -o diff.jsonusage: file_compare.py [-h] [-r] [--no-recursive] [-i] [-w] [-B]
[-c CONTEXT_LINES] [--binary]
[--ignore IGNORE [IGNORE ...]]
[--format {text,html,json}] [-o OUTPUT] [-q] [-v]
path1 path2
文件和目录比较工具
positional arguments:
path1 第一个文件或目录路径
path2 第二个文件或目录路径
比较选项:
-r, --recursive 递归比较子目录（默认启用）
--no-recursive 不递归比较子目录
-i, --ignore-case 忽略大小写差异
-w, --ignore-whitespace
忽略空白字符差异
-B, --ignore-blank-lines
忽略空行
-c, --context-lines CONTEXT_LINES
显示差异上下文的行数（默认: 3）
--binary 以二进制模式比较文件
过滤选项:
--ignore IGNORE [IGNORE ...]
忽略的文件或目录模式列表（如 *.pyc __pycache__）
输出选项:
--format {text,html,json}
输出格式（默认: text）
-o, --output OUTPUT 输出报告的文件路径
-q, --quiet 静默模式，仅显示摘要信息
-v, --verbose 详细模式，显示更多信息
这个脚本提供了文件和目录的加密与解密功能，用于保护敏感数据和个人隐私文件。
- 多种加密算法:
- AES (高级加密标准) - 对称加密算法，广泛用于数据保护
- Fernet - Python cryptography库的高级加密方案，提供认证加密
- 文件安全措施:
- 基于密码的加密，使用PBKDF2派生密钥
- 盐值随机生成，增强安全性
- 文件完整性校验（SHA-256哈希）
- 安全删除选项（多次覆盖原始文件内容）
- 批量处理:
- 支持单个文件和整个目录树的加密/解密
- 递归处理子目录
- 可选择性排除特定文件
- 友好的用户界面:
- 交互式密码输入（不显示密码）
- 加密/解密进度反馈
- 详细的错误报告
加密单个文件：
python file_encrypt.py -e sensitive_document.docx解密文件：
python file_encrypt.py -d sensitive_document.docx.encrypted加密整个目录：
python file_encrypt.py -e important_folder解密整个目录：
python file_encrypt.py -d important_folder_encrypted生成随机强密码：
python file_encrypt.py -g使用AES算法加密：
python file_encrypt.py -e data.db -a aes指定输出路径：
python file_encrypt.py -e photos.zip -o "D:\Backup\photos.zip.encrypted"加密后删除原始文件：
python file_encrypt.py -e tax_documents.pdf --delete排除某些文件：
python file_encrypt.py -e project_folder --exclude "*.log" "*.tmp" ".git*"从文件读取密码（用于脚本自动化）：
python file_encrypt.py -e database.sql --password-file my_password.txt不递归处理子目录：
python file_encrypt.py -e data_folder --no-recursiveusage: file_encrypt.py [-h] (-e | -d | -g) [-o OUTPUT] [-a {aes,fernet}]
[-p PASSWORD] [--password-file PASSWORD_FILE] [--delete]
[-r] [--no-recursive] [--exclude EXCLUDE [EXCLUDE ...]]
[--no-verify] [--length LENGTH] [-q] [-v]
[path]
文件加密/解密工具
positional arguments:
path 要处理的文件或目录路径
options:
-h, --help 显示帮助信息并退出
-e, --encrypt 加密文件或目录
-d, --decrypt 解密文件或目录
-g, --generate-password
生成随机密码
-o, --output OUTPUT 输出文件或目录路径
-a, --algorithm {aes,fernet}
加密算法 (默认: fernet)
-p, --password PASSWORD
加密/解密密码 (不推荐在命令行中使用)
--password-file PASSWORD_FILE
从文件读取密码
--delete 处理后删除原始文件
-r, --recursive 递归处理子目录（默认启用）
--no-recursive 不递归处理子目录
--exclude EXCLUDE [EXCLUDE ...]
排除的文件模式列表（如 *.log *.tmp）
--no-verify 解密时不验证文件完整性
--length LENGTH 生成的随机密码长度（默认: 16）
-q, --quiet 静默模式，减少输出
-v, --verbose 详细模式，显示更多信息
- 请妥善保管您的密码，一旦丢失将无法恢复加密文件
- 建议定期备份重要数据
- 推荐使用交互式密码输入，避免在命令行中直接提供密码
- 使用
--delete选项时请格外小心，原始文件将被安全删除且无法恢复
这个脚本提供了目录同步功能，可以在两个目录之间保持文件内容的一致性，适用于备份数据、工作文件同步和项目协作等场景。
- 多种同步模式:
- 单向同步（从源目录到目标目录）
- 双向同步（两个目录之间相互同步，保留最新的文件）
- 镜像同步（目标目录完全匹配源目录，包括删除源中不存在的文件）
- 更新模式（仅更新目标中已存在的文件）
- 智能文件对比:
- 基于修改时间的快速比较
- 基于文件大小的预先筛选
- 基于内容哈希值的精确比较
- 灵活的过滤选项:
- 可排除特定文件模式（如 *.tmp, *.log）
- 可选择性包含隐藏文件
- 支持符号链接处理
- 冲突解决策略:
- 基于修改时间（保留较新的文件）
- 基于文件大小（保留较大的文件）
- 固定策略（始终使用源文件或目标文件）
- 可跳过冲突文件
- 详细的同步报告:
- 统计信息（复制、更新、删除、跳过的文件数）
- 文件操作日志
- 可导出为JSON格式
单向同步（默认模式）：
python file_sync.py source_dir target_dir双向同步：
python file_sync.py source_dir target_dir -m two-way镜像同步：
python file_sync.py source_dir target_dir -m mirror更新模式：
python file_sync.py source_dir target_dir -m update排除特定文件：
python file_sync.py source_dir target_dir -e "*.tmp" "*.log" ".git*"模拟运行（不实际修改文件）：
python file_sync.py source_dir target_dir --dry-run使用特定冲突解决策略：
python file_sync.py source_dir target_dir -m two-way -c larger生成同步报告：
python file_sync.py source_dir target_dir -r sync_report.json包含隐藏文件并跟随符号链接：
python file_sync.py source_dir target_dir --include-hidden --follow-symlinks删除目标目录中源目录不存在的文件：
python file_sync.py source_dir target_dir --delete-orphanedusage: file_sync.py [-h] [-m {one-way,two-way,mirror,update}]
[-c {newer,larger,source,target,skip,prompt}]
[-e EXCLUDE [EXCLUDE ...]] [--include-hidden]
[--delete-orphaned] [--no-metadata] [--follow-symlinks]
[--dry-run] [-r REPORT] [-q] [-v]
source target
文件同步工具 - 同步两个目录的内容
positional arguments:
source 源目录路径
target 目标目录路径
options:
-h, --help 显示帮助信息并退出
-m, --mode {one-way,two-way,mirror,update}
同步模式（默认: one-way）
-c, --conflict {newer,larger,source,target,skip,prompt}
冲突解决策略（默认: newer）
-e, --exclude EXCLUDE [EXCLUDE ...]
排除的文件模式列表（如 *.tmp *.log）
--include-hidden 包括隐藏文件（以.开头）
--delete-orphaned 删除目标中源不存在的文件
--no-metadata 不保留文件元数据（修改时间等）
--follow-symlinks 跟随符号链接
--dry-run 仅模拟运行，不实际修改文件
-r, --report REPORT 生成同步报告的文件路径
-q, --quiet 静默模式，减少输出
-v, --verbose 详细模式，显示更多信息
- 单向同步 (one-way): 将源目录的文件复制到目标目录。只会添加或更新文件，不会删除目标目录中的任何文件。
- 双向同步 (two-way): 两个目录之间相互同步，保留最新的文件版本。适合两个工作环境之间的文件同步。
- 镜像同步 (mirror): 使目标目录成为源目录的精确副本，包括删除源目录中不存在的文件。适合备份场景。
- 更新模式 (update): 仅更新目标目录中已存在的文件，不会添加新文件或删除文件。适合更新已部署的应用程序。
当双向同步时，如果两个目录中的同一文件都有修改，会产生冲突。可以通过以下策略解决：
- newer: 保留修改时间较新的文件（默认）
- larger: 保留文件大小较大的文件
- source: 始终使用源目录中的文件
- target: 始终使用目标目录中的文件
- skip: 跳过冲突文件，不进行同步
- prompt: 提示用户选择（目前尚未实现，等同于skip）
这个脚本提供了文件和目录的压缩与解压功能，支持多种压缩格式，适用于文件备份、文件共享和存储空间优化。
- 多种压缩格式支持:
- ZIP格式 - 最常用的跨平台压缩格式
- TAR格式 - 无压缩的归档格式
- TAR.GZ格式 - 使用GZIP算法压缩的TAR文件
- TAR.BZ2格式 - 使用BZIP2算法压缩的TAR文件
- 丰富的压缩选项:
- 可调节的压缩级别（ZIP格式）
- 排除特定文件模式
- 选择性包含隐藏文件
- 文件统计和压缩率报告
- 灵活的解压功能:
- 支持展平目录结构
- 选择性解压特定文件
- 自定义输出目录
- 压缩文件管理:
- 列出压缩文件内容
- 显示详细的文件信息
压缩文件或目录（默认ZIP格式）：
python file_compress.py -c my_documents指定压缩格式：
python file_compress.py -c photos -f tar.gz解压文件：
python file_compress.py -d archive.zip解压到指定目录：
python file_compress.py -d archive.zip -o extracted_files查看压缩文件内容：
python file_compress.py -l archive.zip使用较低压缩级别（更快但文件更大）：
python file_compress.py -c large_folder -f zip --level 1排除特定文件：
python file_compress.py -c project_dir -e "*.log" "*.tmp" ".git*"包含隐藏文件：
python file_compress.py -c config_files --include-hidden解压时展平目录结构：
python file_compress.py -d nested_archive.zip --flatten只解压特定文件：
python file_compress.py -d backup.tar.gz --files "docs/important.pdf" "images/"详细查看压缩文件内容：
python file_compress.py -l archive.zip -vusage: file_compress.py [-h] (-c | -d | -l) [-o OUTPUT] [-f {zip,tar,tar.gz,tar.bz2}]
[--level {0,1,2,3,4,5,6,7,8,9}] [-e EXCLUDE [EXCLUDE ...]]
[--include-hidden] [--flatten] [--files FILES [FILES ...]]
[-v] path
文件压缩/解压工具
positional arguments:
path 要处理的文件或目录路径
options:
-h, --help 显示帮助信息并退出
-c, --compress 压缩文件或目录
-d, --decompress 解压文件
-l, --list 列出压缩文件内容
-o, --output OUTPUT 输出文件或目录路径
-v, --verbose 详细模式，显示更多信息
压缩选项:
-f, --format {zip,tar,tar.gz,tar.bz2}
压缩格式（默认: zip）
--level {0,1,2,3,4,5,6,7,8,9}
压缩级别 0-9，9为最高压缩率（仅用于ZIP格式，默认: 9）
-e, --exclude EXCLUDE [EXCLUDE ...]
要排除的文件模式列表（如 *.tmp *.log）
--include-hidden 包括隐藏文件
解压选项:
--flatten 展平目录结构（所有文件直接解压到输出目录）
--files FILES [FILES ...]
只解压指定的文件或目录
- ZIP (.zip): 最通用的压缩格式，支持大多数操作系统和程序。提供良好的压缩率和合理的速度。支持单个文件压缩和加密。
- TAR (.tar): 仅归档不压缩，通常用于保留文件权限和特性。文件大小基本不变。
- TAR.GZ (.tar.gz): 使用GZIP算法压缩的TAR文件，提供良好的压缩率和速度，在Linux系统中常用。
- TAR.BZ2 (.tar.bz2): 使用BZIP2算法压缩的TAR文件，通常比GZIP提供更高的压缩率，但速度较慢。
- 对大文件进行压缩或解压可能需要较长时间和较多内存
- ZIP格式在跨平台使用时最兼容
- 在解压前请确保有足够的磁盘空间
- 文件路径中包含中文或特殊字符可能在某些环境下导致问题
这个脚本用于查找目录中的重复文件，支持多种比较方式和重复文件处理选项，可用于清理磁盘空间、整理备份和优化文件存储。
- 多种文件比较方法:
- 基于文件大小的快速比较
- 基于哈希值的精确比较（MD5、SHA1、SHA256算法）
- 逐字节内容比较（最精确但速度最慢）
- 灵活的文件筛选:
- 指定最小文件大小
- 排除特定文件模式
- 选择性包含隐藏文件
- 丰富的重复处理选项:
- 生成详细报告（文本、CSV、JSON格式）
- 删除重复文件（保留第一个）
- 创建硬链接（节省磁盘空间但保持文件路径）
- 创建符号链接
- 移动重复文件到指定目录
- 交互式处理（手动选择每组文件的处理方式）
- 高效实现:
- 多阶段比较算法（先按大小分组再比较内容）
- 哈希值缓存（避免重复计算）
- 详细的统计信息和进度报告
查找当前目录中的重复文件：
python file_dupes.py .扫描多个目录：
python file_dupes.py 文档 图片 下载查找并删除重复文件：
python file_dupes.py . -p delete查找并创建硬链接（节省空间）：
python file_dupes.py . -p hardlink使用SHA256算法进行精确比较：
python file_dupes.py . -m hash -a sha256忽略小于1MB的文件：
python file_dupes.py . --min-size 1MB排除特定类型文件：
python file_dupes.py . -e "*.tmp" "*.log" "*.bak"将重复文件移动到备份目录：
python file_dupes.py . -p move -t ./duplicates交互式处理重复文件：
python file_dupes.py . -p interactive生成JSON格式报告：
python file_dupes.py . -f json -o duplicates_report.jsonusage: file_dupes.py [-h] [-r] [--no-recursive] [-m {size,hash,content}]
[-a {md5,sha1,sha256}] [--min-size MIN_SIZE]
[-e EXCLUDE [EXCLUDE ...]] [--include-hidden]
[--follow-symlinks]
[-p {report,delete,hardlink,symlink,move,interactive}]
[-t TARGET_DIR] [-o OUTPUT] [-f {text,csv,json}] [-q] [-v]
directories [directories ...]
文件重复查找工具
positional arguments:
directories 要扫描的目录路径列表
options:
-h, --help 显示帮助信息并退出
-r, --recursive 递归扫描子目录（默认启用）
--no-recursive 不递归扫描子目录
比较选项:
-m, --method {size,hash,content}
文件比较方法（默认: hash）
-a, --algorithm {md5,sha1,sha256}
哈希算法（默认: md5）
--min-size MIN_SIZE 最小文件大小，如 1KB、2MB（默认: 1B）
过滤选项:
-e, --exclude EXCLUDE [EXCLUDE ...]
要排除的文件模式列表（如 *.tmp *.log）
--include-hidden 包括隐藏文件
--follow-symlinks 跟随符号链接
处理选项:
-p, --process {report,delete,hardlink,symlink,move,interactive}
重复文件处理操作（默认: report）
-t, --target-dir 移动重复文件的目标目录（用于move操作）
输出选项:
-o, --output OUTPUT 报告输出文件路径
-f, --format {text,csv,json}
报告格式（默认: text）
-q, --quiet 静默模式，减少输出
-v, --verbose 详细模式，显示更多信息
- size: 仅比较文件大小。最快但可能产生误报（不同内容的文件可能大小相同）。
- hash: 使用哈希算法比较文件内容。平衡了速度和准确性，适合大多数场景。
- content: 逐字节比较文件内容。最准确但处理大文件时速度较慢。
- report: 仅生成重复文件报告，不修改任何文件（默认）。
- delete: 删除所有重复文件，保留每组的第一个文件。
- hardlink: 将重复文件替换为到原始文件的硬链接，节省磁盘空间。
- symlink: 将重复文件替换为到原始文件的符号链接。
- move: 将重复文件移动到指定目录。
- interactive: 交互式处理，对每组重复文件手动选择操作。
- 删除、硬链接和符号链接操作会修改文件系统，操作前请确保备份重要数据。
- 硬链接仅在同一文件系统上有效，不能跨驱动器使用。
- 大型目录的扫描可能需要较长时间和较多内存，特别是使用content比较方法时。
- 建议先使用默认的report模式查看重复文件，确认无误后再执行其他操作。
这个脚本用于实时监控指定目录中的文件变化（创建、修改、删除、重命名等），并可以在文件发生变化时记录或执行指定操作。适用于自动备份、开发监控、日志跟踪等场景。
- 实时监控文件变化:
- 监控文件创建、修改、删除和移动事件
- 支持递归监控子目录
- 可单独监控文件或目录变化
- 精细的过滤系统:
- 按文件名模式过滤（通配符支持）
- 按文件大小范围过滤
- 可选择性包含隐藏文件
- 按事件类型过滤
- 多种响应操作:
- 日志记录（控制台、文件或JSON格式）
- 自动备份变化的文件
- 执行自定义命令
- 发送桌面通知
- 高级功能:
- 批处理模式（收集一段时间内的事件后一次处理）
- 冷却时间设置（防止频繁触发）
- 详细的事件统计
-
开发辅助:
- 监控源代码变化并自动运行测试或构建
- 监控配置文件变化并自动重启服务
- 实时预览开发效果
-
数据安全:
- 监控重要文件变化并自动备份
- 记录敏感目录的访问和修改行为
- 检测异常文件操作
-
自动化工作流:
- 监控下载文件夹并自动分类处理新文件
- 监控共享目录变化并执行后续处理
- 图片或视频文件变化时自动转换格式
监控单个目录：
python file_monitor.py 要监控的目录监控多个目录：
python file_monitor.py 目录1 目录2 目录3监控特定类型的文件：
python file_monitor.py --include "*.txt" "*.log" 要监控的目录排除特定类型的文件：
python file_monitor.py --exclude "*.tmp" "*.bak" 要监控的目录仅监控文件创建和删除事件：
python file_monitor.py --event-types created deleted 要监控的目录监控文件变化并自动备份：
python file_monitor.py -b --backup-dir "备份目录" 要监控的目录监控并执行自定义命令：
python file_monitor.py -c "echo 文件 {filename} 已变化" 要监控的目录将监控日志保存到文件：
python file_monitor.py -l file --log-file "监控日志.txt" 要监控的目录启用批处理模式（减少频繁处理）：
python file_monitor.py --batch --batch-timeout 10 要监控的目录监控大型文件的变化：
python file_monitor.py --min-size 10MB 要监控的目录启用桌面通知：
python file_monitor.py -n 要监控的目录设置监控超时时间：
python file_monitor.py -t 3600 要监控的目录 # 监控1小时后自动停止usage: file_monitor.py [-h] [-r] [--no-recursive] [-t TIMEOUT] [-i INCLUDE [INCLUDE ...]]
[-e EXCLUDE [EXCLUDE ...]] [--include-hidden]
[--event-types {created,modified,deleted,moved,all} [{created,modified,deleted,moved,all} ...]]
[--file-types {file,directory,all} [{file,directory,all} ...]]
[--min-size MIN_SIZE] [--max-size MAX_SIZE] [--cooldown COOLDOWN]
[--batch] [--batch-timeout BATCH_TIMEOUT]
[-l {console,file}] [--log-file LOG_FILE] [--json-log JSON_LOG]
[-b] [--backup-dir BACKUP_DIR] [-c COMMAND] [-n]
[-q] [-v]
paths [paths ...]
文件监控工具
positional arguments:
paths 要监控的路径列表
options:
-h, --help 显示帮助信息并退出
-r, --recursive 递归监控子目录（默认启用）
--no-recursive 不递归监控子目录
-t, --timeout TIMEOUT 监控超时时间（秒），0表示一直运行（默认）
过滤选项:
-i, --include INCLUDE [INCLUDE ...]
要包含的文件模式列表（如 *.txt *.log）
-e, --exclude EXCLUDE [EXCLUDE ...]
要排除的文件模式列表（如 *.tmp *.bak）
--include-hidden 包括隐藏文件
--event-types {created,modified,deleted,moved,all} [{created,modified,deleted,moved,all} ...]
要监控的事件类型列表
--file-types {file,directory,all} [{file,directory,all} ...]
要监控的文件类型列表
--min-size MIN_SIZE 最小文件大小，如 1KB、2MB（默认: 0）
--max-size MAX_SIZE 最大文件大小，如 10MB、1GB
--cooldown COOLDOWN 相同文件两次事件间的最小冷却时间（秒）（默认: 1）
批处理选项:
--batch 批处理模式，收集一段时间内的事件后一次处理
--batch-timeout BATCH_TIMEOUT
批处理超时时间（秒）（默认: 5）
操作选项:
-l, --log {console,file}
日志输出目标（默认: console）
--log-file LOG_FILE 日志文件路径（当--log=file时使用）
--json-log JSON_LOG JSON格式日志文件路径
-b, --backup 备份修改的文件
--backup-dir BACKUP_DIR
备份目录路径（默认: file_monitor_backups）
-c, --command COMMAND 文件变化时执行的命令，可使用{path}、{filename}等占位符
-n, --notify 启用桌面通知
其他选项:
-q, --quiet 静默模式，减少输出
-v, --verbose 详细模式，显示更多信息
在使用 -c/--command 选项指定自定义命令时，可以使用以下占位符：
{path}: 完整的文件路径{filename}: 仅文件名（不含路径）{event_type}: 事件类型（created、modified、deleted、moved）{file_type}: 文件类型（file或directory）{dest_path}: 目标路径（仅对moved事件有效）{dest_filename}: 目标文件名（仅对moved事件有效）
例如：
python file_monitor.py -c "echo 文件 {filename} 被 {event_type} 了" 要监控的目录此脚本依赖 watchdog 库来监控文件系统事件。如果尚未安装，请运行：
pip install watchdog- 对于高频变化的目录（如日志目录或临时文件目录），建议使用批处理模式减少处理次数
- 在Windows系统上，某些操作（如编辑并保存文件）可能会触发多个事件
- 桌面通知功能在不同操作系统上可能需要额外的依赖库
- 当使用备份功能时，请确保有足够的磁盘空间存储备份文件
这个脚本用于将多个文本文件合并成一个文件，支持各种合并方式、文件排序方法、分隔符选项和文本处理功能。适用于日志整合、文档汇编、数据收集等场景。
- 灵活的文件排序:
- 按文件名排序
- 按文件大小排序
- 按修改时间排序
- 自定义排序顺序
- 多种文件分隔方式:
- 空行分隔
- 自定义分隔符
- 文件名作为分隔标题
- 带框的文件名标题
- 标记行分隔（如横线）
- 强大的文本处理功能:
- 删除空行和重复行
- 修剪行（删除首尾空白）
- 添加行前缀和后缀
- 根据正则表达式过滤内容
- 限制行长度
- 删除HTML标签
- 转换制表符为空格
- 添加行号
- 行包装
- 完善的输入/输出控制:
- 支持不同的文件编码
- 可添加自定义页眉和页脚
- 输出到文件或标准输出
- 自动生成文件来源信息
合并多个文本文件：
python text_merger.py file1.txt file2.txt file3.txt -o merged.txt合并并按大小排序：
python text_merger.py *.txt -o merged.txt -s size合并并按修改时间逆序排序（最新的文件在前）：
python text_merger.py *.log -o merged.log -s modified -r使用文件名作为分隔标题：
python text_merger.py *.md -o merged.md --separator filename删除重复行和空行：
python text_merger.py *.txt -o clean.txt --remove-duplicate-lines --remove-empty-lines只包含匹配特定模式的行：
python text_merger.py error*.log -o errors_only.log --include "ERROR|CRITICAL" --ignore-case添加行号并限制行长度：
python text_merger.py source.txt -o numbered.txt --number-lines --max-line-length 80添加自定义页眉和页脚：
python text_merger.py *.txt -o report.txt --header "===== 合并报告 =====" --footer "===== 报告结束 ====="使用自定义分隔符：
python text_merger.py *.txt -o merged.txt --separator custom --custom-separator "\n\n===== 下一个文件 =====\n\n"将表格数据合并为CSV（删除空行，修剪空白）：
python text_merger.py table*.txt -o combined.csv --remove-empty-lines --trim-linesusage: text_merger.py [-h] [-o OUTPUT] [-s {name,size,modified,custom}] [-r]
[--custom-order CUSTOM_ORDER [CUSTOM_ORDER ...]]
[--separator {none,newline,custom,filename,filename_box,marker_line}]
[--custom-separator CUSTOM_SEPARATOR]
[--file-encoding FILE_ENCODING]
[--output-encoding OUTPUT_ENCODING]
[--remove-empty-lines] [--remove-duplicate-lines]
[--trim-lines] [--line-prefix LINE_PREFIX]
[--line-suffix LINE_SUFFIX] [--include INCLUDE]
[--exclude EXCLUDE] [--ignore-case]
[--max-line-length MAX_LINE_LENGTH] [--remove-html]
[--convert-tabs] [--tab-size TAB_SIZE] [--number-lines]
[--wrap-lines WRAP_LINES] [--skip-errors]
[--header HEADER] [--header-file HEADER_FILE]
[--footer FOOTER] [--footer-file FOOTER_FILE]
[--no-warning] [-q] [-v]
files [files ...]
文本文件合并工具
positional arguments:
files 要合并的文件列表
options:
-h, --help 显示帮助信息并退出
-o, --output OUTPUT 输出文件路径（如果省略则输出到标准输出）
排序选项:
-s, --sort {name,size,modified,custom}
文件排序方法（默认: name）
-r, --reverse 逆序排序
--custom-order CUSTOM_ORDER [CUSTOM_ORDER ...]
自定义文件排序顺序（仅当sort=custom时有效）
分隔符选项:
--separator {none,newline,custom,filename,filename_box,marker_line}
文件分隔符类型（默认: newline）
--custom-separator CUSTOM_SEPARATOR
自定义分隔符（当separator=custom时使用）
编码选项:
--file-encoding FILE_ENCODING
输入文件编码（默认: utf-8）
--output-encoding OUTPUT_ENCODING
输出文件编码（默认: utf-8）
处理选项:
--remove-empty-lines 删除空行
--remove-duplicate-lines
删除重复行
--trim-lines 修剪行（删除首尾空白）
--line-prefix LINE_PREFIX
添加到每行开头的前缀
--line-suffix LINE_SUFFIX
添加到每行结尾的后缀
--include INCLUDE 包含正则表达式模式（仅包含匹配的行）
--exclude EXCLUDE 排除正则表达式模式（排除匹配的行）
--ignore-case 正则表达式忽略大小写
--max-line-length MAX_LINE_LENGTH
最大行长度（截断更长的行）
--remove-html 删除HTML标签
--convert-tabs 将制表符转换为空格
--tab-size TAB_SIZE 制表符大小（默认: 4）
--number-lines 添加行号
--wrap-lines WRAP_LINES
行包装宽度（每行最大字符数）
其他选项:
--skip-errors 跳过处理错误
--header HEADER 添加到输出文件开头的文本
--header-file HEADER_FILE
从文件读取要添加到输出文件开头的文本
--footer FOOTER 添加到输出文件结尾的文本
--footer-file FOOTER_FILE
从文件读取要添加到输出文件结尾的文本
--no-warning 不添加生成文件的警告注释
-q, --quiet 静默模式，减少输出
-v, --verbose 详细模式，显示更多信息
- none: 不添加分隔符，文件内容直接连接
- newline: 在文件之间添加一个空行（默认）
- custom: 使用自定义分隔符
- filename: 使用文件名作为分隔标题（例如：
# file.txt） - filename_box: 使用带框的文件名（例如：
+--------+、| file.txt |、+--------+） - marker_line: 使用横线作为分隔符（例如：
----------------）
-
日志分析：合并多个日志文件，按时间顺序排列，并筛选出包含特定关键词的行
python text_merger.py log*.txt -o combined_logs.txt -s modified --include "error|warning" --ignore-case
-
源代码合并：合并多个源代码文件，添加文件名作为标题，去除注释行
python text_merger.py *.py -o full_source.txt --separator filename --exclude "^\s*#"
-
数据整理：合并CSV数据文件，删除重复的标题行，修剪空白字符
python text_merger.py data*.csv -o merged_data.csv --exclude "^id,name,value" --trim-lines
-
文档汇编：将多个Markdown文件合并为一个文档，添加适当的标题分隔
python text_merger.py chapter*.md -o book.md --separator filename_box
- 处理大型文件时可能会消耗较多内存
- 删除重复行功能在处理大量数据时可能会降低性能
- 某些编码转换可能导致字符丢失，请确保正确指定输入和输出编码
- 默认情况下，合并后的文件会包含生成信息头部，可以使用
--no-warning禁用
这个脚本用于将大型文件分割成多个较小的文件，支持多种分割方式，包括按行数、大小、内容分割等。适用于处理大型日志、数据集和二进制文件。
- 多种分割模式:
- 按行数分割（适用于文本文件）
- 按大小分割（适用于任何文件）
- 按文件数量均分（自动计算分割点）
- 按正则表达式模式分割（在匹配处拆分）
- 按分隔符分割（类似于文本处理中的split操作）
- 按指定字节位置分割（精确控制分割点）
- 灵活的文件处理:
- 自动检测文本和二进制文件
- 支持多种文件编码
- 可选择保留原始文件表头
- 可添加自定义页眉和页脚
- 支持压缩输出文件
- 智能文件命名:
- 自定义文件名格式
- 支持序号、日期、时间变量
- 保留原始文件扩展名
- 用户友好功能:
- 详细的分割进度和统计信息
- 输出文件统一放置于指定目录
- 可定制的错误处理策略
按行数分割文本文件（每个文件1000行）：
python file_split.py large_log.txt -l 1000按大小分割文件（每个文件10MB）：
python file_split.py large_file.dat -s 10MB将文件平均分成5个部分：
python file_split.py dataset.csv -n 5指定输出目录：
python file_split.py large_video.mp4 -s 700MB -o "D:\分割文件"按特定分隔符分割：
python file_split.py log_file.txt -d "----------SESSION END----------"按正则表达式模式分割：
python file_split.py data.xml -r "<\/record>"保留CSV表头在每个分割文件中：
python file_split.py large_data.csv -l 5000 --preserve-headers指定表头行数：
python file_split.py report.csv -l 1000 --preserve-headers --header-lines 3压缩输出文件：
python file_split.py large_log.txt -l 10000 -c自定义输出文件名格式：
python file_split.py source.txt -l 500 -p "{basename}_part{num}_{date}{extension}"按具体字节位置分割：
python file_split.py binary_file.bin -b "1048576,2097152,3145728"添加自定义页眉和页脚：
python file_split.py document.txt -l 500 --custom-header "--- 分割文件 ---\n" --custom-footer "\n--- 文件结束 ---"usage: file_split.py [-h] [-o OUTPUT_DIR] [-p OUTPUT_PATTERN]
[-l LINES | -s SIZE | -n NUMBER | -d DELIMITER | -r REGEX_PATTERN | -b BYTE_POSITIONS]
[-t {auto,text,binary}] [-e ENCODING]
[--include-header] [--include-footer]
[--custom-header CUSTOM_HEADER] [--custom-footer CUSTOM_FOOTER]
[--preserve-headers] [--header-lines HEADER_LINES] [-c] [-v]
file
文件分割工具
positional arguments:
file 要分割的文件路径
options:
-h, --help 显示帮助信息并退出
-o, --output-dir 输出目录路径（默认为源文件所在目录）
-p, --output-pattern 输出文件名模式（可用变量：{basename}, {num}, {extension}, {date}, {time}）
分割模式（选择一种）:
-l, --lines 按行数分割（每个文件的行数）
-s, --size 按大小分割（每个文件的大小，如 1MB）
-n, --number 按数量平均分割（分割成的文件数量）
-d, --delimiter 按分隔符分割（如 "---分隔符---"）
-r, --regex-pattern 按正则表达式模式分割（在匹配位置拆分）
-b, --byte-positions 按字节位置分割（逗号分隔的位置列表）
文件类型选项:
-t, --type {auto,text,binary}
指定文件类型（默认: auto）
-e, --encoding 文本文件编码（默认: utf-8）
输出选项:
--include-header 在分割文件中包含源文件头部
--include-footer 在分割文件中包含源文件尾部
--custom-header 自定义内容添加到每个分割文件的开头
--custom-footer 自定义内容添加到每个分割文件的结尾
--preserve-headers 在每个分割文件中保留表头（仅对文本文件有效）
--header-lines 表头的行数（默认: 1）
-c, --compress 压缩输出文件（使用gzip）
-v, --verbose 显示详细信息
-
大型日志文件处理: 将庞大的服务器日志文件按会话或日期分割，便于分析特定时段的问题。
python file_split.py server.log -r "\[\d{4}-\d{2}-\d{2}\]" -v -
数据集分割: 将大型CSV数据集分割成小块进行并行处理或分批导入数据库。
python file_split.py dataset.csv -l 10000 --preserve-headers
-
备份文件分段: 将大型备份文件分割成适合存储介质（如U盘、DVD）的大小。
python file_split.py backup.zip -s 4GB
-
多媒体文件处理: 将大型视频或音频文件分割成较小的片段。
python file_split.py video.mp4 -s 700MB
-
数据传输优化: 将大文件分割成小块以便于在网络带宽有限的情况下传输。
python file_split.py large_file.iso -s 100MB -c
- 处理文本文件时，请确保指定正确的文件编码，否则可能导致字符丢失或乱码
- 按行分割仅适用于文本文件，对二进制文件请使用按大小分割
- 使用正则表达式或分隔符分割时，请确认模式在文件中确实存在，否则可能不会产生分割
- 对于非常大的文件（如超过几GB），分割过程可能需要较长时间
- 确保目标位置有足够的磁盘空间存储分割后的文件
这个脚本用于在多个文件中批量查找和替换文本内容，支持普通文本和正则表达式匹配，可以递归处理整个目录结构，并提供详细的替换报告。适用于代码重构、文档更新、内容规范化等场景。
- 多种替换模式:
- 普通文本替换（自动转义特殊字符）
- 正则表达式替换（支持捕获组和反向引用）
- 全词匹配替换（仅匹配完整单词）
- 整行替换（替换包含匹配文本的整行）
- 灵活的文件筛选:
- 按文件名模式包含/排除（支持通配符）
- 按目录名排除（如忽略版本控制目录）
- 按文件大小限制
- 可选择性跳过二进制文件
- 安全操作:
- 文件备份功能
- 干运行模式（预览而不实际修改）
- 详细的替换前后差异对比
- 高效处理:
- 并行处理多个文件（多核心利用）
- 递归处理子目录
- 智能错误处理和恢复
- 全面的报告:
- 修改文件统计
- 替换内容统计
- 每个文件的修改行号
- 可导出的详细报告
简单文本替换：
python text_replace.py "原始文本" "替换文本" 要处理的文件或目录使用正则表达式替换：
python text_replace.py -r "pattern\d+" "replacement" 要处理的目录全词匹配替换：
python text_replace.py -w "word" "newword" 要处理的目录整行替换：
python text_replace.py -l "包含这段文本的行" "替换为这一整行" 要处理的文件指定文件类型（仅处理特定文件）：
python text_replace.py "old" "new" 目录 --include "*.py" "*.txt"排除目录：
python text_replace.py "old" "new" 项目目录 --exclude-dir "node_modules" "build" "dist"备份原始文件：
python text_replace.py "old" "new" 文件 -b模拟运行（不实际修改文件）：
python text_replace.py "old" "new" 目录 -n忽略大小写：
python text_replace.py -i "pattern" "replacement" 文件显示详细差异：
python text_replace.py "old" "new" 文件 -d限制替换次数：
python text_replace.py "old" "new" 文件 --limit 5保存替换报告：
python text_replace.py "old" "new" 目录 -o report.txt使用并行处理加速：
python text_replace.py "old" "new" 大型目录 --parallel使用捕获组：
python text_replace.py -r "version\s*=\s*[\"'](\d+\.\d+)[\"']" "version = \"\\1.1\"" 配置文件替换所有HTML标签：
python text_replace.py -r "<[^>]+>" "" HTML文件规范化日期格式：
python text_replace.py -r "(\d{1,2})/(\d{1,2})/(\d{4})" "\\3-\\1-\\2" 文档文件usage: text_replace.py [-h] [-t | -r | -w | -l] [-i] [--no-recursive]
[--include PATTERN [PATTERN ...]] [--exclude PATTERN [PATTERN ...]]
[--exclude-dir DIR [DIR ...]] [--max-size MAX_SIZE]
[--encoding ENCODING] [--include-binary] [-n] [-b]
[--backup-ext BACKUP_EXT] [--limit LIMIT] [--force]
[--parallel] [-d] [-o OUTPUT] [--summary] [-v] [-q]
search replacement paths [paths ...]
文本批量查找替换工具
positional arguments:
search 要查找的文本或正则表达式模式
replacement 要替换成的内容
paths 要处理的文件或目录路径列表
替换模式选项:
-t, --text 普通文本替换（默认）
-r, --regex 正则表达式替换
-w, --whole-word 全词匹配替换
-l, --line 整行替换（包含匹配文本的整行）
-i, --ignore-case 忽略大小写
文件选项:
--no-recursive 不递归处理子目录
--include PATTERN [PATTERN ...]
要包含的文件模式列表（如 *.txt）
--exclude PATTERN [PATTERN ...]
要排除的文件模式列表
--exclude-dir DIR [DIR ...]
要排除的目录名列表
--max-size MAX_SIZE 处理的最大文件大小（如 1MB）
--encoding ENCODING 文件编码（默认: utf-8）
--include-binary 也处理二进制文件（默认跳过）
操作选项:
-n, --dry-run 模拟运行，不实际修改文件
-b, --backup 备份原始文件
--backup-ext BACKUP_EXT
备份文件扩展名（默认: .bak）
--limit LIMIT 每个文件最多替换的匹配次数（默认: 无限制）
--force 忽略错误并继续处理
--parallel 使用并行处理（多核处理）
输出选项:
-d, --diff 显示详细的替换差异
-o, --output OUTPUT 将报告保存到指定文件
--summary 仅显示摘要信息
-v, --verbose 显示详细信息
-q, --quiet 静默模式
-
代码重构
- 重命名变量、函数或类名
- 更新API调用方式
- 修改代码格式或风格
python text_replace.py -r "oldFunction\((.*?)\)" "newFunction(\\1, config)" --include "*.js" "*.ts" src/
-
文档更新
- 更新版本号、日期或联系信息
- 统一格式和术语
- 修正错误或过时信息
python text_replace.py "旧产品名称" "新产品名称" --include "*.md" "*.txt" docs/ -b
-
配置管理
- 更新连接字符串
- 修改服务器地址或路径
- 调整日志记录等级或格式
python text_replace.py "dev.example.com" "prod.example.com" --include "*.yml" "*.properties" config/ -n -d
-
清理和规范化
- 标准化空格和缩进
- 移除调试代码或注释
- 规范化数据格式
python text_replace.py -r "\s+$" "" --include "*.py" "*.java" . --parallel
- 在进行大规模替换前，始终使用
--dry-run选项预览替换效果 - 处理重要文件时建议启用
--backup选项 - 正则表达式替换时，需要特别注意特殊字符的转义
- 某些大型文本文件的处理可能会消耗较多内存
- 对于特殊的文本编码，务必使用
--encoding选项指定正确的编码
这个脚本提供了批量处理图像的功能，支持调整大小、格式转换、添加水印、应用滤镜效果等操作。适用于摄影作品整理、网站图片优化、社交媒体内容准备等场景。
- 多种调整大小方式:
- 按百分比缩放（等比例缩放）
- 调整为精确尺寸（可能改变纵横比）
- 适应指定尺寸（保持纵横比，不裁剪）
- 填充指定尺寸（保持纵横比，可能裁剪）
- 仅调整宽度或高度（保持纵横比）
- 格式转换与优化:
- 支持常见图像格式间的转换（JPG、PNG、GIF、BMP、TIFF、WEBP等）
- 调整压缩质量
- 批量统一格式
- 水印功能:
- 文本水印（支持自定义文字、字体、大小、颜色、位置、透明度）
- 图像水印（支持自定义图像、位置、透明度）
- 多种预设位置（角落、中心、平铺等）
- 图像增强与特效:
- 应用多种滤镜（模糊、锐化、轮廓、浮雕等）
- 调整亮度、对比度、色彩饱和度、锐度
- 旋转和翻转
- 元数据处理:
- 保留或移除EXIF数据
- 添加作者、版权等信息
- 高效批处理:
- 多线程并行处理
- 递归处理整个目录结构
- 自定义输出命名格式
- 灵活的文件筛选
调整图像大小（保持纵横比）：
python image_processor.py images/ --resize-percent 50转换图像格式：
python image_processor.py images/*.jpg --output-format png添加文本水印：
python image_processor.py images/ --text-watermark "© 2023 版权所有"应用滤镜效果：
python image_processor.py images/ --filter grayscale适应指定尺寸（保持纵横比）：
python image_processor.py images/ --resize-fit 800 600填充指定尺寸（保持纵横比，可能裁剪）：
python image_processor.py images/ --resize-fill 1200 628添加自定义位置的水印：
python image_processor.py images/ --text-watermark "机密文件" --watermark-position center --font-size 48使用图像作为水印：
python image_processor.py images/ --image-watermark logo.png --watermark-position bottom-right --watermark-opacity 30调整图像亮度和对比度：
python image_processor.py images/ --brightness 1.2 --contrast 1.1批量将图像转换为网页优化的WebP格式：
python image_processor.py images/ --output-format webp --quality 80只处理特定类型的图像：
python image_processor.py images/ --include "*.jpg" "*.png" --resize-width 1200多线程加速处理：
python image_processor.py large_image_folder/ --threads 4 --resize-percent 75usage: image_processor.py [-h] [-r] [-v] [-n] [-t THREADS]
[--same-dir | --subfolder OUTPUT_SUBFOLDER | --output-dir OUTPUT_DIR | --replace]
[--output-format OUTPUT_FORMAT] [--quality QUALITY]
[--output-pattern OUTPUT_PATTERN]
[-i PATTERN [PATTERN ...]] [-e PATTERN [PATTERN ...]]
[--resize-percent RESIZE_PERCENT | --resize-exact WIDTH HEIGHT | --resize-fit WIDTH HEIGHT | --resize-fill WIDTH HEIGHT | --resize-width RESIZE_WIDTH | --resize-height RESIZE_HEIGHT]
[--text-watermark TEXT_WATERMARK | --image-watermark IMAGE_WATERMARK]
[--watermark-position {top-left,top-center,top-right,center-left,center,center-right,bottom-left,bottom-center,bottom-right,tiled,custom}]
[--watermark-opacity WATERMARK_OPACITY]
[--font-size FONT_SIZE] [--font-path FONT_PATH]
[--text-color TEXT_COLOR]
[--filter {blur,sharpen,contour,detail,edge,emboss,smooth,grayscale,sepia,negative}]
[--brightness BRIGHTNESS] [--contrast CONTRAST]
[--color COLOR] [--sharpness SHARPNESS] [--rotate ROTATE]
[--flip-horizontal] [--flip-vertical] [--strip-exif]
[--exif-author EXIF_AUTHOR] [--exif-copyright EXIF_COPYRIGHT]
input_paths [input_paths ...]
图像批处理工具 - 批量调整图像大小、格式转换、添加水印等
positional arguments:
input_paths 输入图像或目录路径列表
options:
-h, --help 显示帮助信息并退出
-r, --recursive 递归处理子目录
-v, --verbose 显示详细信息
-n, --dry-run 模拟运行，不实际修改文件
-t, --threads THREADS 处理线程数（默认: 1）
输出选项:
--same-dir 输出到原目录
--subfolder OUTPUT_SUBFOLDER
输出到子文件夹（默认: processed_images）
--output-dir OUTPUT_DIR
输出到自定义目录
--replace 替换原始文件
--output-format OUTPUT_FORMAT
输出格式（如 jpg, png, webp）
--quality QUALITY 输出质量 1-100（默认: 85）
--output-pattern OUTPUT_PATTERN
输出文件名模式（默认: "{basename}{suffix}{extension}"）
文件过滤选项:
-i, --include PATTERN [PATTERN ...]
要包含的文件模式列表（如 *.jpg）
-e, --exclude PATTERN [PATTERN ...]
要排除的文件模式列表
调整大小选项:
--resize-percent RESIZE_PERCENT
按百分比调整大小（如50表示缩小一半）
--resize-exact WIDTH HEIGHT
调整为精确尺寸（可能改变纵横比）
--resize-fit WIDTH HEIGHT
适应指定尺寸（保持纵横比，不裁剪）
--resize-fill WIDTH HEIGHT
填充指定尺寸（保持纵横比，可能裁剪）
--resize-width RESIZE_WIDTH
指定宽度（保持纵横比）
--resize-height RESIZE_HEIGHT
指定高度（保持纵横比）
水印选项:
--text-watermark TEXT_WATERMARK
文本水印内容
--image-watermark IMAGE_WATERMARK
图像水印文件路径
--watermark-position {top-left,top-center,top-right,center-left,center,center-right,bottom-left,bottom-center,bottom-right,tiled,custom}
水印位置（默认: bottom-right）
--watermark-opacity WATERMARK_OPACITY
水印不透明度 0-100（默认: 50）
--font-size FONT_SIZE
文本水印字体大小（默认: 36）
--font-path FONT_PATH
文本水印字体文件路径
--text-color TEXT_COLOR
文本水印颜色（默认: white）
图像处理选项:
--filter {blur,sharpen,contour,detail,edge,emboss,smooth,grayscale,sepia,negative}
应用滤镜效果
--brightness BRIGHTNESS
调整亮度（0.0-2.0，1.0为原始亮度）
--contrast CONTRAST 调整对比度（0.0-2.0，1.0为原始对比度）
--color COLOR 调整色彩（0.0-2.0，1.0为原始色彩）
--sharpness SHARPNESS
调整锐度（0.0-2.0，1.0为原始锐度）
--rotate ROTATE 旋转角度（度，顺时针）
--flip-horizontal 水平翻转
--flip-vertical 垂直翻转
EXIF选项:
--strip-exif 移除EXIF元数据
--exif-author EXIF_AUTHOR
设置作者信息
--exif-copyright EXIF_COPYRIGHT
设置版权信息
-
网站图片优化
- 批量调整图片尺寸适应网站需求
- 转换为WebP格式以提高加载速度
- 添加版权水印保护知识产权
python image_processor.py website_images/ --resize-width 1200 --output-format webp --quality 80 --text-watermark "© 公司名称" --watermark-opacity 30 -
社交媒体内容准备
- 调整图片尺寸以适应不同平台
- 应用特效增强视觉吸引力
- 添加品牌水印
python image_processor.py marketing_photos/ --resize-fill 1080 1080 --filter detail --brightness 1.1 --contrast 1.2 --image-watermark brand_logo.png
-
产品图片批处理
- 统一产品图片尺寸和格式
- 增强图片细节和清晰度
- 移除敏感EXIF数据
python image_processor.py product_photos/ --resize-fit 2000 2000 --filter sharpen --strip-exif --output-format jpg --quality 90
-
摄影作品批量处理
- 批量添加摄影师水印
- 应用特定滤镜风格
- 调整尺寸用于展示
python image_processor.py -r photos/ --text-watermark "摄影师姓名" --filter sepia --resize-percent 50 --exif-copyright "版权所有，未经许可禁止使用"
- 在进行批量处理前，建议先使用
--dry-run选项预览将要执行的操作 - 处理高分辨率图像或大量图像时，可能需要较长时间和较多内存
- 使用
--replace选项时请格外小心，原始文件将被替换 - 水印位置和大小可能需要根据图像内容进行调整
- 对于非常大的目录，建议使用
--threads选项启用多线程处理
这个脚本提供了查看和修改各种文件类型元数据的功能，包括图像EXIF数据、音频ID3标签、视频元数据和文档属性等。
- 多格式文件支持:
- 图像: JPG, PNG, TIFF, WebP, HEIF/HEIC等
- 音频: MP3, FLAC, WAV, OGG, M4A, AAC等
- 视频: MP4, MOV, AVI, MKV, WebM等
- 文档: PDF, DOCX, XLSX, PPTX等
- 全面的元数据处理:
- 读取和显示详细的元数据信息
- 添加或修改元数据字段
- 删除元数据字段
- 按通配符筛选特定元数据字段
- 批量处理能力:
- 递归处理整个目录结构
- 使用模式匹配包含/排除文件
- 批量应用相同的元数据修改
- 灵活的导入导出:
- 将元数据导出为JSON, CSV或XML格式
- 从JSON或CSV文件导入元数据
- 多种格式的元数据输出
- 安全操作选项:
- 在修改前自动备份文件
- 模拟运行模式，不实际修改文件
- 详细的操作日志
查看图像文件的EXIF信息:
python metadata_editor.py 照片.jpg查看特定目录中所有JPEG文件的元数据:
python metadata_editor.py 照片目录/ --include "*.jpg" "*.jpeg"查看并筛选特定元数据字段:
python metadata_editor.py 照片.jpg --fields "Date*" "Camera*" "GPS*"将元数据导出为JSON格式:
python metadata_editor.py 照片目录/ --export-file metadata.json将元数据保存到CSV文件:
python metadata_editor.py 音乐目录/ --output metadata.csv --format csv为图像文件添加版权信息:
python metadata_editor.py 照片目录/ --add "Copyright=© 2023 我的名字" --include "*.jpg"修改音频文件的艺术家和专辑信息:
python metadata_editor.py 音乐.mp3 --add "artist=新艺术家" "album=新专辑名"删除照片的GPS位置信息:
python metadata_editor.py 照片.jpg --remove "GPS*"从CSV文件批量导入并应用元数据:
python metadata_editor.py 照片目录/ --import-file metadata.csv在修改前备份文件:
python metadata_editor.py 重要文档.pdf --add "Author=我的名字" --backup模拟运行，查看将要进行的更改:
python metadata_editor.py 视频目录/ --add "Title=我的视频" --dry-run递归处理整个目录树中的图像文件:
python metadata_editor.py 照片库/ -r --include "*.jpg" "*.png"将元数据结果格式化为XML输出:
python metadata_editor.py 文档目录/ -o metadata.xml --format xml提取所有照片的拍摄日期和相机型号:
python metadata_editor.py 照片目录/ --fields "DateTimeOriginal" "Model" --output dates.csv --format csv批量设置PDF文档的作者和标题:
python metadata_editor.py 文档/ --include "*.pdf" --add "Author=公司名称" "Title=项目报告"usage: metadata_editor.py [-h] [-r] [--include PATTERN [PATTERN ...]] [--exclude PATTERN [PATTERN ...]]
[--fields FIELD [FIELD ...]] [--add FIELD=VALUE [FIELD=VALUE ...]]
[--remove FIELD [FIELD ...]] [--preserve] [--import-file FILE] [--export-file FILE]
[-o OUTPUT] [--format {text,json,csv,xml}] [--backup] [-v] [--dry-run]
files [files ...]
文件元数据编辑器 - 查看和修改各种文件类型的元数据
positional arguments:
files 要处理的文件或目录
文件选择选项:
-r, --recursive 递归处理子目录
--include PATTERN [PATTERN ...]
包含的文件模式（例如"*.jpg *.png"）
--exclude PATTERN [PATTERN ...]
排除的文件模式（例如"*thumb*"）
元数据选项:
--fields FIELD [FIELD ...]
要显示的元数据字段（支持通配符）
--add FIELD=VALUE [FIELD=VALUE ...]
要添加/修改的元数据字段和值，格式为"字段=值"
--remove FIELD [FIELD ...]
要删除的元数据字段
--preserve 保留原始元数据（当添加新字段时）
导入/导出选项:
--import-file FILE 从文件导入元数据 (JSON/CSV)
--export-file FILE 导出元数据到文件 (JSON/CSV/XML)
输出选项:
-o, --output OUTPUT 输出结果到文件
--format {text,json,csv,xml}
输出格式 (默认: text)
其他选项:
--backup 在修改前备份文件
-v, --verbose 显示详细信息
--dry-run 模拟运行，不实际修改文件
- 摄影爱好者: 批量管理照片的EXIF信息，添加版权信息，清理隐私数据
- 音乐收藏家: 整理和标准化音乐文件的ID3标签，完善专辑、艺术家信息
- 视频创作者: 添加或修改视频文件的元数据，如标题、作者、描述等
- 文档管理: 更新PDF或Office文档的属性，统一设置作者、公司等信息
- 数据分析: 提取和导出大量文件的元数据用于分析和报告
该脚本需要以下Python库（根据需要处理的文件类型安装）：
-
图像文件: Pillow, piexif
pip install Pillow piexif
-
音频文件: mutagen
pip install mutagen
-
视频文件: ffmpeg-python
pip install ffmpeg-python
-
文档文件: PyPDF2, python-docx
pip install PyPDF2 python-docx
文件清理工具用于查找和删除临时文件、旧文件或不必要的文件，帮助用户清理磁盘空间，提高系统性能。
- 多种清理规则：支持按文件类型、大小、年龄、访问时间和内容特征进行清理
- 智能模式识别：自动识别常见的临时文件、缓存文件、日志文件和备份文件
- 重复文件查找：使用内容哈希检测和清理重复文件
- 灵活清理选项：提供报告、删除、移动到回收站和移动到目标目录等多种清理模式
- 安全功能：支持模拟运行、交互式确认和报告功能，防止误删重要文件
- 目录过滤：支持排除特定目录和文件模式
# 扫描目录并报告可清理的文件
python file_cleaner.py D:\下载目录 --report
# 清理指定目录中的临时文件，移动到回收站
python file_cleaner.py C:\工作目录 --trash --temp
# 查找并删除超过30天未访问的文件
python file_cleaner.py E:\归档文件 --delete --last-access 30
# 模拟清理重复文件
python file_cleaner.py D:\照片 --duplicates --dry-run# 清理多个位置的特定类型文件
python file_cleaner.py C:\Temp D:\Downloads --include "*.tmp" "*.bak" "thumbs.db" --trash
# 查找大于100MB的旧日志文件
python file_cleaner.py D:\Logs --logs --min-size 100MB --min-age 90 --report
# 清理备份和缓存，但排除特定目录
python file_cleaner.py C:\ --backups --cache --exclude-dir "Program Files" "Windows" "Users"
# 将超过1GB的文件移动到外部存储
python file_cleaner.py D:\Projects --min-size 1GB --move --target-dir "E:\大文件存储" --keep-structure文件选择参数:
paths: 要清理的文件或目录路径-r, --recursive: 递归处理子目录（默认启用）--no-recursive: 不递归处理子目录
清理模式:
--report: 仅报告，不删除文件（默认）--delete: 直接删除匹配的文件--trash: 将匹配的文件移至回收站--move: 将匹配的文件移动到指定目录-i, --interactive: 交互式确认每个文件
文件筛选参数:
--include: 要包含的文件模式列表（如 *.tmp *.bak）--exclude: 要排除的文件模式列表--exclude-dir: 要排除的目录名列表--min-size: 最小文件大小（如 1KB, 5MB）--max-size: 最大文件大小（如 10MB, 1GB）--min-age: 最小文件年龄（天）--last-access: 最后访问时间（天）--empty-only: 仅处理空文件
清理选项:
--temp: 清理临时文件（默认启用）--no-temp: 不清理临时文件--cache: 清理缓存文件和目录--logs: 清理日志文件--backups: 清理备份文件--duplicates: 查找和清理重复文件--custom: 自定义清理规则（正则表达式）
移动选项:
-t, --target-dir: 移动文件的目标目录（当--move选项启用时使用）--keep-structure: 移动文件时保持目录结构
输出选项:
-l, --log-file: 将日志写入指定文件-n, --dry-run: 模拟运行，不实际删除文件-v, --verbose: 显示详细信息
- 系统维护：定期清理系统中的临时文件和缓存，提高性能
- 磁盘空间管理：快速查找和清理占用大量空间的文件和重复内容
- 开发环境清理：清理编译生成的临时文件、缓存和日志
- 数据整理：根据访问时间或年龄清理旧数据
- 安全清理：在交互模式下有选择地清理敏感文件
- 使用
--delete选项时请谨慎，删除后无法恢复 - 建议先使用
--dry-run或--report模式查看将要删除的文件 - 对重要数据使用
--trash选项而非--delete，以便于恢复 - 使用
--exclude-dir排除系统关键目录，避免影响系统运行
send2trash: 安全地将文件发送到回收站（使用--trash选项时需要）pip install send2trash
这个脚本提供了在不同文件格式之间进行转换的功能，支持多种文件类型，如文档、图像、音频、视频等。
- 多种格式支持:
- 文档格式：PDF、DOCX、DOC、ODT、RTF、TXT等
- 图像格式：JPG、PNG、GIF、BMP、TIFF、WebP、SVG等
- 音频格式：MP3、WAV、OGG、FLAC、AAC等
- 视频格式：MP4、AVI、MKV、MOV、WebM等
- 数据格式：CSV、XLSX、XLS、ODS等
- Markdown与HTML格式互转
- 批量转换：可以批量处理多个文件或整个目录中的文件
- 递归处理：支持递归处理子目录中的文件
- 并行处理：支持多线程并行转换，提高处理速度
- 质量控制：对于图像和音视频转换，支持设定转换质量
- 元数据控制：可以选择是否保留文件元数据
- 灵活输出：支持指定输出文件或目录路径
基本用法（转换单个文件）：
python format_converter.py document.docx pdf指定输出文件：
python format_converter.py document.docx -t pdf -o output.pdf批量转换整个目录中的所有Excel文件为CSV：
python format_converter.py -r -f xlsx -t csv ./documents使用4个线程批量转换图片：
python format_converter.py -r -f jpg -t png -p 4 ./images调整转换质量（0-100）：
python format_converter.py -q 90 image.jpg -t webp列出支持的格式：
python format_converter.py --list-formats查看特定格式可以转换到哪些格式：
python format_converter.py --list-formats docx脚本会自动检测系统中是否安装了以下转换工具：
- LibreOffice: 用于文档格式转换（docx、pdf、odt等）
- ImageMagick: 用于图像处理和转换（jpg、png、webp等）
- FFmpeg: 用于音频和视频格式转换（mp3、mp4等）
- Pandoc: 用于Markdown、HTML和其他文本格式转换
如果缺少某个工具，相关的转换功能将受限，但其他功能仍然可用。
usage: format_converter.py [-h] [-t TARGET_FORMAT] [-o OUTPUT] [-f SOURCE_FORMAT] [-r]
[-q QUALITY] [-p PARALLEL] [--no-metadata] [--overwrite]
[--list-formats [FORMAT]] [-v]
[sources ...]
文件格式转换工具 - 在不同文件格式之间进行转换
positional arguments:
sources 要转换的源文件或目录路径
options:
-h, --help 显示帮助信息并退出
-t, --to TARGET_FORMAT
目标文件格式(如pdf, jpg等)
-o, --output OUTPUT 输出文件或目录，适用于转换单个文件或指定输出目录
-f, --from SOURCE_FORMAT
源文件格式，用于批处理时只转换特定格式的文件
-r, --recursive 递归处理子目录
-q, --quality QUALITY
转换质量(0-100)，影响图像和音视频转换质量
-p, --parallel PARALLEL
并行处理的线程数
--no-metadata 不保留元数据
--overwrite 覆盖已存在的文件
--list-formats [FORMAT]
列出支持的文件格式，可选择特定输入格式查看其支持的转换目标格式
-v, --verbose 输出详细日志
这个脚本提供了一系列处理PDF文件的功能，使您能够拆分、合并、提取页面以及以各种方式操作PDF文档。
- PDF拆分:
- 根据页数将PDF拆分成单独的文件
- 支持自定义输出文件的命名模式
- 提供详细的拆分过程日志
- PDF合并:
- 将多个PDF文件合并为一个文档
- 尽可能保持原始文档结构和元数据
- 页面提取:
- 从PDF文档中提取特定页面或页面范围
- 支持复杂的页面选择（例如"1-5,8,10-12"）
- 页面旋转:
- 将特定页面或页面范围旋转90、180或270度
- 在旋转过程中保留其他文档属性
- 添加水印:
- 添加可自定义文本、颜色、不透明度、角度和大小的文本水印
- 可以在页面上的任何位置放置水印
- 添加页码:
- 添加可自定义格式和位置的页码
- 支持不同的编号样式和起始页码
- PDF安全性:
- 使用用户密码和所有者密码加密PDF
- 解密受保护的PDF文档
- PDF压缩:
- 减小PDF文件大小以便于共享和存储
- 移除不必要的元数据以优化文件大小
将PDF拆分为每个文件一页：
python pdf_toolkit.py split input.pdf将PDF拆分为每个文件5页：
python pdf_toolkit.py split input.pdf --pages-per-file 5合并多个PDF：
python pdf_toolkit.py merge output.pdf file1.pdf file2.pdf file3.pdf提取特定页面：
python pdf_toolkit.py extract input.pdf --pages 1-5,8,10-12 --output extracted.pdf旋转特定页面：
python pdf_toolkit.py rotate input.pdf --rotation 90 --pages 1-3 --output rotated.pdf为PDF添加水印：
python pdf_toolkit.py watermark input.pdf --text "机密文件" --color gray --opacity 0.3 --angle 45 --size 40 --output watermarked.pdf添加页码：
python pdf_toolkit.py number input.pdf --format "第%d页" --position bottom-right --output numbered.pdf加密PDF：
python pdf_toolkit.py encrypt input.pdf --password 我的密码 --output encrypted.pdf解密PDF：
python pdf_toolkit.py decrypt input.pdf --password 我的密码 --output decrypted.pdf压缩PDF：
python pdf_toolkit.py compress input.pdf --output compressed.pdfusage: pdf_toolkit.py [-h] [-o OUTPUT_DIR] [--debug]
{split,merge,extract,rotate,watermark,number,encrypt,decrypt,compress} ...
PDF工具集 - 提供PDF文件处理的多种功能
positional arguments:
{split,merge,extract,rotate,watermark,number,encrypt,decrypt,compress}
命令
split 拆分PDF文件
merge 合并多个PDF文件
extract 从PDF中提取页面
rotate 旋转PDF页面
watermark 给PDF添加水印
number 给PDF添加页码
encrypt 加密PDF文件
decrypt 解密PDF文件
compress 压缩PDF文件
options:
-h, --help 显示帮助信息并退出
-o, --output-dir 处理后文件的保存目录（默认: ./pdf_output）
--debug 启用调试日志
此脚本需要PyPDF2库来处理PDF文件。对于水印和页码功能，还需要reportlab库：
pip install PyPDF2 reportlab- 处理加密的PDF时，请确保记住您的密码，因为一旦丢失将无法恢复
- 压缩功能提供基本的PDF优化；对于高级压缩，可能需要专门的工具
- 为获得最佳的水印和页码效果，请确保安装了reportlab库
- 处理非常大的PDF文件可能需要大量内存资源
这个脚本提供了智能的媒体文件组织功能，可以根据照片和视频的元数据（如拍摄日期、GPS位置等）自动将它们分类整理到有意义的目录结构中。
- 多种组织方式:
- 按日期组织（年/月/日结构）
- 按位置组织（国家/城市/区域）
- 按事件自动分组（基于时间间隔）
- 平坦结构（仅重命名，不创建层级目录）
- 元数据提取:
- 从图像文件中提取EXIF信息（拍摄日期、GPS坐标、相机型号等）
- 从视频文件中提取创建日期和位置信息
- 根据GPS坐标自动获取地理位置信息（国家、城市、区域）
- 智能文件命名:
- 自定义命名模板
- 支持多种变量（日期、时间、位置、相机信息、计数器等）
- 自动处理文件名冲突
- 自动事件分组:
- 基于时间间隔自动将文件分组为事件
- 可设置事件内文件最小数量和最大时间间隔
- 自动创建有意义的事件文件夹名称
- 批量处理:
- 多线程并行处理，提高效率
- 支持递归处理子目录
- 选择性处理特定类型的媒体文件（图像、视频、RAW格式）
- 安全功能:
- 预览模式（不实际移动文件）
- 选择复制而不是移动文件
- 详细的处理日志和统计报告
按日期组织媒体文件（默认模式）：
python media_organizer.py D:\Photos按位置组织媒体文件：
python media_organizer.py D:\Photos -t location指定输出目录：
python media_organizer.py D:\Photos -o E:\Organized_Photos预览模式（不实际移动文件）：
python media_organizer.py D:\Photos --dry-run使用自定义命名模板：
python media_organizer.py D:\Photos --rename "{date}_{camera}_{counter}"复制而不是移动文件：
python media_organizer.py D:\Photos --copy自动创建事件文件夹：
python media_organizer.py D:\Photos -t event --events自定义事件分组参数：
python media_organizer.py D:\Photos -t event --events --event-gap 1800 --min-event-files 3只处理特定类型的文件：
python media_organizer.py D:\Photos --file-types image raw调整并发线程数以提高性能：
python media_organizer.py D:\Photos --threads 8生成处理报告：
python media_organizer.py D:\Photos --report report.json用法: media_organizer.py [-h] [-o OUTPUT_DIR] [-t {date,location,event,flat}]
[-r] [--rename TEMPLATE] [--copy] [--dry-run]
[--file-types {image,video,raw} [{image,video,raw} ...]]
[--events] [--event-gap SECONDS]
[--min-event-files N] [--threads N]
[--report FILE] [-v] [--debug]
input_dir
媒体文件组织器 - 根据日期、位置等信息组织照片和视频
位置参数:
input_dir 要处理的输入目录
可选参数:
-h, --help 显示帮助信息并退出
-o, --output-dir 输出目录，默认将在原位置组织
-t, --type {date,location,event,flat}
组织类型: date(按日期), location(按位置), event(按事件), flat(平坦结构)
-r, --recursive 递归处理子目录
--rename TEMPLATE 重命名模板，例如: '{date}_{counter}'
可用变量: {date}, {year}, {month}, {day}, {hour}, {minute},
{second}, {camera}, {location}, {counter}, {original}
--copy 复制而不是移动文件
--dry-run 预览模式，不实际移动文件
--file-types {image,video,raw} [{image,video,raw} ...]
要处理的文件类型
--events 创建事件文件夹
--event-gap SECONDS 定义事件的时间间隔(秒)
--min-event-files N 每个事件的最小文件数量
--threads N 并行处理的线程数
--report FILE 生成报告文件路径
-v, --verbose 详细输出模式
--debug 调试模式
此脚本需要以下Python库：
pip install pillow exif hachoir geopy- pillow: 处理图像和提取基本EXIF数据
- exif: 提供更详细的EXIF数据提取
- hachoir: 用于提取视频元数据
- geopy: 根据GPS坐标获取位置信息
- 按位置组织需要网络连接以查询地理位置信息
- 处理大量文件时，考虑增加线程数以提高效率
- 首次运行时建议使用
--dry-run选项来预览变更 - 确保拥有足够权限访问和修改目标目录
- 对于没有元数据的文件，将使用文件修改时间作为后备选项