@zhin.js/http 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @zhin.js/http
+
+## 1.0.1
+
+### Patch Changes
+
+- efdd58a: fix: init
+- Updated dependencies [efdd58a]
+  - @zhin.js/core@1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 凉菜
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,261 @@
+# @zhin.js/http
+
+基于 Koa 的 HTTP 服务器插件，为 Zhin 机器人框架提供 HTTP API 和 WebSocket 支持。
+
+## 功能特性
+
+- 🌐 基于 Koa.js 的 HTTP 服务器
+- 🔐 Basic Auth 身份验证
+- 🛠️ RESTful API 支持
+- 📡 WebSocket 实时通信
+- 🔄 请求体解析 (JSON)
+- 🌍 可配置的服务器设置
+- 📊 路由管理和中间件支持
+- 📋 内置 API 端点 (系统状态、插件管理、适配器信息)
+- 📝 上下文描述信息支持
+
+## 技术架构
+
+- **HTTP框架**: Koa.js
+- **路由**: 自定义Router类扩展@koa/router
+- **WebSocket**: ws 库
+- **身份验证**: koa-basic-auth
+- **请求解析**: koa-bodyparser
+
+## 安装
+
+```bash
+npm install @zhin.js/http
+```
+
+## 使用
+
+### 基本使用
+
+```javascript
+// 插件会自动启动HTTP服务器
+import '@zhin.js/http'
+```
+
+### 环境变量配置
+
+```bash
+# 服务器端口 (默认: 8086)
+port=8086
+
+# 路由前缀 (可选)
+routerPrefix=/api
+
+# 基础认证用户名 (默认: admin)
+username=admin
+
+# 基础认证密码 (默认: 123456)  
+password=123456
+```
+
+## 核心组件
+
+### Router 类
+
+扩展了 `@koa/router` 的功能：
+
+```typescript
+class Router extends KoaRouter {
+  // WebSocket服务器管理
+  ws(path: string, options?: ServerOptions): WebSocketServer
+  
+  // 销毁路由
+  destroy(layer: Layer): void
+  
+  // 销毁WebSocket服务器
+  destroyWs(wsServer: WebSocketServer): void
+  
+  // 白名单管理（用于历史API排除）
+  whiteList: Path[]
+}
+```
+
+### 全局上下文
+
+```typescript
+declare module '@zhin.js/types' {
+  interface GlobalContext {
+    koa: Koa,           // Koa应用实例
+    router: Router,     // 路由器实例  
+    server: Server      // HTTP服务器实例
+  }
+}
+```
+
+## API 使用
+
+### 内置 API 端点
+
+插件提供以下内置 API：
+
+#### 适配器管理 API
+- `GET /api/adapters` - 获取所有上下文列表
+
+**响应格式:**
+```json
+{
+  "success": true,
+  "data": [
+    {
+      "name": "icqq-adapter",
+      "desc": "ICQQ适配器，用于连接QQ平台"
+    },
+    {
+      "name": "web-console", 
+      "desc": "Web控制台服务，提供管理界面"
+    }
+  ]
+}
+```
+
+#### 其他 API
+- `GET /api/system/status` - 系统状态信息
+- `GET /api/plugins` - 插件列表
+- `GET /api/config` - 配置信息
+- `POST /api/message/send` - 发送消息
+- `POST /api/plugins/:name/reload` - 重载插件
+- `GET /api/health` - 健康检查
+
+### 自定义 HTTP 路由
+
+```javascript
+import { useContext } from 'zhin.js'
+
+useContext('router', async (router) => {
+  // GET 请求
+  router.get('/api/status', async (ctx) => {
+    ctx.body = { status: 'ok' }
+  })
+  
+  // POST 请求
+  router.post('/api/message', async (ctx) => {
+    const { message } = ctx.request.body
+    // 处理消息...
+    ctx.body = { success: true }
+  })
+})
+```
+
+### WebSocket 连接
+
+```javascript
+import { useContext } from 'zhin.js'
+
+useContext('router', async (router) => {
+  const ws = router.ws('/api/realtime')
+  
+  ws.on('connection', (socket) => {
+    socket.send('连接成功')
+    
+    socket.on('message', (data) => {
+      console.log('收到消息:', data)
+    })
+  })
+})
+```
+
+### Koa 中间件
+
+```javascript
+import { useContext } from 'zhin.js'
+
+useContext('koa', async (koa) => {
+  koa.use(async (ctx, next) => {
+    console.log('请求:', ctx.method, ctx.url)
+    await next()
+  })
+})
+```
+
+## 服务器配置
+
+### 启动配置
+
+```javascript
+{
+  host: '0.0.0.0',     // 监听地址
+  port: 8086           // 监听端口
+}
+```
+
+### 身份验证
+
+默认启用 Basic Auth：
+- 用户名: `admin` (可通过环境变量修改)
+- 密码: `123456` (可通过环境变量修改)
+
+## WebSocket 功能
+
+### 路径管理
+
+- 支持多个WebSocket端点
+- 自动路径匹配
+- 连接升级处理
+
+### 连接处理
+
+```javascript
+// 创建WebSocket服务器
+const wsServer = router.ws('/chat')
+
+// 处理连接
+wsServer.on('connection', (ws, request) => {
+  ws.send('欢迎连接')
+})
+
+// 销毁服务器
+router.destroyWs(wsServer)
+```
+
+## 开发
+
+### 项目结构
+
+```
+src/
+├── index.ts      # 主入口，服务器初始化
+└── router.ts     # Router类实现
+```
+
+### 构建
+
+```bash
+npm run build  # 构建插件
+npm run clean  # 清理构建文件
+```
+
+## 依赖项
+
+### 核心依赖
+- `@koa/router` - Koa路由器
+- `koa` - Koa.js框架
+- `ws` - WebSocket库
+- `koa-basic-auth` - 基础认证中间件
+- `koa-bodyparser` - 请求体解析中间件
+
+### 对等依赖
+- `zhin.js` - Zhin核心框架
+
+## 安全考虑
+
+- 🔐 默认启用身份验证
+- 🛡️ 请求体大小限制
+- 🔒 WebSocket连接验证
+- 📝 访问日志记录
+
+## 使用场景
+
+- 🌐 HTTP API服务
+- 📊 管理后台接口  
+- 📡 实时数据推送
+- 🔧 Webhook接收
+- 📱 移动应用后端
+
+## 许可证
+
+MIT License

