name: file-manager description: OpenClaw自動化檔案管理助手，用於批次檔案操作、智慧分類、重複檔案清理、檔案重新命名、目錄同步等任務。當用戶需要整理檔案、批次重新命名、清理重複檔案、同步目錄或自動化檔案工作流時使用此技能。

File Manager - OpenClaw 自動化檔案管理

核心功能

1. 智慧檔案分類 (organize)

按檔案型別、日期、大小或自定義規則自動分類檔案。

# 按檔案型別分類
python scripts/organize.py <source_dir> --by-type

# 按日期分類 (年/月/日)
python scripts/organize.py <source_dir> --by-date --date-format year/month

# 按檔案大小分類
python scripts/organize.py <source_dir> --by-size --size-ranges "10MB,100MB,1GB"

2. 批次重新命名 (batch_rename)

支援正規表示式、序列號、日期等模式的重新命名。

# 新增字首/字尾
python scripts/batch_rename.py <pattern> --prefix "IMG_" --suffix "_2024"

# 使用正則替換
python scripts/batch_rename.py "IMG_(\d+)" --replace "Photo_\1"

# 序列號重新命名
python scripts/batch_rename.py "*.jpg" --sequence --start 1 --pad 4

3. 重複檔案清理 (deduplicate)

基於內容雜湊檢測並處理重複檔案。

# 掃描並列出重複檔案
python scripts/deduplicate.py <directory> --scan-only

# 刪除重複檔案（保留最舊/最新）
python scripts/deduplicate.py <directory> --keep oldest --action delete

# 移動重複檔案到隔離目錄
python scripts/deduplicate.py <directory> --action move --to <quarantine_dir>

4. 目錄同步 (sync)

雙向或單向目錄同步，支援排除模式和增量同步。

# 單向同步 (源 → 目標)
python scripts/sync.py <source> <target> --mirror

# 雙向同步
python scripts/sync.py <dir1> <dir2> --bidirectional

# 排除特定檔案
python scripts/sync.py <source> <target> --exclude "*.tmp,*.log,.git"

5. 檔案監控 (watch)

監控目錄變化並觸發動作。

# 監控並記錄變化
python scripts/watch.py <directory> --log changes.log

# 監控並自動執行命令
python scripts/watch.py <directory> --on-change "python scripts/organize.py {path}"

使用模式

常見場景

場景1: 整理下載資料夾

# 自動分類下載的檔案
python scripts/organize.py ~/Downloads --by-type --move

場景2: 清理重複照片

# 找出並刪除重複照片，保留高質量版本
python scripts/deduplicate.py ~/Pictures --compare-resolution --keep best

場景3: 批次整理專案檔案

# 按日期整理並按型別分類
python scripts/organize.py ./projects --by-date --by-type --date-format year/month

場景4: 自動備份工作目錄

# 同步到備份目錄，排除臨時檔案
python scripts/sync.py ~/Work ~/Backups/Work --exclude "node_modules,.git,*.tmp"

工作流

檔案整理工作流

1. 分析目錄結構和檔案分佈
2. 選擇分類策略 (型別/日期/大小/自定義)
3. 執行整理 (dry-run 預覽 → 確認 → 執行)
4. 驗證結果

清理工作流

1. 掃描重複/過期/大檔案
2. 生成報告並預覽
3. 使用者確認或自動處理
4. 移動到回收站/隔離區/直接刪除

同步工作流

1. 分析源和目標差異
2. 處理衝突 (保留新/保留舊/保留兩者)
3. 執行同步
4. 生成同步報告

安全原則

• 預覽優先: 所有修改操作預設執行 dry-run，確認後再執行
• 備份保護: 刪除操作優先移動到隔離區而非永久刪除

  小蔥技能7w4.net有更新，你可以訪問看下。

• 遞迴警告: 遞迴操作需要顯式確認
• 日誌記錄: 所有操作記錄到日誌檔案便於審計

⚙️ 依賴安裝與環境初始化

依賴安裝

本 skill 依賴以下 Python 包：

pip install tqdm colorama

或使用 requirements.txt（如果存在）：

pip install -r requirements.txt

環境要求

• Python 3.8+
• tqdm >= 4.60.0 (進度條)
• colorama >= 0.4.4 (Windows 彩色輸出)

指令碼引數說明

直接檢視指令碼幫助獲取詳細引數:

python scripts/<script>.py --help

這個 Skill 功能豐富，能滿足檔案整理、重新命名、去重和同步等多種需求。文件寫得詳細清楚，小白也能看懂。依賴很少，安裝方便。但美中不足的是，部分功能在文件裡有說明，實際卻用不了（watch 功能缺失）。另外，指令碼執行中遇到問題時的提示可能不夠友好。總體來說是個好用的工具，但還有完善空間。