← 返回 Skills 市场

file-backup-organizer

Name: file-backup-organizer
Author: psyhl

作者 psyhl · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

112

总下载

当前安装

版本数

在 OpenClaw 中安装

/install file-backup-organizer

功能描述

Intelligent file backup and organizer. Recursively scans folders, categorizes files by type, supports filtering/exclusion, handles duplicates, and generates...

使用说明 (SKILL.md)

file-backup-organizer v1.0.0 -- Intelligent File Backup & Organizer

Core Functions

Feature	Description
Recursive Scan	Scans source folder and all subdirectories
Smart Categorization	Auto-classifies by extension (Word, Excel, PDF, Images, etc.)
Flexible Filtering	Supports excluding specific file types (e.g. .tmp, .log, .cache)
Duplicate Handling	Auto-appends sequential numbers to avoid overwriting
Detailed Reports	Generates backup inventory and deletion lists
Risk Warnings	Flags files that may break without directory structure

How to Use

The main script is scripts/backup_files.py. It provides Python functions:

from scripts.backup_files import backup_files, organize_by_type

backup_files(source_path, exclude_extensions=None)

source_path: Source folder path (e.g. "D:\Projects")
exclude_extensions: List of extensions to exclude (e.g. [".tmp", ".log"])
Returns: dict with success status, file counts, categories, backup directory

organize_by_type(source_path)

source_path: Source folder path
Returns: same as backup_files (without exclusion)

Execution

Run via Python:

python scripts/backup_files.py

Or import and call functions directly in your workflow.

Supported File Types

Category	Extensions
Word	.doc, .docx, .docm, .odt, .rtf
Excel	.xls, .xlsx, .xlsm, .csv, .ods
PDF	.pdf
PPT	.ppt, .pptx, .pptm, .ppsx
Images	.jpg, .jpeg, .png, .gif, .bmp, .webp, .svg, .psd
Videos	.mp4, .avi, .mkv, .mov
Audio	.mp3, .wav, .flac
Archives	.zip, .rar, .7z
Code	.py, .js, .html, .css, .java, .cpp, .php, .json, .xml
Text	.txt, .md, .log

Output

Backup creates a folder named {source}_backup with:

Subfolders per file type
backup_report.txt -- full inventory with file counts and names
exclusion_list.txt -- list of excluded files (only if exclude_extensions used)

Warnings

These file types may break without original directory structure:

Web files: .html, .htm, .css, .js
Server scripts: .php, .asp, .aspx, .jsp
Config files: .json, .xml, .yaml, .ini

Such files are flagged in the backup report.

Dependencies

None -- uses Python standard library only (os, shutil, pathlib, collections, datetime).

安全使用建议

This package appears to do what it claims (local file backup and organization) and uses only the Python standard library. Before installing/running: 1) note the documentation/code mismatch for backup folder and report filenames (the script uses Chinese filenames and a Chinese '_备份' suffix), so expect those names instead of the English ones in SKILL.md; 2) run it first on a small, non-sensitive test directory to verify behavior and output location; 3) be aware the script will copy any files readable by the process — do not point it at sensitive system or credential directories unless you intend to back them up; 4) because the tool runs locally with whatever file permissions the agent/process has, ensure the agent's runtime user has only the intended file access to avoid unintentional copying of secrets. If you want the filenames and backup-folder naming to match the English SKILL.md, inspect and (if acceptable) modify the script's naming strings before use.

功能分析

Type: OpenClaw Skill Name: file-backup-organizer Version: 1.0.0 The skill bundle provides a legitimate file organization and backup utility that categorizes files by extension into subfolders. The implementation in `scripts/backup_files.py` uses standard Python libraries (os, shutil, pathlib) to perform recursive scans and file copies, including logic to handle filename collisions and generate summary reports. There is no evidence of data exfiltration, network activity, or unauthorized access to sensitive system directories.

能力评估

ℹ Purpose & Capability

Overall the code implements the described recursive scan, categorization, exclusion, duplicate-handling, and report generation. Minor incoherences: SKILL.md states output filenames and an English-suffixed backup folder (e.g., '{source}_backup', 'backup_report.txt', 'exclusion_list.txt') but the implementation creates Chinese-named artifacts (e.g., '{source}_备份', '备份清单.txt', '删除清单.txt'). This is a localization/documentation mismatch but not evidence of malicious intent.

✓ Instruction Scope

Runtime instructions are limited to running the provided Python script or importing its functions. The script only reads the user-supplied source_path and writes backups/reports to a sibling backup directory; it does not access other system configuration, environment variables, or network endpoints.

✓ Install Mechanism

No install specification is provided and the code uses only Python standard library imports. Nothing is downloaded or written to system paths by an installer.

✓ Credentials

The skill requests no environment variables or credentials. The script operates entirely on a path supplied by the user, which is appropriate for a file backup tool.

✓ Persistence & Privilege

The skill is not marked always:true and does not modify other skills or system-wide agent settings. It performs only local file I/O scoped to the given source and backup directories.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install file-backup-organizer
安装完成后，直接呼叫该 Skill 的名称或使用 /file-backup-organizer 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

v1.0.0: initial ClawHub release, recursive scan + smart categorization + filtering + reports

元数据

Slug file-backup-organizer

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题