@maiyunnet/kebab 9.1.4 → 9.2.0

package/index.d.ts

@@ -5,7 +5,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "9.1.4";
+export declare const VER = "9.2.0";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 /** --- 框架的 LIB，以 / 结尾 --- */

package/index.js

@@ -6,7 +6,7 @@
  * --- 本文件用来定义每个目录实体地址的常量 ---
  */
 /** --- 当前系统版本号 --- */
-export const VER = '9.1.4';
+export const VER = '9.2.0';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/buffer.d.ts

@@ -52,3 +52,8 @@ export declare function getReader(buffer: Buffer): Reader;
  * @param size 缓冲区大小
  */
 export declare function getWriter(size: number): Writer;
+/**
+ * --- 从可读流中获取完整的 Buffer ---
+ * @param stream 可读流对象
+ */
+export declare function getFull(stream: NodeJS.ReadableStream): Promise<Buffer | null>;

package/lib/buffer.js

@@ -1,3 +1,4 @@
+import * as streamConsumers from 'stream/consumers';
 /** --- 读对象 --- */
 export class Reader {
     _buffer;
@@ -125,3 +126,15 @@ export function getReader(buffer) {
 export function getWriter(size) {
     return new Writer(size);
 }
+/**
+ * --- 从可读流中获取完整的 Buffer ---
+ * @param stream 可读流对象
+ */
+export async function getFull(stream) {
+    try {
+        return await streamConsumers.buffer(stream);
+    }
+    catch {
+        return null;
+    }
+}

package/lib/cookie.d.ts

@@ -0,0 +1,44 @@
+import * as kebab from '#kebab/index.js';
+/**
+ * --- 对 cookie 对象进行操作 ---
+ * @param cookie 要操作的对象
+ * @param name 名
+ * @param value 值
+ * @param domain 应用网址，如 .xxx.com
+ * @param opt 选项 ttl, path, ssl, httponly
+ */
+export declare function setCookie(cookie: Record<string, ICookie>, name: string, value: string, domain: string, opt?: {
+    'ttl'?: number;
+    'path'?: string;
+    'ssl'?: boolean;
+    'httponly'?: boolean;
+}): void;
+/**
+ * --- 根据 Set-Cookie 头部转换到 cookie 对象 ---
+ * @param cookie cookie 对象
+ * @param setCookies 头部的 set-cookie 数组
+ * @param uri 请求的 URI 对象
+ */
+export declare function buildCookieObject(cookie: Record<string, ICookie>, setCookies: string[], uri: kebab.IUrlParse): Promise<void>;
+/**
+ * --- 对象转换为 Cookie 拼接字符串（会自动筛掉不能发送的 cookie） ---
+ * @param cookie cookie 对象
+ * @param uri 请求的 URI 对象
+ */
+export declare function buildCookieQuery(cookie: Record<string, ICookie>, uri: kebab.IUrlParse): string;
+/**
+ * --- 模拟重启浏览器后的状态 ---
+ * @param cookie cookie 对象
+ */
+export declare function resetCookieSession(cookie: Record<string, ICookie>): void;
+/** --- Cookie 对象 --- */
+export interface ICookie {
+    'name': string;
+    'value': string;
+    /** --- 有效期秒级时间戳 --- */
+    'exp': number;
+    'path': string;
+    'domain': string;
+    'secure': boolean;
+    'httponly': boolean;
+}

package/lib/cookie.js

@@ -0,0 +1,216 @@
+import * as lText from '#kebab/lib/text.js';
+import * as lTime from '#kebab/lib/time.js';
+/**
+ * --- 对 cookie 对象进行操作 ---
+ * @param cookie 要操作的对象
+ * @param name 名
+ * @param value 值
+ * @param domain 应用网址，如 .xxx.com
+ * @param opt 选项 ttl, path, ssl, httponly
+ */
+export function setCookie(cookie, name, value, domain, opt = {}) {
+    const tim = lTime.stamp();
+    const ttl = opt.ttl ?? 0;
+    domain = lText.parseHost(domain).hostname;
+    const domainN = domain.startsWith('.') ? domain.slice(1) : domain;
+    let exp = -1992199400;
+    if (ttl) {
+        exp = tim + ttl;
+    }
+    cookie[name + '-' + domainN] = {
+        'name': name,
+        'value': value,
+        'exp': exp,
+        'path': opt['path'] ?? '/',
+        'domain': domainN,
+        'secure': opt['ssl'] ? true : false,
+        'httponly': opt['httponly'] ? true : false
+    };
+}
+/**
+ * --- 根据 Set-Cookie 头部转换到 cookie 对象 ---
+ * @param cookie cookie 对象
+ * @param setCookies 头部的 set-cookie 数组
+ * @param uri 请求的 URI 对象
+ */
+export async function buildCookieObject(cookie, setCookies, uri) {
+    const tim = lTime.stamp();
+    uri.path ??= '/';
+    for (const setCookie of setCookies) {
+        const cookieTmp = {};
+        const list = setCookie.split(';');
+        // --- 提取 set-cookie 中的定义信息 ---
+        for (let index = 0; index < list.length; ++index) {
+            const item = list[index];
+            const arr = item.split('=');
+            /** --- 提取 key 并修整 --- */
+            const key = arr[0].trim();
+            if (key === '') {
+                continue;
+            }
+            /** --- 提取 value --- */
+            let val = '';
+            if (arr.length > 1) {
+                val = item.slice(item.indexOf('=') + 1).trim();
+            }
+            if (index === 0) {
+                // --- 用户定义的信息 ---
+                cookieTmp['name'] = key;
+                try {
+                    cookieTmp['value'] = decodeURIComponent(val);
+                }
+                catch {
+                    cookieTmp['value'] = val;
+                }
+            }
+            else {
+                // --- cookie 配置信息，可转小写方便读取 ---
+                cookieTmp[key.toLowerCase()] = val;
+            }
+        }
+        // --- 获取定义的 domain ---
+        let domain = '', domainN = '';
+        if (cookieTmp['domain']) {
+            cookieTmp['domain'] = lText.parseHost(cookieTmp['domain']).hostname;
+            if (!(cookieTmp['domain'].startsWith('.'))) {
+                domain = '.' + cookieTmp['domain'];
+                domainN = cookieTmp['domain'];
+            }
+            else {
+                domain = cookieTmp['domain'];
+                domainN = cookieTmp['domain'].slice(1);
+            }
+        }
+        else {
+            domain = '.' + (uri.hostname ?? '');
+            domainN = uri.hostname ?? '';
+        }
+        // --- 判断有没有设置 domain 的权限 ---
+        // --- uri.hostname vs  domain(domainN) ---
+        // --- ok.xxx.com   vs  .ok.xxx.com: true ---
+        // --- ok.xxx.com   vs  .xxx.com: true ---
+        // --- z.ok.xxx.com vs  .xxx.com: true ---
+        // --- ok.xxx.com   vs  .zz.ok.xxx.com: false ---
+        if (uri.hostname !== domainN) {
+            // --- 设置的域名和当前 host 不相等，如果是 IP、无 . 域名，则直接失败 ---
+            if (!lText.isDomain(uri.hostname ?? '')) {
+                continue;
+            }
+            const parseDomain = await lText.parseDomain(domainN);
+            if (parseDomain.tld === domainN.toLowerCase()) {
+                // --- 不能给 tld 设置 cookie ---
+                continue;
+            }
+            // --- 判断访问路径 (uri['host']) 是不是设置域名 (domain) 的孩子，domain 必须是 uriHost 的同级或者父辈 ---
+            if (!((uri.hostname ?? '').endsWith(domain))) {
+                // --- false 代表进入了，代表失败 ---
+                // --- ok.xxx.com, .xxx.com: true ---
+                // --- ok.xxx.com, .ppp.com: false ---
+                // --- ok.xxx.com, .p.ok.xxx.com: false ---
+                continue;
+            }
+        }
+        const cookieKey = cookieTmp['name'] + '-' + domainN;
+        let exp = -1992199400;
+        if (cookieTmp['max-age'] !== undefined) {
+            const maxAge = Number(cookieTmp['max-age']);
+            if (!(isNaN(maxAge))) {
+                if (maxAge <= 0) {
+                    delete cookie[cookieKey];
+                    continue;
+                }
+                exp = tim + maxAge;
+            }
+        }
+        if ((exp === -1992199400) && cookieTmp['expires']) {
+            const expires = lTime.stamp(cookieTmp['expires']);
+            if (!(isNaN(expires))) {
+                if (expires <= tim) {
+                    delete cookie[cookieKey];
+                    continue;
+                }
+                exp = expires;
+            }
+        }
+        // --- path ---
+        let path = cookieTmp['path'] ?? '';
+        if (path === '') {
+            const srp = (uri.pathname ?? '').lastIndexOf('/');
+            path = (uri.pathname ?? '').slice(0, srp + 1);
+        }
+        else if (!path.startsWith('/')) {
+            path = '/' + path;
+        }
+        cookie[cookieKey] = {
+            'name': cookieTmp['name'],
+            'value': cookieTmp['value'],
+            'exp': exp,
+            'path': path,
+            'domain': domainN,
+            'secure': cookieTmp['secure'] !== undefined,
+            'httponly': cookieTmp['httponly'] !== undefined
+        };
+    }
+}
+/**
+ * --- 对象转换为 Cookie 拼接字符串（会自动筛掉不能发送的 cookie） ---
+ * @param cookie cookie 对象
+ * @param uri 请求的 URI 对象
+ */
+export function buildCookieQuery(cookie, uri) {
+    const tim = lTime.stamp();
+    let cookieStr = '';
+    for (const key in cookie) {
+        const item = cookie[key];
+        if ((item.exp < tim) && (item.exp !== -1992199400)) {
+            delete cookie[key];
+            continue;
+        }
+        uri.path ??= '/';
+        if (item.secure && (uri.protocol !== 'https:')) {
+            continue;
+        }
+        // --- 判断 path 是否匹配 ---
+        if (!uri.path.startsWith(item.path)) {
+            continue;
+        }
+        const domain = '.' + item.domain;
+        // --- 判断 $uri['host'] 必须是 $domain 的同级或子级 ---
+        // --- $uri['host']     vs      $domain ---
+        // --- ok.xxx.com       vs      .ok.xxx.com: true ---
+        // --- ok.xxx.com       vs      .xxx.com: true ---
+        // --- z.ok.xxx.com     vs      .xxx.com: true ---
+        // --- ok.xxx.com       vs      .zz.ok.xxx.com: false ---
+        if ('.' + (uri.hostname ?? '') !== domain) {
+            // --- 域名不相等，那么判断当前域名 host 是不是 domain 的孩子 ---
+            if (!(uri.hostname.endsWith(domain))) {
+                // --- false 代表进入，被排除了，因为 cookie 的 domain 和当前 host 后半部分，代表不是 domain 的孩子 ---
+                // --- ok.xxx.com, .zz.ok.xxx.com: false ---
+                // --- pp.ok.xxx.com, .zz.ok.xxx.com: false ---
+                // --- q.b.ok.xx.com, .zz.ok.xxx.com: false ---
+                // --- z.ok.xxx.com, .xxx.com: true ---
+                // --- xx.xxx.com, .ok.xxx.com: false ---
+                continue;
+            }
+        }
+        cookieStr += item.name + '=' + encodeURIComponent(item.value) + '; ';
+    }
+    if (cookieStr !== '') {
+        return cookieStr.slice(0, -2);
+    }
+    else {
+        return '';
+    }
+}
+/**
+ * --- 模拟重启浏览器后的状态 ---
+ * @param cookie cookie 对象
+ */
+export function resetCookieSession(cookie) {
+    for (const key in cookie) {
+        const item = cookie[key];
+        if (item.exp === -1992199400000) {
+            delete cookie[key];
+        }
+    }
+}

package/lib/core.d.ts

@@ -3,7 +3,8 @@ import * as http2 from 'http2';
 import * as stream from 'stream';
 import * as net from 'net';
 import * as kebab from '#kebab/index.js';
-import * as lResponse from '#kebab/lib/net/response.js';
+import * as lNetResponse from '#kebab/lib/net/response.js';
+import * as lUndiciResponse from '#kebab/lib/undici/response.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 /** --- 全局参数 --- */
 export declare const globalConfig: kebab.IConfig & {
@@ -149,7 +150,7 @@ export declare function emptyObject(obj: Record<string, any>, deep?: boolean): v
  * @param data 数组
  * @param end 是否关闭写入，默认是，关闭后 passThrough 不能被写入，但仍然可读
  */
-export declare function passThroughAppend(passThrough: stream.PassThrough, data: Array<stream.Readable | lResponse.Response | string | Buffer>, end?: boolean): Promise<void>;
+export declare function passThroughAppend(passThrough: stream.PassThrough, data: Array<stream.Readable | lNetResponse.Response | lUndiciResponse.Response | string | Buffer>, end?: boolean): Promise<void>;
 /**
  * --- 执行命令行 ---
  * @param command 命令字符串

package/lib/core.js

@@ -14,9 +14,10 @@ import * as kebab from '#kebab/index.js';
 import * as lTime from '#kebab/lib/time.js';
 import * as lFs from '#kebab/lib/fs.js';
 import * as lText from '#kebab/lib/text.js';
-import * as lNet from '#kebab/lib/net.js';
+import * as lUndici from '#kebab/lib/undici.js';
 import * as lCrypto from '#kebab/lib/crypto.js';
-import * as lResponse from '#kebab/lib/net/response.js';
+import * as lNetResponse from '#kebab/lib/net/response.js';
+import * as lUndiciResponse from '#kebab/lib/undici/response.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 /** --- 全局参数 --- */
 export const globalConfig = {};
@@ -396,7 +397,9 @@ export function emptyObject(obj, deep = false) {
  */
 export async function passThroughAppend(passThrough, data, end = true) {
     for (const item of data) {
-        if (item instanceof stream.Readable || item instanceof lResponse.Response) {
+        if (item instanceof stream.Readable ||
+            item instanceof lNetResponse.Response ||
+            item instanceof lUndiciResponse.Response) {
             const stm = item instanceof stream.Readable ? item : item.getStream();
             if (!stm) {
                 continue;
@@ -463,7 +466,7 @@ export async function sendReload(hosts) {
     /** --- 返回成功的 host --- */
     const rtn = [];
     for (const host of hosts) {
-        const res = await lNet.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'reload',
             'time': time
         }), globalConfig.rpcSecret), {
@@ -502,7 +505,7 @@ export async function sendRestart(hosts) {
     /** --- 返回成功的 host --- */
     const rtn = [];
     for (const host of hosts) {
-        const res = await lNet.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'restart',
             'time': time
         }), globalConfig.rpcSecret), {
@@ -535,7 +538,7 @@ export async function sendPm2(name, action = 'restart', hosts) {
     /** --- 返回成功的 host --- */
     const rtn = [];
     for (const host of hosts) {
-        const res = await lNet.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'pm2',
             'time': time,
             'name': name,
@@ -572,7 +575,7 @@ export async function sendNpm(path, hosts) {
     /** --- 返回成功的 host --- */
     const rtn = [];
     for (const host of hosts) {
-        const res = await lNet.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'npm',
             'time': time,
             'path': path
@@ -619,7 +622,7 @@ export async function setGlobal(key, data, hosts) {
     /** --- 返回成功的 host --- */
     const rtn = [];
     for (const host of hosts) {
-        const res = await lNet.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.get('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'global',
             'time': time
         }), globalConfig.rpcSecret), {
@@ -660,14 +663,14 @@ export async function updateCode(sourcePath, path, hosts, config = true, strict
     /** --- 返回成功的 host --- */
     const rtn = {};
     for (const host of hosts) {
-        const fd = lNet.getFormData();
+        const fd = lUndici.getFormData();
         if (!await fd.putFile('file', sourcePath)) {
             continue;
         }
         fd.putString('path', path);
         fd.putString('config', config ? '1' : '0');
         fd.putString('strict', strict ? '1' : '0');
-        const res = await lNet.post('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+        const res = await lUndici.post('http://' + host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
             'action': 'code',
             'time': lTime.stamp()
         }), globalConfig.rpcSecret), fd, {
@@ -801,7 +804,7 @@ export async function getLog(opt) {
     opt.host ??= '127.0.0.1';
     // --- 局域网模式 ---
     const time = lTime.stamp();
-    const res = await lNet.get('http://' + opt.host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+    const res = await lUndici.get('http://' + opt.host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
         'action': 'log',
         'time': time,
         'hostname': opt.hostname,
@@ -837,7 +840,7 @@ export async function ls(opt) {
     opt.host ??= '127.0.0.1';
     // --- 局域网模式 ---
     const time = lTime.stamp();
-    const res = await lNet.get('http://' + opt.host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
+    const res = await lUndici.get('http://' + opt.host + ':' + globalConfig.rpcPort.toString() + '/' + lCrypto.aesEncrypt(lText.stringifyJson({
         'action': 'ls',
         'time': time,
         'path': opt.path,

package/lib/dns.d.ts

@@ -1,7 +1,7 @@
 /**
  * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-6-19
- * Last: 2022-09-12 20:58:07, 2024-2-21 17:55:54, 2025-6-13 19:08:56, 2025-11-19 00:17:56
+ * Last: 2022-09-12 20:58:07, 2024-2-21 17:55:54, 2025-6-13 19:08:56, 2025-11-19 00:17:56, 2026-04-17 18:28:54
  */
 import * as sCtr from '#kebab/sys/ctr.js';
 /**

package/lib/dns.js

@@ -1,14 +1,13 @@
 /**
  * Project: Kebab, User: JianSuoQiYue
  * Date: 2019-6-19
- * Last: 2022-09-12 20:58:07, 2024-2-21 17:55:54, 2025-6-13 19:08:56, 2025-11-19 00:17:56
+ * Last: 2022-09-12 20:58:07, 2024-2-21 17:55:54, 2025-6-13 19:08:56, 2025-11-19 00:17:56, 2026-04-17 18:28:54
  */
 // --- 库和定义 ---
-import * as lNet from '#kebab/lib/net.js';
 import * as lCore from '#kebab/lib/core.js';
 import * as lText from '#kebab/lib/text.js';
 import * as lCrypto from '#kebab/lib/crypto.js';
-import * as lResponse from '#kebab/lib/net/response.js';
+import * as lUndici from '#kebab/lib/undici.js';
 /**
  * 0.DNSPod：https://www.dnspod.cn/docs/index.html（腾讯云也请使用 DNSPod 的 API）
  * 1.阿里云：https://help.aliyun.com/document_detail/29745.html
@@ -91,7 +90,7 @@ export class Dns {
                 const path = data['_path'];
                 delete data['_path'];
                 // --- 境外服务器请求的话 api 会自动解析到香港服务器 ---
-                return lNet.post('https://dnsapi.cn/' + path, data);
+                return lUndici.post('https://dnsapi.cn/' + path, data);
             }
             // --- 阿里云 ---
             case ESERVICE.ALIBABA: {
@@ -106,10 +105,9 @@ export class Dns {
                 }, obj));
                 const urlRight = lText.queryStringify(getData);
                 const signature = lCrypto.hashHmac('sha1', `GET&${encodeURIComponent('/')}&${encodeURIComponent(urlRight)}`, (this._opt.secretKey ?? '') + '&', 'base64');
-                return lNet.get(`https://alidns.aliyuncs.com/?${urlRight}&Signature=${encodeURIComponent(signature)}`); // 境外 api 会自动调度到新加坡服务器
+                return lUndici.get(`https://alidns.aliyuncs.com/?${urlRight}&Signature=${encodeURIComponent(signature)}`); // 境外 api 会自动调度到新加坡服务器
             }
         }
-        return new lResponse.Response(null);
     }
     /**
      * --- 获取域名列表 ---

package/lib/net/request.d.ts

@@ -5,6 +5,7 @@
  */
 import * as stream from 'stream';
 import * as lNet from '#kebab/lib/net.js';
+import * as lCookie from '#kebab/lib/cookie.js';
 import * as lResponse from './response.js';
 export declare class Request {
     /** --- get 或 post 的数据 --- */
@@ -81,5 +82,5 @@ export declare class Request {
      * --- 发起请求 ---
      * @param cookie
      */
-    request(cookie?: Record<string, lNet.ICookie>): Promise<lResponse.Response>;
+    request(cookie?: Record<string, lCookie.ICookie>): Promise<lResponse.Response>;
 }

package/lib/net.d.ts

@@ -8,6 +8,7 @@ import * as stream from 'stream';
 import * as http from 'http';
 import * as http2 from 'http2';
 import * as kebab from '#kebab/index.js';
+import * as lCookie from '#kebab/lib/cookie.js';
 import * as sCtr from '#kebab/sys/ctr.js';
 import * as lFd from './net/formdata.js';
 import * as lRequest from './net/request.js';
@@ -74,31 +75,6 @@ export declare function fetch(input: string | URL | Request, init?: RequestInit
  * @param opt 配置项
  */
 export declare function request(u: string, data?: Record<string, kebab.Json> | Buffer | string | stream.Readable, opt?: IRequestOptions): Promise<lResponse.Response>;
-/**
- * --- 对 cookie 对象进行操作 ---
- * @param cookie 要操作的对象
- * @param name 名
- * @param value 值
- * @param domain 应用网址，如 .xxx.com
- * @param opt 选项 ttl, path, ssl, httponly
- */
-export declare function setCookie(cookie: Record<string, ICookie>, name: string, value: string, domain: string, opt?: {
-    'ttl'?: number;
-    'path'?: string;
-    'ssl'?: boolean;
-    'httponly'?: boolean;
-}): void;
-/**
- * --- 对象转换为 Cookie 拼接字符串（会自动筛掉不能发送的 cookie） ---
- * @param cookie cookie 对象
- * @param uri 请求的 URI 对象
- */
-export declare function buildCookieQuery(cookie: Record<string, ICookie>, uri: kebab.IUrlParse): string;
-/**
- * --- 模拟重启浏览器后的状态 ---
- * @param cookie cookie 对象
- */
-export declare function resetCookieSession(cookie: Record<string, ICookie>): void;
 /**
  * --- 创建 FormData 对象 ---
  */
@@ -134,7 +110,7 @@ export declare function rproxy(ctr: sCtr.Ctr, route: Record<string, string>, opt
 export interface IRequestOptions {
     'method'?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'OPTIONS';
     'type'?: 'form' | 'json';
-    /** --- 秒数 --- */
+    /** --- 秒数，默认 10 秒 --- */
     'timeout'?: number;
     /** --- 追踪 location 次数，0 为不追踪，默认为 0 --- */
     'follow'?: number;
@@ -156,7 +132,7 @@ export interface IRequestOptions {
     /** --- 复用池名，默认为 default --- */
     'reuse'?: string;
     /** --- cookie 托管对象 --- */
-    'cookie'?: Record<string, ICookie>;
+    'cookie'?: Record<string, lCookie.ICookie>;
     /** --- 若有异常写入文件日志，默认为 true --- */
     'log'?: boolean;
 }
@@ -202,14 +178,3 @@ export type THttpHeaders = http.IncomingHttpHeaders & {
     'http-code'?: number;
     'http-url'?: string;
 };
-/** --- Net Cookie 对象 --- */
-export interface ICookie {
-    'name': string;
-    'value': string;
-    /** --- 有效期秒级时间戳 --- */
-    'exp': number;
-    'path': string;
-    'domain': string;
-    'secure': boolean;
-    'httponly': boolean;
-}