Home - x1ao4/quark-auto-save-x GitHub Wiki

本项目是在 Cp0204/quark-auto-save:0.5.3.1 的基础上修改而来的(感谢 Cp0204),我对整个 WebUI 进行了重塑,增加了更多实用功能,新增功能的代码都是通过 AI 完成的,不保证功能的稳定性。本项目修改后的版本为个人需求定制版,目的是满足我自己的使用需求,某些(我不用的)功能可能会因为修改而出现 BUG,不一定会被修复,请悉知。

你可以凭借赞赏(金额不限)截图加入夸克自动转存(QASX)的微信交流群(我的微信 x1ao-4,备注 QASX),讨论与 QASX 相关的话题,领取与夸克网盘相关的福利。但请注意,这不代表你会获得一对一的咨询服务,我只是提供一个交流场地,当然如果时间和精力允许,我也会在群内解答一些能力范围内的问题。

主要的新增功能如下(原版的正则命名功能依然有效,本项目可自由切换正则/顺序/剧集三种重命名模式):

2.3 过滤规则

通过在 过滤规则 一栏输入过滤词汇,可以过滤掉文件名(文件夹名、扩展名)中包含过滤词汇的项目,也就是不转存名称包含过滤词的项目。多个过滤词用逗号( ,)隔开,如 纯享,txt,超前企划,在同时需要过滤文件和使用正则重命名时比较方便,用来过滤综艺节目的非正片也比较简单。

image image

2.4 顺序命名

当在 保存规则匹配表达式 输入框内输入包含 {} 的表达式时(如 乘风2025 - S06E{}黑镜.S07E{}雁回时 - S01E{} - 第{}集 等等),将会自动切换为 顺序命名 模式,该模式将通过文件名与上传时间等信息对文件进行智能排序,然后按顺序对每个文件的 {} 赋予序号,实现顺序命名。

新增文件的序号会在目标目录中已保存文件的最大序号的基础上递增,文件夹为空文件夹(新增文件夹)时会从 1 开始排序,已经保存过的文件不会重复保存。该模式会自动过滤/排除分享链接中的文件夹(不转存文件夹和文件夹中的内容)。

通过与 过滤规则 搭配使用,该模式可以解决部分综艺节目的命名问题,先通过 过滤规则 排除非正片,然后对正片进行排序,该模式可以自动识别 第1期第2期第3期 以及 第1期上第1期中第1期下 和日期等文件名的顺序,可将大部分文件按照播出顺序排序,而不是单纯通过文本和上传时间来判断顺序。例如:

image image

2.5 剧集命名

当在 保存规则匹配表达式 输入框内输入包含 [] 的表达式时(如 黑镜 - S06E[]黑镜.S07E[]雁回时 - S01E[] - 第[]集 等等),将会自动切换为 剧集命名 模式,该模式将从原始文件名中提取剧集编号(若存在可提取的编号),然后把提取的编号代入对应文件名的 [] 中,实现自动按剧集编号命名。

已经保存过的文件不会重复保存。该模式会自动过滤/排除分享链接中的文件夹(不转存文件夹和文件夹中的内容)。

该模式主要用于自动提取电视剧集的集编号,有点类似于 $TV 这个模式,不需要根据不同的资源名单独编辑表达式,并且只要通过一个剧集命名表达式就可以设置重命名的格式(不需要替换表达式就可以自定义格式)。应该可以识别大部分资源名。例如:

image image

你可以在 系统配置剧集识别 部分查看和编辑用于识别剧集编号的正则表达式:集编号识别规则,若你要转存的资源名不受支持,也可以自行增加表达式。多个表达式用 | 隔开。表达式的顺序代表了识别的优先级,越靠前越优先。每个表达式都需要包含一个 (\d+) 捕获组,它代表数字编号,表达式只需要包含 (\d+) 和数字编号前后的字符即可,注意特殊符号需要转义。若修改后出现问题可以改回默认值。

默认的集编号识别规则为:第(\d+)集|第(\d+)期|第(\d+)话|(\d+)集|(\d+)期|(\d+)话|[Ee][Pp]?(\d+)|(\d+)[-_\\s]*4[Kk]|\[(\d+)\]|【(\d+)】|_?(\d+)_?,含义如下:

