docs: update docs (#99)

anwen-anyi · web-flow · commit 36aa977588c6 · 2025-07-03T15:09:01.000+08:00
* update quark docs and modify ecosystem

* Fix document configuration error prompt
diff --git a/docs/.vuepress/config.ts b/docs/.vuepress/config.ts
@@ -72,11 +72,6 @@ export default defineUserConfig({
       description: "OpenList v3 的文档",
     },
   },
-  markdown: {
-    headers: {
-      level: [2, 3, 4, 5, 6]
-    }
-  },
   plugins: [
 
   ],
diff --git a/docs/.vuepress/public/img/drivers/quark/quark_file_b.png b/docs/.vuepress/public/img/drivers/quark/quark_file_b.png
diff --git a/docs/.vuepress/public/img/drivers/quark/quark_file_h.png b/docs/.vuepress/public/img/drivers/quark/quark_file_h.png
diff --git a/docs/.vuepress/public/img/drivers/quark/quark_token_b.png b/docs/.vuepress/public/img/drivers/quark/quark_token_b.png
diff --git a/docs/.vuepress/public/img/drivers/quark/quark_token_h.png b/docs/.vuepress/public/img/drivers/quark/quark_token_h.png
diff --git a/docs/.vuepress/theme.ts b/docs/.vuepress/theme.ts
@@ -37,6 +37,7 @@ export default hopeTheme(
       },
     },
     markdown: {
+      spoiler: true,
       imgMark: true,
       imgLazyload: true,
       tabs: true,
@@ -48,6 +49,7 @@ export default hopeTheme(
       sup: true,
       flowchart: true,
       mermaid: true,
+      echarts: true,
       codeTabs: true,
     },
     plugins: {
diff --git a/docs/guide/README.md b/docs/guide/README.md
@@ -42,7 +42,7 @@ A file list program that supports multiple storage, and supports web browsing an
 - [x] [MoPan](https://mopan.sc.189.cn/mopan/#/downloadPc)
 - [x] [YandexDisk](https://disk.yandex.com/)
 - [x] [BaiduNetdisk](https://pan.baidu.com/)
-- [x] [Quark/TV](https://pan.quark.cn/)
+- [x] [Quark/TV/Open](https://pan.quark.cn/)
 - [x] [Thunder / X Browser](../guide/drivers/thunder.md)
 - [x] [Lanzou](https://www.lanzou.com/)、[NewLanzou](https://www.ilanzou.com)
 - [x] [Feiji Cloud](https://feijipan.com/)
diff --git a/docs/guide/drivers/115.md b/docs/guide/drivers/115.md
@@ -15,7 +15,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 
 ---
 
diff --git a/docs/guide/drivers/115_open.md b/docs/guide/drivers/115_open.md
@@ -16,7 +16,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 ---
 
 # 115 Open
diff --git a/docs/guide/drivers/onedrive.md b/docs/guide/drivers/onedrive.md
@@ -16,7 +16,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 ---
 
 # OneDrive / Share
diff --git a/docs/guide/drivers/quark.md b/docs/guide/drivers/quark.md
@@ -18,14 +18,23 @@ sticky: true
 star: true
 ---
 
-# Quark / TV
+# Quark / TV / Open
 
 **https://pan.quark.cn**
 
-:::danger
+::::danger
 Due to the speed limit of Quark Cloud,Quick Cloud must use local agents for transmission now,[For details, see](https://github.com/alist-org/alist/issues/4318#issuecomment-1536214188)
+
+::: tip
+
+**V4.0.7 version has added open 302 redirection**
+
 :::
 
+::::
+
+
+
 ## **Quark Cloud**
 
 ### **Cookie**
@@ -38,6 +47,37 @@ Press F12 to open "Debug", select "Network", select any request on the left, and
 
 
 
+### **Use transcoding address**
+
+:::tip
+
+When the LAN environment/server uplink bandwidth is sufficient, it is not recommended to enable the `Use transcoding address` option.
+
+:::
+
+After opening, the video file address will be obtained through the `Use transcoding address`, with the highest support for `4K` image quality, the link **supports 302 redirection **, and the video source network disk transcoding compressed image quality
+
+- Note: After opening, **get the transcoding video file, and its file size is different from the original video file size**, because the network disk service provider has transcoding and compression
+- It is recommended to match
+- - `Web Proxy`: option is off
+- - `WebDAV Policy`: Use the `302 Redirect` option
+- - `Use transcoding address` : option is enabled
+
+<br/>
+
+
+
+### **Only list video file**
+
+After opening, only folders and video files are displayed. It is recommended to use them in conjunction with the above `Use transcoding address`
+
+![quark-file-b](/img/drivers/quark/quark_file_b.png#light)
+![quark-file-h](/img/drivers/quark/quark_file_h.png#dark)
+
+<br/>
+
+
+
 ### **Root Folder ID**
 
 Root Folder ID is `0`
@@ -60,14 +100,18 @@ Note that only Cookies captured in Chrome is available, use Firefox's Cookies ma
 title: Which download method is used by default?
 ---
 flowchart TB
-    style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
+    style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
     style a2 fill:#ff7575,stroke:#333,stroke-width:4px
     subgraph ide1 [ ]
-    c1
+    a1
     end
-    c1[local proxy]:::someclass==mandatory===>a2[user equipment]
+    a1[302]:::someclass====|default|a2[user equipment]
     classDef someclass fill:#f96
+    c1[local proxy]-.alternative.->a2[user equipment]
+    b1[Download proxy URL]-.alternative.->a2[user equipment]
+    click a1 "../drivers/common.html#webdav-policy"
     click b1 "../drivers/common.html#webdav-policy"
+    click c1 "../drivers/common.html#webdav-policy"
 ```
 
 illustrate：[**alist/issues/4318**](https://github.com/alist-org/alist/issues/4318#issuecomment-1536214188)
@@ -130,3 +174,53 @@ flowchart TB
     click b1 "../drivers/common.html#webdav-policy"
     click c1 "../drivers/common.html#webdav-policy"
 ```
+
+
+
+
+
+<br/>
+
+## **Quark Open**
+
+### AppID、SignKey
+
+- **https://api.oplist.org** Authorization page selection **夸克网盘 (OAuth2) Verify login**
+
+  - **AppId**，**SignKey**，It is not convenient to provide it directly, `find a way to get it yourself`:crying_cat_face:
+
+
+![quark-b](/img/drivers/quark/quark_token_b.png#light)
+![quark-h](/img/drivers/quark/quark_token_h.png#dark)
+
+<br/>
+
+
+
+### **Use online api**
+
+Token refresh Use the online interface in the `Api url address` to refresh the token. Due to the lack of relevant documents, local refresh has not been implemented at present. You can only use **Use online api** to refresh the token.
+
+<br/>
+
+
+
+### **The default download method used**
+
+
+```mermaid
+---
+title: Which download method is used by default?
+---
+flowchart TB
+    style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
+    style a2 fill:#ff7575,stroke:#333,stroke-width:4px
+    subgraph ide1 [ ]
+    c1
+    end
+    c1[local proxy]:::someclass==default===>a2[user equipment]
+    classDef someclass fill:#f96
+    b1[Download proxy URL]-.alternative.->a2[user equipment]
+    click b1 "../drivers/common.html#webdav-policy"
+    click c1 "../drivers/common.html#webdav-policy"
+```
diff --git a/docs/zh/guide/README.md b/docs/zh/guide/README.md
@@ -40,7 +40,7 @@ category:
 - [x] [四川电信魔盘](https://mopan.sc.189.cn/mopan/#/downloadPc)
 - [x] [Yandex.Disk](https://disk.yandex.com/)
 - [x] [百度网盘](https://pan.baidu.com/)
-- [x] [夸克网盘/TV](https://pan.quark.cn)
+- [x] [夸克网盘/TV/Open](https://pan.quark.cn)
 - [x] [迅雷网盘 / X / 浏览器](../guide/drivers/thunder.md)
 - [x] [蓝奏云](https://www.lanzou.com/)、[蓝奏云优享版](https://www.ilanzou.com)
 - [x] [小飞机网盘](https://feijipan.com/)
diff --git a/docs/zh/guide/drivers/115.md b/docs/zh/guide/drivers/115.md
@@ -15,7 +15,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 ---
 
 # 115 网盘 / 分享
diff --git a/docs/zh/guide/drivers/115_open.md b/docs/zh/guide/drivers/115_open.md
@@ -16,7 +16,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 ---
 
 # 115 开放平台
diff --git a/docs/zh/guide/drivers/onedrive.md b/docs/zh/guide/drivers/onedrive.md
@@ -16,7 +16,7 @@ tag:
 sticky: true
 # this page will appear in starred articles
 star: true
-headerDepth: 5
+toc: [2,6]
 ---
 
 # OneDrive / 分享
diff --git a/docs/zh/guide/drivers/quark.md b/docs/zh/guide/drivers/quark.md
@@ -18,14 +18,23 @@ sticky: true
 star: true
 ---
 
-# 夸克网盘 / TV
+# 夸克网盘 / TV / Open
 
 **https://pan.quark.cn**
 
-:::danger
+::::danger
 由于夸克网盘限速问题，夸克网盘现在只能使用本地代理进行传输，[说明详见](https://github.com/alist-org/alist/issues/4318#issuecomment-1536214188)
+
+::: tip
+
+**V4.0.7 版本新增开放302模式**
+
 :::
 
+::::
+
+
+
 ## **夸克网盘**
 
 ### **Cookie**
@@ -38,6 +47,33 @@ star: true
 
 
 
+### **视频转码地址**
+
+:::tip
+
+局域网环境/服务器上行带宽足够的情况下，不建议开启 `视频转码地址 - UseTransCodingAddress` 选项
+
+:::
+
+开启后，视频文件地址将通过 `转码接口获取` ，最高支持`4K`画质，链接**支持302重定向**，视频来源网盘转码压缩后的画质
+
+- 注意 开启后 **获取的是转码后的视频文件**，**其文件大小与原视频文件大小不相同**，因为网盘服务商进行了转码压缩
+- 建议搭配
+- - `Web 代理`: 选项关闭
+- - `WebDAV 策略`: 使用 `302 重定向` 选项
+- - `视频转码地址`: 选项开启
+
+<br/>
+
+### **仅展示视频文件**
+
+开启后只展示文件夹和视频文件，建议配合上面的 `视频转码地址` 使用
+
+![quark-file-b](/img/drivers/quark/quark_file_b.png#light)
+![quark-file-h](/img/drivers/quark/quark_file_h.png#dark)
+
+<br/>
+
 ### **根文件夹ID**
 
 根目录ID为 `0`
@@ -77,13 +113,17 @@ star: true
 title: 默认使用的哪种下载方式？
 ---
 flowchart TB
-    style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
+    style a1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
     style a2 fill:#ff7575,stroke:#333,stroke-width:4px
     subgraph ide1 [ ]
-    c1
+    a1
     end
-    c1[本机代理]:::someclass==强制===>a2[用户设备]
+    a1[302]:::someclass====|默认|a2[用户设备]
     classDef someclass fill:#f96
+    c1[本机代理]-.备选.->a2[用户设备]
+    b1[代理URL]-.备选.->a2[用户设备]
+    click a1 "../drivers/common.html#webdav-策略"
+    click b1 "../drivers/common.html#webdav-策略"
     click c1 "../drivers/common.html#webdav-策略"
 ```
 
@@ -147,3 +187,48 @@ flowchart TB
     click b1 "../drivers/common.html#webdav-策略"
     click c1 "../drivers/common.html#webdav-策略"
 ```
+
+<br/>
+
+## **夸克Open**
+
+### AppID、SignKey
+
+- **https://api.oplist.org** 授权页面选择 **夸克网盘 (OAuth2) 验证登录**
+
+  - **AppId**，**SignKey**，不方便直接提供，`自己想办法获取` :crying_cat_face:
+
+![quark-b](/img/drivers/quark/quark_token_b.png#light)
+![quark-h](/img/drivers/quark/quark_token_h.png#dark)
+
+<br/>
+
+
+
+### **使用在线api**
+
+令牌刷新 使用 `Api url 地址` 中的 在线接口进行令牌刷新操作，因缺少相关文档，目前未实现本地刷新，只能使用在线接口进行刷新令牌
+
+<br/>
+
+
+
+### **默认使用的下载方式**
+
+
+```mermaid
+---
+title: 默认使用的哪种下载方式？
+---
+flowchart TB
+    style c1 fill:#bbf,stroke:#f66,stroke-width:2px,color:#fff
+    style a2 fill:#ff7575,stroke:#333,stroke-width:4px
+    subgraph ide1 [ ]
+    c1
+    end
+    c1[本机代理]:::someclass==默认===>a2[用户设备]
+    classDef someclass fill:#f96
+    b1[代理URL]-.备选.->a2[用户设备]
+    click b1 "../drivers/common.html#webdav-策略"
+    click c1 "../drivers/common.html#webdav-策略"
+```
diff --git a/ecosystem.json b/ecosystem.json
@@ -4,7 +4,7 @@
   ],
   "community": [
     { "type": "github", "repo": "jinzhi0123/picgo-plugin-alist" },
-    { "type": "github", "repo": "sbwml/luci-app-alist" },
+    { "type": "github", "repo": "sbwml/luci-app-openlist" },
     { "type": "github", "repo": "traceless/alist-encrypt" },
     { "type": "github", "repo": "iranee/qnap-alist-webdav" },
     { "type": "github", "repo": "yzbtdiy/alist_batch" },
diff --git a/package.json b/package.json
@@ -19,8 +19,9 @@
   },
   "devDependencies": {
     "@types/node": "^18.19.75",
-    "@vuepress/bundler-vite": "2.0.0-rc.19",
+    "@vuepress/bundler-vite": "2.0.0-rc.23",
     "@vuepress/plugin-docsearch": "2.0.0-rc.74",
+    "@vuepress/plugin-watermark": "2.0.0-rc.110",
     "artplayer": "^5.2.2",
     "dashjs": "^4.7.4",
     "flowchart.ts": "^3.0.1",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
