# 夸克网盘 — 使用

## 目录浏览

```bash
# 根目录
mcporter call 'netdisk.list(cloud: "quark", path: "/")'

# 子目录
mcporter call 'netdisk.list(cloud: "quark", path: "/动漫")'
mcporter call 'netdisk.list(cloud: "quark", path: "/动漫/国漫2024")'
```

列表输出中包含每项的 `(ID: xxx)`，即 FID（文件夹/文件唯一标识），后续操作需要用到。

## 查看分享链接

```bash
# 查看完整内容
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/xxx")'

# 按格式过滤
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/xxx", file_pattern: "*.mp4")'
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/xxx", file_pattern: "*.mkv")'
```

## 转存文件

### 第一步：确认目标目录存在

转存前必须**先搜索夸克网盘中所有相关目录**，确认资源是否已存在：

```bash
# 遍历所有可能的目录，不能只看一个
mcporter call 'netdisk.list(cloud: "quark", path: "/动漫/国漫2024")'
mcporter call 'netdisk.list(cloud: "quark", path: "/动漫/国漫2025")'
mcporter call 'netdisk.list(cloud: "quark", path: "/动漫/国漫2026")'
```

> 例如：斗破苍穹可能在 `/动漫/国漫2024/斗破苍穹`，只在 `/动漫/国漫2026` 找就会漏掉。

确认目录已存在后再进入第二步。

如果目录不存在，先创建（见下方"创建文件夹"）。

### 第二步：转存

```bash
# 转存分享中所有文件
mcporter call 'netdisk.transfer(share_link: "https://pan.quark.cn/s/xxx", source_pattern: "/*", target_path: "/目标目录")'

# 按文件名匹配转存
mcporter call 'netdisk.transfer(share_link: "https://pan.quark.cn/s/xxx", source_pattern: "/文件夹名/*.mp4", target_path: "/目标目录")'
```

### 第三步：验证

```bash
mcporter call 'netdisk.list(cloud: "quark", path: "/目标目录")'
```

---

## Quark API 补全操作

以下操作 MCP 工具不支持，通过直接调用 Quark API 实现。

### 通用准备

```bash
# 从文件读取避免泄露（推荐）
COOKIE=$(cat tmp/cookie_quark.txt)

# 或直接写入（注意命令行历史）
# COOKIE="你的夸克Cookie"
```

### 获取 FID

方式一：从 `netdisk.list` 输出中提取
```
3. [dir] 遮.天（2023） (ID: 1ffc622be174429fa36de460856cad05)
```

方式二：API 递归查询

```bash
# 列出指定目录下的内容（含 FID）
curl -s "https://drive-h.quark.cn/1/clouddrive/file/sort?pr=ucpro&fr=pc&pdir_fid=<父FID>&_page=1&_size=200" \
  -H "cookie: $COOKIE" | python -X utf8 -c "
import json,sys
data=json.load(sys.stdin)
for item in data.get('data',{}).get('list',[]):
    t='📁' if item.get('file_type')==0 else '📄'
    print(f'{t} {item[\"file_name\"]} -> FID: {item[\"fid\"]}')
"
```

### 创建文件夹

```bash
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file?pr=ucpro&fr=pc&__t=$(date +%s)000" \
  -H "cookie: $COOKIE" \
  -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" \
  -H "referer: https://pan.quark.cn/" \
  -d '{"pdir_fid":"<父FID>","file_name":"<文件夹名>","file_type":0,"dir_init":true}'
```

- `pdir_fid`：父目录 FID（根目录为 `0`）
- 返回 `data.fid` 即新文件夹的 FID

### 移动文件

```bash
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/move?pr=ucpro&fr=pc&__t=$(date +%s)000" \
  -H "cookie: $COOKIE" \
  -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" \
  -H "referer: https://pan.quark.cn/" \
  -d '{"action_type":1,"filelist":["<FID1>","<FID2>"],"to_pdir_fid":"<目标FID>"}'
```

- `filelist` 建议 ≤30 个 FID 一批
- 返回 `data.finish: true` 表示完成

### 重命名文件

```bash
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/rename?pr=ucpro&fr=pc&__t=$(date +%s)000" \
  -H "cookie: $COOKIE" \
  -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" \
  -H "referer: https://pan.quark.cn/" \
  -d '{"fid":"<文件FID>","file_name":"<新文件名>"}'
```

- `fid`：要重命名的文件 FID
- `file_name`：新文件名（含扩展名）

### 删除文件

```bash
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/delete?pr=ucpro&fr=pc&__t=$(date +%s)000" \
  -H "cookie: $COOKIE" \
  -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" \
  -H "referer: https://pan.quark.cn/" \
  -d '{"action_type":2,"filelist":["<FID1>","<FID2>"]}'
```

---

## 文件整理流程

### 场景：按集数分段归类

```bash
# 1. 列出目标目录，获取所有文件 FID
mcporter call 'netdisk.list(cloud: "quark", path: "/要整理的目录")'

# 2. 创建分段子目录
for name in "101-120" "121-140" "141-150"; do
  curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file?pr=ucpro&fr=pc" \
    -H "cookie: $COOKIE" -H "content-type: application/json" \
    -H "origin: https://pan.quark.cn" -H "referer: https://pan.quark.cn/" \
    -d "{\"pdir_fid\":\"<父FID>\",\"file_name\":\"$name\",\"file_type\":0,\"dir_init\":true}"
done

# 3. 移动文件到对应子目录
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/move?pr=ucpro&fr=pc" \
  -H "cookie: $COOKIE" -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" -H "referer: https://pan.quark.cn/" \
  -d '{"action_type":1,"filelist":["<FID1>","<FID2>",...],"to_pdir_fid":"<目标子目录FID>"}'

# 4. 验证
mcporter call 'netdisk.list(cloud: "quark", path: "/要整理的目录")'
mcporter call 'netdisk.list(cloud: "quark", path: "/要整理的目录/101-120")'
```

### 场景：转存后清理杂文件

转存的 `source_pattern` 匹配是**跨文件夹全局匹配**的，会混入不相关的文件。

```bash
# 1. 转存
mcporter call 'netdisk.transfer(...)'

# 2. 列出目标目录，找到杂文件
mcporter call 'netdisk.list(cloud: "quark", path: "/目标目录")'

# 3. 获取杂文件的 FID，删除
curl -s -X POST "https://drive-h.quark.cn/1/clouddrive/file/delete?pr=ucpro&fr=pc" \
  -H "cookie: $COOKIE" -H "content-type: application/json" \
  -H "origin: https://pan.quark.cn" -H "referer: https://pan.quark.cn/" \
  -d '{"action_type":2,"filelist":["<杂文件FID1>","<杂文件FID2>"]}'
```

---

## 刮削器命名规范

如果文件最终要交给 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` 形式会报路径错误：

```bash
# ✅ 正确
mcporter call 'netdisk.list(cloud: "quark", path: "/")'

# ❌ 错误
mcporter call netdisk.list cloud=quark path=/
```