Merge pull request #76 from x1ao4/dev

重写 README 文档

README.md

@@ -1,84 +1,155 @@
 # 夸克自动转存
-本项目是在 [Cp0204/quark-auto-save:0.5.3.1](https://github.com/Cp0204/quark-auto-save) 的基础上修改而来的（感谢 [Cp0204](https://github.com/Cp0204)），我对整个 WebUI 进行了重塑，增加了更多实用功能，新增功能的代码都是通过 AI 完成的，不保证功能的稳定性。主要的新增功能如下（[详见](https://github.com/x1ao4/quark-auto-save-x/wiki)）：
 
-- **过滤项目**：通过在 `过滤规则` 里设置过滤词来过滤不需要转存的文件或文件夹。支持高级过滤功能，使用保留词和过滤词可实现复杂的过滤逻辑。
-- **顺序命名**：通过使用包含 `{}` 的表达式（如 `乘风2025 - S06E{}`）自动切换为 `顺序命名` 模式，该模式将通过文件名与上传时间等信息对文件进行智能排序，然后按顺序对每个文件的 `{}` 赋予序号，实现顺序命名。
-- **剧集命名**：通过使用包含 `[]` 的表达式（如 `黑镜 - S06E[]`）自动切换为 `剧集命名` 模式，该模式将从原始文件名中提取剧集编号，然后把提取的编号代入对应文件名的 `[]` 中，实现自动按剧集编号命名。
-- **自动切换命名模式**：默认的命名模式依然为 `正则命名` 模式，现在会通过用户输入的 `匹配表达式` 自动实时判断和切换对应的模式。
-- **自定义集编号识别规则**：支持在系统配置页面编辑用于提取剧集编号的 `集编号识别规则` 表达式，扩展识别范围。
-- **数据库**：引入 SQLite 数据库，记录和管理所有转存历史，便于查询和追踪。
-- **转存记录**：支持通过 WebUI 的转存记录页面查看、查询历史转存记录的相关信息，支持删除转存记录。
-- **WebUI**：对整个 WebUI 进行了重塑，增加了更多实用功能，如文件选择和预览界面的排序功能、资源搜索的过滤功能、TMDB 和豆瓣搜索功能、页面视图切换功能、账号设置功能等等。
-- **查重逻辑**：支持优先通过历史转存记录查重，对于有转存记录的文件，即使删除网盘文件，也不会重复转存。
-- **Aria2**：支持成功添加 Aria2 下载任务后自动删除夸克网盘内对应的文件，清理网盘空间。
-- **文件整理**：支持浏览和管理多个夸克账号的网盘文件，支持单项/批量重命名（支持应用完整的命名、过滤规则和撤销重命名等操作）、移动文件、删除文件、新建文件夹等操作。
-- **更新状态**：支持在任务列表页面显示任务的最近更新日期、最近转存文件，支持在任务列表、转存记录、文件整理页面显示当日更新标识（对于当日更新的内容）。
-- **影视发现**：支持在影视发现页面浏览豆瓣热门影视榜单，一键快速创建任务，智能填充任务配置，实现便捷订阅。
-- **类型筛选**：支持在任务列表页面按照任务类型（如剧集、动画、综艺等）筛选任务，在对应的筛选视图下创建任务将会自动继承同类任务的基础配置，便于自动填充任务配置。
-- **任务排序**：支持在任务列表页面按照任务编号、任务名称、任务进度和更新时间进行排序，支持升序和降序排列。
-- **任务视图**：支持在任务列表页面使用列表视图和海报视图两种视图浏览和管理任务，海报视图将通过 TMDB 与任务对应的电视节目进行匹配，并显示对应的节目海报。
-- **任务匹配**：在配置了 TMDB API 密钥后，所有任务将自动通过 TMDB 进行元数据匹配，匹配后将获取电视节目的海报和元数据，丰富任务相关信息的展示，包括集数信息统计、当前任务进度和电视节目状态等。
-- **追剧日历**：支持在追剧日历页面查看和浏览任务对应电视节目的信息和播出时间表，追踪电视节目的播出情况，了解任务的完成进度。追剧日历支持海报视图和日历视图两种视图，可方便快捷的了解订阅内容的实时状态。
-- **字幕命名规则**：支持在全局设置字幕文件的语言代码后缀，在重命名字幕文件时自动添加语言代码后缀，如 `.zh.srt`、`.zh.ass` 等。
-- **状态筛选**：支持在任务列表、转存记录、追剧日历页面按照任务状态（进度状态或对应节目状态）筛选任务（记录或节目），便于筛除次要信息。
-- **执行周期**：支持按自选周期执行（自选）和按任务进度执行（自动）两种执行周期判断模式，按任务进度执行将自动跳过进度达到 100% 的任务，也就是说如果已播出的最新集已完成转存，后续的定时任务将自动跳过该任务，如果已播出的集还有没转存的，那么这个任务会在每次的定时时间都被执行，直到进度到达 100%。如此可有效减少播出前和转存后的无意义执行。
-- **运行日志**：支持在 WebUI 上直接查看容器的运行日志，允许进行筛选和搜索。
-- **播出时间**：支持通过 Trakt API 自动获取匹配节目的准确播出时间，并转换为本地时间，也支持自定义播出时间和播出日期偏移，用于准确体现节目的播出进度和任务的完成进度，也可以用于设置任务的延迟运行。并支持在海报卡片和追剧日历上查看单集的准确播出状态（时间）和下一集的准确播出日期及时间。
+一个功能强大的夸克网盘自动转存工具，支持自动转存、智能命名、文件过滤、任务管理、资源搜索、影视发现、追剧日历、文件整理、自动签到、通知推送、媒体库局部刷新等功能，让追剧更轻松！
 
-本项目修改后的版本为个人需求定制版，目的是满足我自己的使用需求，某些（我不用的）功能可能会因为修改而出现 BUG，不一定会被修复。若你要使用本项目，请知晓本人不是程序员，我无法保证本项目的稳定性，如果你在使用过程中发现了 BUG，可以在 Issues 中提交，但不保证每个 BUG 都能被修复，请谨慎使用，风险自担。
+## 项目简介
 
-你可以凭借<a href="#赞赏">赞赏</a>（金额不限）截图加入夸克自动转存（QASX）的微信交流群（我的微信 x1ao-4，备注 QASX），讨论与 QASX 相关的话题，领取与夸克网盘相关的福利。但请注意，这不代表你会获得一对一的咨询服务，我只是提供一个交流场地，当然如果时间和精力允许，我也会在群内解答一些能力范围内的问题。
+夸克自动转存（Quark Auto Save X 简称 QASX）是一个基于 Flask 的 Web 应用，提供夸克网盘自动转存功能，可以帮助你：
 
-夸克网盘签到、自动转存、命名整理、发推送提醒和刷新媒体库一条龙。对于一些持续更新的资源，隔段时间去转存十分麻烦。定期执行本脚本自动转存、重命名整理，配合 Alist、rclone、Emby、Plex 可达到自动追更的效果。🥳
+- 🔄 **自动转存**：定时或自动（根据节目状态和任务进度）运行，自动转存夸克网盘分享链接中的文件
+- 📝 **智能命名**：支持正则、顺序、剧集三种命名模式，自动整理文件名
+- 🧩 **文件过滤**：通过过滤规则排除不需要的文件或文件夹，支持高级过滤功能
+- 📊 **任务管理**：支持多任务管理，支持全局统一设置及单任务独立设置，支持任务筛选和排序
+- 🔍 **资源搜索**：智能搜索夸克网盘资源，自动填充分享链接，支持自动过滤失效链接
+- 🎬 **影视发现**：浏览豆瓣热门影视榜单，一键快速创建任务，智能填充配置
+- 📅 **追剧日历**：追踪节目播出时间，了解转存进度，支持海报视图和日历视图
+- 📁 **文件整理**：浏览和管理多个夸克账号的网盘文件，支持单项/批量重命名、移动、删除等操作
+- ✅ **自动签到**：每日自动签到领空间
+- 🔔 **通知推送**：支持多个通知推送渠道，及时了解转存状态
+- 🔌 **插件系统**：支持多种插件扩展功能，包括媒体库局部刷新、下载任务推送、strm 文件生成等
 
-注意！资源不会每时每刻更新，**严禁设置过高的定时运行频率！**
-以免账号风控或者给夸克服务器造成不必要的压力。
+配合 AList/OpenList、Rclone、CloudDrive、Emby、Plex 等工具，可以实现从转存到播放的完整自动化流程。
 
-## 功能
-- 部署方式
-  - [x] 支持 Docker 部署，WebUI 配置
-  - [x] 可能兼容青龙
+## 核心功能
 
-- 分享链接
-  - [x] 支持分享链接的子目录
-  - [x] 记录失效分享并跳过任务
-  - [x] 支持需提取码的分享链接 <sup>[?](https://github.com/x1ao4/quark-auto-save-x/wiki/使用技巧集锦#支持需提取码的分享链接)</sup>
-  - [x] 智能搜索资源并自动填充（**支持自动过滤失效链接**） <sup>[?](https://github.com/x1ao4/quark-auto-save-x/wiki/资源搜索)</sup>
+### 自动转存
 
-- 文件管理
-  - [x] 目标目录不存在时自动新建
-  - [x] 跳过已转存过的文件（**即使删除网盘文件，也不会重复转存**）
-  - [x] **过滤不需要转存的文件或文件夹**
-  - [x] 转存后文件名整理（正则命名、**顺序命名**、**剧集命名**）
-  - [x] 可选忽略文件后缀
-  - [x] **数据库记录所有转存历史（支持查看、查询和删除记录）**
-  - [x] **文件整理（支持浏览和管理多个夸克账号的网盘文件）**
+- 支持分享链接自动转存
+- 支持分享链接的子目录转存
+- 支持需提取码的分享链接
+- 支持定时运行和自动运行（根据节目播出时间智能执行任务，任务进度达到 100% 后自动跳过）
+- 智能搜索资源并自动填充（集成 CloudSaver、PanSou，支持自动过滤失效链接）
+- 记录失效分享并跳过任务
+- 支持跳过已转存过的文件（即使删除网盘文件，也不会重复转存）
+- 支持一次性转存任务（执行完成后自动删除任务）
 
-- 任务管理
-  - [x] 支持多组任务
-  - [x] 任务结束期限，期限后不执行此任务
-  - [x] **支持按自选周期执行（自选）和按任务进度执行（自动）两种执行周期判断模式（支持混用）**
-  - [x] **支持通过任务名称跳转 TMDB、豆瓣相关页面**
-  - [x] **支持通过影视发现页面浏览豆瓣热门影视榜单、快速创建任务（支持智能填充任务配置）**
+### 智能命名
 
-- 媒体库整合
-  - [x] 根据任务名搜索 Emby 媒体库
-  - [x] 追更或整理后自动刷新 Emby、Plex 媒体库
-  - [x] 媒体库模块化，用户可很方便地[开发自己的媒体库hook模块](./plugins)
+支持三种命名模式，系统会根据匹配表达式自动识别并切换：
 
-- 其它
-  - [x] 每日签到领空间 <sup>[?](https://github.com/x1ao4/quark-auto-save-x/wiki/使用技巧集锦#每日签到领空间)</sup>
-  - [x] 支持多个通知推送渠道 <sup>[?](https://github.com/x1ao4/quark-auto-save-x/wiki/通知设置)</sup>
-  - [x] 支持多账号（多账号签到、**文件管理**，仅首账号转存）
-  - [x] 支持网盘文件下载、strm 文件生成等功能 <sup>[?](https://github.com/x1ao4/quark-auto-save-x/wiki/插件设置)</sup>
-  - [x] **支持通过追剧日历功能了解订阅内容的播出情况和对应文件的转存情况**
+1. **正则命名**：使用正则表达式匹配和替换文件名
+   - 支持完整的正则表达式语法，可精确匹配文件名模式
+   - 支持捕获组和反向引用（如 `\1`、`\2`），可灵活重组文件名
+   - 支持仅匹配不替换（用于文件过滤）
+   - 可同时处理文件名与扩展名
 
-## 部署
-### Docker 部署
+2. **顺序命名**：使用 `{}` 占位符，按文件顺序自动编号
+   - 系统自动识别 `{}` 占位符并切换为顺序命名模式
+   - 按智能排序自动编号，接续目标目录或转存记录中的最大序号
+   - 编号格式自动补零（默认两位），保持文件名长度一致
 
-Docker Run
+3. **剧集命名**：使用 `[]` 占位符，从原文件名提取集编号
+   - 系统自动识别 `[]` 占位符并切换为剧集命名模式
+   - 智能识别原文件名中的集编号信息（支持多种集数格式）
+   - 自动提取集编号并填充到指定位置，保持原有集数信息
 
-```shell
+### 文件过滤
+
+- 支持使用过滤词过滤不需要的文件或文件夹
+- 支持高级过滤功能（保留词和过滤词组合使用）
+- 支持按文件扩展名过滤
+- 支持忽略文件后缀（转存时仅比较文件名，避免同名不同格式文件重复转存）
+
+### 任务管理
+
+- 多组任务并行管理
+- 支持自定义定时规则（支持随机延迟）
+- 两种执行周期模式：
+  - **自选模式**：按自定义周期执行
+  - **自动模式**：按任务进度执行，进度达到 100% 后自动跳过
+- 任务类型筛选（剧集、动画、综艺等）
+- 任务排序（按任务编号、名称、进度、更新时间、播出时间）
+- 任务视图切换（列表视图、海报视图）
+- 支持设置默认（或继承）保存路径和命名规则
+
+### 资源搜索
+
+- 智能搜索夸克网盘资源
+- 根据任务名称自动搜索相关分享链接
+- 自动填充分享链接到任务配置
+- 自动过滤失效链接
+- 支持跳转 Google、TMDB 和豆瓣搜索相关资源或信息
+
+### 影视发现
+
+- 浏览豆瓣热门影视榜单
+- 一键快速创建任务（支持一次性任务）
+- 智能填充任务配置
+
+### 追剧日历
+
+- 查看任务对应电视节目的播出时间表
+- 追踪电视节目的播出情况
+- 了解任务的完成进度
+- 支持海报视图和日历视图
+- 显示单集的准确播出状态
+
+### 文件整理
+
+- 浏览和管理多个夸克账号的网盘文件
+- 单项/批量重命名（支持应用完整的命名、过滤规则）
+- 支持撤销重命名
+- 单项/批量移动文件、删除文件
+- 新建文件夹、删除文件夹
+
+### 插件系统
+
+- **AList**：自动局部刷新 AList 目录
+- **AList Strm**：配合 AList-Strm 项目，触发特定配置运行
+- **AList Strm Gen**：自动生成 strm 文件
+- **Aria2**：自动添加下载任务，支持转存后自动删除网盘文件
+- **Emby**：自动局部刷新 Emby 媒体库
+- **Plex**：自动局部刷新 Plex 媒体库
+- 支持自定义插件开发
+
+### 转存记录
+
+- 数据库记录所有转存历史
+- 通过 WebUI 查看、查询、筛选历史转存记录
+- 支持删除转存记录
+- 显示当日更新标识
+
+### 任务匹配
+
+- 通过 TMDB API 自动匹配电视节目元数据（支持修正匹配）
+- 获取节目海报（支持更换海报）和播出时间（支持通过 Trakt API 获取或自定义）
+- 显示集数信息统计
+- 显示当前任务进度和电视节目状态
+
+### 其他功能
+
+- 每日签到领空间（需配置移动端账号参数）
+- 支持多个通知推送渠道
+- 支持多账号（多账号签到、文件管理，仅首账号转存）
+- 运行日志查看（支持筛选和搜索）
+- 支持设置任务截止日期
+- 支持选择转存起始文件
+- 支持添加自定义魔法匹配（正则匹配和替换表达式）
+- 支持添加自定义集编号识别规则
+- 支持自定义 WebUI 上部分元素的显示方式和顺序
+
+## 快速开始
+
+### 前置要求
+
+- Docker 或支持 Python 3 的环境
+- 夸克网盘账号 Cookie（用于转存和签到）
+
+### Docker 部署（推荐）
+
+#### Docker Run
+
+```bash
 docker run -d \
   --name quark-auto-save-x \
   -p 5005:5005 \
@@ -88,7 +159,7 @@ docker run -d \
   x1ao4/quark-auto-save-x:latest
 ```
 
-Docker Compose（推荐）
+#### Docker Compose
 
 ```yaml
 services:
@@ -103,53 +174,182 @@ services:
     restart: unless-stopped
 ```
 
-默认管理地址：http://yourhost:5005
-
-默认管理用户名/密码：admin
+### 环境变量
 
 | 环境变量         | 说明                                 |
-| ---------------- | -------- |
-| `WEBUI_USERNAME` | 用户名 |
-| `WEBUI_PASSWORD` | 密码 |
-| `PLUGIN_FLAGS`   | 插件标志，如使用 `-emby,-aria2` 来禁用某些插件 |
-| `PORT` | 端口，Host 模式可使用此变量更换端口 |
-| `DEBUG` | 调试模式开关，可使用 `true` 或 `false` 来开启或关闭，调试模式将输出更详细的日志信息 |
+| ---------------- | ------------------------------------ |
+| `WEBUI_USERNAME` | WebUI 登录用户名（默认：admin）       |
+| `WEBUI_PASSWORD` | WebUI 登录密码（默认：admin）        |
+| `PLUGIN_FLAGS`   | 指定要禁用的插件，如 `-emby, -aria2, -alist_strm`（默认：全部启用） |
+| `PORT`           | 端口号（默认：5005）                 |
+| `DEBUG`          | 调试模式开关，`true` 或 `false`（默认：关闭）      |
 
-### 青龙部署
-程序也支持以青龙定时任务的方式运行，但该方式无法使用 WebUI 管理任务，需手动修改配置文件。
+### 访问 WebUI
 
-青龙部署说明已转移到 Wiki ：[青龙部署教程](https://github.com/x1ao4/quark-auto-save-x/wiki/部署教程#青龙部署)
+部署完成后，可通过 `http://yourhost:5005` 访问 WebUI，默认用户名/密码：`admin`。首次登录后请立即修改默认密码！
 
-## 使用说明
-### 正则整理示例
+## 使用指南
+
+### 1. 配置夸克账号
+
+在 WebUI 的「系统配置」页面，添加夸克网盘的 Cookie：
+
+1. 登录夸克网盘网页版
+2. 打开浏览器开发者工具（F12）
+3. 在 Network 标签中找到任意请求
+4. 复制请求头中的 `Cookie` 值
+5. 粘贴到 WebUI 的「账号设置」中
+
+### 2. 配置插件和三方服务
+
+系统支持多种插件和三方服务，可根据需求选择配置：
+
+#### 插件（按需配置）
+
+支持的插件包括：
+
+* **AList**、**AList Strm**、**AList Strm Gen**、**Aria2**、**Emby**、**Plex**
+
+配置后，插件会自动执行对应功能（如刷新媒体库、添加下载任务或生成 strm 文件），无需手动干预。
+
+#### 三方服务（建议配置）
+
+支持的三方服务包括：
+
+* **TMDB**：用于匹配电视节目元数据、获取海报、显示集数信息
+* **Trakt**：用于获取准确播出时间、追踪播出进度
+* **CloudSaver/PanSou**：用于智能搜索网盘资源并自动填充分享链接
+
+配置后，相关功能会自动生效，无需额外操作。
+
+### 3. 创建转存任务
+
+#### 方式一：从任务列表创建
+
+1. 进入「任务列表」页面
+2. 点击「添加/创建任务」按钮
+3. 填写任务信息：
+   - **任务名称**：用于标识任务和匹配元数据
+   - **分享链接**：夸克网盘分享链接
+   - **保存路径**：转存后的文件保存路径
+   - **匹配表达式**：用于匹配和命名文件的表达式
+   - **替换表达式**：用于替换文件名的表达式（可选）
+   - **过滤规则**：过滤不需要的文件或文件夹（可选）
+
+#### 方式二：从影视发现创建
+
+1. 进入「影视发现」页面
+2. 浏览豆瓣热门影视榜单
+3. 点击「创建任务」按钮
+4. 系统会自动填充任务配置（建议先在「系统配置」的「任务设置」中完成自定义设置）
+
+### 4. 命名规则示例
+
+#### 正则命名
 
 | 匹配表达式                                | 替换表达式                | 效果                                                                   |
 | -------------------------------------- | ---------------------- | ---------------------------------------------------------------------- |
-| `.*`                                   |                        | 无脑转存所有文件，不整理                                               |
+| `.*`                                   |                        | 转存所有文件，不整理                                               |
 | `\.mp4$`                               |                        | 转存所有 `.mp4` 后缀的文件                                             |
 | `^【电影TT】花好月圆(\d+)\.(mp4\|mkv)` | `\1.\2`                | 【电影TT】花好月圆01.mp4 → 01.mp4<br>【电影TT】花好月圆02.mkv → 02.mkv |
 | `^(\d+)\.mp4`                          | `S02E\1.mp4`           | 01.mp4 → S02E01.mp4<br>02.mp4 → S02E02.mp4                             |
-| `$TV`                                  |                        | “魔法匹配”剧集文件                                                     |
-| `^(\d+)\.mp4`                          | `$TASKNAME.S02E\1.mp4` | 01.mp4 → 任务名.S02E01.mp4                                             |
 | `(\d{4})(-?)(\d{2})(-?)(\d{2})(期?)`    | `你好，星期六 - \1-\3-\5`| 2025-04-05.mp4 → 你好，星期六 - 2025-04-05.mp4<br>20250412期.mp4 → 你好，星期六 - 2025-04-12.mp4|
-| `乘风2025 - S06E{}`                     |                        | 按照文件顺序命名，`{}` 会被代入序号，新增项目序号在已存在的最大序号的基础上递增  |
-| `黑镜 - S07E[]`                         |                        | 自动识别文件名中的集编号，`[]` 会被代入从文件名中自动提取的集编号               |
 
-更多正则使用说明：[命名规则](https://github.com/x1ao4/quark-auto-save-x/wiki/命名规则)
+#### 顺序命名
 
-### 刷新媒体库
-在有新转存时，可触发完成相应功能，如自动刷新媒体库、生成 .strm 文件等。配置指南：[插件设置](https://github.com/x1ao4/quark-auto-save-x/wiki/插件设置)
+使用 `{}` 占位符，系统会自动按文件顺序智能编号：
 
-媒体库模块以插件的方式的集成，如果你有兴趣请参考[插件开发指南](https://github.com/x1ao4/quark-auto-save-x/tree/x/plugins)。
+- 匹配表达式：`乘风2025 - S06E{}`
+- 效果：文件会按顺序命名为 `乘风2025 - S06E01`、`乘风2025 - S06E02` 等
 
-### 更多使用技巧
-请参考 Wiki ：[使用技巧集锦](https://github.com/x1ao4/quark-auto-save-x/wiki/使用技巧集锦)
+#### 剧集命名
+
+使用 `[]` 占位符，系统会从原文件名提取集编号：
+
+- 匹配表达式：`黑镜 - S07E[]`
+- 效果：从原文件名提取集编号，如 `黑镜 - S07E01`、`黑镜 - S07E02` 等
+
+### 5. 过滤规则
+
+#### 基础过滤
+
+使用逗号分隔的过滤词：
+
+```
+超前，加更，训练，蒸蒸，纯享，团播，抢先
+```
+
+#### 高级过滤
+
+使用 `|` 分隔保留词和过滤词：
+
+- `保留词|过滤词`：先筛选包含保留词的文件，再过滤包含过滤词的文件
+- `保留词1，保留词2|过滤词`：多个保留词（或关系）
+- `保留词1|保留词2|过滤词`：多个保留词（并关系）
+
+示例：
+
+```
+期|加更，企划，超前
+```
+
+表示：先筛选出文件名包含 “期” 的文件，然后从中过滤掉包含 “加更”、“企划”、“超前” 的文件。
+
+### 6. 执行周期设置
+
+#### 自选模式
+
+手动设置执行周期（如每天、每周等）。
+
+#### 自动模式
+
+系统会根据任务进度自动判断：
+
+- 如果已播出的最新集已完成转存，后续定时任务将自动跳过该任务
+- 如果已播出的集还有没转存的，任务会在每次定时时间执行，直到进度到达 100%
+
+这样可以有效减少播出前和转存后的无意义执行。
+
+## 更多文档
+
+- [基础配置](https://github.com/x1ao4/quark-auto-save-x/wiki/使用技巧集锦)
+- [命名规则](https://github.com/x1ao4/quark-auto-save-x/wiki/命名规则)
+- [定时规则](https://github.com/x1ao4/quark-auto-save-x/wiki/定时规则)
+- [任务设置](https://github.com/x1ao4/quark-auto-save-x/wiki/影视发现任务设置)
+- [插件设置](https://github.com/x1ao4/quark-auto-save-x/wiki/插件设置)
+- [通知设置](https://github.com/x1ao4/quark-auto-save-x/wiki/通知设置)
+- [性能设置](https://github.com/x1ao4/quark-auto-save-x/wiki/性能设置)
+- [显示设置](https://github.com/x1ao4/quark-auto-save-x/wiki/显示设置)
+- [资源搜索](https://github.com/x1ao4/quark-auto-save-x/wiki/资源搜索)
+- [插件开发](./plugins/README.md)
+
+## 重要提示
+
+1. **定时频率**：资源不会每时每刻更新，严禁设置过高的定时运行频率！以免账号风控或者给夸克服务器造成不必要的压力。
+2. **账号安全**：请妥善保管你的 Cookie，不要泄露给他人。
+3. **项目状态**：本项目为个人定制项目，代码由 AI 辅助完成，可能存在未修复缺陷；我会确保自身使用所需的核心功能正常运行，Issues 仅用于问题反馈，不承诺长期维护或全部修复，使用风险需自行承担。
+
+## 版权
+
+- **原项目**：Copyright (C) Cp0204 - [Cp0204/quark-auto-save](https://github.com/Cp0204/quark-auto-save)
+- **本项目**：Copyright (C) 2025-2026 x1ao4 - [x1ao4/quark-auto-save-x](https://github.com/x1ao4/quark-auto-save-x)
+
+本项目基于 [Cp0204/quark-auto-save:0.5.3.1](https://github.com/Cp0204/quark-auto-save/releases/tag/v0.5.3.1) 进行二次开发，包含大量功能扩展与代码重构，新增和修改部分的版权归 x1ao4 所有。
 
 ## 声明
-本程序为个人兴趣开发，开源仅供学习与交流使用。
-程序没有任何破解行为，只是对于夸克已有的 API 进行封装，所有数据来自于夸克官方 API，本人不对网盘内容负责、不对夸克官方 API 未来可能的改动导致的后果负责。
 
-## 赞赏 <a name="赞赏"></a>
+本项目基于个人兴趣开发并开源，仅供学习与交流使用，不包含任何破解行为，只是对夸克官方 API 的封装与调用，所有数据均来源于夸克官方，本人不对网盘内容及官方 API 变更所导致的任何后果负责。
+
+## 致谢
+
+本项目基于 [Cp0204/quark-auto-save:0.5.3.1](https://github.com/Cp0204/quark-auto-save/releases/tag/v0.5.3.1) 进行二次开发，感谢 [Cp0204](https://github.com/Cp0204) 的开源贡献。
+
+## 交流
+
+你可以凭借赞赏（金额不限）截图加入 QASX 的微信交流群（我的微信 x1ao-4，备注 QASX），讨论与 QASX 相关的话题，领取与夸克网盘相关的福利。该群主要用于交流 QASX 相关话题与经验分享，我也会在时间和精力允许的情况下参与讨论，适当解答一些问题。
+
+## 赞赏
+
 如果你觉得这个项目对你有用，可以考虑请我喝杯咖啡或者给我一个⭐️。谢谢你的支持！
 
 <img width="383" alt="赞赏" src="https://github.com/user-attachments/assets/bdd2226b-6282-439d-be92-5311b6e9d29c">