quark-auto-save

name	quark-auto-save
version	1.1.0
last_updated	2026-04-13
description	夸克自动转存任务管理技能。用于管理夸克网盘自动转存任务，包括：获取任务列表、检查同步状态、更新 startfid（增量更新起始位置）、更新失效的分享链接（自动获取最新剧集 fid）、查看已转存文件列表、清理旧剧集（保留最新N个，按文件名排序）、删除已转存文件（需用户二次确认）。当用户提到夸克转存、quark-auto-save、自动转存、startfid 更新、增量更新、更新链接、删除转存文件、清理旧剧集时使用此技能。

夸克自动转存任务管理 (v1.1.0)

配置信息

• API 地址: http://192.168.31.252:15005
• Token: d9566abfb26765aa

当前任务列表

任务	保存路径	startfid状态	说明
仙逆	/qh_nas/Movie/仙逆/	✅ 已同步	从最新剧集开始
吞噬星空	/qh_nas/Movie/吞噬星空	✅ 已同步	从最新剧集开始
斗破苍穹	/qh_nas/Movie/斗破苍穹	✅ 已同步	从最新剧集开始
绝世唐门	/qh_nas/Movie/绝世唐门	✅ 已同步	从最新剧集开始
师兄啊师兄	/qh_nas/Movie/师兄啊师兄	✅ 已同步	从最新剧集开始
一人之下	/qh_nas/Movie/一人之下	✅ 已同步	从最新剧集开始
沧元图	/qh_nas/Movie/沧元图	✅ 已同步	从最新剧集开始

API 接口

接口	方法	说明
/data	GET	获取当前配置
/update	POST	更新配置
/get_share_detail	POST	获取分享详情（提取 first_fid）
/get_savepath_detail	GET	获取已转存文件列表（path=URL编码路径）
/delete_file	POST	删除已转存文件（fid）

常用操作

1. 获取任务列表

python3 scripts/quark_ops.py get_tasklist

2. 检查同步状态

python3 scripts/quark_ops.py check_sync

自动检查每个任务的 startfid 是否与分享链接最新剧集同步。

3. 更新任务的 startfid

python3 scripts/quark_ops.py update_startfid "任务名" "新fid"

4. 更新失效链接（自动获取最新 fid）

python3 scripts/quark_ops.py update_link "任务名" "新分享链接"

5. 查看已转存文件列表

python3 scripts/quark_ops.py list_saved "任务名"
# 或指定路径
python3 scripts/quark_ops.py list_saved "/qh_nas/Movie/仙逆/"

6. 清理旧剧集（保留最新N个，按文件名排序）⚡

python3 scripts/quark_ops.py cleanup [数量]
# 默认保留30个，按文件名集数排序（最新 = 集数最大）

7. 删除已转存文件 ⚠️（需二次确认）

python3 scripts/quark_ops.py delete_file "fid值"

重要：删除操作需要用户二次确认！

startfid 原理

• startfid = 某个文件的 fid → 只转存修改时间晚于该文件的新剧集
• startfid = null → 转存全部文件
• 已同步状态：startfid 等于分享链接中最新剧集的 fid

文件名排序规则

清理旧剧集时，按文件名中的集数排序：

• 格式：第xx话、S01Exx、Exx 等
• 最新剧集 = 集数最大（如 S01E65 > S01E64）
• 保留集数最大的 N 个，删除较旧的

任务结构

{
  "taskname": "任务名称",
  "shareurl": "https://pan.quark.cn/s/xxx",
  "savepath": "/保存路径/",
  "startfid": "最新剧集fid",
  "runweek": [1, 2, 3, 4, 5, 6, 7]
}

同步检查逻辑

执行 check_sync 时：

1. 获取分享链接的最新剧集 fid
2. 对比本地已转存文件，取最新剧集 fid
3. 如果两者不一致，更新 startfid

注意：startfid 指向的是"起始点"，转存时会从 startfid 对应文件的下一个文件开始转存。