---
name: "f-download-sorter"
description: "整理 /mnt/f 下下载的视频文件：扫描→清垃圾→按规则归档到7个大类目录"
---

# /mnt/f 下载文件批量归档整理

## 用途
把 source_dirs 里堆叠的下载视频，按规则自动清理、归类到大类目录。

## Touch point
用户说"整理 /mnt/f 视频""归档 collections""下载文件太多理一下"等，调用此 skill。

## 流程
1. 运行 `scripts/scan_and_clean.py` → 扫描 + 清垃圾
2. 运行 `scripts/classify_and_move.py` → 按规则归档
3. 报告结果

## 配置
核心配置在 `config.json`，可自定义：

| 字段 | 说明 |
|------|------|
| `source_dirs` | 源目录列表，默认 `["/mnt/f/collections", "/mnt/f/video"]` |
| `keep_as_is` | 已有元数据不动的内容 |
| `min_size_mb` | 小于此值且无实质视频的目录自动删除 |
| `categories` | 分类规则数组，每个有 `dir`（目标路径）和 `keywords`（关键词列表） |
| `fallback_dir` | 无关键词匹配时的兜底目录 |

### 添加新分类
在 `categories` 数组中新增一项：
```json
{
  "dir": "/mnt/f/新分类",
  "keywords": ["关键词A", "关键词B"]
}
```

### 添加新源目录
在 `source_dirs` 中追加路径。

### 保护不移动的内容
在 `keep_as_is` 列表追加名称。

## 注意事项
- 同一分区 mv，不复制数据
- 不预览文件内容，只基于文件名关键词
- WSL `/mnt/` 跨文件系统扫描慢，大数量时建议用 Windows 原生 Python 执行