node-karin 0.10.5 → 0.10.7

package/lib/adapter/input/index.js

@@ -112,7 +112,7 @@ export class AdapterInput {
         }
         const buffer = await common.buffer(file);
         // 生成文件名 根据type生成不同的文件后缀
-        const name = `${Date.now()}.${type === 'image' ? 'jpg' : type === 'voice' ? 'mp3' : 'file'}`;
+        const name = `${Date.now()}.${type === 'image' ? 'jpg' : type === 'record' ? 'mp3' : 'file'}`;
         fs.writeFileSync(`./temp/input/${name}`, buffer);
         return `[${type === 'image' ? '图片' : '语音'}: http://${ip}:${config.Server.http.port}/api/input?name=${name}&token=${this.token} ]`;
     }
@@ -135,7 +135,7 @@ export class AdapterInput {
                     text.push(v.text);
                     break;
                 case 'image':
-                case 'voice':
+                case 'record':
                     text.push(await this.#MsgToFile(v.type, v.file));
                     break;
                 default:

package/lib/adapter/onebot/11/convert.d.ts

@@ -1,3 +1,4 @@
+import { AdapterOneBot11 } from './index.js';
 import { KarinElement, OB11Segment } from '../../../types/index.js';
 /**
    * onebot11转karin
@@ -8,4 +9,4 @@ export declare function AdapterConvertKarin(data: Array<OB11Segment>): Array<Kar
    * karin转onebot11
    * @param data karin格式消息
    */
-export declare function KarinConvertAdapter(data: Array<KarinElement>): Array<OB11Segment>;
+export declare function KarinConvertAdapter(data: Array<KarinElement>, bot: AdapterOneBot11): Array<OB11Segment>;

package/lib/adapter/onebot/11/convert.js

@@ -1,3 +1,4 @@
+import fs from 'fs';
 import { segment } from '../../../utils/index.js';
 /**
    * onebot11转karin
@@ -53,11 +54,22 @@ export function AdapterConvertKarin(data) {
     }
     return elements;
 }
+/**
+ * 处理非本地ws的文件
+ * @param file 文件路径
+ */
+function fileToBase64(file, bot) {
+    if (!bot || !file.startsWith('file://') || !bot.adapter.connect)
+        return file;
+    const list = ['127.0.0.1', 'localhost'];
+    const url = new URL(bot.adapter.connect);
+    return list.includes(url.hostname) ? `base64://${fs.readFileSync(file).toString('base64')}` : file;
+}
 /**
    * karin转onebot11
    * @param data karin格式消息
    */
-export function KarinConvertAdapter(data) {
+export function KarinConvertAdapter(data, bot) {
     const elements = [];
     for (const i of data) {
         const type = i.type;
@@ -77,7 +89,7 @@ export function KarinConvertAdapter(data) {
             case "image" /* OB11SegmentType.Image */:
             case "video" /* OB11SegmentType.Video */:
             case "file" /* OB11SegmentType.File */: {
-                elements.push({ type, data: { file: i.file } });
+                elements.push({ type, data: { file: fileToBase64(i.file, bot) } });
                 break;
             }
             case "xml" /* OB11SegmentType.Xml */: {
@@ -93,7 +105,7 @@ export function KarinConvertAdapter(data) {
                 break;
             }
             case "record" /* OB11SegmentType.Record */: {
-                elements.push({ type, data: { file: i.file, magic: i.magic || false } });
+                elements.push({ type, data: { file: fileToBase64(i.file, bot), magic: i.magic || false } });
                 break;
             }
             case "music" /* OB11SegmentType.Music */: {
@@ -106,21 +118,6 @@ export function KarinConvertAdapter(data) {
                 }
                 break;
             }
-            case 'button': {
-                elements.push({ type: 'button', data: i.data });
-                break;
-            }
-            case 'markdown': {
-                const { type, ...data } = i;
-                elements.push({ type, data: { ...data } });
-                break;
-            }
-            case 'rows': {
-                for (const val of i.rows) {
-                    elements.push({ type: 'button', data: val.data });
-                }
-                break;
-            }
             case "poke" /* OB11SegmentType.Poke */: {
                 elements.push({ type, data: { type: i.poke_type, id: i.id } });
                 break;
@@ -157,6 +154,9 @@ export function KarinConvertAdapter(data) {
                 elements.push({ type: 'weather', data: { city: i.city, type: i.type } });
                 break;
             }
+            case 'button':
+            case 'markdown':
+            case 'keyboard':
             default: {
                 elements.push(i);
                 break;

package/lib/adapter/onebot/11/index.js

@@ -137,7 +137,7 @@ export class AdapterOneBot11 {
      * @param data karin格式消息
      */
     KarinConvertAdapter(data) {
-        return KarinConvertAdapter(data);
+        return KarinConvertAdapter(data, this);
     }
     /**
      * 专属当前Bot的日志打印方法

package/lib/core/listener/listener.d.ts

@@ -3,7 +3,7 @@ import { KarinAdapter, Contact, KarinElement } from '../../types/index.js';
 /**
  * 监听器管理
  */
-declare class Listeners extends EventEmitter {
+export declare class Listeners extends EventEmitter {
     #private;
     /**
      * Bot索引
@@ -103,4 +103,3 @@ declare class Listeners extends EventEmitter {
 }
 export declare const listener: Listeners;
 export declare const Bot: Listeners;
-export {};

package/lib/core/listener/listener.js

@@ -6,7 +6,7 @@ import { MessageHandler, NoticeHandler, RequestHandler } from '../../event/index
 /**
  * 监听器管理
  */
-class Listeners extends EventEmitter {
+export class Listeners extends EventEmitter {
     /**
      * Bot索引
      * @type - Bot索引

package/lib/event/handler/message.js

@@ -108,8 +108,11 @@ export class MessageHandler extends EventBaseHandler {
                     logs.push(`[face:${val.id}]`);
                     break;
                 case 'video':
+                    logs.push(`[video:${val.file}]`);
+                    break;
                 case 'record':
-                    logs.push(`[${val.type}:${val.file}]`);
+                    this.e.record = val.file;
+                    logs.push(`[record:${val.file}]`);
                     break;
                 case 'image':
                     this.e.image.push(val.file);
@@ -186,11 +189,8 @@ export class MessageHandler extends EventBaseHandler {
                     logs.push(`[markdown_tpl:${JSON.stringify(content)}]`);
                     break;
                 }
-                case 'rows': {
-                    const rows = [];
-                    for (const v of val.rows)
-                        rows.push(JSON.stringify(v.data));
-                    logs.push(`[rows:${JSON.stringify(rows)}]`);
+                case 'keyboard': {
+                    logs.push(`[rows:${JSON.stringify(val.rows)}]`);
                     break;
                 }
                 case 'button':

package/lib/types/element/element.d.ts

@@ -1,4 +1,4 @@
-export type ElementType = 'text' | 'at' | 'face' | 'bubble_face' | 'reply' | 'image' | 'voice' | 'video' | 'basketball' | 'dice' | 'rps' | 'poke' | 'music' | 'weather' | 'location' | 'share' | 'gift' | 'market_face' | 'forward' | 'contact' | 'json' | 'xml' | 'file' | 'markdown' | 'markdown_tpl' | 'keyboard' | 'node' | 'rows' | 'record' | 'long_msg';
+export type ElementType = 'text' | 'at' | 'face' | 'bubble_face' | 'reply' | 'image' | 'video' | 'basketball' | 'dice' | 'rps' | 'poke' | 'music' | 'weather' | 'location' | 'share' | 'gift' | 'market_face' | 'forward' | 'contact' | 'json' | 'xml' | 'file' | 'markdown' | 'markdown_tpl' | 'keyboard' | 'node' | 'rows' | 'record' | 'long_msg';
 export interface Element {
     /**
      * - 元素类型
@@ -109,29 +109,6 @@ export interface ImageElement extends Element {
      */
     file_type: 'show' | 'flash' | 'original';
 }
-/**
- * - 语音元素
- * @deprecated 即将废弃 请使用segment.record
- */
-export interface VoiceElement extends Element {
-    type: 'voice';
-    /**
-     * - 语音文件url、路径或者base64
-     */
-    file: string;
-    /**
-     * - 是否为魔法语音
-     */
-    magic: boolean;
-    /**
-     * - 语音md5
-     */
-    md5?: string;
-    /**
-     * - 语音名称
-     */
-    name?: string;
-}
 /**
  * - 语音元素
  */
@@ -489,68 +466,81 @@ export interface MarkdownElement extends Element {
     content: string;
 }
 /**
- * - 按钮
+ * 单个按钮结构 这是karin的按钮结构 与qqbot的不同
+ */
+export interface Button {
+    /**
+     * - 按钮显示文本
+     */
+    text: string;
+    /**
+     * - 按钮类型 不建议使用 此为预留字段
+     */
+    type?: number;
+    /**
+     * - 是否为回调按钮
+     * @default false
+     */
+    callback?: boolean;
+    /**
+     * - 跳转按钮
+     */
+    link?: string;
+    /**
+     * - 操作相关的数据
+     */
+    data?: string;
+    /**
+     * - 按钮点击后显示的文字，不传为text
+     */
+    show?: string;
+    /**
+     * 按钮样式
+     * - 0-灰色线框
+     * - 1-蓝色线框
+     * - 2-特殊样式按钮
+     * - 3-红色文字
+     * - 4-白色填充
+     */
+    style?: number;
+    /**
+     * - 点击按钮后直接自动发送 data
+     */
+    enter?: boolean;
+    /**
+     * - 指令是否带引用回复本消息
+     */
+    reply?: boolean;
+    /**
+     * - 是否仅群管理员可操作
+     */
+    admin?: boolean;
+    /**
+     * - 有权限点击的用户UID列表 群聊、私聊
+     */
+    list?: string[];
+    /**
+     * - 有权限点击的用户UID列表 频道
+     */
+    role?: string[];
+    /**
+     * - 客户端不支持本 action 的时候，弹出的 toast 文案
+     */
+    tips?: string;
+}
+/**
+ * - 按钮 构建单行多个按钮
  */
 export interface ButtonElement {
     type: 'button';
-    data: {
-        /**
-         * - 按钮显示文本
-         */
-        text: string;
-        /**
-         * - 是否为回调按钮
-         * @default false
-         */
-        callback?: boolean;
-        /**
-         * - 跳转按钮
-         */
-        link?: string;
-        /**
-         * - 操作相关的数据
-         */
-        data?: string;
-        /**
-         * - 按钮点击后显示的文字，不传为text
-         */
-        show?: string;
-        /**
-         * - 按钮样式：0 灰色线框，1 蓝色线框
-         */
-        style?: number;
-        /**
-         * - 点击按钮后直接自动发送 data
-         */
-        enter?: boolean;
-        /**
-         * - 指令是否带引用回复本消息
-         */
-        reply?: boolean;
-        /**
-         * - 是否仅群管理员可操作
-         */
-        admin?: boolean;
-        /**
-         * - 有权限点击的用户UID列表 群聊、私聊
-         */
-        list?: string[];
-        /**
-         * - 有权限点击的用户UID列表 频道
-         */
-        role?: string[];
-        /**
-         * - 客户端不支持本 action 的时候，弹出的 toast 文案
-         */
-        tips?: string;
-    };
+    data: Array<Button>;
 }
 /**
- * - 按钮组
+ * - 按钮组 构建多行多个按钮
  */
-export interface RowElement extends Element {
-    type: 'rows';
-    rows: Array<ButtonElement>;
+export interface KeyBoardElement extends Element {
+    type: 'keyboard';
+    rows: Array<Array<Button>>;
 }
 /**
  * - 长消息元素
@@ -562,7 +552,7 @@ export interface LongMsgElement extends Element {
      */
     id: string;
 }
-export type KarinElement = TextElement | AtElement | FaceElement | BubbleFaceElement | ReplyElement | ImageElement | VoiceElement | VideoElement | BasketballElement | DiceElement | RpsElement | PokeElement | MusicElement | WeatherElement | LocationElement | ShareElement | GiftElement | MarketFaceElement | ForwardElement | ContactElement | JsonElement | XmlElement | FileElement | ButtonElement | RowElement | RecordElement | LongMsgElement | TplMarkdownElement | RawMarkdownElement;
+export type KarinElement = TextElement | AtElement | FaceElement | BubbleFaceElement | ReplyElement | ImageElement | VideoElement | BasketballElement | DiceElement | RpsElement | PokeElement | MusicElement | WeatherElement | LocationElement | ShareElement | GiftElement | MarketFaceElement | ForwardElement | ContactElement | JsonElement | XmlElement | FileElement | ButtonElement | KeyBoardElement | RecordElement | LongMsgElement | TplMarkdownElement | RawMarkdownElement;
 /**
  * - 构建自定义转发节点 此元素仅可通过专用接口发送 不支持混合发送
  */

package/lib/types/element/qqbot.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 原生Markdown消息结构
+ */
+export interface RawMarkdownType {
+    /** markdown文本 */
+    content: string;
+}
+/**
+ * 模板Markdown消息结构
+ */
+export interface TplMarkdownType {
+    /**
+    * - 模板ID
+    */
+    custom_template_id: string;
+    /**
+     * - 模板参数
+     */
+    params: Array<{
+        /**
+         * - 模板参数键名称
+         */
+        key: string;
+        /**
+         * - 模板参数值
+         */
+        values: Array<string>;
+    }>;
+}
+/**
+ * Markdown消息结构
+ * @param T 是否为原生结构
+ */
+export type MarkdownType<T extends boolean> = T extends true ? RawMarkdownType : TplMarkdownType;
+/**
+ * 原生keyboard消息结构
+ */
+export interface RawKeyboardType {
+    content: {
+        rows: Array<{
+            buttons: Array<ButtonType>;
+        }>;
+    };
+}
+/**
+ * 模板keyboard消息结构
+ */
+export interface TplKeyboardType {
+    /** 模板ID */
+    id: string;
+}
+/**
+ * 按钮消息结构
+ */
+export interface ButtonType {
+    /** 按钮ID：在一个keyboard消息内设置唯一 */
+    id: string;
+    /** 按钮上的文字 */
+    render_data: {
+        /** 按钮上的文字 */
+        label: string;
+        /** 点击后按钮的上文字 */
+        visited_label: string;
+        /**
+         * 按钮样式
+         * - 0-灰色线框
+         * - 1-蓝色线框
+         * - 2-特殊样式按钮
+         * - 3-红色文字
+         * - 4-白色填充
+         */
+        style: number;
+    };
+    /** 操作相关的数据 */
+    action: {
+        /** 设置 0 跳转按钮：http 或 小程序 客户端识别 scheme，设置 1 回调按钮：回调后台接口, data 传给后台，设置 2 指令按钮：自动在输入框插入 @bot data */
+        type: number;
+        /** 权限设置 */
+        permission: {
+            /** 0 指定用户可操作，1 仅管理者可操作，2 所有人可操作，3 指定身份组可操作（仅频道可用） */
+            type: number;
+            /** 有权限的用户 id 的列表 */
+            specify_user_ids?: string[];
+            /** 有权限的身份组 id 的列表（仅频道可用） */
+            specify_role_ids?: string[];
+        };
+        /** 操作相关的数据 */
+        data: string;
+        /** 指令按钮可用，指令是否带引用回复本消息，默认 false */
+        reply?: boolean;
+        /** 指令按钮可用，点击按钮后直接自动发送 data，默认 false */
+        enter?: boolean;
+        /** 本字段仅在指令按钮下有效，设置后后会忽略 action.enter 配置。
+        设置为 1 时 ，点击按钮自动唤起启手Q选图器，其他值暂无效果。
+        （仅支持手机端版本 8983+ 的单聊场景，桌面端不支持） */
+        anchor?: number;
+        /** 【已弃用】可操作点击的次数，默认不限 */
+        click_limit?: number;
+        /** 【已弃用】指令按钮可用，弹出子频道选择器，默认 false */
+        at_bot_show_channel_list?: boolean;
+        /** 客户端不支持本action的时候，弹出的toast文案 */
+        unsupport_tips: string;
+    };
+}
+/**
+ * Keyboard消息结构
+ * @param T 是否为原生结构
+ */
+export type KeyboardType<T extends boolean> = T extends true ? RawKeyboardType : TplKeyboardType;
+/**
+ * Ark消息结构
+ */
+export interface ArkType {
+    /** 模版 id，管理端可获得或内邀申请获得 */
+    template_id: number;
+    /** {key: xxx, value: xxx}，模版内变量与填充值的kv映射 */
+    kv: Array<{
+        obj_kv: Array<{
+            key: string;
+            value: string;
+        }>;
+    }>;
+}

package/lib/types/element/qqbot.js

@@ -0,0 +1 @@
+export {};

package/lib/types/event/message.d.ts

@@ -34,6 +34,10 @@ export interface KarinMessageType extends KarinEventType {
      * - 消息图片
      */
     image: string[];
+    /**
+     * - 语音url
+     */
+    record: string;
     file: any;
     /**
      * 是否atBot
@@ -88,6 +92,7 @@ export declare class KarinMessage implements KarinMessageType {
     replyCallback: KarinMessageType['replyCallback'];
     msg: KarinMessageType['msg'];
     image: KarinMessageType['image'];
+    record: KarinMessageType['record'];
     file: KarinMessageType['file'];
     atBot: KarinMessageType['atBot'];
     atAll: KarinMessageType['atAll'];

package/lib/types/event/message.js

@@ -30,6 +30,7 @@ export class KarinMessage {
     replyCallback;
     msg;
     image;
+    record;
     file;
     atBot;
     atAll;
@@ -63,6 +64,7 @@ export class KarinMessage {
         this.msg = '';
         this.image = [];
         this.file = {};
+        this.record = '';
         this.atBot = false;
         this.atAll = false;
         this.at = [];

package/lib/types/index.d.ts

@@ -1,6 +1,7 @@
 export * from './adapter/base.js';
 export * from './config/config.js';
 export * from './element/element.js';
+export * from './element/qqbot.js';
 export * from './event/index.js';
 export * from './logger/logger.js';
 export * from './render/render.js';

package/lib/types/index.js

@@ -1,6 +1,7 @@
 export * from './adapter/base.js'
 export * from './config/config.js'
 export * from './element/element.js'
+export * from './element/qqbot.js'
 export * from './event/index.js'
 export * from './logger/logger.js'
 export * from './render/render.js'

package/lib/types/type/global.d.ts

@@ -0,0 +1,23 @@
+import { Logger as LoggerType } from 'log4js';
+import { Logger } from '../../types/index.js';
+import { Lang, Mode, Runner } from '../../cli/karin.js';
+declare global {
+    namespace NodeJS {
+        interface ProcessEnv {
+            /** 重启次数 */
+            karin_app_start_count: string;
+            /** 是否为监听模式 yes=true no=false */
+            karin_app_watch: string;
+            /** 运行模式 "dev" | "prod" */
+            karin_app_mode: `${Mode}`;
+            /** 语言环境 "js" | "ts" */
+            karin_app_lang: `${Lang}`;
+            /** 运行器 "node" | "tsx" | "pm2" */
+            karin_app_runner: `${Runner}`;
+        }
+    }
+}
+declare global {
+    var logger: LoggerType & Logger;
+}
+export {};

package/lib/types/type/global.js

@@ -0,0 +1 @@
+export {};

package/lib/utils/common/common.d.ts

@@ -1,7 +1,7 @@
 import fs from 'fs';
 import { AxiosRequestConfig } from 'axios';
 import { Readable } from 'stream';
-import { dirName, fileName, KarinElement, NodeElement } from '../../types/index.js';
+import { ButtonElement, ButtonType, dirName, fileName, KarinElement, NodeElement, KeyBoardElement } from '../../types/index.js';
 /**
  * 常用方法
  */
@@ -174,6 +174,13 @@ declare class Common {
         /** 需要写入的注释 */
         comment: string;
     }[]): void;
+    /**
+     * karin按钮转换为QQBot官方按钮 返回官方按钮结构
+     * @param button - 按钮
+     */
+    buttonToQQBot(button: ButtonElement | KeyBoardElement): Array<{
+        buttons: Array<ButtonType>;
+    }>;
 }
 /**
  * 常用方法

package/lib/utils/common/common.js

@@ -324,18 +324,10 @@ class Common {
      * @param elements - 消息内容
      */
     makeMessage(elements) {
-        /** 将msg格式化为数组 */
         if (!Array.isArray(elements))
             elements = [elements];
         const message = [];
-        elements.forEach(v => {
-            if (typeof v === 'string') {
-                message.push(segment.text(v));
-            }
-            else {
-                message.push(v);
-            }
-        });
+        elements.forEach(v => { typeof v === 'string' ? message.push(segment.text(v)) : message.push(v); });
         return message;
     }
     /**
@@ -468,7 +460,6 @@ class Common {
                     break;
                 case 'video':
                 case 'image':
-                case 'voice':
                 case 'record':
                 case 'file': {
                     let file;
@@ -534,11 +525,8 @@ class Common {
                     logs.push(`[markdown_tpl:${JSON.stringify(content)}]`);
                     break;
                 }
-                case 'rows': {
-                    const rows = [];
-                    for (const v of val.rows)
-                        rows.push(JSON.stringify(v.data));
-                    logs.push(`[rows:${JSON.stringify(rows)}]`);
+                case 'keyboard': {
+                    logs.push(`[rows:${JSON.stringify(val.rows)}]`);
                     break;
                 }
                 case 'button':
@@ -584,6 +572,55 @@ class Common {
         });
         yaml.save();
     }
+    /**
+     * karin按钮转换为QQBot官方按钮 返回官方按钮结构
+     * @param button - 按钮
+     */
+    buttonToQQBot(button) {
+        let id = 0;
+        const rows = [];
+        /** 格式化为多行 */
+        const list = [];
+        button.type === 'button' ? list.push(button.data) : list.push(...button.rows);
+        for (const row of list) {
+            const buttons = [];
+            for (const i of row) {
+                const type = i.link ? 0 : (i.callback ? 1 : i.type ?? 2);
+                const data = {
+                    id: String(id),
+                    render_data: {
+                        label: i.text,
+                        style: i.style ?? 0,
+                        visited_label: i.show || i.text,
+                    },
+                    action: {
+                        type,
+                        data: i.data || i.link || i.text,
+                        unsupport_tips: i.tips || '.',
+                        permission: { type: 2 },
+                    },
+                };
+                if (i.enter)
+                    data.action.enter = true;
+                if (i.reply)
+                    data.action.reply = true;
+                if (i.admin)
+                    data.action.permission.type = 1;
+                if (i.list) {
+                    data.action.permission.type = 0;
+                    data.action.permission.specify_user_ids = i.list;
+                }
+                else if (i.role) {
+                    data.action.permission.type = 3;
+                    data.action.permission.specify_role_ids = i.role;
+                }
+                buttons.push(data);
+                id++;
+            }
+            rows.push({ buttons });
+        }
+        return rows;
+    }
 }
 /**
  * 常用方法

package/lib/utils/core/segment.d.ts

@@ -1,4 +1,4 @@
-import { TextElement, AtElement, ImageElement, FaceElement, BubbleFaceElement, ReplyElement, VideoElement, BasketballElement, DiceElement, RpsElement, PokeElement, MusicElement, WeatherElement, LocationElement, ShareElement, GiftElement, MarketFaceElement, ForwardElement, ContactElement, JsonElement, XmlElement, FileElement, ButtonElement, CustomMusicElemen, TplMarkdownElement, RawMarkdownElement, NodeElement, KarinElement, LongMsgElement, RecordElement } from '../../types/index.js';
+import { TextElement, AtElement, ImageElement, FaceElement, BubbleFaceElement, ReplyElement, VideoElement, BasketballElement, DiceElement, RpsElement, PokeElement, MusicElement, WeatherElement, LocationElement, ShareElement, GiftElement, MarketFaceElement, ForwardElement, ContactElement, JsonElement, XmlElement, FileElement, ButtonElement, CustomMusicElemen, TplMarkdownElement, RawMarkdownElement, NodeElement, KarinElement, LongMsgElement, RecordElement, KeyBoardElement, Button } from '../../types/index.js';
 export declare const segment: {
     /**
      * 纯文本
@@ -70,12 +70,10 @@ export declare const segment: {
     }): ImageElement;
     /**
      * 语音
-     * @description 即将废弃，请使用voice
      * @param file - 语音URL或路径、Base64
      * @param magic - 是否魔法语音，默认为 false
      * @param md5 - 语音md5
      * @param name - 语音名称
-     * @returns {VoiceElement} 语音元素
      */
     record(file: string, magic?: boolean, md5?: string, name?: string): RecordElement;
     /**
@@ -84,8 +82,6 @@ export declare const segment: {
      * @param magic - 是否魔法语音，默认为 false
      * @param md5 - 语音md5
      * @param name - 语音名称
-     * @returns {VoiceElement} 语音元素
-     * @deprecated 即将废弃 请使用segment.record
      */
     voice(file: string, magic?: boolean, md5?: string, name?: string): RecordElement;
     /**
@@ -260,15 +256,19 @@ export declare const segment: {
      */
     markdown_tpl(custom_template_id: TplMarkdownElement["custom_template_id"], params: TplMarkdownElement["params"]): TplMarkdownElement;
     /**
-     * 按钮
+     * 按钮 构建单行单个(obj)、多个按钮(obj[])
      * @param data - 按钮数据
      * @returns {ButtonElement} 按钮元素
      */
-    button(data: ButtonElement["data"]): ButtonElement;
-    rows(data: Array<ButtonElement["data"]>): {
-        type: "rows";
-        rows: Array<ButtonElement>;
+    button(data: Button | Array<Button>): {
+        type: ButtonElement["type"];
+        data: Array<Button>;
     };
+    /**
+     * 多维按钮
+     * @param data - 按钮数据
+     */
+    keyboard(data: Array<Button> | Array<Array<Button>>): KeyBoardElement;
     /**
      * 转发自定义节点
      * @param user_id - 用户ID

package/lib/utils/core/segment.js

@@ -90,12 +90,10 @@ export const segment = new (class Segment {
     }
     /**
      * 语音
-     * @description 即将废弃，请使用voice
      * @param file - 语音URL或路径、Base64
      * @param magic - 是否魔法语音，默认为 false
      * @param md5 - 语音md5
      * @param name - 语音名称
-     * @returns {VoiceElement} 语音元素
      */
     record(file, magic = false, md5 = '', name = '') {
         return {
@@ -112,8 +110,6 @@ export const segment = new (class Segment {
      * @param magic - 是否魔法语音，默认为 false
      * @param md5 - 语音md5
      * @param name - 语音名称
-     * @returns {VoiceElement} 语音元素
-     * @deprecated 即将废弃 请使用segment.record
      */
     voice(file, magic = false, md5 = '', name = '') {
         return {
@@ -404,25 +400,39 @@ export const segment = new (class Segment {
         };
     }
     /**
-     * 按钮
+     * 按钮 构建单行单个(obj)、多个按钮(obj[])
      * @param data - 按钮数据
      * @returns {ButtonElement} 按钮元素
      */
     button(data) {
         return {
             type: 'button',
-            data,
+            data: Array.isArray(data) ? data : [data],
         };
     }
-    rows(data) {
+    /**
+     * 多维按钮
+     * @param data - 按钮数据
+     */
+    keyboard(data) {
+        /** 每一个元素为一行按钮 每一行按钮存在多个 */
         const rows = [];
         if (!Array.isArray(data))
             data = [data];
         for (const i of data) {
-            rows.push(this.button(i));
-            continue;
+            /** 如果还是数组 说明是单行多个按钮 */
+            if (Array.isArray(i)) {
+                const button = [];
+                for (const v of i)
+                    button.push(v);
+                rows.push(button);
+            }
+            else {
+                /** 单行 单个按钮 */
+                rows.push([i]);
+            }
         }
-        return { type: 'rows', rows };
+        return { type: 'keyboard', rows };
     }
     /**
      * 转发自定义节点

package/lib/utils/tools/exec.js

@@ -42,11 +42,9 @@ export const exec = (cmd, log = true, options = { cwd: process.cwd(), encoding:
  */
 export const execs = (cmd, options = { cwd: process.cwd(), encoding: 'utf-8' }) => {
     return new Promise((resolve, reject) => {
-        execCmd(cmd, options, (error, stdout, stderr) => {
+        execCmd(cmd, options, (error, stdout) => {
             if (error)
                 return reject(error);
-            if (stderr)
-                console.error(stderr);
             resolve(stdout.trim());
         });
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-karin",
-  "version": "0.10.5",
+  "version": "0.10.7",
   "private": false,
   "description": "基于 Kritor 进行开发的nodejs机器人框架",
   "homepage": "https://github.com/KarinJS/Karin",