feat: 更新静态资源代理文档，优化路由和插件集成，提升代码可读性和功能性

src/app.ts

@@ -2,7 +2,6 @@ import { QueryRouter, Route, RouteContext, RouteOpts } from './route.ts';
 import { ServerNode, ServerNodeOpts } from './server/server.ts';
 import { HandleCtx } from './server/server-base.ts';
 import { ServerType } from './server/server-type.ts';
-import { CustomError } from './result/error.ts';
 import { handleServer } from './server/handle-server.ts';
 import { IncomingMessage, ServerResponse } from 'http';
 import { isBun } from './utils/is-engine.ts';
@@ -26,12 +25,13 @@ export type AppRouteContext<T = {}> = HandleCtx & RouteContext<T> & { app: App<T
  *  封装了 Router 和 Server 的 App 模块，处理http的请求和响应，内置了 Cookie 和 Token 和 res 的处理
  *  U - Route Context的扩展类型
  */
-export class App<U = {}> {
-  appId: string;
+export class App<U = {}> extends QueryRouter {
+  declare appId: string;
   router: QueryRouter;
   server: ServerType;
   constructor(opts?: AppOptions<U>) {
-    const router = opts?.router || new QueryRouter();
+    super();
+    const router = this;
     let server = opts?.server;
     if (!server) {
       const serverOptions = opts?.serverOptions || {};
@@ -64,15 +64,9 @@ export class App<U = {}> {
     // @ts-ignore
     this.server.listen(...args);
   }
-  use(path: string, fn: (ctx: any) => any, opts?: RouteOpts) {
-    const route = new Route(path, '', opts);
-    route.run = fn;
-    this.router.add(route);
-  }
   addRoute(route: Route) {
-    this.router.add(route);
+    super.add(route);
   }
-  add = this.addRoute;
 
   Route = Route;
   route(opts: RouteOpts<AppRouteContext<U>>): Route<AppRouteContext<U>>;
@@ -109,30 +103,10 @@ export class App<U = {}> {
   }
 
   async call(message: { id?: string, path?: string; key?: string; payload?: any }, ctx?: AppRouteContext<U> & { [key: string]: any }) {
-    const router = this.router;
-    return await router.call(message, ctx);
+    return await super.call(message, ctx);
   }
-  /**
-   * @deprecated
-   */
-  async queryRoute(path: string, key?: string, payload?: any, ctx?: AppRouteContext<U> & { [key: string]: any }) {
-    return await this.router.queryRoute({ path, key, payload }, ctx);
-  }
-  async run(msg: { id?: string, path?: string; key?: string; payload?: any }, ctx?: AppRouteContext<U> & { [key: string]: any }) {
-    return await this.router.run(msg, ctx);
-  }
-  exportRoutes() {
-    return this.router.exportRoutes();
-  }
-  importRoutes(routes: any[]) {
-    this.router.importRoutes(routes);
-  }
-  importApp(app: App) {
-    this.importRoutes(app.exportRoutes());
-  }
-  throw(code?: number | string, message?: string, tips?: string): void;
-  throw(...args: any[]) {
-    throw new CustomError(...args);
+  async run(msg: { id?: string, path?: string; key?: string; payload?: any }, ctx?: Partial<AppRouteContext<U>> & { [key: string]: any }) {
+    return await super.run(msg, ctx);
   }
   static handleRequest(req: IncomingMessage, res: ServerResponse) {
     return handleServer(req, res);

src/opencode.ts

@@ -4,7 +4,7 @@ import { type App } from './app.ts'
 import { type Plugin } from "@opencode-ai/plugin"
 
 import { filter } from '@kevisual/js-filter';
-export const addCallFn = (app: QueryRouterServer) => {
+export const addCallFn = (app: App) => {
   app.route({
     path: 'call',
     key: '',
@@ -35,20 +35,23 @@ export const addCallFn = (app: QueryRouterServer) => {
   }).addTo(app)
 }
 export const createRouterAgentPluginFn = (opts?: {
-  router?: QueryRouter,
+  router?: App | QueryRouterServer,
   //** 过滤比如，WHERE metadata.tags includes 'opencode' */
   query?: string
 }) => {
   let router = opts?.router
   if (!router) {
     const app = useContextKey<App>('app')
-    router = app.router
+    router = app
   }
   if (!router) {
     throw new Error('Router 参数缺失')
   }
   if (!router.hasRoute('call', '')) {
-    addCallFn(router as QueryRouterServer)
+    addCallFn(router as App)
+  }
+  if (!router.hasRoute('auth', '')) {
+    router.route({ path: 'auth', key: '', id: 'auth', description: '认证' }).define(async (ctx) => { }).addTo(router as App)
   }
   const _routes = filter(router.routes, opts?.query || '')
   const routes = _routes.filter(r => {
@@ -88,6 +91,7 @@ export const createRouterAgentPluginFn = (opts?: {
                 }
                 return str;
               }
+              console.error('调用出错', res);
               return `Error: ${res?.message || '无法获取结果'}`;
             }
           }

src/route.ts

@@ -60,7 +60,7 @@ export type RouteContext<T = { code?: number }, S = any> = {
   needSerialize?: boolean;
 } & T;
 export type SimpleObject = Record<string, any>;
-export type Run<T extends SimpleObject = {}> = (ctx: RouteContext<T>) => Promise<typeof ctx | null | void>;
+export type Run<T extends SimpleObject = {}> = (ctx: Required<RouteContext<T>>) => Promise<typeof ctx | null | void>;
 
 export type NextRoute = Pick<Route, 'id' | 'path' | 'key'>;
 export type RouteMiddleware =
@@ -355,7 +355,7 @@ export class QueryRouter {
         const middleware = routeMiddleware[i];
         if (middleware) {
           try {
-            await middleware.run(ctx);
+            await middleware.run(ctx as Required<RouteContext>);
           } catch (e) {
             if (route?.isDebug) {
               console.error('=====debug====:middlerware error');
@@ -385,7 +385,7 @@ export class QueryRouter {
     if (route) {
       if (route.run) {
         try {
-          await route.run(ctx);
+          await route.run(ctx as Required<RouteContext>);
         } catch (e) {
           if (route?.isDebug) {
             console.error('=====debug====:', 'router run error:', e.message);
@@ -664,15 +664,9 @@ export class QueryRouterServer extends QueryRouter {
   setHandle(wrapperFn?: HandleFn, ctx?: RouteContext) {
     this.handle = this.getHandle(this, wrapperFn, ctx);
   }
-  use(path: string, fn: (ctx: any) => any, opts?: RouteOpts) {
-    const route = new Route(path, '', opts);
-    route.run = fn;
-    this.add(route);
-  }
   addRoute(route: Route) {
     this.add(route);
   }
-
   Route = Route;
   route(opts: RouteOpts): Route<Required<RouteContext>>;
   route(path: string, key?: string): Route<Required<RouteContext>>;