diff --git a/storage/quark/v1/usage.md b/storage/quark/v1/usage.md index 171d34a..19ca6db 100644 --- a/storage/quark/v1/usage.md +++ b/storage/quark/v1/usage.md @@ -184,6 +184,76 @@ curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/delete?pr=ucpro&fr=p --- +## 刮削器命名规范 + +如果文件最终要交给 Jellyfin / Emby / Plex / Kodi 等刮削器识别,文件名必须符合特定格式,否则无法自动匹配元数据。 + +### 电视剧 / 动漫 + +| 刮削器 | 推荐格式 | 示例 | +|--------|---------|------| +| Jellyfin / Emby / Plex | `剧名 S01E01.ext` | `遮天 S01E151.mp4` | +| Kodi | `剧名 S01E01.ext` 或 `剧名 - 001.ext` | `遮天 - 151.mp4` | +| 通用(按集数) | `剧名 - 集数.ext` | `遮天 - 151.mp4` | + +### 电影 + +| 格式 | 示例 | +|------|------| +| `片名 (年份).ext` | `流浪地球 (2019).mp4` | +| `片名 (年份) 画质.ext` | `流浪地球 (2019) 4K.mp4` | + +### 当前文件的问题 + +从分享链接转存后的文件命名通常刮削器无法识别: + +``` +❌ 151.mp4 → 无剧名,无法识别 +❌ Z 4K 130.mp4 → 前缀混乱 +❌ 148.4k.mp4 → 格式混乱,无剧名 +❌ 遮天 4K 162.mkv → 格式不规范,刮削器可能不认 +``` + +### 建议命名策略 + +> 当前夸克 API **不支持重命名**,以下为下载到本地后的处理参考。 + +下载后用批量重命名工具(如 `PowerRename`、`ReNamer`、Python 脚本)统一: + +```bash +# Python 批量重命名示例(本地执行) +python -X utf8 -c " +import os, re +path = '/下载的/遮天目录' +for f in os.listdir(path): + # 提取数字:151.mp4, 148.4k.mp4 → 151, 148 + match = re.search(r'(\d+)', f) + if match: + ep = match.group(1) + ext = os.path.splitext(f)[1] + new_name = f'遮天 S01E{ep.zfill(3)}{ext}' + os.rename(os.path.join(path, f), os.path.join(path, new_name)) + print(f'{f} → {new_name}') +" +``` + +### 刮削器目录结构要求 + +``` +动漫/ +├── 遮天 (2023)/ +│ ├── Season 01/ +│ │ ├── 遮天 S01E101.mp4 +│ │ ├── 遮天 S01E102.mp4 +│ └── Season 02/ +│ ├── 遮天 S02E151.mp4 +│ └── ... +``` + +> 注:整理在夸克网盘内是为了存储和下载方便。刮削器识别需要下载到本地或挂载到 NAS 后按上述规范重新命名。 + +--- + ## 调用语法注意事项 **必须使用函数式语法**,`key=value` 形式会报路径错误: