@kevisual/router 0.0.29 → 0.0.31

package/dist/router-browser.d.ts

@@ -141,7 +141,7 @@ type RouteOpts = {
         [key: string]: Rule;
     };
     schema?: {
-        [key: string]: Schema<any>;
+        [key: string]: any;
     };
     isVerify?: boolean;
     verify?: (ctx?: RouteContext, dev?: boolean) => boolean;
@@ -157,7 +157,7 @@ type RouteOpts = {
     isDebug?: boolean;
 };
 type DefineRouteOpts = Omit<RouteOpts, 'idUsePath' | 'verify' | 'verifyKey' | 'nextRoute'>;
-declare const pickValue: readonly ["path", "key", "id", "description", "type", "validator", "middleware"];
+declare const pickValue: readonly ["path", "key", "id", "description", "type", "validator", "middleware", "metadata"];
 type RouteInfo = Pick<Route, (typeof pickValue)[number]>;
 declare class Route<U = {
     [key: string]: any;
@@ -182,7 +182,7 @@ declare class Route<U = {
     type?: string;
     private _validator?;
     schema?: {
-        [key: string]: Schema<any>;
+        [key: string]: any;
     };
     data?: any;
     /**
@@ -193,7 +193,7 @@ declare class Route<U = {
      * 是否开启debug，开启后会打印错误信息
      */
     isDebug?: boolean;
-    constructor(path: string, key?: string, opts?: RouteOpts);
+    constructor(path?: string, key?: string, opts?: RouteOpts);
     private createSchema;
     /**
      * set validator and create schema
@@ -233,6 +233,8 @@ declare class Route<U = {
     setValidator(validator: {
         [key: string]: Rule;
     }): this;
+    prompt(description: string): this;
+    prompt(description: Function): this;
     define<T extends {
         [key: string]: any;
     } = RouterContextT>(opts: DefineRouteOpts): this;
@@ -245,6 +247,7 @@ declare class Route<U = {
     define<T extends {
         [key: string]: any;
     } = RouterContextT>(path: string, key: string, fn: Run<T & U>): this;
+    update(opts: DefineRouteOpts, checkList?: string[]): this;
     addTo(router: QueryRouter | {
         add: (route: Route) => void;
         [key: string]: any;
@@ -313,6 +316,7 @@ declare class QueryRouter {
      * @returns
      */
     queryRoute(message: {
+        id?: string;
         path: string;
         key?: string;
         payload?: any;
@@ -334,7 +338,8 @@ declare class QueryRouter {
      * 获取handle函数, 这里会去执行parse函数
      */
     getHandle<T = any>(router: QueryRouter, wrapperFn?: HandleFn<T>, ctx?: RouteContext): (msg: {
-        path: string;
+        id?: string;
+        path?: string;
         key?: string;
         [key: string]: any;
     }, handleContext?: RouteContext) => Promise<{
@@ -408,6 +413,8 @@ declare class QueryRouterServer extends QueryRouter {
     route(path: string, key?: string): Route<Required<RouteContext>>;
     route(path: string, opts?: RouteOpts): Route<Required<RouteContext>>;
     route(path: string, key?: string, opts?: RouteOpts): Route<Required<RouteContext>>;
+    prompt(description: string): Route<Required<RouteContext>>;
+    prompt(description: Function): Route<Required<RouteContext>>;
     /**
      * 等于queryRoute，但是调用了handle
      * @param param0
@@ -419,6 +426,7 @@ declare class QueryRouterServer extends QueryRouter {
         payload?: any;
     }): Promise<any>;
 }
+declare const Mini: typeof QueryRouterServer;
 
 /** 自定义错误 */
 declare class CustomError extends Error {
@@ -529,5 +537,5 @@ declare class QueryUtil<T extends RouteObject = RouteObject> {
 
 declare const App: typeof QueryRouterServer;
 
-export { App, CustomError, QueryRouter, QueryRouterServer, QueryUtil, Route, createSchema, define, parseBody, parseSearch, parseSearchValue, util };
+export { App, CustomError, Mini, QueryRouter, QueryRouterServer, QueryUtil, Route, createSchema, define, parseBody, parseSearch, parseSearchValue, util };
 export type { RouteArray, RouteContext, RouteObject, RouteOpts, Rule, Run, Schema };

package/dist/router-browser.js

@@ -4788,7 +4788,7 @@ const listenProcess = async ({ app, emitter, params, timeout = 10 * 60 * 60 * 10
     }
 };
 
-const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware'];
+const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware', 'metadata'];
 class Route {
     /**
      * 一级路径
@@ -4817,7 +4817,10 @@ class Route {
      * 是否开启debug，开启后会打印错误信息
      */
     isDebug;
-    constructor(path, key = '', opts) {
+    constructor(path = '', key = '', opts) {
+        if (!path) {
+            path = nanoid$1(8);
+        }
         path = path.trim();
         key = key.trim();
         this.path = path;
@@ -4946,6 +4949,16 @@ class Route {
         this.validator = validator;
         return this;
     }
+    prompt(...args) {
+        const [description] = args;
+        if (typeof description === 'string') {
+            this.description = description;
+        }
+        else if (typeof description === 'function') {
+            this.description = description() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+        }
+        return this;
+    }
     define(...args) {
         const [path, key, opts] = args;
         // 全覆盖，所以opts需要准确，不能由idUsePath 需要check的变量
@@ -4985,6 +4998,26 @@ class Route {
         }
         return this;
     }
+    update(opts, checkList) {
+        const keys = Object.keys(opts);
+        const defaultCheckList = ['path', 'key', 'run', 'nextRoute', 'description', 'metadata', 'middleware', 'type', 'validator', 'isVerify', 'isDebug'];
+        checkList = checkList || defaultCheckList;
+        for (let item of keys) {
+            if (!checkList.includes(item)) {
+                continue;
+            }
+            if (item === 'validator') {
+                this.validator = opts[item];
+                continue;
+            }
+            if (item === 'middleware') {
+                this.middleware = this.middleware.concat(opts[item]);
+                continue;
+            }
+            this[item] = opts[item];
+        }
+        return this;
+    }
     addTo(router) {
         router.add(this);
     }
@@ -5265,19 +5298,20 @@ class QueryRouter {
      */
     async call(message, ctx) {
         let path = message.path;
-        message.key;
+        let key = message.key;
         if (message.id) {
             const route = this.routes.find((r) => r.id === message.id);
             if (route) {
                 path = route.path;
-                route.key;
+                key = route.key;
             }
             else {
                 return { code: 404, body: null, message: 'Not found route' };
             }
+            return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
         }
         else if (path) {
-            return await this.parse({ ...message, path }, { ...this.context, ...ctx });
+            return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
         }
         else {
             return { code: 404, body: null, message: 'Not found path' };
@@ -5317,6 +5351,17 @@ class QueryRouter {
         return async (msg, handleContext) => {
             try {
                 const context = { ...ctx, ...handleContext };
+                if (msg.id) {
+                    const route = router.routes.find((r) => r.id === msg.id);
+                    if (route) {
+                        msg.path = route.path;
+                        msg.key = route.key;
+                    }
+                    else {
+                        return { code: 404, message: 'Not found route' };
+                    }
+                }
+                // @ts-ignore
                 const res = await router.parse(msg, context);
                 if (wrapperFn) {
                     res.data = res.body;
@@ -5400,6 +5445,17 @@ class QueryRouterServer extends QueryRouter {
         }
         return new Route(path, key, opts);
     }
+    prompt(...args) {
+        const [desc] = args;
+        let description = '';
+        if (typeof desc === 'string') {
+            description = desc;
+        }
+        else if (typeof desc === 'function') {
+            description = desc() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+        }
+        return new Route('', '', { description });
+    }
     /**
      * 等于queryRoute，但是调用了handle
      * @param param0
@@ -5431,6 +5487,7 @@ class QueryRouterServer extends QueryRouter {
         }
     }
 }
+const Mini = QueryRouterServer;
 
 const parseBody = async (req) => {
     return new Promise((resolve, reject) => {
@@ -5635,4 +5692,4 @@ class QueryUtil {
 
 const App = QueryRouterServer;
 
-export { App, CustomError, QueryRouter, QueryRouterServer, QueryUtil, Route, createSchema, define, parseBody, parseSearch, parseSearchValue, util };
+export { App, CustomError, Mini, QueryRouter, QueryRouterServer, QueryUtil, Route, createSchema, define, parseBody, parseSearch, parseSearchValue, util };

package/dist/router.d.ts

@@ -145,7 +145,7 @@ type RouteOpts = {
         [key: string]: Rule;
     };
     schema?: {
-        [key: string]: Schema<any>;
+        [key: string]: any;
     };
     isVerify?: boolean;
     verify?: (ctx?: RouteContext, dev?: boolean) => boolean;
@@ -161,7 +161,7 @@ type RouteOpts = {
     isDebug?: boolean;
 };
 type DefineRouteOpts = Omit<RouteOpts, 'idUsePath' | 'verify' | 'verifyKey' | 'nextRoute'>;
-declare const pickValue: readonly ["path", "key", "id", "description", "type", "validator", "middleware"];
+declare const pickValue: readonly ["path", "key", "id", "description", "type", "validator", "middleware", "metadata"];
 type RouteInfo = Pick<Route, (typeof pickValue)[number]>;
 declare class Route<U = {
     [key: string]: any;
@@ -186,7 +186,7 @@ declare class Route<U = {
     type?: string;
     private _validator?;
     schema?: {
-        [key: string]: Schema<any>;
+        [key: string]: any;
     };
     data?: any;
     /**
@@ -197,7 +197,7 @@ declare class Route<U = {
      * 是否开启debug，开启后会打印错误信息
      */
     isDebug?: boolean;
-    constructor(path: string, key?: string, opts?: RouteOpts);
+    constructor(path?: string, key?: string, opts?: RouteOpts);
     private createSchema;
     /**
      * set validator and create schema
@@ -237,6 +237,8 @@ declare class Route<U = {
     setValidator(validator: {
         [key: string]: Rule;
     }): this;
+    prompt(description: string): this;
+    prompt(description: Function): this;
     define<T extends {
         [key: string]: any;
     } = RouterContextT>(opts: DefineRouteOpts): this;
@@ -249,6 +251,7 @@ declare class Route<U = {
     define<T extends {
         [key: string]: any;
     } = RouterContextT>(path: string, key: string, fn: Run<T & U>): this;
+    update(opts: DefineRouteOpts, checkList?: string[]): this;
     addTo(router: QueryRouter | {
         add: (route: Route) => void;
         [key: string]: any;
@@ -317,6 +320,7 @@ declare class QueryRouter {
      * @returns
      */
     queryRoute(message: {
+        id?: string;
         path: string;
         key?: string;
         payload?: any;
@@ -338,7 +342,8 @@ declare class QueryRouter {
      * 获取handle函数, 这里会去执行parse函数
      */
     getHandle<T = any>(router: QueryRouter, wrapperFn?: HandleFn<T>, ctx?: RouteContext): (msg: {
-        path: string;
+        id?: string;
+        path?: string;
         key?: string;
         [key: string]: any;
     }, handleContext?: RouteContext) => Promise<{
@@ -412,6 +417,8 @@ declare class QueryRouterServer extends QueryRouter {
     route(path: string, key?: string): Route<Required<RouteContext>>;
     route(path: string, opts?: RouteOpts): Route<Required<RouteContext>>;
     route(path: string, key?: string, opts?: RouteOpts): Route<Required<RouteContext>>;
+    prompt(description: string): Route<Required<RouteContext>>;
+    prompt(description: Function): Route<Required<RouteContext>>;
     /**
      * 等于queryRoute，但是调用了handle
      * @param param0
@@ -423,6 +430,7 @@ declare class QueryRouterServer extends QueryRouter {
         payload?: any;
     }): Promise<any>;
 }
+declare const Mini: typeof QueryRouterServer;
 
 declare class Connect {
     path: string;
@@ -717,8 +725,11 @@ declare class App<T = {}, U = AppReqRes> {
     route(path: string, key?: string): Route<U>;
     route(path: string, opts?: RouteOpts): Route<U>;
     route(path: string, key?: string, opts?: RouteOpts): Route<U>;
+    prompt(description: string): Route<Required<RouteContext>>;
+    prompt(description: Function): Route<Required<RouteContext>>;
     call(message: {
-        path: string;
+        id?: string;
+        path?: string;
         key?: string;
         payload?: any;
     }, ctx?: RouteContext & {
@@ -744,5 +755,5 @@ declare class App<T = {}, U = AppReqRes> {
     onServerRequest(fn: (req: IncomingMessage$1, res: ServerResponse$1) => void): void;
 }
 
-export { App, Connect, CustomError, QueryConnect, QueryRouter, QueryRouterServer, QueryUtil, Route, Server, createSchema, define, handleServer, util };
+export { App, Connect, CustomError, Mini, QueryConnect, QueryRouter, QueryRouterServer, QueryUtil, Route, Server, createSchema, define, handleServer, util };
 export type { RouteArray, RouteContext, RouteMiddleware, RouteObject, RouteOpts, Rule, Run, Schema };

package/dist/router.js

@@ -4810,7 +4810,7 @@ const listenProcess = async ({ app, emitter, params, timeout = 10 * 60 * 60 * 10
     }
 };
 
-const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware'];
+const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware', 'metadata'];
 class Route {
     /**
      * 一级路径
@@ -4839,7 +4839,10 @@ class Route {
      * 是否开启debug，开启后会打印错误信息
      */
     isDebug;
-    constructor(path, key = '', opts) {
+    constructor(path = '', key = '', opts) {
+        if (!path) {
+            path = nanoid$1(8);
+        }
         path = path.trim();
         key = key.trim();
         this.path = path;
@@ -4968,6 +4971,16 @@ class Route {
         this.validator = validator;
         return this;
     }
+    prompt(...args) {
+        const [description] = args;
+        if (typeof description === 'string') {
+            this.description = description;
+        }
+        else if (typeof description === 'function') {
+            this.description = description() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+        }
+        return this;
+    }
     define(...args) {
         const [path, key, opts] = args;
         // 全覆盖，所以opts需要准确，不能由idUsePath 需要check的变量
@@ -5007,6 +5020,26 @@ class Route {
         }
         return this;
     }
+    update(opts, checkList) {
+        const keys = Object.keys(opts);
+        const defaultCheckList = ['path', 'key', 'run', 'nextRoute', 'description', 'metadata', 'middleware', 'type', 'validator', 'isVerify', 'isDebug'];
+        checkList = checkList || defaultCheckList;
+        for (let item of keys) {
+            if (!checkList.includes(item)) {
+                continue;
+            }
+            if (item === 'validator') {
+                this.validator = opts[item];
+                continue;
+            }
+            if (item === 'middleware') {
+                this.middleware = this.middleware.concat(opts[item]);
+                continue;
+            }
+            this[item] = opts[item];
+        }
+        return this;
+    }
     addTo(router) {
         router.add(this);
     }
@@ -5287,19 +5320,20 @@ class QueryRouter {
      */
     async call(message, ctx) {
         let path = message.path;
-        message.key;
+        let key = message.key;
         if (message.id) {
             const route = this.routes.find((r) => r.id === message.id);
             if (route) {
                 path = route.path;
-                route.key;
+                key = route.key;
             }
             else {
                 return { code: 404, body: null, message: 'Not found route' };
             }
+            return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
         }
         else if (path) {
-            return await this.parse({ ...message, path }, { ...this.context, ...ctx });
+            return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
         }
         else {
             return { code: 404, body: null, message: 'Not found path' };
@@ -5339,6 +5373,17 @@ class QueryRouter {
         return async (msg, handleContext) => {
             try {
                 const context = { ...ctx, ...handleContext };
+                if (msg.id) {
+                    const route = router.routes.find((r) => r.id === msg.id);
+                    if (route) {
+                        msg.path = route.path;
+                        msg.key = route.key;
+                    }
+                    else {
+                        return { code: 404, message: 'Not found route' };
+                    }
+                }
+                // @ts-ignore
                 const res = await router.parse(msg, context);
                 if (wrapperFn) {
                     res.data = res.body;
@@ -5422,6 +5467,17 @@ class QueryRouterServer extends QueryRouter {
         }
         return new Route(path, key, opts);
     }
+    prompt(...args) {
+        const [desc] = args;
+        let description = '';
+        if (typeof desc === 'string') {
+            description = desc;
+        }
+        else if (typeof desc === 'function') {
+            description = desc() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+        }
+        return new Route('', '', { description });
+    }
     /**
      * 等于queryRoute，但是调用了handle
      * @param param0
@@ -5453,6 +5509,7 @@ class QueryRouterServer extends QueryRouter {
         }
     }
 }
+const Mini = QueryRouterServer;
 
 class Connect {
     path;
@@ -11325,6 +11382,17 @@ class App {
         }
         return new Route(path, key, opts);
     }
+    prompt(...args) {
+        const [desc] = args;
+        let description = '';
+        if (typeof desc === 'string') {
+            description = desc;
+        }
+        else if (typeof desc === 'function') {
+            description = desc() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+        }
+        return new Route('', '', { description });
+    }
     async call(message, ctx) {
         const router = this.router;
         return await router.call(message, ctx);
@@ -11355,4 +11423,4 @@ class App {
     }
 }
 
-export { App, Connect, CustomError, QueryConnect, QueryRouter, QueryRouterServer, QueryUtil, Route, Server, createSchema, define, handleServer, util };
+export { App, Connect, CustomError, Mini, QueryConnect, QueryRouter, QueryRouterServer, QueryUtil, Route, Server, createSchema, define, handleServer, util };

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@kevisual/router",
-  "version": "0.0.29",
+  "version": "0.0.31",
   "description": "",
   "type": "module",
   "main": "./dist/router.js",
@@ -24,18 +24,18 @@
     "@kevisual/local-proxy": "^0.0.6",
     "@kevisual/query": "^0.0.29",
     "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "28.0.6",
+    "@rollup/plugin-commonjs": "28.0.8",
     "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.1.4",
+    "@rollup/plugin-typescript": "^12.3.0",
     "@types/lodash-es": "^4.17.12",
-    "@types/node": "^24.7.2",
+    "@types/node": "^24.9.1",
     "@types/send": "^1.2.0",
     "@types/ws": "^8.18.1",
     "@types/xml2js": "^0.4.14",
     "cookie": "^1.0.2",
     "lodash-es": "^4.17.21",
     "nanoid": "^5.1.6",
-    "rollup": "^4.52.4",
+    "rollup": "^4.52.5",
     "rollup-plugin-dts": "^6.2.3",
     "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",

package/src/app.ts

@@ -5,7 +5,7 @@ import { CustomError } from './result/error.ts';
 import { handleServer } from './server/handle-server.ts';
 import { IncomingMessage, ServerResponse } from 'http';
 
-type RouterHandle = (msg: { path: string; [key: string]: any }) => { code: string; data?: any; message?: string; [key: string]: any };
+type RouterHandle = (msg: { path: string;[key: string]: any }) => { code: string; data?: any; message?: string;[key: string]: any };
 type AppOptions<T = {}> = {
   router?: QueryRouter;
   server?: Server;
@@ -82,7 +82,20 @@ export class App<T = {}, U = AppReqRes> {
     }
     return new Route(path, key, opts);
   }
-  async call(message: { path: string; key?: string; payload?: any }, ctx?: RouteContext & { [key: string]: any }) {
+  prompt(description: string): Route<Required<RouteContext>>;
+  prompt(description: Function): Route<Required<RouteContext>>;
+  prompt(...args: any[]) {
+    const [desc] = args;
+    let description = ''
+    if (typeof desc === 'string') {
+      description = desc;
+    } else if (typeof desc === 'function') {
+      description = desc() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+    }
+    return new Route('', '', { description });
+  }
+  
+  async call(message: { id?: string, path?: string; key?: string; payload?: any }, ctx?: RouteContext & { [key: string]: any }) {
     const router = this.router;
     return await router.call(message, ctx);
   }

package/src/browser.ts

@@ -1,4 +1,4 @@
-export { Route, QueryRouter, QueryRouterServer } from './route.ts';
+export { Route, QueryRouter, QueryRouterServer, Mini } from './route.ts';
 
 export type { Rule, Schema } from './validator/index.ts';
 

package/src/chat.ts

@@ -0,0 +1,40 @@
+import { QueryRouter } from "./route.ts";
+
+type RouterChatOptions = {
+  router?: QueryRouter;
+}
+export class RouterChat {
+  router: QueryRouter;
+  prompt: string = '';
+  constructor(opts?: RouterChatOptions) {
+    this.router = opts?.router || new QueryRouter();
+  }
+  prefix(wrapperFn?: (routes: any[]) => string) {
+    if (this.prompt) {
+      return this.prompt;
+    }
+    let _prompt = `你是一个调用函数工具的助手，当用户询问时，如果拥有工具，请返回 JSON 数据，数据的值的内容是 id 和 payload 。如果有参数，请放到 payload 当中。
+
+下面是你可以使用的工具列表：
+
+`;
+    if (!wrapperFn) {
+      _prompt += this.router.routes.map(r => `工具名称: ${r.id}\n描述: ${r.description}\n`).join('\n');
+    } else {
+      _prompt += wrapperFn(this.router.exportRoutes());
+    }
+    _prompt += `当你需要使用工具时，请严格按照以下格式返回：
+{
+  "id": "工具名称",
+  "payload": {
+    // 参数列表
+  }
+}
+如果你不需要使用工具，直接返回用户想要的内容即可，不要返回任何多余的信息。`;
+    return _prompt;
+  }
+  chat() {
+    const prompt = this.prefix();
+    return prompt;
+  }
+}

package/src/index.ts

@@ -1,4 +1,4 @@
-export { Route, QueryRouter, QueryRouterServer } from './route.ts';
+export { Route, QueryRouter, QueryRouterServer, Mini } from './route.ts';
 export { Connect, QueryConnect } from './connect.ts';
 
 export type { RouteContext, RouteOpts, RouteMiddleware } from './route.ts';
@@ -11,7 +11,9 @@ export { Server, handleServer } from './server/index.ts';
  */
 export { CustomError } from './result/error.ts';
 
-export { Rule, Schema, createSchema } from './validator/index.ts';
+export { createSchema } from './validator/index.ts';
+
+export type { Rule, Schema,  } from './validator/index.ts';
 
 export { App } from './app.ts';
 

package/src/route.ts

@@ -1,4 +1,4 @@
-import { nanoid } from 'nanoid';
+import { nanoid, random } from 'nanoid';
 import { CustomError } from './result/error.ts';
 import { Schema, Rule, createSchema } from './validator/index.ts';
 import { pick } from './utils/pick.ts';
@@ -88,7 +88,7 @@ export type RouteOpts = {
    * }
    */
   validator?: { [key: string]: Rule };
-  schema?: { [key: string]: Schema<any> };
+  schema?: { [key: string]: any };
   isVerify?: boolean;
   verify?: (ctx?: RouteContext, dev?: boolean) => boolean;
   verifyKey?: (key: string, ctx?: RouteContext, dev?: boolean) => boolean;
@@ -103,7 +103,7 @@ export type RouteOpts = {
   isDebug?: boolean;
 };
 export type DefineRouteOpts = Omit<RouteOpts, 'idUsePath' | 'verify' | 'verifyKey' | 'nextRoute'>;
-const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware'] as const;
+const pickValue = ['path', 'key', 'id', 'description', 'type', 'validator', 'middleware', 'metadata'] as const;
 export type RouteInfo = Pick<Route, (typeof pickValue)[number]>;
 export class Route<U = { [key: string]: any }> {
   /**
@@ -123,7 +123,7 @@ export class Route<U = { [key: string]: any }> {
   middleware?: RouteMiddleware[]; // middleware
   type? = 'route';
   private _validator?: { [key: string]: Rule };
-  schema?: { [key: string]: Schema<any> };
+  schema?: { [key: string]: any };
   data?: any;
   /**
    * 是否需要验证
@@ -133,7 +133,10 @@ export class Route<U = { [key: string]: any }> {
    * 是否开启debug，开启后会打印错误信息
    */
   isDebug?: boolean;
-  constructor(path: string, key: string = '', opts?: RouteOpts) {
+  constructor(path: string = '', key: string = '', opts?: RouteOpts) {
+    if (!path) {
+      path = nanoid(8)
+    }
     path = path.trim();
     key = key.trim();
     this.path = path;
@@ -261,6 +264,17 @@ export class Route<U = { [key: string]: any }> {
     this.validator = validator;
     return this;
   }
+  prompt(description: string): this;
+  prompt(description: Function): this;
+  prompt(...args: any[]) {
+    const [description] = args;
+    if (typeof description === 'string') {
+      this.description = description;
+    } else if (typeof description === 'function') {
+      this.description = description() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+    }
+    return this;
+  }
   define<T extends { [key: string]: any } = RouterContextT>(opts: DefineRouteOpts): this;
   define<T extends { [key: string]: any } = RouterContextT>(fn: Run<T & U>): this;
   define<T extends { [key: string]: any } = RouterContextT>(key: string, fn: Run<T & U>): this;
@@ -304,6 +318,27 @@ export class Route<U = { [key: string]: any }> {
     }
     return this;
   }
+
+  update(opts: DefineRouteOpts, checkList?: string[]): this {
+    const keys = Object.keys(opts);
+    const defaultCheckList = ['path', 'key', 'run', 'nextRoute', 'description', 'metadata', 'middleware', 'type', 'validator', 'isVerify', 'isDebug'];
+    checkList = checkList || defaultCheckList;
+    for (let item of keys) {
+      if (!checkList.includes(item)) {
+        continue;
+      }
+      if (item === 'validator') {
+        this.validator = opts[item];
+        continue;
+      }
+      if (item === 'middleware') {
+        this.middleware = this.middleware.concat(opts[item]);
+        continue;
+      }
+      this[item] = opts[item];
+    }
+    return this;
+  }
   addTo(router: QueryRouter | { add: (route: Route) => void;[key: string]: any }) {
     router.add(this);
   }
@@ -583,8 +618,9 @@ export class QueryRouter {
       } else {
         return { code: 404, body: null, message: 'Not found route' };
       }
+      return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
     } else if (path) {
-      return await this.parse({ ...message, path }, { ...this.context, ...ctx });
+      return await this.parse({ ...message, path, key }, { ...this.context, ...ctx });
     } else {
       return { code: 404, body: null, message: 'Not found path' };
     }
@@ -596,7 +632,7 @@ export class QueryRouter {
    * @param ctx
    * @returns
    */
-  async queryRoute(message: { path: string; key?: string; payload?: any }, ctx?: RouteContext & { [key: string]: any }) {
+  async queryRoute(message: { id?: string; path: string; key?: string; payload?: any }, ctx?: RouteContext & { [key: string]: any }) {
     const res = await this.parse(message, { ...this.context, ...ctx });
     return {
       code: res.code,
@@ -621,9 +657,19 @@ export class QueryRouter {
    * 获取handle函数, 这里会去执行parse函数
    */
   getHandle<T = any>(router: QueryRouter, wrapperFn?: HandleFn<T>, ctx?: RouteContext) {
-    return async (msg: { path: string; key?: string;[key: string]: any }, handleContext?: RouteContext) => {
+    return async (msg: { id?: string; path?: string; key?: string;[key: string]: any }, handleContext?: RouteContext) => {
       try {
         const context = { ...ctx, ...handleContext };
+        if (msg.id) {
+          const route = router.routes.find((r) => r.id === msg.id);
+          if (route) {
+            msg.path = route.path;
+            msg.key = route.key;
+          } else {
+            return { code: 404, message: 'Not found route' };
+          }
+        }
+        // @ts-ignore
         const res = await router.parse(msg, context);
         if (wrapperFn) {
           res.data = res.body;
@@ -721,6 +767,18 @@ export class QueryRouterServer extends QueryRouter {
     }
     return new Route(path, key, opts);
   }
+  prompt(description: string): Route<Required<RouteContext>>;
+  prompt(description: Function): Route<Required<RouteContext>>;
+  prompt(...args: any[]) {
+    const [desc] = args;
+    let description = ''
+    if (typeof desc === 'string') {
+      description = desc;
+    } else if (typeof desc === 'function') {
+      description = desc() || ''; // 如果是Promise，需要addTo App之前就要获取应有的函数了。
+    }
+    return new Route('', '', { description });
+  }
 
   /**
    * 等于queryRoute，但是调用了handle
@@ -751,3 +809,6 @@ export class QueryRouterServer extends QueryRouter {
     }
   }
 }
+
+
+export const Mini = QueryRouterServer

package/src/test/chat.ts

@@ -0,0 +1,17 @@
+import { App } from '../app.ts'
+import { RouterChat } from '@/chat.ts';
+
+const app = new App();
+
+app.prompt(`获取时间的工具`).define(async (ctx) => {
+  ctx.body = '123'
+}).addTo(app);
+
+app.prompt('获取天气的工具。\n参数是 city 为对应的城市').define(async (ctx) => {
+  ctx.body = '晴天'
+}).addTo(app);
+
+
+export const chat = new RouterChat({ router: app.router });
+
+console.log(chat.chat());