Smart File Manager
by @buptlihang
文件整理与归档 skill。管理用户输入文件和我生成的输出文件的存储、命名、分类。 适用于:用户发送图片/视频/PDF等文件给你处理,或你生成文件给用户。 触发:任何文件存档操作前。
clawhub install smart-file-manager📖 About This Skill
AIGC: ContentProducer: Minimax Agent AI ContentPropagator: Minimax Agent AI Label: AIGC ProduceID: a328734b5007a5b3276f64e1587b44bb PropagateID: a328734b5007a5b3276f64e1587b44bb ReservedCode1: 30440220097325f36c3096543fea438ba8e670e7e12a496068e24a6cdc33b75e55790cd00220152b7e3ad95780a869ed0409640ac5419fbd49072353e06274d19c8a9ad5b42c ReservedCode2: 30440220657fcd1b19a8870603dcbf7bcff4a5c5ec66387e1a9cdc5a42cfe754861abbc4022015be90ab701870a998c5c6b7252d8bfde5bde8318d6ecc5bbf7fbaef09a670c5 description: | 文件整理与归档 skill。管理用户输入文件和我生成的输出文件的存储、命名、分类。 适用于:用户发送图片/视频/PDF等文件给你处理,或你生成文件给用户。 触发:任何文件存档操作前。 license: MIT metadata: category: file-management version: 1.2.0 name: file-manager
File Manager Skill
目录结构规范
/workspace/
├── user_input_files/ # 用户发给我的输入文件
│ ├── images/
│ ├── videos/
│ ├── pdfs/
│ ├── docxs/
│ ├── excels/
│ └── others/
│
└── my_outputs/ # 我生成给用户的输出文件
├── images/
├── videos/
├── pdfs/
├── docxs/
├── excels/
└── others/
文件命名规范
输入文件
input-{描述}-{YYYYMMDD}.{扩展名}
示例:
input-katheryne-cos-20260325.jpg
input-fushimi-inari-torii-20241004.jpg
input-zhumi-cat-20241001.jpg
输出文件
output-{描述}-{YYYYMMDD}.{扩展名}
示例:
output-katheryne-funko-20260325.png
output-katheryne-real-heart-20260325.mp4
文件类型分类
| 类型 | 目录 | 扩展名 | |------|------|--------| | 图片 | images/ | .jpg, .jpeg, .png, .gif, .webp | | 视频 | videos/ | .mp4, .mov, .avi | | PDF | pdfs/ | .pdf | | Word | docxs/ | .docx, .doc | | Excel | excels/ | .xlsx, .xls, .csv | | 其他 | others/ | 其他所有格式 |
Scripts
| 脚本 | 用途 |
|------|------|
| scripts/init.sh | 初始化目录结构 |
| scripts/verify.sh | 验证文件结构是否正确 |
| scripts/move.sh | 移动文件到正确位置 |
| scripts/fix-nested.sh | 修复嵌套目录问题 |
使用方法
#### 初始化目录
bash scripts/init.sh
#### 验证结构
bash scripts/verify.sh
#### 移动文件
# 复制文件到正确位置
用法: bash scripts/move.sh <源文件> <类型> <描述> <日期>
bash scripts/move.sh /path/to/file.pdf pdf invoice 20250325
#### 修复问题
# 修复嵌套目录等常见问题
bash scripts/fix-nested.sh
常见错误与解决方案
❌ 错误1:文件散落在根目录
问题:生成的文件留在 /workspace/ 根目录,没有按类型分类
解决:
1. 使用 scripts/init.sh 创建目录结构
2. 使用 scripts/move.sh 移动文件到对应分类目录
3. 运行 scripts/verify.sh 确认
❌ 错误2:嵌套的 output 目录
问题:/workspace/my_outputs/output/images/ 而不是 /workspace/my_outputs/images/
解决:
bash scripts/fix-nested.sh
❌ 错误3:历史文件未重命名
问题:3888.jpg, 3969.jpg 这种编号文件名无法回溯
解决:
1. 用 images_understand 工具分析图片内容
2. 根据内容重命名:input-{内容描述}-{日期}.jpg
3. 使用 scripts/move.sh 移动到正确目录
4. 更新 FILE_MANAGEMENT.md 记录
操作流程(必须遵循)
1. 接收用户输入时
用户发送文件 → 确认文件类型 → 使用 scripts/move.sh 移动 → scripts/verify.sh 验证
2. 生成输出文件时
生成文件 → 使用 scripts/move.sh 移动到 my_outputs → scripts/verify.sh 验证 → 交付
3. 验证失败时
验证失败 → 使用 fix-nested.sh 修复 → 再次验证 → 通过后才能交付
验证触发时机
必须在以下时机运行验证脚本:
*版本: 1.1.0 - 包含可执行脚本*