详细分析 ▾
运行时依赖
版本
v1.0.0:ClawHub 初始版本,支持递归扫描 + 智能分类 + 过滤 + 报告
安装命令
点击复制技能文档
# file-backup-organizer v1.0.0 -- 智能文件备份与整理 ## 核心功能 | 功能 | 描述 | |---------|-------------| | 递归扫描 | 扫描源文件夹及所有子目录 | | 智能分类 | 按扩展名自动分类(Word、Excel、PDF、图片等) | | 灵活过滤 | 支持排除特定文件类型(如 .tmp、.log、.cache) | | 重复处理 | 自动追加序号避免覆盖 | | 详细报告 | 生成备份清单与删除列表 | | 风险警告 | 标记可能因目录结构缺失而失效的文件 | ## 使用方法 主脚本为 scripts/backup_files.py,提供以下 Python 函数: ``python from scripts.backup_files import backup_files, organize_by_type ` ### backup_files(source_path, exclude_extensions=None) - source_path:源文件夹路径(如 "D:\\Projects") - exclude_extensions:要排除的扩展名列表(如 [".tmp", ".log"]) - 返回:包含成功状态、文件计数、分类、备份目录的字典 ### organize_by_type(source_path) - source_path:源文件夹路径 - 返回:与 backup_files 相同(无排除) ## 执行 通过 Python 运行: `bash python scripts/backup_files.py ` 或直接导入函数在流程中调用。 ## 支持的文件类型 | 类别 | 扩展名 | |----------|-----------| | Word | .doc, .docx, .docm, .odt, .rtf | | Excel | .xls, .xlsx, .xlsm, .csv, .ods | | PDF | .pdf | | PPT | .ppt, .pptx, .pptm, .ppsx | | 图片 | .jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .psd | | 视频 | .mp4, .avi, .mkv, .mov | | 音频 | .mp3, .wav, .flac | 压缩包 | .zip, .rar, .7z | 代码 | .py, .js, .html, .css, .java, .cpp, .php, .json, .xml | 文本 | .txt, .md, .log | ## 输出 备份创建名为 {source}_backup 的文件夹,内含: - 按文件类型分的子文件夹 - backup_report.txt -- 完整清单,含文件计数与名称 - exclusion_list.txt` -- 被排除文件列表(仅使用 exclude_extensions 时) ## 警告 以下文件类型可能因失去原目录结构而失效: - 网页文件:.html、.htm、.css、.js - 服务器脚本:.php、.asp、.aspx、.jsp - 配置文件:.json、.xml、.yaml、.ini 此类文件将在备份报告中被标记。 ## 依赖 无依赖 -- 仅使用 Python 标准库(os、shutil、pathlib、collections、datetime)。