@maiyunnet/kebab 3.1.8 → 3.1.10

package/index.d.ts

@@ -8,7 +8,7 @@
  * ------------------------
  */
 /** --- 当前系统版本号 --- */
-export declare const VER = "3.1.8";
+export declare const VER = "3.1.10";
 /** --- 框架根目录，以 / 结尾  --- */
 export declare const ROOT_PATH: string;
 export declare const LIB_PATH: string;
@@ -133,7 +133,9 @@ export interface IConfigSql {
 }
 /** --- 常量 --- */
 export interface IConfigConst {
+    /** --- 不以 / 开头，不含 qs --- */
     'path': string;
+    /** --- 不含 ? 开头 --- */
     'qs': string;
     'startTime': bigint;
     'startMemory': number;

package/index.js

@@ -9,7 +9,7 @@
  * ------------------------
  */
 /** --- 当前系统版本号 --- */
-export const VER = '3.1.8';
+export const VER = '3.1.10';
 // --- 服务端用的路径 ---
 const imu = decodeURIComponent(import.meta.url).replace('file://', '').replace(/^\/(\w:)/, '$1');
 /** --- /xxx/xxx --- */

package/lib/core.js

@@ -5,6 +5,7 @@
  */
 import * as cp from 'child_process';
 import * as stream from 'stream';
+import * as os from 'os';
 import * as kebab from '#kebab/index.js';
 import * as lTime from '#kebab/lib/time.js';
 import * as lFs from '#kebab/lib/fs.js';
@@ -624,7 +625,7 @@ export function log(opt, msg, fend = '') {
         }
         path += h + '.csv';
         if (!await lFs.isFile(path)) {
-            if (!await lFs.putContent(path, 'TIME,UNIX,URL,COOKIE,SESSION,JWT,USER_AGENT,REALIP,CLIENTIP,MESSAGE\n', {
+            if (!await lFs.putContent(path, 'TIME,UNIX,URL,COOKIE,SESSION,JWT,USER_AGENT,REALIP,CLIENTIP,OS,PROCESS,MESSAGE\n', {
                 'encoding': 'utf8',
                 'mode': 0o777
             })) {
@@ -641,6 +642,8 @@ export function log(opt, msg, fend = '') {
             (headers['user-agent']?.replace(/"/g, '""') ?? 'No HTTP_USER_AGENT') + '","' +
             realIp.replace(/"/g, '""') + '","' +
             clientIp.replace(/"/g, '""') + '","' +
+            lText.sizeFormat(os.totalmem() - os.freemem(), '') + '","' +
+            lText.sizeFormat(process.memoryUsage().rss, '') + '","' +
             JSON.stringify(msg).slice(1, -1).replace(/"/g, '""') + '"\n', {
             'encoding': 'utf8',
             'mode': 0o777,

package/lib/lang.js

@@ -1,11 +1,11 @@
 /** --- 支持的语言缩写列表 --- */
 export const codes = [
-    'sc', 'tc', 'ja', 'ko', 'en', 'es', 'th', 'vi',
-    'de', 'fr', 'pt', 'ru', 'ar', 'id', 'it', 'tr',
+    'sc', 'tc', 'ja', 'ko', 'th', 'vi', 'ar', 'id',
+    'en', 'es', 'de', 'fr', 'pt', 'ru', 'it', 'tr',
 ];
 export const names = [
-    '简体中文', '繁體中文', '日本語', '한국어', 'English', 'Español', 'ไทย', 'Tiếng việt',
-    'Deutsch', 'Français', 'Português', 'Русский', 'العربية', 'Bahasa Indonesia', 'Italiano', 'Türkçe',
+    '简体中文', '繁體中文', '日本語', '한국어', 'ไทย', 'Tiếng việt', 'العربية', 'Bahasa Indonesia',
+    'English', 'Español', 'Deutsch', 'Français', 'Português', 'Русский', 'Italiano', 'Türkçe',
 ];
 /** --- 浏览器常用映射为本语言 --- */
 export const map = {
@@ -13,16 +13,16 @@ export const map = {
     'zh': 'tc',
     'ja': 'ja',
     'ko': 'ko',
-    'en': 'en',
-    'es': 'es',
     'th': 'th',
     'vi': 'vi',
+    'ar': 'ar',
+    'id': 'id',
+    'en': 'en',
+    'es': 'es',
     'de': 'de',
     'fr': 'fr',
     'pt': 'pt',
     'ru': 'ru',
-    'ar': 'ar',
-    'id': 'id',
     'it': 'it',
     'tr': 'tr',
 };

package/lib/net.js

@@ -468,6 +468,9 @@ export async function mproxy(ctr, auth, opt = {}) {
     const res = ctr.getPrototype('_res');
     /** --- 客户端请求中的 get 的数据 --- */
     const get = ctr.getPrototype('_get');
+    if (req.readableEnded) {
+        return -3;
+    }
     if (get['auth'] !== auth) {
         return 0;
     }
@@ -519,6 +522,9 @@ export async function rproxy(ctr, route, opt = {}) {
     const res = ctr.getPrototype('_res');
     const config = ctr.getPrototype('_config');
     const path = config.const.path + (config.const.qs ? '?' + config.const.qs : '');
+    if (req.readableEnded) {
+        return false;
+    }
     for (const key in route) {
         if (!path.startsWith(key)) {
             continue;

package/lib/socket.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Project: Kebab, User: JianSuoQiYue
+ * Date: 2025-9-25 16:49:45
+ * Last: 2025-9-25 16:49:48
+ */
+import net from 'net';
+import * as lNet from '#kebab/lib/net.js';
+import * as lWs from '#kebab/lib/ws.js';
+export interface IRwebsocketOptions {
+    /** --- 秒数 --- */
+    'timeout'?: number;
+    'hosts'?: Record<string, string>;
+    'local'?: string;
+    'headers'?: lNet.THttpHeaders;
+    /** --- cookie 托管对象 --- */
+    'cookie'?: Record<string, lNet.ICookie>;
+    /** --- 小帧模式，默认 false --- */
+    'mode'?: lWs.EFrameReceiveMode;
+    /** --- 加密模式，默认 true --- */
+    'masking'?: boolean;
+    /** --- 正向 mproxy 代理，url 如 wss://xxx/abc --- */
+    'mproxy'?: {
+        'url': string;
+        'auth': string;
+    };
+}
+/**
+ * --- 创建一个 Socket 服务器并反代到 WebSocket ---
+ * @param port 监听端口
+ * @param url 反代到的 WebSocket
+ * @param opt 选项
+ */
+export declare function rwebsocket(port: number, url: string, opt?: IRwebsocketOptions): net.Server;

package/lib/socket.js

@@ -0,0 +1,64 @@
+/**
+ * Project: Kebab, User: JianSuoQiYue
+ * Date: 2025-9-25 16:49:45
+ * Last: 2025-9-25 16:49:48
+ */
+import net from 'net';
+import * as lWs from '#kebab/lib/ws.js';
+import * as lCore from '#kebab/lib/core.js';
+/**
+ * --- 创建一个 Socket 服务器并反代到 WebSocket ---
+ * @param port 监听端口
+ * @param url 反代到的 WebSocket
+ * @param opt 选项
+ */
+export function rwebsocket(port, url, opt = {}) {
+    /** --- 请求端产生的双向 socket --- */
+    const server = net.createServer(socket => {
+        (async () => {
+            // --- 每次进一个新连接都反代到一个新 WebSocket ---
+            lCore.display('New client: ' + socket.remoteAddress + ':' + socket.remotePort);
+            /** --- 远程端的双向 websocket --- */
+            const rws = await lWs.connect(url, opt);
+            if (!rws) {
+                return false;
+            }
+            rws.on('message', msg => {
+                switch (msg.opcode) {
+                    case lWs.EOpcode.TEXT:
+                    case lWs.EOpcode.BINARY: {
+                        socket.write(msg.data);
+                        break;
+                    }
+                    case lWs.EOpcode.CLOSE: {
+                        socket.end();
+                        break;
+                    }
+                    case lWs.EOpcode.PING: {
+                        rws.pong();
+                        break;
+                    }
+                    case lWs.EOpcode.PONG: {
+                        break;
+                    }
+                    default: {
+                        // --- EOpcode.CONTINUATION ---
+                    }
+                }
+            }).on('close', () => {
+                socket.end();
+            });
+            socket.on('data', data => {
+                rws.writeBinary(data);
+            }).on('end', () => {
+                rws.end();
+                lCore.display('Client disconnected: ' + socket.remoteAddress + ':' + socket.remotePort);
+            }).on('error', err => {
+                lCore.display('Client error: ' + socket.remoteAddress + ':' + socket.remotePort + ', ' + err.message);
+            });
+        })().catch(() => { });
+    }).listen(port, () => {
+        lCore.display('Listening:' + port);
+    });
+    return server;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maiyunnet/kebab",
-  "version": "3.1.8",
+  "version": "3.1.10",
   "description": "Simple, easy-to-use, and fully-featured Node.js framework that is ready-to-use out of the box.",
   "type": "module",
   "keywords": [

package/sys/ctr.d.ts

@@ -94,6 +94,10 @@ export declare class Ctr {
      * --- 实例化后会执行的方法，可重写此方法 ---
      */
     onLoad(): boolean | string | kebab.DbValue[] | Promise<boolean | string | kebab.DbValue[]>;
+    /**
+     * --- onLoad 执行后会执行的方法，可重写此方法 ---
+     */
+    onReady(): boolean | string | kebab.DbValue[] | Promise<boolean | string | kebab.DbValue[]>;
     /**
      * --- 整个结束前会执行本方法，可重写此方法对输出结果再处理一次（Websocket 模式无效） ---
      * @param rtn 之前用户的输出结果

package/sys/ctr.js

@@ -132,6 +132,12 @@ export class Ctr {
     onLoad() {
         return true;
     }
+    /**
+     * --- onLoad 执行后会执行的方法，可重写此方法 ---
+     */
+    onReady() {
+        return true;
+    }
     /**
      * --- 整个结束前会执行本方法，可重写此方法对输出结果再处理一次（Websocket 模式无效） ---
      * @param rtn 之前用户的输出结果

package/sys/route.js

@@ -261,86 +261,96 @@ export async function run(data) {
             return true;
         }
         if (rtn === undefined || rtn === true) {
-            await new Promise(function (resolve) {
-                wsSocket.on('message', async function (msg) {
-                    switch (msg.opcode) {
-                        case ws.EOpcode.CLOSE: {
-                            const r = await cctr['onMessage'](msg.data, msg.opcode);
-                            if (r === false) {
-                                break;
-                            }
-                            wsSocket.end();
-                            break;
-                        }
-                        case ws.EOpcode.PING: {
-                            const r = await cctr['onMessage'](msg.data, msg.opcode);
-                            if (r === false) {
+            try {
+                rtn = await cctr.onReady();
+            }
+            catch (e) {
+                lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                data.socket.destroy();
+                return true;
+            }
+            if (rtn === undefined || rtn === true) {
+                await new Promise(function (resolve) {
+                    wsSocket.on('message', async function (msg) {
+                        switch (msg.opcode) {
+                            case ws.EOpcode.CLOSE: {
+                                const r = await cctr['onMessage'](msg.data, msg.opcode);
+                                if (r === false) {
+                                    break;
+                                }
+                                wsSocket.end();
                                 break;
                             }
-                            wsSocket.pong();
-                            break;
-                        }
-                        case ws.EOpcode.BINARY:
-                        case ws.EOpcode.TEXT: {
-                            try {
+                            case ws.EOpcode.PING: {
                                 const r = await cctr['onMessage'](msg.data, msg.opcode);
                                 if (r === false) {
                                     break;
                                 }
-                                const wrtn = await cctr['onData'](msg.data, msg.opcode);
-                                if (wrtn === false) {
-                                    wsSocket.end();
-                                    return;
-                                }
-                                if (!wrtn) {
-                                    return;
-                                }
-                                if (wrtn instanceof Buffer) {
-                                    wsSocket.writeBinary(wrtn);
-                                    return;
-                                }
-                                if (typeof wrtn === 'string') {
+                                wsSocket.pong();
+                                break;
+                            }
+                            case ws.EOpcode.BINARY:
+                            case ws.EOpcode.TEXT: {
+                                try {
+                                    const r = await cctr['onMessage'](msg.data, msg.opcode);
+                                    if (r === false) {
+                                        break;
+                                    }
+                                    const wrtn = await cctr['onData'](msg.data, msg.opcode);
+                                    if (wrtn === false) {
+                                        wsSocket.end();
+                                        return;
+                                    }
                                     if (!wrtn) {
                                         return;
                                     }
-                                    wsSocket.writeText(wrtn);
-                                    return;
+                                    if (wrtn instanceof Buffer) {
+                                        wsSocket.writeBinary(wrtn);
+                                        return;
+                                    }
+                                    if (typeof wrtn === 'string') {
+                                        if (!wrtn) {
+                                            return;
+                                        }
+                                        wsSocket.writeText(wrtn);
+                                        return;
+                                    }
+                                    if (typeof wrtn === 'object') {
+                                        // --- 返回的是数组，那么代表可能是 JSON，可能是对象序列 ---
+                                        wsSocket.writeResult(wrtn);
+                                        return;
+                                    }
                                 }
-                                if (typeof wrtn === 'object') {
-                                    // --- 返回的是数组，那么代表可能是 JSON，可能是对象序列 ---
-                                    wsSocket.writeResult(wrtn);
-                                    return;
+                                catch (e) {
+                                    lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
                                 }
+                                break;
                             }
-                            catch (e) {
-                                lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                            default: {
+                                // --- nothing ---
                             }
-                            break;
                         }
-                        default: {
-                            // --- nothing ---
+                    }).on('drain', async () => {
+                        try {
+                            await cctr['onDrain']();
                         }
-                    }
-                }).on('drain', async () => {
-                    try {
-                        await cctr['onDrain']();
-                    }
-                    catch (e) {
-                        lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
-                    }
-                }).on('error', (e) => {
-                    lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
-                }).on('close', async () => {
-                    try {
-                        await cctr['onClose']();
-                    }
-                    catch (e) {
+                        catch (e) {
+                            lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                        }
+                    }).on('error', (e) => {
                         lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
-                    }
-                    resolve();
+                    }).on('close', async () => {
+                        try {
+                            await cctr['onClose']();
+                        }
+                        catch (e) {
+                            lCore.log(cctr, lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                        }
+                        resolve();
+                    });
                 });
-            });
-            return true;
+                return true;
+            }
         }
         if (!wsSocket.ended) {
             wsSocket.end();
@@ -393,112 +403,142 @@ export async function run(data) {
     let httpCode = middle.getPrototype('_httpCode');
     if (rtn === undefined || rtn === true) {
         // --- 只有不返回或返回 true 时才加载控制文件 ---
-        // --- 判断真实控制器文件是否存在 ---
-        const filePath = config.const.ctrPath + pathLeft + '.js';
-        if (!await lFs.isFile(filePath)) {
-            // --- 指定的控制器不存在 ---
-            const text = '[Error] Controller not found, path: ' + path + '.';
-            if (config.route['#404']) {
-                data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
-                data.res.writeHead(302);
-                data.res.end('');
-                return true;
-            }
-            data.res.setHeader('content-type', 'text/html; charset=utf-8');
-            data.res.setHeader('content-length', Buffer.byteLength(text));
-            data.res.writeHead(404);
-            data.res.end(text);
-            return true;
-        }
-        // --- 加载控制器文件 ---
-        const ctrCtr = (await import((!filePath.startsWith('/') ? '/' : '') + filePath)).default;
-        cctr = new ctrCtr(config, data.req, data.res ?? data.socket);
-        // --- 对信息进行初始化 ---
-        cctr.setPrototype('_timer', middle.getPrototype('_timer'));
-        cctr.setPrototype('_waitInfo', middle.getPrototype('_waitInfo'));
-        // --- 路由定义的参数序列 ---
-        cctr.setPrototype('_param', param);
-        cctr.setPrototype('_action', middle.getPrototype('_action'));
-        cctr.setPrototype('_headers', headers);
-        cctr.setPrototype('_get', get);
-        cctr.setPrototype('_rawPost', middle.getPrototype('_rawPost'));
-        cctr.setPrototype('_input', middle.getPrototype('_input'));
-        cctr.setPrototype('_files', middle.getPrototype('_files'));
-        cctr.setPrototype('_post', middle.getPrototype('_post'));
-        cctr.setPrototype('_cookie', cookies);
-        cctr.setPrototype('_jwt', middle.getPrototype('_jwt'));
-        if (!cctr.getPrototype('_sess') && middle.getPrototype('_sess')) {
-            cctr.setPrototype('_session', middle.getPrototype('_session'));
-            cctr.setPrototype('_sess', middle.getPrototype('_sess'));
+        try {
+            rtn = await middle.onReady();
         }
-        cctr.setPrototype('_cacheTTL', middle.getPrototype('_cacheTTL'));
-        cctr.setPrototype('_xsrf', middle.getPrototype('_xsrf'));
-        cctr.setPrototype('_httpCode', middle.getPrototype('_httpCode'));
-        lCore.log(cctr, '', '-visit');
-        // --- 强制 HTTPS ---
-        if (config.set.mustHttps && !config.const.https) {
-            data.res.setHeader('location', data.req.url ?? '');
-            data.res.writeHead(302);
+        catch (e) {
+            lCore.log(middle, '(E05)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
+            data.res.setHeader('content-type', 'text/html; charset=utf-8');
+            data.res.setHeader('content-length', 25);
+            data.res.writeHead(500);
+            data.res.end('<h1>500 Server Error</h1><hr>Kebab');
             return true;
         }
-        // --- 检测 action 是否存在，以及排除内部方法 ---
-        if (pathRight.startsWith('_') || pathRight === 'onUpgrade' || pathRight === 'onLoad' || pathRight === 'onData' || pathRight === 'onDrain' || pathRight === 'onClose' || pathRight === 'setPrototype' || pathRight === 'getPrototype' || pathRight === 'getAuthorization') {
-            // --- _ 开头的 action 是内部方法，不允许访问 ---
-            if (config.route['#404']) {
-                data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
-                data.res.writeHead(302);
-                data.res.end('');
+        cacheTTL = middle.getPrototype('_cacheTTL');
+        httpCode = middle.getPrototype('_httpCode');
+        if (rtn === undefined || rtn === true) {
+            // --- 判断真实控制器文件是否存在 ---
+            const filePath = config.const.ctrPath + pathLeft + '.js';
+            if (!await lFs.isFile(filePath)) {
+                // --- 指定的控制器不存在 ---
+                const text = '[Error] Controller not found, path: ' + path + '.';
+                if (config.route['#404']) {
+                    data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    data.res.writeHead(302);
+                    data.res.end('');
+                    return true;
+                }
+                data.res.setHeader('content-type', 'text/html; charset=utf-8');
+                data.res.setHeader('content-length', Buffer.byteLength(text));
+                data.res.writeHead(404);
+                data.res.end(text);
                 return true;
             }
-            const text = '[Error] Action not found, path: ' + path + '.';
-            data.res.setHeader('content-type', 'text/html; charset=utf-8');
-            data.res.setHeader('content-length', Buffer.byteLength(text));
-            data.res.writeHead(404);
-            data.res.end(text);
-            return true;
-        }
-        pathRight = pathRight.replace(/-([a-zA-Z0-9])/g, function (t, t1) {
-            return t1.toUpperCase();
-        });
-        if (cctr[pathRight] === undefined) {
-            if (config.route['#404']) {
-                data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+            // --- 加载控制器文件 ---
+            const ctrCtr = (await import((!filePath.startsWith('/') ? '/' : '') + filePath)).default;
+            cctr = new ctrCtr(config, data.req, data.res ?? data.socket);
+            // --- 对信息进行初始化 ---
+            cctr.setPrototype('_timer', middle.getPrototype('_timer'));
+            cctr.setPrototype('_waitInfo', middle.getPrototype('_waitInfo'));
+            // --- 路由定义的参数序列 ---
+            cctr.setPrototype('_param', param);
+            cctr.setPrototype('_action', middle.getPrototype('_action'));
+            cctr.setPrototype('_headers', headers);
+            cctr.setPrototype('_get', get);
+            cctr.setPrototype('_rawPost', middle.getPrototype('_rawPost'));
+            cctr.setPrototype('_input', middle.getPrototype('_input'));
+            cctr.setPrototype('_files', middle.getPrototype('_files'));
+            cctr.setPrototype('_post', middle.getPrototype('_post'));
+            cctr.setPrototype('_cookie', cookies);
+            cctr.setPrototype('_jwt', middle.getPrototype('_jwt'));
+            if (!cctr.getPrototype('_sess') && middle.getPrototype('_sess')) {
+                cctr.setPrototype('_session', middle.getPrototype('_session'));
+                cctr.setPrototype('_sess', middle.getPrototype('_sess'));
+            }
+            cctr.setPrototype('_cacheTTL', middle.getPrototype('_cacheTTL'));
+            cctr.setPrototype('_xsrf', middle.getPrototype('_xsrf'));
+            cctr.setPrototype('_httpCode', middle.getPrototype('_httpCode'));
+            lCore.log(cctr, '', '-visit');
+            // --- 强制 HTTPS ---
+            if (config.set.mustHttps && !config.const.https) {
+                data.res.setHeader('location', data.req.url ?? '');
                 data.res.writeHead(302);
-                data.res.end('');
                 return true;
             }
-            const text = '[Error] Action not found, path: ' + path + '.';
-            data.res.setHeader('content-type', 'text/html; charset=utf-8');
-            data.res.setHeader('content-length', Buffer.byteLength(text));
-            data.res.writeHead(404);
-            data.res.end(text);
-            return true;
-        }
-        // --- 执行 onLoad 方法 ---
-        try {
-            rtn = await cctr.onLoad();
-            // --- 执行 action ---
-            if (rtn === undefined || rtn === true) {
-                rtn = await cctr[pathRight]();
-                rtn = await cctr.onUnload(rtn);
-                rtn = await middle.onUnload(rtn);
-                const sess = cctr.getPrototype('_sess');
-                if (sess) {
-                    await sess.update();
+            // --- 检测 action 是否存在，以及排除内部方法 ---
+            if (pathRight.startsWith('_') || pathRight === 'onUpgrade' || pathRight === 'onLoad' || pathRight === 'onData' || pathRight === 'onDrain' || pathRight === 'onClose' || pathRight === 'setPrototype' || pathRight === 'getPrototype' || pathRight === 'getAuthorization') {
+                // --- _ 开头的 action 是内部方法，不允许访问 ---
+                if (config.route['#404']) {
+                    data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    data.res.writeHead(302);
+                    data.res.end('');
+                    return true;
                 }
+                const text = '[Error] Action not found, path: ' + path + '.';
+                data.res.setHeader('content-type', 'text/html; charset=utf-8');
+                data.res.setHeader('content-length', Buffer.byteLength(text));
+                data.res.writeHead(404);
+                data.res.end(text);
+                return true;
+            }
+            pathRight = pathRight.replace(/-([a-zA-Z0-9])/g, function (t, t1) {
+                return t1.toUpperCase();
+            });
+            if (cctr[pathRight] === undefined) {
+                if (config.route['#404']) {
+                    data.res.setHeader('location', lText.urlResolve(config.const.urlBase, config.route['#404']));
+                    data.res.writeHead(302);
+                    data.res.end('');
+                    return true;
+                }
+                const text = '[Error] Action not found, path: ' + path + '.';
+                data.res.setHeader('content-type', 'text/html; charset=utf-8');
+                data.res.setHeader('content-length', Buffer.byteLength(text));
+                data.res.writeHead(404);
+                data.res.end(text);
+                return true;
+            }
+            // --- 执行 onLoad 方法 ---
+            try {
+                rtn = await cctr.onLoad();
+                // --- 执行 action ---
+                if (rtn === undefined || rtn === true) {
+                    try {
+                        rtn = await cctr.onReady();
+                        // --- 执行 action ---
+                        if (rtn === undefined || rtn === true) {
+                            rtn = await cctr[pathRight]();
+                            rtn = await cctr.onUnload(rtn);
+                            rtn = await middle.onUnload(rtn);
+                            const sess = cctr.getPrototype('_sess');
+                            if (sess) {
+                                await sess.update();
+                            }
+                        }
+                    }
+                    catch (e) {
+                        lCore.log(cctr, '(E05)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                        data.res.setHeader('content-type', 'text/html; charset=utf-8');
+                        data.res.setHeader('content-length', 25);
+                        data.res.writeHead(500);
+                        data.res.end('<h1>500 Server Error</h1><hr>Kebab');
+                        await waitCtr(cctr);
+                        return true;
+                    }
+                }
+                // --- 获取 ctr 设置的 cache 和 hcode ---
+                cacheTTL = cctr.getPrototype('_cacheTTL');
+                httpCode = cctr.getPrototype('_httpCode');
+            }
+            catch (e) {
+                lCore.log(cctr, '(E04)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
+                data.res.setHeader('content-type', 'text/html; charset=utf-8');
+                data.res.setHeader('content-length', 25);
+                data.res.writeHead(500);
+                data.res.end('<h1>500 Server Error</h1><hr>Kebab');
+                await waitCtr(cctr);
+                return true;
             }
-            // --- 获取 ctr 设置的 cache 和 hcode ---
-            cacheTTL = cctr.getPrototype('_cacheTTL');
-            httpCode = cctr.getPrototype('_httpCode');
-        }
-        catch (e) {
-            lCore.log(cctr, '(E04)' + lText.stringifyJson(e.stack).slice(1, -1), '-error');
-            data.res.setHeader('content-type', 'text/html; charset=utf-8');
-            data.res.setHeader('content-length', 25);
-            data.res.writeHead(500);
-            data.res.end('<h1>500 Server Error</h1><hr>Kebab');
-            await waitCtr(cctr);
-            return true;
         }
     }
     // --- 设置缓存 ---

package/www/example/ctr/test.d.ts

@@ -4,6 +4,7 @@ import * as sCtr from '#kebab/sys/ctr.js';
 export default class extends sCtr.Ctr {
     private _internalUrl;
     onLoad(): Array<string | number> | boolean;
+    onReady(): boolean;
     onUnload(rtn: string | boolean | kebab.DbValue[]): string | boolean | kebab.DbValue[];
     notfound(): string;
     index(): string;

package/www/example/ctr/test.js

@@ -45,6 +45,10 @@ export default class extends sCtr.Ctr {
         }
         return true;
     }
+    onReady() {
+        lCore.display('onReady');
+        return true;
+    }
     onUnload(rtn) {
         if (!Array.isArray(rtn)) {
             return rtn;