feat: init media-center skill
资源中心——从多渠道获取资源链接,转存到夸克网盘并整理归档。 - sources/tencent-doc: 腾讯文档读取 - sources/search: 网盘搜索 - storage/quark: 夸克网盘操作 - ref/: 来源 skill 参考归档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
# 文件组织规范
|
||||
|
||||
## 目录结构推荐
|
||||
|
||||
```
|
||||
资源大类/
|
||||
├── 子类1/
|
||||
│ ├── 分段区间1/
|
||||
│ │ ├── 文件
|
||||
│ │ └── ...
|
||||
│ └── 分段区间2/
|
||||
└── 子类2/
|
||||
└── ...
|
||||
```
|
||||
|
||||
## 命名规范
|
||||
|
||||
| 资源类型 | 推荐目录结构 | 示例 |
|
||||
|---------|-------------|------|
|
||||
| 动漫/国漫 | `/动漫/国漫<年份>/<作品名(年份)>/集数分段/` | `/动漫/国漫2024/遮.天(2023)/101-120/` |
|
||||
| 电视剧 | `/电视剧/<年份>-<季度>/<剧名>/` | `/电视剧/2026-1/爱情没有神话/` |
|
||||
| 电影 | `/电影/<年份>/<片名(年份)>/` | `/电影/2026/星河入梦(2026)/` |
|
||||
| 综艺 | `/综艺/<综艺名>/` | `/综艺/乘风2026/` |
|
||||
| 短剧 | `/短剧/<分类>/` | `/短剧/经典/` |
|
||||
|
||||
## 分段策略
|
||||
|
||||
| 总集数 | 推荐分段 |
|
||||
|-------|---------|
|
||||
| ≤30 | 不分段,直接放一起 |
|
||||
| 30-60 | 按 30 集一段:1-30, 31-60 |
|
||||
| 60-100 | 按 20-30 集一段 |
|
||||
| 100+ | 按 20 集一段:1-20, 21-40, ...
|
||||
|
||||
## 文件名清洗建议
|
||||
|
||||
从分享链接转存后可能遇到的命名问题:
|
||||
|
||||
| 问题 | 示例 | 建议 |
|
||||
|------|------|------|
|
||||
| 大小写不统一 | `4K` vs `4k` | 统一为 `4K` |
|
||||
| 分隔符乱用 | `空格` vs `.` vs `-` | 统一用空格 |
|
||||
| 无意义前缀 | `Z 4K 130.mp4` | 去除 `Z` 前缀 |
|
||||
| 格式混用 | `.mp4` vs `.mkv` | 保持原格式不动 |
|
||||
|
||||
> **注意**:当前夸克 API 不支持重命名文件,清洗工作需在下载后本地处理或用文件名更丰富的工具。
|
||||
@@ -0,0 +1,111 @@
|
||||
# Quark API 补全方案
|
||||
|
||||
`netdisk-mcp-server` 缺失的创建/移动/删除功能,通过直接调用夸克内部 API 实现。
|
||||
|
||||
> **警告**:这些 API 是夸克网页版的内部接口,非官方公开 API,可能随时变更。
|
||||
|
||||
## 通用参数
|
||||
|
||||
```bash
|
||||
COOKIE="你的夸克网盘Cookie"
|
||||
|
||||
BASE_CURL="curl -s --max-time 15 \
|
||||
-H \"cookie: $COOKIE\" \
|
||||
-H \"accept: application/json\" \
|
||||
-H \"content-type: application/json\" \
|
||||
-H \"origin: https://pan.quark.cn\" \
|
||||
-H \"referer: https://pan.quark.cn/\""
|
||||
```
|
||||
|
||||
## API 列表
|
||||
|
||||
### 1. 创建文件夹
|
||||
|
||||
```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`)
|
||||
- `file_name`:文件夹名称
|
||||
- `file_type`:固定为 `0`(目录)
|
||||
- `dir_init`:固定为 `true`
|
||||
|
||||
**返回**:`data.fid` 是新文件夹的 FID
|
||||
|
||||
### 2. 获取文件夹 FID
|
||||
|
||||
方式一:从 `netdisk.list` 的输出中提取
|
||||
```
|
||||
3. [dir] 遮.天(2023) (ID: 1ffc622be174429fa36de460856cad05)
|
||||
↑ 这就是 FID
|
||||
```
|
||||
|
||||
方式二:逐层 API 查询
|
||||
```bash
|
||||
# 查根目录
|
||||
curl -s "https://drive-h.quark.cn/1/clouddrive/file/sort?pr=ucpro&fr=pc&pdir_fid=0" \
|
||||
-H "cookie: $COOKIE" | python -X utf8 -c "
|
||||
import json,sys
|
||||
data = json.load(sys.stdin)
|
||||
for item in data.get('data',{}).get('list',[]):
|
||||
if item.get('file_type')==0:
|
||||
print(f'{item[\"file_name\"]} -> {item[\"fid\"]}')
|
||||
"
|
||||
```
|
||||
|
||||
### 3. 移动文件
|
||||
|
||||
```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>"}'
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `action_type`:固定为 `1`(移动)
|
||||
- `filelist`:要移动的文件/文件夹 FID 数组(建议 ≤30 个)
|
||||
- `to_pdir_fid`:目标文件夹 FID
|
||||
|
||||
**返回**:`data.finish: true` 表示完成
|
||||
|
||||
### 4. 删除文件
|
||||
|
||||
```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>"]}'
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `action_type`:固定为 `2`(删除)
|
||||
- `filelist`:要删除的文件 FID 数组
|
||||
|
||||
**返回**:`data.task_id` 异步任务 ID,`data.finish: true` 表示已完成
|
||||
|
||||
## API 端点速查
|
||||
|
||||
| 操作 | 方法 | 端点 |
|
||||
|------|------|------|
|
||||
| 列出目录 | GET | `/1/clouddrive/file/sort` |
|
||||
| 创建文件夹 | POST | `/1/clouddrive/file` |
|
||||
| 移动 | POST | `/1/clouddrive/file/move` |
|
||||
| 删除 | POST | `/1/clouddrive/file/delete` |
|
||||
|
||||
## 注意事项
|
||||
|
||||
- **FID 每次都会变**:不能硬编码 FID,每次操作前重新获取
|
||||
- **异步操作**:`finish: false` 表示任务还在进行,需要等待
|
||||
- **频率限制**:连续请求间隔至少 500ms(返回中有 `tq_gap` 提示)
|
||||
- **Cookie 有效期**:夸克 Cookie 有效期不定,失效时返回 `401/403`
|
||||
Reference in New Issue
Block a user