feat: add scrapper naming convention section to quark usage

- 电视剧/动漫、电影的刮削器命名格式
- 当前文件问题分析(无剧名、前缀混乱、格式不规范)
- 批量重命名 Python 脚本示例
- 目录结构要求(Season 01/02 等)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-05-16 18:56:01 +08:00
parent 5bc15d1855
commit a2c3463d15
+70
View File
@@ -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` 形式会报路径错误: