alemonjs 1.0.0

package/lib/ntqq/sdk/web/client.js

@@ -0,0 +1,89 @@
+import Koa from 'koa';
+import Router from 'koa-router';
+import bodyParser from 'koa-bodyparser';
+import { mkdirSync } from 'fs';
+import { getLocalImg } from './img.js';
+import { setWebConfig } from '../config.js';
+/**
+ * 创建客户端
+ * @param param0
+ * @param callBack
+ * @param logFnc
+ */
+export function createWeb({ callback_port = 9090, img_size = 9999999, http = 'http', img_url = '/api/mys/img', IMAGE_DIR = '/data/mys/img' }, logFnc) {
+    /**
+     * 创建 Koa 应用
+     */
+    const app = new Koa();
+    const router = new Router();
+    /**
+     * 处理 POST 请求体中的 JSON 数据
+     */
+    app.use(bodyParser());
+    /**
+     * 确保目录存在
+     */
+    mkdirSync(IMAGE_DIR, { recursive: true });
+    mkdirSync(img_url, { recursive: true });
+    /**
+     * 处理图片请求
+     */
+    router.get(`${img_url}/:filename`, getLocalImg);
+    /**
+     * 将路由注册到应用
+     */
+    app.use(router.routes());
+    app.use(router.allowedMethods());
+    let currentPort = callback_port;
+    let size = 0;
+    /**
+     * 错误处理
+     * @param err
+     * @returns
+     */
+    function handlePortConflict(err) {
+        if (err.code === 'EADDRINUSE') {
+            console.error(`端口 ${currentPort} 被占用，尝试启动新的端口...`);
+            currentPort++;
+            size++;
+            if (size >= 10) {
+                console.error('寻端失败~');
+                return;
+            }
+            createApp(currentPort);
+        }
+        else {
+            console.error('启动应用程序时发生错误：', err);
+        }
+    }
+    /**
+     * 创建应用
+     * @param port
+     */
+    function createApp(port) {
+        /**
+         * 设置配置
+         */
+        setWebConfig({
+            callback_port: port,
+            img_url,
+            http,
+            img_size,
+            IMAGE_DIR
+        });
+        /**
+         * 启动应用
+         */
+        app
+            .listen(port, async () => {
+            if (logFnc) {
+                await logFnc(port);
+            }
+        })
+            .on('error', handlePortConflict);
+    }
+    /**
+     * 启动应用
+     */
+    createApp(currentPort);
+}

package/lib/ntqq/sdk/web/img.js

@@ -0,0 +1,76 @@
+import { createReadStream, writeFileSync, readdirSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { fileTypeFromBuffer } from 'file-type';
+import { getWebConfig } from '../config.js';
+/**
+ * 处理图片请求
+ * @param req
+ * @param res
+ */
+export function getLocalImg(ctx) {
+    const cfg = getWebConfig();
+    const filename = ctx.params.filename;
+    const imagePath = join(cfg.IMAGE_DIR, filename);
+    try {
+        const stream = createReadStream(imagePath);
+        ctx.set('Content-Type', 'image/jpeg');
+        ctx.body = stream;
+    }
+    catch (error) {
+        ctx.status = 404;
+        ctx.body = 'Not Found';
+    }
+}
+/**
+ * 自动清除机制
+ * 清除挂载下的所有图片
+ * 'jpg', 'jpeg', 'png', 'gif'
+ * @param time
+ */
+export function autoClearImages(time) {
+    /**
+     * 得到配置
+     */
+    const cfg = getWebConfig();
+    /**
+     * 启动清除
+     */
+    setInterval(() => {
+        const files = readdirSync(cfg.IMAGE_DIR);
+        for (const file of files) {
+            const extname = file.split('.').pop();
+            if (['jpg', 'jpeg', 'png', 'gif'].includes(extname.toLowerCase())) {
+                const filePath = join(cfg.IMAGE_DIR, file);
+                unlinkSync(filePath);
+            }
+        }
+    }, time);
+}
+/**
+ * 存储图片
+ * @param Buffer 元素
+ */
+export async function setLocalImg(img) {
+    /**
+     * 检查参数是否有效
+     */
+    if (!img)
+        return false;
+    /**
+     * 得到配置
+     */
+    const cfg = getWebConfig();
+    /**
+     * 生成文件名
+     */
+    const filename = `${Math.floor(Math.random() * cfg.img_size)}.${(await fileTypeFromBuffer(img))?.ext}`;
+    /**
+     * 文件路径
+     */
+    const imagePath = join(cfg.IMAGE_DIR, filename);
+    /**
+     * 将图片保存到文件系统中
+     */
+    writeFileSync(imagePath, img);
+    return `${cfg.img_url}/${filename}`;
+}

package/lib/ntqq/sdk/web/index.js

@@ -0,0 +1,4 @@
+export * from './client.js';
+export * from '../types.js';
+export * from './img.js';
+export * from './ip.js';

package/lib/ntqq/sdk/web/ip.js

@@ -0,0 +1,24 @@
+import { publicIp } from 'public-ip';
+/**
+ * 得到ip地址
+ * @returns
+ */
+export async function getIP() {
+    const ip = await publicIp({
+        onlyHttps: true,
+        timeout: 10000
+    })
+        .then((ip) => {
+        if (/^(\d{1,3}\.){3}\d{1,3}$/.test(ip)) {
+            return ip;
+        }
+        else {
+            return false;
+        }
+    })
+        .catch(err => {
+        console.error(err);
+        process.exit();
+    });
+    return ip;
+}

package/lib/ntqq/sdk/wss.js

@@ -0,0 +1,178 @@
+import WebSocket from 'ws';
+import { requestService } from './api.js';
+import { getBotConfig } from './config.js';
+import { getIntentsMask } from './intents.js';
+/**
+ * @param token  token
+ * @returns
+ */
+export async function getGatewayUrl() {
+    try {
+        const response = await requestService({
+            url: '/gateway'
+        }).then(res => res.data);
+        if (response.url) {
+            return response.url;
+        }
+        else {
+            console.error('[http] err:', null);
+        }
+    }
+    catch (error) {
+        console.error('[token] err:', error.message);
+    }
+}
+let reconnectAttempts = 0; // 重新连接计数器
+/**
+ * 使用获取到的网关连接地址建立 WebSocket 连接
+ * @param token
+ * @param callBack
+ */
+export async function createClient(call, shard = [0, 1]) {
+    /**
+     * 请求url
+     */
+    const gatewayUrl = await getGatewayUrl();
+    // 重新连接的逻辑
+    const reconnect = async () => {
+        if (reconnectAttempts >= 5) {
+            console.info('已达到最大重连次数，取消重新连接');
+            return;
+        }
+        console.info('正在重新连接...');
+        // 延迟一段时间后发起重新连接
+        await new Promise(resolve => setTimeout(resolve, 5000));
+        // 调用createClient函数重新建立连接
+        await createClient(call, shard);
+        reconnectAttempts++; // 递增重连计数器
+    };
+    if (gatewayUrl) {
+        const ws = new WebSocket(gatewayUrl);
+        ws.on('open', () => {
+            console.info('[token] ok');
+        });
+        /**
+         * 标记是否已连接
+         */
+        let isConnected = false;
+        /**
+         * 存储最新的消息序号
+         */
+        let heartbeat_interval = 30000;
+        /**
+         * 鉴权
+         */
+        let power;
+        /**
+         * 监听消息
+         */
+        ws.on('message', async (msg) => {
+            const message = JSON.parse(msg.toString('utf8'));
+            /**
+             * opcode
+             *
+             * s 标识消息的唯一性
+             *
+             * t 代表事件类型
+             *
+             * d 代表事件内容
+             */
+            const { op, s, d: data, t } = message;
+            // 根据 opcode 进行处理
+            switch (op) {
+                case 0: {
+                    console.log('[数据接收]', data);
+                    // 存在,则执行t对应的函数
+                    if (Object.prototype.hasOwnProperty.call(call, t)) {
+                        call[t](data);
+                    }
+                    // Ready Event，鉴权成功
+                    if (t === 'READY') {
+                        power = setInterval(() => {
+                            if (isConnected) {
+                                ws.send(JSON.stringify({
+                                    op: 1,
+                                    d: null // 如果是第一次连接，传null
+                                }));
+                            }
+                        }, heartbeat_interval);
+                    }
+                    // Resumed Event，恢复连接成功
+                    if (t === 'RESUMED') {
+                        console.info('恢复连接');
+                        // 重制次数
+                        reconnectAttempts = 0;
+                    }
+                    break;
+                }
+                case 6: {
+                    console.info('[连接尝试]', message);
+                    break;
+                }
+                case 7: {
+                    // 执行重新连接
+                    console.info('[重新连接]', message);
+                    // 取消鉴权发送
+                    if (power) {
+                        clearInterval(power);
+                    }
+                    await reconnect();
+                    break;
+                }
+                case 9: {
+                    console.info('[参数错误]', message);
+                    break;
+                }
+                case 10: {
+                    // 重制次数
+                    isConnected = true;
+                    heartbeat_interval = data.heartbeat_interval;
+                    const { token, intents } = getBotConfig();
+                    /**
+                     * 发送鉴权
+                     */
+                    ws.send(JSON.stringify({
+                        op: 2,
+                        d: {
+                            token: `QQBot ${token}`,
+                            intents: getIntentsMask(intents),
+                            shard,
+                            properties: {
+                                $os: 'linux',
+                                $browser: 'my_library',
+                                $device: 'my_library'
+                            }
+                        }
+                    }));
+                    reconnectAttempts = 0;
+                    break;
+                }
+                case 11: {
+                    // OpCode 11 Heartbeat ACK 消息，心跳发送成功
+                    console.info('[心跳发送]', message);
+                    break;
+                }
+                case 12: {
+                    console.info('[平台数据]', message);
+                }
+            }
+        });
+        ws.on('close', () => {
+            console.info('[ws] close');
+        });
+    }
+}
+/**
+
+1	Heartbeat	Send/Receive	客户端或服务端发送心跳
+2	Identify	Send	客户端发送鉴权
+6	Resume	Send	客户端恢复连接
+
+0	Dispatch	Receive	服务端进行消息推送
+7	Reconnect	Receive	服务端通知客户端重新连接
+9	Invalid Session	Receive	当identify或resume的时候，如果参数有错，服务端会返回该消息
+10	Hello	Receive	当客户端与网关建立ws连接之后，网关下发的第一条消息
+11	Heartbeat ACK	Receive/Reply	当发送心跳成功之后，就会收到该消息
+12	HTTP Callback ACK	Reply	仅用于 http 回调模式的回包，代表机器人收到了平台推送的数据
+
+ */

package/lib/qq/alemon/apidoc.js

@@ -0,0 +1,216 @@
+/**
+ * **********
+ * 频道api
+ * ************
+ */
+/**
+ * 获取当前用户下的所有频道列表
+ * @returns
+ */
+export const getGuildList = async () => {
+    const data = await clientApiByQQ.meApi
+        .meGuilds()
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * 获取频道详情
+ * @param guildId
+ * **************
+id	string	频道 ID
+name	string	频道名称
+owner_id	string	创建人用户 ID
+owner	boolean	当前人是否是创建人
+member_count	number	成员数
+max_members	number	最大成员数
+description	string	描述
+ */
+export const getGuildMsg = async (guildId) => {
+    const data = await clientApiByQQ.guildApi
+        .guild(guildId)
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * *****************
+ * 子频道api
+ * *****************
+ */
+/**
+ * 获取子频道列表
+ * @param guildId
+ * @returns
+ * ***********
+id	string	子频道 ID
+guild_id	string	频道 ID
+name	string	子频道名
+type	number	子频道类型 ChannelType
+sub_type	number	子频道子类型 ChannelSubType
+position	number	排序，非必填
+parent_id	string	分组 ID
+owner_id	string	创建人 ID
+ */
+export const getChannels = async (guildId) => {
+    const data = await clientApiByQQ.channelApi
+        .channels(guildId)
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * 获取子频道详情
+ * @param channelId
+ * @returns
+id	string	子频道 ID
+guild_id	string	频道 ID
+name	string	子频道名
+type	number	子频道类型 ChannelType
+sub_type	number	子频道子类型 ChannelSubType
+position	number	排序，非必填
+parent_id	string	分组 ID
+owner_id	string	创建人 ID
+ */
+export const getChannel = async (channelId) => {
+    const data = await clientApiByQQ.channelApi
+        .channel(channelId)
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * ***********
+ * 仅私域可用,毫无用处
+ * ***********
+ * 创建子频道
+ * 修改子频道
+ * 删除子频道
+ */
+/**
+ * ********
+ * 成员api
+ * **********
+ */
+/***
+ * 获取频道下的成员列表:仅私域可用
+ */
+/**
+ *获取频道下某个成员的信息
+ * @param guildId 频道
+ * @param userId 用户
+ * @returns
+ * 次功能已在e消息中携带
+ */
+export const getGuildMemberMsg = async (guildId, userId) => {
+    const data = await clientApiByQQ.guildApi
+        .guildMember(guildId, userId)
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * 移除频道的某个成员
+ * 仅私域
+ */
+/**
+ * 用于获取 channelID 指定的语音子频道中，所有在线成员的详情列表
+ * 仅私域
+ */
+/**
+ * ***************
+ * 频道身份组api
+ * ***********
+ */
+/**
+ * **********
+ * 子频道权限api
+ * *********
+ * /
+
+
+/**
+ * *******
+ * 消息api
+ * *****
+ */
+/**
+ * 撤回指定消息
+ * @param channelID
+ * @param messageID
+ * @param hideTip 是否隐藏
+ * @returns
+ */
+export const deleteMsg = async (channelID, messageID, hideTip) => {
+    const data = await clientApiByQQ.messageApi
+        .deleteMessage(channelID, messageID, hideTip)
+        .then(res => {
+        const { data } = res;
+        return data;
+    })
+        .catch(err => {
+        console.error(err);
+        return false;
+    });
+    return data;
+};
+/**
+ * *******
+ * 私信api
+ * ********
+ */
+/**
+ * ******
+ * 群精华api
+ * ********
+ */
+/**
+ * *****
+ * 日程api
+ * *****
+ */
+/**
+ * *******
+ *音频api
+ * ******
+ */
+/**
+ * ******
+ * 禁言api
+ * ****
+ */
+/**
+ * ***********
+ * 权限接口api
+ * ********
+ */

package/lib/qq/alemon/bot.js

@@ -0,0 +1,11 @@
+let bot = {
+    id: '',
+    name: '',
+    avatar: 'string'
+};
+export function setBotMsgByQQ(val) {
+    bot = val;
+}
+export function getBotMsgByQQ() {
+    return bot;
+}

package/lib/qq/alemon/console.js

@@ -0,0 +1,13 @@
+const info = console.info;
+/**
+ * 屏蔽错误反馈
+ * @param args
+ */
+console.info = (...args) => {
+    if (args[0] !== '[CLIENT] 心跳校验' &&
+        args[0] !== '[CLIENT] 超过重试次数，连接终止' &&
+        args[0] !== '[ERROR] createSession: ') {
+        info(...args);
+    }
+};
+export {};