← 返回 Skills 市场

Jiji5188 File Manager

Name: Jiji5188 File Manager
Author: jiji5188

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

cross-platform ✓ 安全检测通过

100

总下载

当前安装

版本数

在 OpenClaw 中安装

/install jiji5188-file-manager

功能描述

OpenClaw自动化文件管理助手，用于批量文件操作、智能分类、重复文件清理、文件重命名、目录同步等任务。当用户需要整理文件、批量重命名、清理重复文件、同步目录或自动化文件工作流时使用此技能。

使用说明 (SKILL.md)

File Manager - OpenClaw 自动化文件管理

核心功能

1. 智能文件分类 (`organize`)

按文件类型、日期、大小或自定义规则自动分类文件。

# 按文件类型分类
python scripts/organize.py \x3Csource_dir> --by-type

# 按日期分类 (年/月/日)
python scripts/organize.py \x3Csource_dir> --by-date --date-format year/month

# 按文件大小分类 (尚未实现)
# python scripts/organize.py \x3Csource_dir> --by-size --size-ranges "10MB,100MB,1GB"

2. 批量重命名 (`batch_rename`)

支持正则表达式、序列号、日期等模式的重命名。

# 添加前缀/后缀
python scripts/batch_rename.py \x3Cpattern> --prefix "IMG_" --suffix "_2024"

# 使用正则替换
python scripts/batch_rename.py "*.jpg" --replace "IMG_(\d+)" "Photo_\1"

# 序列号重命名
python scripts/batch_rename.py "*.jpg" --sequence --padding 4

3. 重复文件清理 (`deduplicate`)

基于内容哈希检测并处理重复文件。

# 扫描并列出重复文件
python scripts/deduplicate.py \x3Cdirectory> --scan-only

# 删除重复文件（保留最旧/最新）
python scripts/deduplicate.py \x3Cdirectory> --keep oldest --action delete

# 移动重复文件到隔离目录
python scripts/deduplicate.py \x3Cdirectory> --action move --to \x3Cquarantine_dir>

4. 目录同步 (`sync`)

双向或单向目录同步，支持排除模式和增量同步。

# 单向同步 (源 → 目标)
python scripts/sync.py \x3Csource> \x3Ctarget> --mirror

# 双向同步 (尚未实现)
python scripts/sync.py \x3Cdir1> \x3Cdir2> --bidirectional

# 排除特定文件
python scripts/sync.py \x3Csource> \x3Ctarget> --exclude "*.tmp,*.log,.git"

使用模式

常见场景

场景1: 整理下载文件夹

# 自动分类下载的文件
python scripts/organize.py ~/Downloads --by-type --move

场景2: 清理重复照片

# 扫描重复照片
python scripts/deduplicate.py ~/Pictures --scan-only

场景3: 批量整理项目文件

# 按日期整理项目文件
python scripts/organize.py ./projects --by-date --date-format year/month

场景4: 自动备份工作目录

# 同步到备份目录，排除临时文件
python scripts/sync.py ~/Work ~/Backups/Work --exclude "node_modules,.git,*.tmp"

工作流

文件整理工作流

分析目录结构和文件分布
选择分类策略 (类型/日期/大小/自定义)
执行整理 (dry-run 预览 → 确认 → 执行)
验证结果

清理工作流

扫描重复/过期/大文件
生成报告并预览
用户确认或自动处理
移动到回收站/隔离区/直接删除

同步工作流

分析源和目标差异
预览待同步的文件列表
确认后执行同步
显示同步统计

安全原则

预览优先: 所有修改操作默认执行 dry-run 预览，需加 --execute 才执行
操作确认: 执行前需要用户输入 yes 确认
符号链接安全: 遍历目录时跳过符号链接，避免无限递归
冲突保护: 目标文件已存在时自动重命名或跳过，不会覆盖

⚙️ 依赖安装与环境初始化

环境要求

Python 3.8+
无外部依赖，仅使用 Python 标准库

脚本参数说明

直接查看脚本帮助获取详细参数:

python scripts/\x3Cscript>.py --help

安全使用建议

这是一个本地文件管理工具，代码可读且行为与说明一致，但发布来源未说明且元数据有不一致（版本/owner/publishedAt）。在安装或运行前请： - 仔细检查脚本（它们已经包含在包内）； - 先在非关键目录或临时目录运行 dry-run（默认模式）并确认预览输出； - 对重要数据先做备份，尤其在执行 --execute、delete 或 move 操作前； - 如果你对来源或元数据不放心，避免在生产/个人重要目录运行，或在沙箱/虚拟机中测试； - 如担心自动执行，可在 OpenClaw 平台禁用技能的自动调用（或只在手动触发下使用）。

功能分析

Type: OpenClaw Skill Name: jiji5188-file-manager Version: 1.0.0 The skill bundle provides a legitimate set of file management tools for organizing, renaming, deduplicating, and syncing files. The Python scripts (batch_rename.py, deduplicate.py, organize.py, sync.py) use standard libraries, implement safety features like dry-run previews and mandatory user confirmation, and show no signs of data exfiltration, obfuscation, or malicious intent.

能力评估

ℹ Purpose & Capability

技能名称、描述与包含的脚本（organize, batch_rename, deduplicate, sync）一致：它们执行本地文件分类、重命名、去重和同步。没有请求与此用途不相关的凭据或外部服务。但元数据存在不一致（注册表版本 1.0.0 vs SKILL.md/_meta.json 中 1.2.1，ownerId 也不完全一致，publishedAt 值异常），以及 source/homepage 均为 unknown/none — 这提示发布来源不明确，建议谨慎对待来源不明的包。

✓ Instruction Scope

SKILL.md 明确列出如何调用 scripts/*.py，并强调 dry-run 预览与用户确认。运行说明只涉及本地文件系统操作、无网络外发、无读取未声明的配置或环境变量，范围与描述一致。

✓ Install Mechanism

无安装规范（instruction-only），文件为纯 Python 脚本且 requirements.txt 表示仅使用标准库；没有下载外部归档或从不可信 URL 拉取代码，写磁盘/执行行为限于用户显式运行脚本。

✓ Credentials

不要求任何环境变量或凭据，也不访问系统凭据或配置路径。脚本仅进行文件 I/O 和哈希计算，这与其功能相称。

ℹ Persistence & Privilege

flags: always = false（正常）。默认允许模型发起调用（平台默认），但本技能没有自启动安装或持久修改其他技能的行为。若担心自动执行，可在平台上禁用模型自动调用或仅在手动触发时使用。

如何使用

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

版本历史

v1.0.0

- Initial release of the file manager skill, providing automated file organization, batch renaming, duplicate file cleaning, and directory synchronization. - Supports intelligent file categorization by type, date, or custom rules. - Enables batch file renaming using patterns, prefixes/suffixes, regex, or sequence numbers. - Detects and handles duplicate files based on content hashes, with options to keep, delete, or quarantine. - Allows one-way directory sync with exclude rules; bidirectional sync planned. - Emphasizes safety with dry-run previews, explicit confirmation, and conflict protections.

元数据

Slug jiji5188-file-manager

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题