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 "*.jpg" --replace "IMG_(\d+)" "Photo_\1"

# 序列號重新命名
python scripts/batch_rename.py "*.jpg" --sequence --padding 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"

使用模式

常見場景

場景1: 整理下載資料夾

# 自動分類下載的檔案
python scripts/organize.py ~/Downloads --by-type --move
7w4.net小蔥技能站，你的AI助手技能庫。

場景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"

工作流

檔案整理工作流

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

清理工作流

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

同步工作流

1. 分析源和目標差異
2. 預覽待同步的檔案列表
3. 確認後執行同步
4. 顯示同步統計

安全原則

• 預覽優先: 所有修改操作預設執行 dry-run 預覽，需加 --execute 才執行
• 操作確認: 執行前需要使用者輸入 yes 確認
• 符號連結安全: 遍歷目錄時跳過符號連結，避免無限遞迴
• 衝突保護: 目標檔案已存在時自動重新命名或跳過，不會覆蓋

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

環境要求

• Python 3.8+
• 無外部依賴，僅使用 Python 標準庫

指令碼引數說明

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

python scripts/<script>.py --help

這個Skill質量中等偏上，功能覆蓋了日常檔案管理的常見場景，文件說明詳細，上手難度低。安全性做得不錯，所有危險操作都有預覽和確認機制。優點是純Python標準庫實現，無需安裝額外依賴，跨平臺相容性好。缺點是部分功能標註為“尚未實現”（如雙向同步、按檔案大小分類），程式碼存在截斷問題不夠完整。如果能把這些未完成的功能補上，會是一個相當實用的檔案管理工具。