name: file-sorter description: 通用檔案智慧分類工具，支援多種分類規則：型別、大小、日期、關鍵詞等。適用於需要批次整理檔案的場景，如下載資料夾整理、照片歸檔、文件分類等。

File Sorter - 檔案智慧分類工具

功能特性

想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

• ✅ 多種分類規則：檔案型別、檔案大小、檔案日期、關鍵詞
• ✅ 靈活操作：移動、複製、建立符號連結
• ✅ 預覽功能：先預覽效果，確認後再執行
• ✅ 撤銷操作：支援撤銷最近一次整理
• ✅ 自定義規則：支援自定義分類規則和資料夾結構
• ✅ 規則預設：儲存和載入分類規則預設

快速開始

1. 按檔案型別分類

file-sorter organize ~/Downloads --by-type --output ~/Sorted

2. 按檔案大小分類

file-sorter organize ~/Downloads --by-size --output ~/Sorted

3. 按檔案日期分類（修改日期）

file-sorter organize ~/Downloads --by-date modified --output ~/Sorted

4. 預覽模式（不實際執行）

file-sorter organize ~/Downloads --by-type --preview

5. 撤銷操作

file-sorter undo ~/Sorted

詳細使用說明

分類規則說明

按檔案型別分類

• 預設類別：
• documents：文件類（.pdf, .doc, .docx, .txt, .xls, .xlsx, .ppt, .pptx）
• images：圖片類（.jpg, .jpeg, .png, .gif, .webp, .heic）
• videos：影片類（.mp4, .avi, .mov, .mkv）
• audio：音訊類（.mp3, .wav, .flac, .aac）
• installers：安裝包類（.exe, .msi, .dmg, .pkg, .deb, .rpm）
• archives：壓縮包類（.zip, .rar, .7z, .tar, .gz）
• code：程式碼類（.py, .js, .html, .css, .java, .cpp）
• 自定義類別：使用 --categories 引數或配置檔案

按檔案大小分類

• 預設規則：
• small：小於 1MB
• medium：1MB - 100MB
• large：大於 100MB
• 自定義規則：使用 --size-rules 引數或配置檔案

按檔案日期分類

• 選項：
• created：按建立日期
• modified：按修改日期
• accessed：按訪問日期
• 資料夾結構：按年/月/日組織（如 2026/03/07）

操作型別

• move：移動檔案（預設）
• copy：複製檔案
• link：建立符號連結

配置檔案

可以在專案根目錄建立 .file-sorter.json 配置預設選項：

{
  "output_dir": "~/Sorted",
  "action": "move",
  "categories": {
    "documents": [".pdf", ".doc"],
    "images": [".jpg", ".png"]
  },
  "size_rules": {
    "small": [0, 1048576],
    "medium": [1048576, 104857600],
    "large": [104857600, null]
  },
  "backup_original": true
}

安全措施

1. 預覽模式：預設先顯示預覽，需要確認後才執行
2. 自動備份：執行整理前自動儲存操作日誌
3. 撤銷功能：隨時可以撤銷最近一次操作
4. dry-run 選項：使用 --preview 檢視效果

示例場景

場景 1：整理下載資料夾

# 按型別整理下載檔案
file-sorter organize ~/Downloads --by-type --output ~/Downloads/Organized

場景 2：整理照片

# 按拍攝日期整理照片
file-sorter organize ~/Photos --by-date created --output ~/Photos/ByDate

場景 3：按大小分類大檔案

# 找出所有大於 100MB 的檔案
file-sorter organize ~/Videos --by-size --output ~/Videos/BySize

故障排除

• 撤銷失敗：確保在同一目錄下執行，且備份檔案未被刪除
• 規則衝突：多個規則匹配時，按規則優先順序處理（型別 > 大小 > 日期）
• 許可權問題：確保有檔案讀寫許可權

更新日誌

v1.0.0 (2026-03-07)

• 初始正式版本釋出
• 支援按型別、大小、日期分類
• 支援預覽和撤銷功能

這個檔案整理工具功能實用，支援按型別、大小、日期等多種方式分類檔案，還能預覽效果和撤銷操作，文件說明也很詳細。不過實際使用時會發現它無法正常執行——文件裡寫了命令用法，但缺少安裝程式讓系統認識這個命令。另外一些小細節也欠考慮，比如同名檔案會被直接覆蓋。建議開發者補充安裝配置後再發布。