结构调整

2026-07-14 16:36:24 +08:00
parent 585e9d8e15
commit 57f354cf9f
254 changed files with 84114 additions and 44 deletions
@@ -0,0 +1,48 @@
+---
+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 执行