From ca6d47d200f757bdd5213029f867f008428117ca Mon Sep 17 00:00:00 2001
From: Saul Hetherman <126445083+YYDS678@users.noreply.github.com>
Date: Mon, 2 Sep 2024 15:37:48 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8A=9F=E8=83=BD=E6=89=A9=E5=B1=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md         | 15 +++++++++++++++
 js/README.md      | 20 +++++++++++++-------
 js/core/uz3lib.js |  1 +
 js/core/uzCode.js | 11 +++++++----
 4 files changed, 36 insertions(+), 11 deletions(-)

diff --git a/README.md b/README.md
index c0b0b50..eef87cc 100644
--- a/README.md
+++ b/README.md
@@ -22,3 +22,18 @@
 <https://github.com/YYDS678/uzVideo/tree/main/js>
 
 # 如有任何相关问题联系：[机器人](https://t.me/uzVideoAppbot)
+
+# 数据源格式说明
+
+## 采集站源格式
+```
+{
+    "api": "采集地址",
+    "name": "名称",
+    "remark": "备注",
+    "noHistory": false, // *不开启*历史记录 默认false(即开启历史记录)，用户可自行在 app 内修改
+    "userAgent": "", // 设置播放ua，用户可自行在 app 内修改
+    "isLock": false, // 是否上锁 默认false(即不上锁)，用户可自行在 app 内修改
+    "blockClassList": ["短剧"] // 屏蔽分类，用户可自行在 app 内修改
+  }
+```
diff --git a/js/README.md b/js/README.md
index ac14507..a93de48 100644
--- a/js/README.md
+++ b/js/README.md
@@ -13,8 +13,12 @@
   "name": "名称",
   "api": "扩展链接",
   "instance": "实例名称",
-  "webSite": "视频站地址。在 app 内用户可自行修改，当加载代码时会赋值给对象的 webSite 属性",
-  "remark": "备注"
+  "webSite": "视频站地址。当加载代码时会赋值给对象的 webSite 属性，用户可自行在 app 内修改",
+  "remark": "备注",
+  "noHistory": false, // *不开启*历史记录 默认false(即开启历史记录)，用户可自行在 app 内修改
+  "userAgent": "", // 设置播放ua 优先级低于 getVideoPlayUrl 返回ua，用户可自行在 app 内修改
+  "isLock": false, // 是否上锁 默认false(即不上锁)，用户可自行在 app 内修改
+  "blockClassList": ["短剧"] // 屏蔽分类，用户可自行在 app 内修改
 }
 
 ```
@@ -53,16 +57,18 @@ graph TD
 
 # 修改记录
 
+### v1.5.40
+
+1. `req` 支持设置 `responseType` 值为字符串 `json、arraybuffer、bytes、plain、stream`
+2. `vod_pic` 支持 data url 格式
+3. `RepVideoPlayUrl.data` 支持 data url 格式
+
 ### v1.4.00
 
 1. 增加二级分类和筛选列表功能
 
 ### v1.3.00
 
-1. 去掉 `cat.js`, 更改为 `cheerio` `Crypto` `Encrypt` `parse`
+1. 去掉 `cat.js`, 更改为 `cheerio` `Crypto` `Encrypt` `parse(后期可能会移除，推荐优先使用 cheerio)`
 2. `VideoDetail` 新增 `quarkUrl` 支持夸克网盘
 3. `RepVideoPlayUrl` 新增 `headers` 支持设置播放 `header`
-
-```
-
-```
diff --git a/js/core/uz3lib.js b/js/core/uz3lib.js
index 773bf80..f496428 100644
--- a/js/core/uz3lib.js
+++ b/js/core/uz3lib.js
@@ -1,4 +1,5 @@
 const cheerio = createCheerio();
 const Crypto = createCryptoJS();
 const Encrypt = loadJSEncrypt();
+// 推荐优先使用 cheerio, parse 后期可能会移除
 const parse = node_html_parser.parse;
diff --git a/js/core/uzCode.js b/js/core/uzCode.js
index 521628b..2c36d4c 100644
--- a/js/core/uzCode.js
+++ b/js/core/uzCode.js
@@ -79,7 +79,7 @@ class VideoDetail {
      * 第一集$第一集的视频详情链接#第二集$第二集的视频详情链接$$$第一集$第一集的视频详情链接#第二集$第二集的视频详情链接
      */
     this.vod_play_url = "";
-    // 封面
+    // 封面 支持 data:image/xxx;base64,
     this.vod_pic = "";
     // 视频分类
     this.type_name = "";
@@ -99,7 +99,7 @@ class VideoDetail {
     this.vod_content = "";
     // 地区
     this.vod_area = "";
-    // 夸克网盘链接
+    // 夸克网盘链接 暂未实现
     this.quarkUrl = "";
   }
 }
@@ -163,6 +163,9 @@ class RepVideoDetail {
  */
 class RepVideoPlayUrl {
   constructor() {
+    /**
+     * 播放视频的URL 支持 data:xxx/xxx;base64,
+     **/
     this.data = "";
     /**
      * 播放视频的请求header
@@ -241,7 +244,7 @@ class WebApiBase {
   async getVideoList(args) {
     return JSON.stringify(new RepVideoList());
   }
-  
+
   /**
    * 获取二级分类视频列表 或 筛选视频列表
    * @param {UZSubclassVideoListArgs} args
@@ -298,7 +301,7 @@ class ProData {
 /**
  * 网络请求，也可以使用 fetch
  * @param {string} url 请求的URL
- * @param {object} options 请求参数 {headers:{},method:"POST",data:{}}
+ * @param {object} options 请求参数 {headers:{},method:"POST",data:{},responseType:"json"/arraybuffer/bytes/plain/stream}
  * @returns {Promise<ProData>}
  */
 async function req(url, options) {