package/lib/index.d.ts

@@ -0,0 +1,12 @@
+import { Server } from 'http';
+import Koa from 'koa';
+import { Router } from './router.js';
+export * from './router.js';
+declare module '@zhin.js/types' {
+    interface GlobalContext {
+        koa: Koa;
+        router: Router;
+        server: Server;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,MAAM,EAAE,MAAM,MAAM,CAAC;AAC5C,OAAO,GAAG,MAAM,KAAK,CAAC;AAGtB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,cAAc,aAAa,CAAC;AAE5B,OAAO,QAAQ,gBAAgB,CAAA;IAC7B,UAAU,aAAa;QACrB,GAAG,EAAE,GAAG,CAAC;QACT,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAA;KACf;CACF"}

package/lib/index.js

@@ -0,0 +1,200 @@
+import { register, useApp } from '@zhin.js/core';
+import { createServer } from 'http';
+import Koa from 'koa';
+import auth from 'koa-basic-auth';
+import KoaBodyParser from 'koa-bodyparser';
+import { Router } from './router.js';
+import * as process from 'process';
+export * from './router.js';
+const koa = new Koa();
+const server = createServer(koa.callback());
+const router = new Router(server, { prefix: process.env.routerPrefix || '' });
+const username = process.env.username || 'admin';
+const password = process.env.password || '123456';
+const app = useApp();
+koa.use(auth({
+    name: username,
+    pass: password,
+}));
+// ============================================================================
+// API 路由
+// ============================================================================
+// 系统状态 API
+router.get('/api/system/status', async (ctx) => {
+    try {
+        ctx.body = {
+            success: true,
+            data: {
+                uptime: process.uptime(),
+                memory: process.memoryUsage(),
+                cpu: process.cpuUsage(),
+                platform: process.platform,
+                nodeVersion: process.version,
+                pid: process.pid,
+                timestamp: new Date().toISOString()
+            }
+        };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// 健康检查 API
+router.get('/api/health', async (ctx) => {
+    ctx.body = {
+        success: true,
+        status: 'ok',
+        timestamp: new Date().toISOString()
+    };
+});
+// 插件管理 API
+router.get('/api/plugins', async (ctx) => {
+    try {
+        // 获取详细的插件数据
+        const plugins = app.dependencyList.map(dep => {
+            return {
+                name: dep.name,
+                command_count: dep.commands.length,
+                component_count: dep.components.size,
+                middleware_count: dep.middlewares.length,
+                context_count: dep.contexts.size,
+            };
+        });
+        ctx.body = { success: true, data: plugins };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// 适配器管理 API
+router.get('/api/adapters', async (ctx) => {
+    try {
+        // 模拟适配器数据
+        const adapters = app.contextList.map(ctx => {
+            return {
+                name: ctx.name,
+                desc: ctx.description,
+            };
+        });
+        ctx.body = { success: true, data: adapters };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// 框架配置信息 API
+router.get('/api/config', async (ctx) => {
+    try {
+        const config = app.getConfig();
+        ctx.body = { success: true, data: config };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// 消息发送 API
+router.post('/api/message/send', async (ctx) => {
+    try {
+        const body = ctx.request.body;
+        const { context, bot, id, type, content } = body;
+        if (!context || !bot || !id || !type || !content) {
+            ctx.status = 400;
+            ctx.body = {
+                success: false,
+                error: 'Missing required fields: context, bot, id, type, content'
+            };
+            return;
+        }
+        // 模拟发送消息（实际环境中会调用应用实例的sendMessage方法）
+        // console.log 已替换为注释
+        ctx.body = {
+            success: true,
+            message: 'Message sent successfully',
+            data: { context, bot, id, type, content, timestamp: new Date().toISOString() }
+        };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// 日志 API
+router.get('/api/logs', async (ctx) => {
+    try {
+        // 模拟日志数据
+        const logs = [
+            {
+                level: 'info',
+                message: 'HTTP服务器启动成功',
+                timestamp: new Date(Date.now() - 60000).toISOString(),
+                source: 'http'
+            },
+            {
+                level: 'info',
+                message: 'Web控制台已就绪',
+                timestamp: new Date(Date.now() - 50000).toISOString(),
+                source: 'console'
+            },
+            {
+                level: 'warn',
+                message: 'KOOK适配器连接不稳定',
+                timestamp: new Date(Date.now() - 30000).toISOString(),
+                source: 'kook'
+            },
+            {
+                level: 'error',
+                message: 'ICQQ登录失败',
+                timestamp: new Date(Date.now() - 20000).toISOString(),
+                source: 'icqq'
+            }
+        ];
+        ctx.body = { success: true, data: logs };
+    }
+    catch (error) {
+        ctx.status = 500;
+        ctx.body = { success: false, error: error.message };
+    }
+});
+// ============================================================================
+// 上下文注册
+// ============================================================================
+register({
+    name: 'server',
+    description: "http server",
+    mounted(p) {
+        return new Promise((resolve) => {
+            server.listen({
+                host: '0.0.0.0',
+                port: Number((process.env.port ||= '8086')),
+            }, () => {
+                const address = server.address();
+                if (!address)
+                    return;
+                const visitAddress = typeof address === 'string' ? address : `${address.address}:${address.port}`;
+                p.logger.info(`server is running at http://${visitAddress}`);
+                p.logger.info('your username is：', username);
+                p.logger.info('your password is：', password);
+                resolve(server);
+            });
+        });
+    },
+    dispose(s) {
+        s.close();
+    }
+});
+register({
+    name: "koa",
+    description: "koa instance",
+    value: koa
+});
+register({
+    name: 'router',
+    description: "koa router",
+    value: router
+});
+koa.use(KoaBodyParser()).use(router.routes()).use(router.allowedMethods());
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/router.d.ts

@@ -0,0 +1,17 @@
+import { Layer, RouterOptions } from '@koa/router';
+import KoaRouter from "@koa/router";
+import * as http from 'http';
+import { ServerOptions, WebSocketServer } from 'ws';
+type Path = string | RegExp;
+export declare class Router extends KoaRouter {
+    server: http.Server;
+    wsStack: WebSocketServer[];
+    whiteList: Path[];
+    constructor(server: http.Server, options?: RouterOptions);
+    register(...args: Parameters<KoaRouter['register']>): Layer;
+    destroy(layer: Layer): void;
+    destroyWs(wsServer: WebSocketServer): void;
+    ws(path: string, options?: Omit<ServerOptions, 'noServer' | 'path'>): WebSocketServer;
+}
+export {};
+//# sourceMappingURL=router.d.ts.map

package/lib/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAGpD,KAAK,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5B,qBAAa,MAAO,SAAQ,SAAS;IAI1B,MAAM,EAAE,IAAI,CAAC,MAAM;IAH5B,OAAO,EAAE,eAAe,EAAE,CAAM;IAChC,SAAS,EAAE,IAAI,EAAE,CAAM;gBAEd,MAAM,EAAE,IAAI,CAAC,MAAM,EAC1B,OAAO,CAAC,EAAE,aAAa;IAKzB,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAMnD,OAAO,CAAC,KAAK,EAAE,KAAK;IAIpB,SAAS,CAAC,QAAQ,EAAE,eAAe;IAKnC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,MAAM,CAAM,GAAG,eAAe;CAoB1F"}

package/lib/router.js

@@ -0,0 +1,46 @@
+import { remove } from '@zhin.js/core';
+import KoaRouter from "@koa/router";
+import { WebSocketServer } from 'ws';
+import { parse } from 'url';
+export class Router extends KoaRouter {
+    server;
+    wsStack = [];
+    whiteList = []; //用于historyApi排除
+    constructor(server, options) {
+        super(options);
+        this.server = server;
+    }
+    register(...args) {
+        const path = args[0];
+        this.whiteList.push(path);
+        return super.register(...args);
+    }
+    destroy(layer) {
+        remove(this.stack, layer);
+    }
+    destroyWs(wsServer) {
+        wsServer.close();
+        remove(this.wsStack, wsServer);
+    }
+    ws(path, options = {}) {
+        const wsServer = new WebSocketServer({
+            noServer: true,
+            path,
+            ...options,
+        });
+        this.wsStack.push(wsServer);
+        this.server.on('upgrade', (request, socket, head) => {
+            const { pathname } = parse(request.url);
+            if (this.wsStack.findIndex(wss => wss.options.path === path) === -1) {
+                socket.destroy();
+            }
+            else if (pathname === path) {
+                wsServer.handleUpgrade(request, socket, head, ws => {
+                    wsServer.emit('connection', ws, request);
+                });
+            }
+        });
+        return wsServer;
+    }
+}
+//# sourceMappingURL=router.js.map

package/lib/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAiB,eAAe,EAAE,MAAM,IAAI,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAI5B,MAAM,OAAO,MAAO,SAAQ,SAAS;IAI1B;IAHT,OAAO,GAAsB,EAAE,CAAC;IAChC,SAAS,GAAW,EAAE,CAAC,CAAC,gBAAgB;IACxC,YACS,MAAmB,EAC1B,OAAuB;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,WAAM,GAAN,MAAM,CAAa;IAI5B,CAAC;IAED,QAAQ,CAAC,GAAG,IAAuC;QACjD,MAAM,IAAI,GAAS,IAAI,CAAC,CAAC,CAAQ,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,KAAY;QAClB,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,SAAS,CAAC,QAAyB;QACjC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,EAAE,CAAC,IAAY,EAAE,UAAoD,EAAE;QACrE,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;YACnC,QAAQ,EAAE,IAAI;YACd,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5B,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YACnD,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAI,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACpE,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;iBAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC7B,QAAQ,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE;oBACjD,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC3C,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@zhin.js/http",
+  "version": "1.0.1",
+  "description": "Zhin机器人框架HTTP工具",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "dependencies": {
+    "@koa/router": "latest",
+    "koa": "latest",
+    "ws": "^8.18.3",
+    "koa-basic-auth": "latest",
+    "koa-bodyparser": "latest"
+  },
+  "peerDependencies": {
+    "@zhin.js/core": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/koa": "latest",
+    "@types/koa-basic-auth": "latest",
+    "@types/koa-bodyparser": "latest",
+    "@types/koa__router": "latest",
+    "@types/ws": "latest",
+    "@zhin.js/types": "^1.0.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf lib"
+  }
+}

package/src/index.ts

@@ -0,0 +1,227 @@
+import {register, useApp} from '@zhin.js/core';
+import { createServer, Server } from 'http';
+import Koa from 'koa';
+import auth from 'koa-basic-auth';
+import KoaBodyParser from 'koa-bodyparser';
+import { Router } from './router.js';
+import * as process from 'process';
+
+export * from './router.js';
+
+declare module '@zhin.js/types'{
+  interface GlobalContext {
+    koa: Koa,
+    router: Router,
+    server: Server
+  }
+}
+
+const koa = new Koa();
+const server = createServer(koa.callback())
+const router = new Router(server, { prefix: process.env.routerPrefix || '' });
+const username = process.env.username || 'admin';
+const password = process.env.password || '123456';
+const app=useApp()
+koa.use(
+  auth({
+    name: username,
+    pass: password,
+  }),
+);
+
+// ============================================================================
+// API 路由
+// ============================================================================
+
+// 系统状态 API
+router.get('/api/system/status', async (ctx) => {
+  try {
+    ctx.body = {
+      success: true,
+      data: {
+        uptime: process.uptime(),
+        memory: process.memoryUsage(),
+        cpu: process.cpuUsage(),
+        platform: process.platform,
+        nodeVersion: process.version,
+        pid: process.pid,
+        timestamp: new Date().toISOString()
+      }
+    }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// 健康检查 API
+router.get('/api/health', async (ctx) => {
+  ctx.body = { 
+    success: true, 
+    status: 'ok', 
+    timestamp: new Date().toISOString() 
+  }
+})
+
+// 插件管理 API
+router.get('/api/plugins', async (ctx) => {
+  try {
+    // 获取详细的插件数据
+    const plugins = app.dependencyList.map(dep => {
+      return {
+        name:dep.name,
+        command_count:dep.commands.length,
+        component_count:dep.components.size,
+        middleware_count:dep.middlewares.length,
+        context_count:dep.contexts.size,
+      }
+    })
+    
+    ctx.body = { success: true, data: plugins }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// 适配器管理 API
+router.get('/api/adapters', async (ctx) => {
+  try {
+    // 模拟适配器数据
+    const adapters = app.contextList.map(ctx=>{
+      return {
+        name:ctx.name,
+        desc:ctx.description,
+      }
+    })
+    
+    ctx.body = { success: true, data: adapters }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// 框架配置信息 API
+router.get('/api/config', async (ctx) => {
+  try {
+    const config = app.getConfig()
+    
+    ctx.body = { success: true, data: config }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// 消息发送 API
+router.post('/api/message/send', async (ctx) => {
+  try {
+    const body = ctx.request.body as any
+    const { context, bot, id, type, content } = body
+    
+    if (!context || !bot || !id || !type || !content) {
+      ctx.status = 400
+      ctx.body = { 
+        success: false, 
+        error: 'Missing required fields: context, bot, id, type, content' 
+      }
+      return
+    }
+    
+    // 模拟发送消息（实际环境中会调用应用实例的sendMessage方法）
+    // console.log 已替换为注释
+    
+    ctx.body = {
+      success: true,
+      message: 'Message sent successfully',
+      data: { context, bot, id, type, content, timestamp: new Date().toISOString() }
+    }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// 日志 API
+router.get('/api/logs', async (ctx) => {
+  try {
+    // 模拟日志数据
+    const logs = [
+      {
+        level: 'info',
+        message: 'HTTP服务器启动成功',
+        timestamp: new Date(Date.now() - 60000).toISOString(),
+        source: 'http'
+      },
+      {
+        level: 'info', 
+        message: 'Web控制台已就绪',
+        timestamp: new Date(Date.now() - 50000).toISOString(),
+        source: 'console'
+      },
+      {
+        level: 'warn',
+        message: 'KOOK适配器连接不稳定',
+        timestamp: new Date(Date.now() - 30000).toISOString(),
+        source: 'kook'
+      },
+      {
+        level: 'error',
+        message: 'ICQQ登录失败',
+        timestamp: new Date(Date.now() - 20000).toISOString(),
+        source: 'icqq'
+      }
+    ]
+    
+    ctx.body = { success: true, data: logs }
+  } catch (error) {
+    ctx.status = 500
+    ctx.body = { success: false, error: (error as Error).message }
+  }
+})
+
+// ============================================================================
+// 上下文注册
+// ============================================================================
+
+register({
+  name: 'server',
+  description:"http server",
+  mounted(p) {
+    return new Promise<Server>((resolve) => {
+      server.listen(
+        {
+          host: '0.0.0.0',
+          port: Number((process.env.port ||= '8086')),
+        },
+        () => {
+          const address = server.address();
+          if (!address) return;
+          const visitAddress = typeof address === 'string' ? address : `${address.address}:${address.port}`;
+          p.logger.info(`server is running at http://${visitAddress}`);
+          p.logger.info('your username is：', username);
+          p.logger.info('your password is：', password);
+          resolve(server)
+        },
+      )
+    })
+  },
+  dispose(s) {
+    s.close()
+  }
+})
+
+register({
+  name: "koa",
+  description:"koa instance",
+  value: koa
+})
+
+register({
+  name: 'router',
+  description:"koa router",
+  value: router
+})
+
+koa.use(KoaBodyParser()).use(router.routes()).use(router.allowedMethods());

package/src/router.ts

@@ -0,0 +1,55 @@
+import { remove } from '@zhin.js/core';
+import { Layer, RouterOptions } from '@koa/router';
+import KoaRouter from "@koa/router";
+import * as http from 'http';
+import { ServerOptions, WebSocketServer } from 'ws';
+import { parse } from 'url';
+
+type Path = string | RegExp;
+
+export class Router extends KoaRouter {
+  wsStack: WebSocketServer[] = [];
+  whiteList: Path[] = []; //用于historyApi排除
+  constructor(
+    public server: http.Server,
+    options?: RouterOptions,
+  ) {
+    super(options);
+  }
+
+  register(...args: Parameters<KoaRouter['register']>) {
+    const path: Path = args[0] as any;
+    this.whiteList.push(path);
+    return super.register(...args);
+  }
+
+  destroy(layer: Layer) {
+    remove(this.stack, layer);
+  }
+
+  destroyWs(wsServer: WebSocketServer) {
+    wsServer.close();
+    remove(this.wsStack, wsServer);
+  }
+
+  ws(path: string, options: Omit<ServerOptions, 'noServer' | 'path'> = {}): WebSocketServer {
+    const wsServer = new WebSocketServer({
+      noServer: true,
+      path,
+      ...options,
+    });
+    this.wsStack.push(wsServer);
+
+    this.server!.on('upgrade', (request, socket, head) => {
+      const { pathname } = parse(request.url!);
+      if (this.wsStack.findIndex(wss => wss.options.path === path) === -1) {
+        socket.destroy();
+      } else if (pathname === path) {
+        wsServer.handleUpgrade(request, socket, head, ws => {
+          wsServer.emit('connection', ws, request);
+        });
+      }
+    });
+    return wsServer;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "outDir": "./lib",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["lib", "node_modules"]
+}