yz-yuki-plugin 2.0.1 → 2.0.2-1

package/lib/index.js

@@ -1,14 +1,32 @@
 import chalk from 'chalk';
-import { applicationOptions, useEvent } from 'yunzai';
+import { applicationOptions, setBotTask, useEvent } from 'yunzai';
 import Config from './utils/config.js';
 import * as index$1 from './apps/index.js';
+import { BiliTask } from './models/bilibili/bilibili.task.js';
+import { WeiboTask } from './models/weibo/weibo.task.js';
 
+let biliConfigData = Config.getConfigData("config", "bilibili", "config");
+let weiboConfigData = Config.getConfigData("config", "weibo", "config");
+/** B站动态任务 函数 */
+async function biliNewPushTask(e) {
+    await new BiliTask(e).runTask();
+}
+/** 微博动态任务 函数 */
+async function weiboNewPushTask(e) {
+    await new WeiboTask(e).runTask();
+}
 var index = () => {
+    // 预先存储
     const rules = [];
+    // options
     return applicationOptions({
         create() {
+            // created
             for (const key in index$1) {
+                // 推类型
                 const app = new index$1[key]();
+                // 用  reg 和 key 连接起来。
+                // 也可以进行自由排序
                 for (const rule of app.rule) {
                     rules.push({
                         reg: rule.reg,
@@ -23,12 +41,42 @@ var index = () => {
             logger.info(chalk.rgb(255, 245, 255)(`https://github.com/snowtafir/yuki-plugin`));
             logger.info(chalk.rgb(0, 190, 255)(`-----------------------------------------`));
             logger.info(chalk.rgb(0, 190, 255)(`★ 优纪插件加载完成了喵~`));
+            /** B站动态推送定时任务 */
+            setBotTask(async (Bot) => {
+                try {
+                    biliNewPushTask();
+                    if (biliConfigData.pushTaskLog) {
+                        Bot.logger.mark("yuki插件---B站动态推送定时任务");
+                    }
+                }
+                catch (err) {
+                    console.error('B站动态推送定时任务', err);
+                }
+            }, biliConfigData.pushStatus ? biliConfigData.pushTime : "");
+            /** 微博动态推送定时任务 */
+            setBotTask(async (Bot) => {
+                try {
+                    await weiboNewPushTask();
+                    if (weiboConfigData.pushTaskLog) {
+                        Bot.logger.mark("yuki插件---微博动态推送定时任务");
+                    }
+                }
+                catch (err) {
+                    console.error('微博动态推送定时任务', err);
+                }
+            }, weiboConfigData.pushStatus ? weiboConfigData.pushTime : "");
         },
         async mounted(e) {
+            // 存储
             const data = [];
+            // 如果key不存在
             const cache = {};
+            // 使用event以确保得到正常类型
             await useEvent(e => {
                 for (const item of rules) {
+                    // 匹配正则
+                    // 存在key
+                    // 第一次new
                     if (new RegExp(item.reg).test(e.msg) &&
                         index$1[item.key] &&
                         !cache[item.key]) {
@@ -36,7 +84,10 @@ var index = () => {
                         data.push(new index$1[item.key]());
                     }
                 }
-            }, [e, 'message']);
+            }, 
+            // 推倒为message类型的event
+            [e, 'message']);
+            // back
             return data;
         }
     });

package/lib/models/bilibili/bilibili.api.d.ts

@@ -12,6 +12,7 @@ export declare class BiliApi {
         biliLiveUserInfo: string;
         biliOpusDetail: string;
     };
+    /**header */
     static BILIBILI_HEADERS: {
         Accept: string;
         'Accept-Language': string;
@@ -32,6 +33,7 @@ export declare class BiliApi {
         "Upgrade-Insecure-Requests": string;
         'User-Agent': string;
     };
+    /**Login header */
     static BIlIBILI_LOGIN_HEADERS: {
         Accept: string;
         'Accept-Language': string;
@@ -45,6 +47,7 @@ export declare class BiliApi {
         'Sec-Fetch-User': string;
         TE: string;
     };
+    /**FullArticle header */
     static BILIBILI_ARTICLE_HEADERS: {
         Accept: string;
         'Accept-Language': string;

package/lib/models/bilibili/bilibili.api.js

@@ -1,10 +1,16 @@
 class BiliApi {
     static BILIBIL_API = {
+        //获取动态资源列表 wbi/无wbi parama = { host_mid: uid, timezone_offset: -480, platform: 'web', features: 'itemOpusStyle,listOnlyfans,opusBigCover,onlyfansVote', web_location: "333.999", ...getDmImg(), "x-bili-device-req-json": { "platform": "web", "device": "pc" }, "x-bili-web-req-json": { "spm_id": "333.999" }, w_rid, wts }
         biliDynamicInfoList: `https://api.bilibili.com/x/polymer/web-dynamic/v1/feed/space`,
+        //获取关注数与粉丝数 parama = { vmid: uid }
         biliUpFollowFans: `https://api.bilibili.com/x/relation/stat`,
+        //通过uid获取up详情 parama = { mid: uid, jsonp: jsonp }
         biliSpaceUserInfo: `https://api.bilibili.com/x/space/acc/info`,
+        //parama = { mid: uid, jsonp: jsonp }
         biliSpaceUserInfoWbi: `https://api.bilibili.com/x/space/wbi/acc/info`,
+        //通过关键词${upKeyword}搜索up主 parama = { keyword: 'upKeyword', page: 1, search_type: 'bili_user', order: 'totalrank', pagesize: 5  }
         biliSearchUp: `https://api.bilibili.com/x/web-interface/search/type`,
+        //通过关键词${upKeyword}搜索up主 parama = { keyword: 'upKeyword', page: 1, search_type: 'bili_user', order: 'totalrank'  }，需要wbi签名
         biliSearchUpWbi: `https://api.bilibili.com/x/web-interface/wbi/search/type`,
         biliLiveStatus: 'https://api.live.bilibili.com/room/v1/Room/get_status_info_by_uids',
         biliCard: "https://api.bilibili.com/x/web-interface/card",
@@ -12,6 +18,7 @@ class BiliApi {
         biliLiveUserInfo: "https://api.live.bilibili.com/live_user/v1/Master/info",
         biliOpusDetail: "https://api.bilibili.com/x/polymer/web-dynamic/v1/opus/detail",
     };
+    /**header */
     static BILIBILI_HEADERS = {
         'Accept': '*/*',
         'Accept-Language': 'zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2',
@@ -32,6 +39,7 @@ class BiliApi {
         "Upgrade-Insecure-Requests": '1',
         'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:127.0) Gecko/20100101 Firefox/127.0'
     };
+    /**Login header */
     static BIlIBILI_LOGIN_HEADERS = {
         'Accept': '*/*',
         'Accept-Language': 'zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2',
@@ -45,6 +53,7 @@ class BiliApi {
         'Sec-Fetch-User': '?1',
         'TE': 'trailers',
     };
+    /**FullArticle header */
     static BILIBILI_ARTICLE_HEADERS = {
         'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/png,image/svg+xml,*/*;q=0.8',
         'Accept-Language': 'zh-CN,zh;q=0.8,zh-TW;q=0.7,zh-HK;q=0.5,en-US;q=0.3,en;q=0.2',

package/lib/models/bilibili/bilibili.get.web.data.d.ts

@@ -1,6 +1,9 @@
 export declare class BiliGetWebData {
     constructor(e?: any);
+    /**通过uid获取up动态数据表*/
     getBiliDynamicListDataByUid(uid: any): Promise<import("axios").AxiosResponse<any, any>>;
+    /**通过uid获取up详情*/
     getBilibiUserInfoByUid(uid: any): Promise<import("axios").AxiosResponse<any, any>>;
+    /**通过关键词搜索up*/
     searchBiliUserInfoByKeyword(keyword: string): Promise<import("axios").AxiosResponse<any, any>>;
 }

package/lib/models/bilibili/bilibili.get.web.data.js

@@ -7,6 +7,7 @@ import { getWbiSign } from './bilibili.wbi.js';
 class BiliGetWebData {
     constructor(e) {
     }
+    /**通过uid获取up动态数据表*/
     async getBiliDynamicListDataByUid(uid) {
         const url = BiliApi.BILIBIL_API.biliDynamicInfoList;
         let { cookie } = await readSyncCookie();
@@ -17,6 +18,7 @@ class BiliGetWebData {
             platform: 'web',
             features: "itemOpusStyle,listOnlyfans,opusBigCover,onlyfansVote",
             web_location: "333.999",
+            //...getDmImg(),
             "x-bili-device-req-json": { "platform": "web", "device": "pc" },
             "x-bili-web-req-json": { "spm_id": "333.999" }
         };
@@ -34,6 +36,7 @@ class BiliGetWebData {
         });
         return res;
     }
+    /**通过uid获取up详情*/
     async getBilibiUserInfoByUid(uid) {
         const url = BiliApi.BILIBIL_API.biliSpaceUserInfoWbi;
         let { cookie } = await readSyncCookie();
@@ -55,6 +58,7 @@ class BiliGetWebData {
         });
         return res;
     }
+    /**通过关键词搜索up*/
     async searchBiliUserInfoByKeyword(keyword) {
         const url = BiliApi.BILIBIL_API.biliSearchUpWbi;
         let { cookie } = await readSyncCookie();

package/lib/models/bilibili/bilibili.models.d.ts

@@ -1,20 +1,57 @@
 import { EventType } from 'yunzai';
+/**
+* *******************************************************************
+* Login 相关
+* *******************************************************************
+*/
+/**申请登陆二维码(web端) */
 export declare function applyLoginQRCode(e: EventType): Promise<any>;
+/**处理扫码结果 */
 export declare function pollLoginQRCode(e: EventType, qrcodeKey: string): Promise<string>;
+/**查看app扫码登陆获取的ck的有效状态*/
 export declare function checkBiliLogin(e: EventType): Promise<void>;
+/**退出B站账号登录，将会删除redis缓存的LoginCK，并在服务器注销该登录 Token (SESSDATA)*/
 export declare function exitBiliLogin(e: EventType): Promise<void>;
+/**
+* *******************************************************************
+* cookie相关
+* *******************************************************************
+*/
+/**保存扫码登录的loginCK*/
 export declare function saveLoginCookie(e: EventType, biliLoginCk: string): Promise<void>;
+/** 覆盖保存手动获取绑定的B站ck */
 export declare function saveLocalBiliCk(data: any): Promise<void>;
+/** 读取缓存的tempCK */
 export declare function readTempCk(): Promise<string>;
+/**保存tempCK*/
 export declare function saveTempCk(newTempCk: any): Promise<void>;
+/** 综合获取ck，返回优先级：localCK > loginCK > tempCK */
 export declare function readSyncCookie(): Promise<{
     cookie: any;
     mark: string;
 }>;
+/**
+ * 综合读取、筛选 传入的或本地或redis存储的cookie的item
+ * @param {string} mark 读取存储的CK类型，'localCK' 'tempCK' 'loginCK' 或传入值 'xxx'并进行筛选
+ * @param {Array} items 选取获取CK的项 选全部值：items[0] = 'all' ，或选取其中的值 ['buvid3', 'buvid4', '_uuid', 'SESSDATA', 'DedeUserID', 'DedeUserID__ckMd5', 'bili_jct', 'b_nut', 'b_lsid']
+ * @param {boolean} isInverted 控制正取和反取，true为反取，false为正取
+ * @returns {string}
+ **/
 export declare function readSavedCookieItems(mark: string, items: Array<string>, isInverted?: boolean): Promise<string>;
 export declare function readSavedCookieOtherItems(mark: string, items: Array<string>): Promise<string>;
+/** 生成 _uuid */
 export declare function genUUID(): Promise<string>;
+/**生成 b_lsid */
 export declare function gen_b_lsid(): Promise<string>;
+/**获取新的tempCK*/
 export declare function getNewTempCk(): Promise<void>;
+/**
+ * 请求参数POST接口(ExClimbWuzhi)过校验
+ * @param cookie 请求所需的cookie
+ * @returns 返回POST请求的结果
+ */
 export declare function postGateway(cookie: string): Promise<import("axios").AxiosResponse<any, any>>;
+/**生成buvid_fp
+ * @param {string} uuid
+*/
 export declare function get_buvid_fp(cookie: string): Promise<string>;

package/lib/models/bilibili/bilibili.models.js

@@ -11,6 +11,12 @@ import Image from '../../utils/image.js';
 import { _paths } from '../../utils/paths.js';
 import { BiliApi } from './bilibili.api.js';
 
+/**
+* *******************************************************************
+* Login 相关
+* *******************************************************************
+*/
+/**申请登陆二维码(web端) */
 async function applyLoginQRCode(e) {
     const url = 'https://passport.bilibili.com/x/passport-login/web/qrcode/generate?source=main-fe-header';
     const response = await fetch(url, {
@@ -49,6 +55,7 @@ async function applyLoginQRCode(e) {
         throw new Error(`获取B站登录二维码失败: ${res.data.message}`);
     }
 }
+/**处理扫码结果 */
 async function pollLoginQRCode(e, qrcodeKey) {
     const url = `https://passport.bilibili.com/x/passport-login/web/qrcode/poll?qrcode_key=${qrcodeKey}&source=main-fe-header`;
     const response = await fetch(url, {
@@ -59,20 +66,26 @@ async function pollLoginQRCode(e, qrcodeKey) {
     const data = await response.json();
     if (data.code === 0) {
         if (data.data.code === 0) {
+            // 登录成功，获取 cookie
             const LoginCookie = response.headers.get('set-cookie');
             e.reply(`~B站登陆成功~`);
             return LoginCookie;
         }
         else if (data.data.code === 86101) {
+            // 未扫码
+            // 继续轮询
             await new Promise((resolve) => setTimeout(resolve, 2000));
             (logger ?? Bot.logger)?.mark(`优纪插件：扫码B站登录：未扫码，轮询中...`);
             return pollLoginQRCode(e, qrcodeKey);
         }
         else if (data.data.code === 86090) {
+            // 已扫码未确认
+            // 继续轮询
             await new Promise((resolve) => setTimeout(resolve, 2000));
             return pollLoginQRCode(e, qrcodeKey);
         }
         else if (data.data.code === 86038) {
+            // 二维码已失效
             e.reply('B站登陆二维码已失效');
             return null;
         }
@@ -86,6 +99,7 @@ async function pollLoginQRCode(e, qrcodeKey) {
         throw new Error(`处理扫码结果出错: ${data?.message}`);
     }
 }
+/**查看app扫码登陆获取的ck的有效状态*/
 async function checkBiliLogin(e) {
     const LoginCookie = await readLoginCookie();
     const res = await fetch("https://api.bilibili.com/x/web-interface/nav", {
@@ -106,9 +120,11 @@ async function checkBiliLogin(e) {
         e.reply(`~B站账号已登陆~\n昵称：${uname}\nuid：${mid}\n硬币：${money}\n经验等级：${current_level}\n当前经验值exp：${current_exp}\n下一等级所需exp：${next_exp}`);
     }
     else {
+        // 处理其他情况
         return;
     }
 }
+/**退出B站账号登录，将会删除redis缓存的LoginCK，并在服务器注销该登录 Token (SESSDATA)*/
 async function exitBiliLogin(e) {
     const url = 'https://passport.bilibili.com/login/exit/v2';
     const exitCk = await readLoginCookie();
@@ -160,6 +176,12 @@ async function exitBiliLogin(e) {
         e.reply("退出登录请求出错，请稍后再试");
     }
 }
+/**
+* *******************************************************************
+* cookie相关
+* *******************************************************************
+*/
+/**保存扫码登录的loginCK*/
 async function saveLoginCookie(e, biliLoginCk) {
     if (biliLoginCk && biliLoginCk.length > 0) {
         const LoginCkKey = "Yz:yuki:bili:loginCookie";
@@ -169,15 +191,17 @@ async function saveLoginCookie(e, biliLoginCk) {
         e.reply("扫码超时");
     }
 }
+/** 读取扫码登陆后缓存的cookie */
 async function readLoginCookie() {
     const CK_KEY = "Yz:yuki:bili:loginCookie";
     const tempCk = await Redis.get(CK_KEY);
     return tempCk ? tempCk : '';
 }
+/** 读取手动绑定的B站ck */
 async function readLocalBiliCk() {
     const dir = path.join(_paths.root, 'data/yuki-plugin/');
     if (!fs__default.existsSync(dir)) {
-        fs__default.mkdirSync(dir, { recursive: true });
+        fs__default.mkdirSync(dir, { recursive: true }); // 创建目录，包括父目录
     }
     const files = fs__default.readdirSync(dir).filter((file) => file.endsWith('.yaml'));
     const readFile = promisify(fs__default.readFile);
@@ -186,6 +210,7 @@ async function readLocalBiliCk() {
     const Bck = contents.map((content) => YAML.parse(content));
     return Bck[0];
 }
+/** 覆盖保存手动获取绑定的B站ck */
 async function saveLocalBiliCk(data) {
     const dirPath = path.join(_paths.root, 'data/yuki-plugin/');
     const filePath = path.join(dirPath, 'biliCookie.yaml');
@@ -201,15 +226,18 @@ async function saveLocalBiliCk(data) {
         fs__default.writeFileSync(filePath, yamlContent, 'utf8');
     }
 }
+/** 读取缓存的tempCK */
 async function readTempCk() {
     const CK_KEY = "Yz:yuki:bili:tempCookie";
     const tempCk = await Redis.get(CK_KEY);
     return tempCk ?? '';
 }
+/**保存tempCK*/
 async function saveTempCk(newTempCk) {
     const CK_KEY = "Yz:yuki:bili:tempCookie";
     await Redis.set(CK_KEY, newTempCk, { EX: 3600 * 24 * 180 });
 }
+/** 综合获取ck，返回优先级：localCK > loginCK > tempCK */
 async function readSyncCookie() {
     const localCk = await readLocalBiliCk();
     const tempCk = await readTempCk();
@@ -228,6 +256,13 @@ async function readSyncCookie() {
         return { cookie: '', mark: "ckIsEmpty" };
     }
 }
+/**
+ * 综合读取、筛选 传入的或本地或redis存储的cookie的item
+ * @param {string} mark 读取存储的CK类型，'localCK' 'tempCK' 'loginCK' 或传入值 'xxx'并进行筛选
+ * @param {Array} items 选取获取CK的项 选全部值：items[0] = 'all' ，或选取其中的值 ['buvid3', 'buvid4', '_uuid', 'SESSDATA', 'DedeUserID', 'DedeUserID__ckMd5', 'bili_jct', 'b_nut', 'b_lsid']
+ * @param {boolean} isInverted 控制正取和反取，true为反取，false为正取
+ * @returns {string}
+ **/
 async function readSavedCookieItems(mark, items, isInverted = false) {
     let ckString;
     switch (mark) {
@@ -252,16 +287,18 @@ async function readSavedCookieItems(mark, items, isInverted = false) {
     }
     const cookiePairs = String(Bck)
         .trim()
-        .match(/(\w+)=([^;|,]+)/g)
+        .match(/(\w+)=([^;|,]+)/g) //正则 /(\w+)=([^;]+);/g 匹配 a=b 的内容，并分组为 [^;|,]+ 来匹配值，其中 [^;|,] 表示除了分号和,以外的任意字符
         ?.map(match => match.split('='))
         .filter(([key, value]) => (isInverted ? !items.includes(key) : items.includes(key)) && value !== '')
         .map(([key, value]) => `${key}=${value}`)
         .join(';') || '';
     return cookiePairs;
 }
+// 取反读取ck、筛选 传入的或本地或redis存储的cookie的item
 async function readSavedCookieOtherItems(mark, items) {
     return await readSavedCookieItems(mark, items, true);
 }
+/** 生成 _uuid */
 async function genUUID() {
     const generatePart = (length) => Array.from({ length }, () => Math.floor(16 * Math.random()))
         .map(num => num.toString(16).toUpperCase())
@@ -276,6 +313,7 @@ async function genUUID() {
     const uuid = `_uuid=${e}-${t}-${r}-${n}-${o}${padLeft((i % 1e5).toString(), 5)}infoc;`;
     return uuid;
 }
+/**生成 b_lsid */
 async function gen_b_lsid() {
     function get_random_str(length) {
         return Array.from({ length }, () => Math.floor(Math.random() * 16).toString(16).toUpperCase()).join('');
@@ -285,6 +323,7 @@ async function gen_b_lsid() {
     const timestampHex = timestamp.toString(16).toUpperCase();
     return `b_lsid=${randomPart}_${timestampHex};`;
 }
+/** 获取 buvid3 和 buvid4 */
 async function getBuvid3_4(uuid) {
     const url = 'https://api.bilibili.com/x/frontend/finger/spi/';
     const headers = lodash.merge({}, BiliApi.BILIBILI_HEADERS, {
@@ -303,14 +342,16 @@ async function getBuvid3_4(uuid) {
         return '';
     }
 }
+/**获取新的tempCK*/
 async function getNewTempCk() {
     const uuid = await genUUID();
     const buvid3_buvid4 = await getBuvid3_4(uuid);
     const b_lsid = await gen_b_lsid();
-    let newTempCk = `${uuid}${buvid3_buvid4}${b_lsid}`;
+    //const buvid_fp = await get_buvid_fp(uuid);
+    let newTempCk = `${uuid}${buvid3_buvid4}${b_lsid}`; //${buvid_fp}`;
     await saveTempCk(newTempCk);
     const result = await postGateway(newTempCk);
-    const { code, data } = await result.data;
+    const { code, data } = await result.data; // 解析校验结果
     if (code !== 0) {
         logger?.mark(`优纪插件：tempCK，Gateway校验失败：${JSON.stringify(data)}`);
     }
@@ -318,23 +359,29 @@ async function getNewTempCk() {
         logger?.mark(`优纪插件：tempCK，Gateway校验成功：${JSON.stringify(data)}`);
     }
 }
+/**
+* *******************************************************************
+* 风控相关函数
+* *******************************************************************
+*/
+/**获取GatWay payload */
 async function getPayload(cookie) {
     const payloadOriginData = {
-        "3064": 1,
-        "5062": `${Date.now()}`,
-        "03bf": "https://www.bilibili.com/",
+        "3064": 1, // ptype, mobile => 2, others => 1
+        "5062": `${Date.now()}`, // timestamp
+        "03bf": "https://www.bilibili.com/", // url accessed
         "39c8": "333.999.fp.risk",
-        "34f1": "",
-        "d402": "",
-        "654a": "",
-        "6e7c": "878x1066",
+        "34f1": "", // target_url, default empty now
+        "d402": "", // screenx, default empty
+        "654a": "", // screeny, default empty
+        "6e7c": "878x1066", // browser_resolution, window.innerWidth || document.body && document.body.clientWidth + "x" + window.innerHeight || document.body && document.body.clientHeight
         "3c43": {
-            "2673": 0,
-            "5766": 24,
-            "6527": 0,
-            "7003": 1,
-            "807e": 1,
-            "b8ce": BiliApi.BILIBILI_HEADERS['User-Agent'],
+            "2673": 0, // hasLiedResolution, window.screen.width < window.screen.availWidth || window.screen.height < window.screen.availHeight
+            "5766": 24, // colorDepth, window.screen.colorDepth
+            "6527": 0, // addBehavior, !!window.HTMLElement.prototype.addBehavior, html5 api
+            "7003": 1, // indexedDb, !!window.indexedDB, html5 api
+            "807e": 1, // cookieEnabled, navigator.cookieEnabled
+            "b8ce": BiliApi.BILIBILI_HEADERS['User-Agent'], // ua "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:127.0) Gecko/20100101 Firefox/127.0",
             "641c": 0,
             "07a4": "zh-CN",
             "1c57": "not available",
@@ -347,7 +394,7 @@ async function getPayload(cookie) {
             "3b21": 1,
             "8a1c": 0,
             "d52f": "not available",
-            "adca": BiliApi.BILIBILI_HEADERS['User-Agent'].includes('Windows') ? 'Win32' : 'Linux',
+            "adca": BiliApi.BILIBILI_HEADERS['User-Agent'].includes('Windows') ? 'Win32' : 'Linux', // platform, navigator.platform
             "80c9": [
                 ["PDF Viewer", "Portable Document Format", [
                         ["application/pdf", "pdf"],
@@ -455,13 +502,18 @@ async function getPayload(cookie) {
             }
         },
         "8b94": "",
-        "df35": `${await readSavedCookieItems(cookie, ['_uuid'], false)}`,
+        "df35": `${await readSavedCookieItems(cookie, ['_uuid'], false)}`, // _uuid, set from cookie, generated by client side(algorithm remains unknown)
         "07a4": "zh-CN",
         "5f45": null,
         "db46": 0
     };
     return JSON.stringify(payloadOriginData);
 }
+/**
+ * 请求参数POST接口(ExClimbWuzhi)过校验
+ * @param cookie 请求所需的cookie
+ * @returns 返回POST请求的结果
+ */
 async function postGateway(cookie) {
     const payload = getPayload(cookie);
     const requestUrl = 'https://api.bilibili.com/x/internal/gaia-gateway/ExClimbWuzhi';

package/lib/models/bilibili/bilibili.query.d.ts

@@ -1,15 +1,39 @@
 export declare class BiliQuery {
+    /**
+     * 序列化动态数据
+     * @param data - 动态数据对象
+     * @returns 序列化后的动态数据对象
+     */
     static formatDynamicData(data: any): Promise<{
         uid: any;
         data: {
             [key: string]: any;
         };
     }>;
+    /**
+     * 动态内容富文本节点解析
+     * @param nodes - 动态内容富文本节点
+     * @returns 解析后的动态内容富文本
+     */
     static parseRichTextNodes: (nodes: any[] | string | any) => any;
+    /**获取完整B站文章内容
+  * @param postId - 文章ID
+  * @returns {Json}完整的B站文章内容json数据
+  */
     static getFullArticleContent(postUrl: string): Promise<any>;
+    /**解析完整文章内容 */
     static praseFullArticleContent(content: string): string;
     static formatUrl(url: string): string;
+    /**
+     * 生成动态消息文字内容
+     * @param upName - UP主名称
+     * @param formatData - 动态数据
+     * @param isForward - 是否为转发动态
+     * @param setData - 设置数据
+     * @returns 生成的动态消息文字内容
+     */
     static formatTextDynamicData(upName: string, data: any, isForward: boolean, setData: any): Promise<any>;
     static dynamicContentLimit(content: string, setData: any): string;
+    /**根据关键字更新 up 的动态类型 */
     static typeHandle(up: any, msg: string, type: string): unknown[];
 }