正则表达式 示例 含义(数字就是要提取的剧集编号)
第(\d+)集 第05集 匹配 “第 + 数字 + 集” 格式
第(\d+)期 第05期 匹配 “第 + 数字 + 期” 格式
第(\d+)话 第05话 匹配 “第 + 数字 + 话” 格式
(\d+)集 05集 匹配数字后接 “集” 字
(\d+)期 05期 匹配数字后接 “期” 字
(\d+)话 05话 匹配数字后接 “话” 字
[Ee][Pp]?(\d+) E05EP05Ep05e05ep05 匹配 E 或 EP(可大小写)加数字
(\d+)[-_\\s]*4[Kk] 05-4K05_4K05 4K05-4k05_4k05 4k 匹配数字后跟连接符和 4K/4k
\[(\d+)\] [05] 匹配英文方括号中的数字
【(\d+)】 【05】 匹配中文全角括号中的数字
_?(\d+)_? _05__0505_05 匹配数字,前后可有下划线

2.6 智能填充

添加任务

在添加新任务时,新任务会自动继承最后一个任务的 保存路径命名规则(包括命名模式和表达式),方便进行修改。

编辑任务

在编辑 任务名称 时,若任务名称中包含季的信息(如 S01、Season 1、第1季、第一季等等),或者保存路径中包含与电视节目相关的目录(如电视、节目、剧、动漫、综艺、TV、Show 等等)时,会自动将此任务判定为电视节目,然后从任务名称中提取剧名和季序号,按照任务名称的原始格式(如果任务名称中不含季序号将使用默认模式)自动构建 保存路径命名规则 中相关的部分。

推荐的 任务名称 格式为:剧名 - S季序号,如:东邻西舍 - S07、折腰 - S01,也支持不同的连字符,如:东邻西舍 S07、折腰.S01。自动填充的结果如下:

东邻西舍 - S07
目录前缀/东邻西舍 (2018)/东邻西舍 - S07
东邻西舍 - S07E[]

东邻西舍 S07
目录前缀/东邻西舍 (2018)/东邻西舍 S07
东邻西舍 S07E[]

东邻西舍.S07
目录前缀/东邻西舍 (2018)/东邻西舍.S07
东邻西舍.S07E[]

保存路径的最末两级将会根据从任务名称中提取的信息进行重构,如果当前的命名模式为 剧集命名顺序命名,那么对应的表达式也会被重构,如果为 正则命名 模式,则只有保存路径会被重构。

如果任务名称中不包含季数信息,并且保存路径中也没有指向电视节目的相关词汇,则会将此任务判定为一般内容,会自动使用完整的任务名称替换 保存路径 的最末级。

智能填充只是一个自动替换(建议值),你始终都可以通过手动修改来更改最终的配置并进行保存。

Docker 部署

Docker Run

docker run -d \
  --name quark-auto-save-x \
  -p 5005:5005 \
  -v /自定义配置文件的存储目录/quark-auto-save-x/config:/app/config \
  -v /自定义生成文件的存储目录:/media \  # 可选,插件 alist_strm_gen 生成 strm 使用
  --restart unless-stopped \
  x1ao4/quark-auto-save-x:latest

Docker Compose(推荐)

version: "3.3"
services:
  quark-auto-save-x:
    image: x1ao4/quark-auto-save-x:latest
    container_name: quark-auto-save-x
    ports:
      - 5005:5005
    volumes:
      - /自定义配置文件的存储目录/quark-auto-save-x/config:/app/config
      - /自定义生成文件的存储目录:/media  # 可选,插件 alist_strm_gen 生成 strm 使用
    restart: unless-stopped

默认管理地址:http://yourhost:5005

默认管理用户名/密码:admin

环境变量 说明
WEBUI_USERNAME 用户名
WEBUI_PASSWORD 密码
PLUGIN_FLAGS 插件标志,如使用 -emby,-aria2 来禁用某些插件
PORT 端口,Host 模式可使用此变量更换端口
⚠️ **GitHub.com Fallback** ⚠️