mioki 0.9.2 → 0.10.0

package/dist/index.d.cts

@@ -19,8 +19,8 @@ import { ScheduledTask, TaskContext } from "node-cron";
 //#region src/logger.d.ts
 declare const logger: Logger;
 /**
-* 获取日志文件名
-*/
+ * 获取日志文件名
+ */
 declare function getLogFilePath(type?: string): string;
 declare function getMiokiLogger(level: LogLevel): Logger;
 //#endregion
@@ -42,69 +42,69 @@ type HasMessage = {
   message: RecvElement[];
 } | RecvElement[];
 /**
-* Jiti 实例
-*/
+ * Jiti 实例
+ */
 declare const jiti: Jiti;
 interface CreateCmdOptions {
   prefix?: string;
   onPrefix?(): void;
 }
 /**
-* 解析命令字符串，返回命令和参数
-*/
+ * 解析命令字符串，返回命令和参数
+ */
 declare function createCmd(cmdStr: string, options?: CreateCmdOptions): {
   cmd: string | undefined;
   params: string[];
   options: Record<string, any>;
 };
 /**
-* 带有表情反应的函数执行包装器
-*/
+ * 带有表情反应的函数执行包装器
+ */
 declare function runWithReaction<T extends AnyFunc>(e: GroupMessageEvent, fn: T, id?: string): Promise<ReturnType<T>>;
 /**
-* 创建一个 LowDB 数据库实例
-*/
+ * 创建一个 LowDB 数据库实例
+ */
 declare function createDB<T extends object = object>(filename: string, options?: {
   defaultData?: T;
   compress?: boolean;
 }): Promise<Low<T>>;
 /**
-* 确保返回一个可用的图片元素
-*
-* @param buffer 图片缓冲区
-* @param text 文本
-* @returns 图片元素
-*/
+ * 确保返回一个可用的图片元素
+ *
+ * @param buffer 图片缓冲区
+ * @param text 文本
+ * @returns 图片元素
+ */
 declare function ensureBuffer(buffer?: Buffer | null | undefined, text?: null): null;
 declare function ensureBuffer(buffer?: Buffer | null | undefined, text?: string): Sendable;
 /**
-* 格式化时间间隔为可读字符串
-*
-* @param ms 时间间隔（毫秒）
-* @returns 可读字符串
-*/
+ * 格式化时间间隔为可读字符串
+ *
+ * @param ms 时间间隔（毫秒）
+ * @returns 可读字符串
+ */
 declare function formatDuration(ms: number): string;
 type MatchPatternItem = null | undefined | void | false | Sendable | Sendable[];
 type MatchValue<E extends MessageEvent> = MatchPatternItem | ((matches: RegExpMatchArray, event: E) => MatchPatternItem) | ((matches: RegExpMatchArray, event: E) => Promise<MatchPatternItem>);
 /**
-* 匹配输入文本与匹配模式，如果匹配成功，则回复匹配结果
-*
-* 支持：
-* - 精确匹配
-* - 正则表达式匹配（以 `/` 开头和结尾的字符串）
-* - 通配符匹配（使用 `*` 作为通配符）
-*
-* @param event 消息事件
-* @param pattern 匹配模式
-* @param quote 是否引用回复
-* @returns 匹配结果
-*/
+ * 匹配输入文本与匹配模式，如果匹配成功，则回复匹配结果
+ *
+ * 支持：
+ * - 精确匹配
+ * - 正则表达式匹配（以 `/` 开头和结尾的字符串）
+ * - 通配符匹配（使用 `*` 作为通配符）
+ *
+ * @param event 消息事件
+ * @param pattern 匹配模式
+ * @param quote 是否引用回复
+ * @returns 匹配结果
+ */
 declare function match<E extends MessageEvent>(event: E, pattern: Record<string, MatchValue<E>>, quote?: boolean): Promise<{
   message_id: number;
 } | null>;
 /**
-* 创建一个持久化数据库，基于 createDB 封装
-*/
+ * 创建一个持久化数据库，基于 createDB 封装
+ */
 declare function createStore<T extends object = object>(defaultData: T, options?: {
   __dirname?: string;
   importMeta?: ImportMeta;
@@ -112,270 +112,270 @@ declare function createStore<T extends object = object>(defaultData: T, options?
   filename?: string;
 }): Promise<Low<T>>;
 /**
-* MD5 加密
-*/
-declare function md5(text: BinaryLike, encoding: "buffer"): Buffer;
+ * MD5 加密
+ */
+declare function md5(text: BinaryLike, encoding: 'buffer'): Buffer;
 declare function md5(text: BinaryLike, encoding?: BinaryToTextEncoding): string;
 /**
-* 数组去重
-*/
+ * 数组去重
+ */
 declare function unique<T>(array: T[]): T[];
 /**
-* 确保值为数组
-*
-*/
+ * 确保值为数组
+ *
+ */
 declare function toArray<T>(value: T | T[]): T[];
 /**
-* 是否是群消息
-*/
+ * 是否是群消息
+ */
 declare const isGroupMsg: (event: MessageEvent) => event is GroupMessageEvent;
 /**
-* 是否是私聊消息
-*/
+ * 是否是私聊消息
+ */
 declare const isPrivateMsg: (event: MessageEvent) => event is PrivateMessageEvent;
 /**
-* 异步延时函数
-*
-* @param {number} ms 等待毫秒数
-* @return {Promise<void>}
-*/
+ * 异步延时函数
+ *
+ * @param {number} ms 等待毫秒数
+ * @return {Promise<void>}
+ */
 declare function wait(ms: number): Promise<void>;
 interface FormatOptions {
   locale?: string;
   timeZone?: string;
 }
 /**
-* 获取今天的固定日期字符串，可用来作为「稳定随机」的参数，用于签到、每日任务等场景
-*
-* 格式： 2024/12/12，可选控制时区，默认为 'Asia/Shanghai' （亚洲/上海 时区）
-*
-* @param timeZone 指定的时区，默认为 'Asia/Shanghai'
-* @returns 返回当前日期的字符串格式
-*/
+ * 获取今天的固定日期字符串，可用来作为「稳定随机」的参数，用于签到、每日任务等场景
+ *
+ * 格式： 2024/12/12，可选控制时区，默认为 'Asia/Shanghai' （亚洲/上海 时区）
+ *
+ * @param timeZone 指定的时区，默认为 'Asia/Shanghai'
+ * @returns 返回当前日期的字符串格式
+ */
 declare function localeDate(ts?: number | string | Date, options?: FormatOptions): string;
 /**
-* 获取当前时间的固定时间字符串
-*/
+ * 获取当前时间的固定时间字符串
+ */
 declare function localeTime(ts?: number | string | Date, options?: FormatOptions & {
   seconds?: boolean;
 }): string;
 /**
-* 生成指定范围（min ～ max）内的随机整数
-*
-* 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机数相同
-*/
+ * 生成指定范围（min ～ max）内的随机整数
+ *
+ * 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机数相同
+ */
 declare function randomInt(min: number, max: number, ...hashArgs: any[]): number;
 /**
-* 取数组内随机一项
-*
-* 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机项
-*/
+ * 取数组内随机一项
+ *
+ * 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机项
+ */
 declare function randomItem<T = any>(array: readonly T[], ...hashArgs: any[]): T;
 /**
-* 从数组中随机选出指定数量的项（不重复）
-*
-* 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机项相同
-*
-* @param array 源数组
-* @param count 要选择的项数量
-* @param hashArgs 稳定随机的额外参数
-* @returns 随机选出的项组成的数组
-*/
+ * 从数组中随机选出指定数量的项（不重复）
+ *
+ * 额外支持「稳定随机」，继续传入额外参数即可，如果额外参数相同（忽略顺序），则生成的随机项相同
+ *
+ * @param array 源数组
+ * @param count 要选择的项数量
+ * @param hashArgs 稳定随机的额外参数
+ * @returns 随机选出的项组成的数组
+ */
 declare function randomItems<T = any>(array: readonly T[], count: number, ...hashArgs: any[]): T[];
 /**
-* 包含大写字母与数字的 6 位随机 ID 生成器
-*/
+ * 包含大写字母与数字的 6 位随机 ID 生成器
+ */
 declare function randomId(): string;
 /**
-* 简单生成符合 UUID 规范的字符串，但不保证唯一性
-*/
+ * 简单生成符合 UUID 规范的字符串，但不保证唯一性
+ */
 declare function uuid(): string;
 /**
-* clamp 操作，限制数值在指定范围内
-*/
+ * clamp 操作，限制数值在指定范围内
+ */
 declare function clamp(n: number, min: number, max: number): number;
 /**
-* 排除 null 和 undefined
-*/
+ * 排除 null 和 undefined
+ */
 declare function noNullish<T>(val: T | null): val is T;
 /**
-* 判断是否定义
-*/
+ * 判断是否定义
+ */
 declare function isDefined<T = unknown>(val?: T): val is T;
 /**
-* 通过消息事件生成唯一 id
-*/
+ * 通过消息事件生成唯一 id
+ */
 declare function toMsgId(event: {
   seq: number;
   rand: number;
 }): string;
 /**
-* 判断是否为函数
-*/
+ * 判断是否为函数
+ */
 declare function isFunction<T extends AnyFunc>(val: unknown): val is T;
 /**
-* 判断是否为数字
-*/
+ * 判断是否为数字
+ */
 declare function isNumber(val: unknown): val is number;
 /**
-* 判断是否为布尔值
-*/
+ * 判断是否为布尔值
+ */
 declare function isBoolean(val: unknown): val is boolean;
 /**
-* 判断是否为字符串
-*/
+ * 判断是否为字符串
+ */
 declare function isString(val: unknown): val is string;
 /**
-* 判断是否为对象
-*/
+ * 判断是否为对象
+ */
 declare function isObject(val: unknown): val is object;
 /**
-* 将数字转换为本地化数字字符串
-*/
+ * 将数字转换为本地化数字字符串
+ */
 declare function localNum(num: number, locale?: string): string;
 /**
-* 通过 QQ 号获取任意头像链接
-*
-* size 可选： 0 | 40 | 100 | 160 | 640，0 为原图
-*/
+ * 通过 QQ 号获取任意头像链接
+ *
+ * size 可选： 0 | 40 | 100 | 160 | 640，0 为原图
+ */
 declare function getQQAvatarLink(qq: number, size?: number): string;
 /**
-* 通过群号获取任意群头像链接
-*
-* size 可选： 40 | 100 | 640，0 为原图
-*/
+ * 通过群号获取任意群头像链接
+ *
+ * size 可选： 40 | 100 | 640，0 为原图
+ */
 declare function getGroupAvatarLink(group: number, size?: number): string;
 /** 获取引用回复的消息 */
 declare function getQuoteMsg(event: MessageEvent, timeout?: number): Promise<GroupMessageEvent | PrivateMessageEvent | null>;
 /**
-* 获取原创表情包的图片链接
-*/
+ * 获取原创表情包的图片链接
+ */
 declare function getBfaceUrl(file: string): Promise<string | null>;
 /**
-* 获取消息中的图片链接
-*/
+ * 获取消息中的图片链接
+ */
 declare function getImageUrl(event: HasMessage): Promise<string>;
 /**
-* 获取引用回复的消息中的图片链接
-*/
+ * 获取引用回复的消息中的图片链接
+ */
 declare function getQuoteImageUrl(event: MessageEvent): Promise<string>;
 /**
-* 获取消息提及的图片链接（消息或者引用消息）
-*/
+ * 获取消息提及的图片链接（消息或者引用消息）
+ */
 declare function getMentionedImageUrl(event: MessageEvent): Promise<string>;
 /**
-* 获取消息中的图片元素
-*/
+ * 获取消息中的图片元素
+ */
 declare function getImage(event: HasMessage): RecvImageElement | null;
 /**
-* 获取引用回复的图片消息
-*/
+ * 获取引用回复的图片消息
+ */
 declare function getQuoteImage(event: MessageEvent): Promise<RecvImageElement | null>;
 /**
-* 获取消息提及的图片（消息或者引用消息）
-*/
+ * 获取消息提及的图片（消息或者引用消息）
+ */
 declare function getMentionedImage(event: MessageEvent): Promise<RecvImageElement | null>;
 /**
-* 获取消息中的文本内容，默认采取 'whole' 模式，去除整体的首尾空格，可选 'each' 模式，去除每个文本的首尾空格
-*
-* 如: whole 模式下 => '  123    [表情] 456  ' => '123     456'
-* 如: each 模式下 => '  123    [表情] 456  ' => '123456'
-*/
+ * 获取消息中的文本内容，默认采取 'whole' 模式，去除整体的首尾空格，可选 'each' 模式，去除每个文本的首尾空格
+ *
+ * 如: whole 模式下 => '  123    [表情] 456  ' => '123     456'
+ * 如: each 模式下 => '  123    [表情] 456  ' => '123456'
+ */
 declare function text(event: HasMessage, options?: {
-  trim?: boolean | "whole" | "each";
+  trim?: boolean | 'whole' | 'each';
 }): string;
 /**
-* 获取回复的消息中的文本内容
-*/
+ * 获取回复的消息中的文本内容
+ */
 declare function getQuoteText(event: MessageEvent): Promise<string>;
 /**
-* 获取提到的用户 QQ 号，可以通过 if(!qq) 判断是否提到了用户，返回 0 代表没有提到用户
-*/
+ * 获取提到的用户 QQ 号，可以通过 if(!qq) 判断是否提到了用户，返回 0 代表没有提到用户
+ */
 declare function getMentionedUserId(event: MessageEvent): Promise<number | 0>;
 /**
-* 获取 **一个** 指定类型的消息元素，如获取图片、表情等，如果没有则返回 undefined
-*/
-declare function find<Type extends Pick<RecvElement, "type">["type"], TargetType extends Extract<RecvElement, {
+ * 获取 **一个** 指定类型的消息元素，如获取图片、表情等，如果没有则返回 undefined
+ */
+declare function find<Type extends Pick<RecvElement, 'type'>['type'], TargetType extends Extract<RecvElement, {
   type: Type;
 }> = Extract<RecvElement, {
   type: Type;
 }>>(event: HasMessage, type: Type): TargetType | undefined;
 /**
-* 获取 **所有** 指定类型的消息元素，如获取图片、表情等，如果没有则返回 []
-*/
-declare function filter<Type extends Pick<RecvElement, "type">["type"], TargetType extends Extract<RecvElement, {
+ * 获取 **所有** 指定类型的消息元素，如获取图片、表情等，如果没有则返回 []
+ */
+declare function filter<Type extends Pick<RecvElement, 'type'>['type'], TargetType extends Extract<RecvElement, {
   type: Type;
 }> = Extract<RecvElement, {
   type: Type;
 }>>(event: HasMessage, type: Type): TargetType[];
 /**
-* 错误信息字符串格式化
-*
-* @param {any} error 待处理错误
-* @return {string} stringify 结果
-*/
+ * 错误信息字符串格式化
+ *
+ * @param {any} error 待处理错误
+ * @return {string} stringify 结果
+ */
 declare function stringifyError(error: any): string;
 /**
-* Encodes string | number | buffer using base64.
-*/
+ * Encodes string | number | buffer using base64.
+ */
 declare function base64Encode(str: string | number | Buffer): string;
 /**
-* Decodes the string from base64 to UTF-8.
-*
-* @param {string} str - The base64-encoded string.
-*/
-declare function base64Decode(str: string, type?: "buffer" | BufferEncoding): string | Buffer;
-/**
-* JS 对象转换成 `urlencoded` 格式字符串 { name: 'Bob', age: 18 } => name=Bob&age=18
-*
-* @param {Record<number | string, any>} obj JS 对象
-* @return {string} 转换后的字符串
-*/
+ * Decodes the string from base64 to UTF-8.
+ *
+ * @param {string} str - The base64-encoded string.
+ */
+declare function base64Decode(str: string, type?: 'buffer' | BufferEncoding): string | Buffer;
+/**
+ * JS 对象转换成 `urlencoded` 格式字符串 { name: 'Bob', age: 18 } => name=Bob&age=18
+ *
+ * @param {Record<number | string, any>} obj JS 对象
+ * @return {string} 转换后的字符串
+ */
 declare function qs(obj: Record<number | string, any>): string;
 /**
-* 格式化展示 QQ 等级
-*/
+ * 格式化展示 QQ 等级
+ */
 declare function formatQQLevel(level: number): string;
 /**
-* 申请通过开发者工具登录，以获取 Cookie
-*/
+ * 申请通过开发者工具登录，以获取 Cookie
+ */
 declare function requestLoginViaDevTools(): Promise<{
   code: string;
   url: string;
 }>;
 /**
-* 获取开发者工具登录结果
-*/
+ * 获取开发者工具登录结果
+ */
 declare function queryDevToolsLoginStatus(code: string): Promise<{
-  status: "OK" | "Wait" | "Expired" | "Used" | "Error";
+  status: 'OK' | 'Wait' | 'Expired' | 'Used' | 'Error';
   ticket?: string;
 }>;
 /**
-* 通过开发者工具登录获取 AuthCode
-*/
+ * 通过开发者工具登录获取 AuthCode
+ */
 declare function getAuthCodeViaTicket(ticket: string, appid: number): Promise<string>;
 /**
-* 通过 Auth Code 获取 minico Token
-*/
+ * 通过 Auth Code 获取 minico Token
+ */
 declare function getMinicoTokenViaAuthCode(authCode: string, appid: number): Promise<any>;
 /**
-* 获取终端输入，返回 Promise，支持提示信息
-*/
+ * 获取终端输入，返回 Promise，支持提示信息
+ */
 declare function getTerminalInput(inputTip?: string): Promise<string>;
 /**
-* 当前 Node.js 进程的启动时间，常量，Date 类型
-*/
+ * 当前 Node.js 进程的启动时间，常量，Date 类型
+ */
 declare const START_TIME: Date;
 /**
-* 计算 GTK 值
-*/
+ * 计算 GTK 值
+ */
 declare function getGTk(pskey: string): number;
 declare namespace config_d_exports {
   export { BOT_CWD, MiokiConfig, botConfig, hasRight, isAdmin, isInPm2, isOwner, isOwnerOrAdmin, readMiokiConfig, readPackageJson, updateBotCWD, updateBotConfig, writePackageJson };
 }
 /**
-* mioki 配置
-*/
+ * mioki 配置
+ */
 interface MiokiConfig {
   prefix?: string;
   owners: number[];
@@ -385,38 +385,38 @@ interface MiokiConfig {
   online_push?: boolean;
   log_level?: LogLevel;
   plugins_dir?: string;
-  status_permission?: "all" | "admin-only";
+  status_permission?: 'all' | 'admin-only';
   napcat: {
-    protocol?: "ws" | "wss";
+    protocol?: 'ws' | 'wss';
     port?: number;
     host?: string;
     token: string;
   };
 }
 /**
-* 机器人根目录
-*/
+ * 机器人根目录
+ */
 declare const BOT_CWD: {
   value: string;
 };
-declare function readPackageJson(): Record<"mioki" | (string & {}), any>;
+declare function readPackageJson(): Record<'mioki' | (string & {}), any>;
 declare function writePackageJson(pkg: Record<string, any>): void;
 declare function readMiokiConfig(): MiokiConfig;
 /**
-* `mioki` 框架相关配置
-*/
+ * `mioki` 框架相关配置
+ */
 declare const botConfig: MiokiConfig;
 /**
-* 更新 `mioki` 配置，同时同步更新本地配置文件
-*/
+ * 更新 `mioki` 配置，同时同步更新本地配置文件
+ */
 declare const updateBotConfig: (draftFn: (config: MiokiConfig) => any) => Promise<void>;
 /**
-* 更新机器人根目录
-*/
+ * 更新机器人根目录
+ */
 declare const updateBotCWD: (root: string) => void;
 /**
-* 是否是主人
-*/
+ * 是否是主人
+ */
 declare const isOwner: (id: number | {
   sender: {
     user_id: number;
@@ -425,8 +425,8 @@ declare const isOwner: (id: number | {
   user_id: number;
 }) => boolean;
 /**
-* 是否是管理员，注意: 主人不是管理员
-*/
+ * 是否是管理员，注意: 主人不是管理员
+ */
 declare const isAdmin: (id: number | {
   sender: {
     user_id: number;
@@ -435,8 +435,8 @@ declare const isAdmin: (id: number | {
   user_id: number;
 }) => boolean;
 /**
-* 是否是主人或管理员
-*/
+ * 是否是主人或管理员
+ */
 declare const isOwnerOrAdmin: (id: number | {
   sender: {
     user_id: number;
@@ -445,8 +445,8 @@ declare const isOwnerOrAdmin: (id: number | {
   user_id: number;
 }) => boolean;
 /**
-* 是否有权限，即：主人或管理员
-*/
+ * 是否有权限，即：主人或管理员
+ */
 declare const hasRight: (id: number | {
   sender: {
     user_id: number;
@@ -455,39 +455,39 @@ declare const hasRight: (id: number | {
   user_id: number;
 }) => boolean;
 /**
-* 是否在 PM2 中运行
-*/
+ * 是否在 PM2 中运行
+ */
 declare const isInPm2: boolean;
 declare namespace actions_d_exports {
   export { createForwardMsg, getViolationRecords, noticeAdmins, noticeFriends, noticeGroups, noticeMainOwner, noticeOwners, runWithErrorHandler, signArk, uploadImageToCollection, uploadImageToGroupHomework, uploadImageToGroupNotice };
 }
 /**
-* 群发群消息
-*/
+ * 群发群消息
+ */
 declare function noticeGroups(bot: NapCat, groupIdList: number[], message?: Sendable | null, delay?: number): Promise<void>;
 /**
-* 群发好友消息
-*/
+ * 群发好友消息
+ */
 declare function noticeFriends(bot: NapCat, friendIdList: number[], message?: Sendable | null, delay?: number): Promise<void>;
 /**
-* 群发通知给管理员
-*/
+ * 群发通知给管理员
+ */
 declare function noticeAdmins(bot: NapCat, message?: Sendable | null, delay?: number): Promise<void>;
 /**
-* 群发通知给主人
-*/
+ * 群发通知给主人
+ */
 declare function noticeOwners(bot: NapCat, message?: Sendable | null, delay?: number): Promise<void>;
 /**
-* 群发通知给第一个主人
-*/
+ * 群发通知给第一个主人
+ */
 declare function noticeMainOwner(bot: NapCat, message?: Sendable | null): Promise<void>;
 /**
-* 签名卡片 json
-*/
+ * 签名卡片 json
+ */
 declare function signArk(bot: NapCat, json: string): Promise<string>;
 /**
-* 运行函数并捕获错误, 并通过 event.reply 发送错误信息
-*/
+ * 运行函数并捕获错误, 并通过 event.reply 发送错误信息
+ */
 declare function runWithErrorHandler(bot: NapCat, fn: () => any, event?: {
   reply: (content: Sendable, quote?: boolean) => Promise<{
     message_id: number;
@@ -499,16 +499,16 @@ declare function createForwardMsg(bot: NapCat, message?: Sendable[], options?: {
   nickname?: string;
 }): Sendable;
 /**
-* 上传图片到收藏
-*/
+ * 上传图片到收藏
+ */
 declare function uploadImageToCollection(bot: NapCat, buffer: ArrayBuffer): Promise<string>;
 /**
-* 上传图片到群作业
-*/
+ * 上传图片到群作业
+ */
 declare function uploadImageToGroupHomework(bot: NapCat, imgBase64: string): Promise<string>;
 /**
-* 上传图片到群公告
-*/
+ * 上传图片到群公告
+ */
 declare function uploadImageToGroupNotice(bot: NapCat, urlOrBlob: string | Blob): Promise<{
   h: string;
   w: string;
@@ -521,8 +521,8 @@ declare function uploadImageToGroupNotice(bot: NapCat, urlOrBlob: string | Blob)
   url6: string;
 }>;
 /**
-* 获取 QQ 安全中心违规记录
-*/
+ * 获取 QQ 安全中心违规记录
+ */
 declare function getViolationRecords(bot: NapCat, authCode: string, appid: number, size?: number): Promise<{
   type: string;
   time: string;
@@ -583,25 +583,27 @@ interface MiokiStatus {
 //#region src/builtins/core/index.d.ts
 interface MiokiCoreServiceContrib {
   /** 获取框架和系统的实时状态 */
-  miokiStatus(): Promise<MiokiStatus>;
-  /** 获取框架和系统的实时状态字符串 */
-  miokiStatusStr(): Promise<string>;
+  getMiokiStatus(): Promise<MiokiStatus>;
+  /** 格式化框架状态字符串 */
+  formatMiokiStatus(status: MiokiStatus): Promise<string>;
+  /** 自定义框架状态格式化函数 */
+  customFormatMiokiStatus(formatter: (status: MiokiStatus) => string | Promise<string>): void;
 }
 declare namespace services_d_exports {
   export { MiokiServices, addService, services };
 }
 interface MiokiServices extends Record<string, unknown>, MiokiCoreServiceContrib {}
 /**
-* 服务，由其他插件贡献的方法、数据等
-*/
+ * 服务，由其他插件贡献的方法、数据等
+ */
 declare const services: MiokiServices;
 /**
-* 给 `Mioki` 添加公共服务，可用于插件间通信和共享数据
-*
-* 请注意合理设置插件的 `priority` 属性，以确保服务的正确加载顺序，`priority` 默认为 100，越小越先加载
-*
-* 建议需要调用 `addService` 的插件设置 `priority` 为 `10`
-*/
+ * 给 `Mioki` 添加公共服务，可用于插件间通信和共享数据
+ *
+ * 请注意合理设置插件的 `priority` 属性，以确保服务的正确加载顺序，`priority` 默认为 100，越小越先加载
+ *
+ * 建议需要调用 `addService` 的插件设置 `priority` 为 `10`
+ */
 declare function addService(name: string, service: any, cover?: boolean): () => void;
 //#endregion
 //#region src/plugin.d.ts
@@ -615,15 +617,15 @@ type RemoveBotParam<T> = { [K in keyof T]: T[K] extends ((...args: any[]) => any
 type OmitBotParamFromFunc<Func extends (bot: NapCat, ...args: any[]) => any> = Func extends ((bot: NapCat, ...args: infer A) => infer Return) ? (...args: A) => Return : never;
 declare function bindBot<Params extends Array<any> = any[], Return$1 = any>(bot: NapCat, func: (bot: NapCat, ...args: Params) => Return$1): OmitBotParamFromFunc<(bot: NapCat, ...args: Params) => Return$1>;
 /**
-* Mioki 上下文对象，包含 Mioki 运行时的信息和方法
-*/
+ * Mioki 上下文对象，包含 Mioki 运行时的信息和方法
+ */
 interface MiokiContext extends Services, Configs, Utils, RemoveBotParam<Actions> {
   /** 机器人实例 */
   bot: NapCat;
   /** 消息构造器 */
-  segment: NapCat["segment"];
+  segment: NapCat['segment'];
   /** 通过域名获取 Cookies */
-  getCookie: NapCat["getCookie"];
+  getCookie: NapCat['getCookie'];
   /** 注册事件处理器 */
   handle: <EventName extends keyof EventMap>(eventName: EventName, handler: (event: EventMap[EventName]) => any) => void;
   /** 注册定时任务 */
@@ -635,7 +637,7 @@ interface MiokiContext extends Services, Configs, Utils, RemoveBotParam<Actions>
 }
 declare const runtimePlugins: Map<string, {
   name: string;
-  type: "builtin" | "external";
+  type: 'builtin' | 'external';
   version: string;
   description: string;
   plugin: MiokiPlugin;
@@ -656,20 +658,20 @@ interface MiokiPlugin {
   setup?: (ctx: MiokiContext) => any;
 }
 /**
-* 定义一个 Mioki 插件
-* @param plugin Mioki 插件对象
-* @returns Mioki 插件对象
-*/
+ * 定义一个 Mioki 插件
+ * @param plugin Mioki 插件对象
+ * @returns Mioki 插件对象
+ */
 declare function definePlugin(plugin: MiokiPlugin): MiokiPlugin;
 /**
-* 确保插件目录存在
-*/
+ * 确保插件目录存在
+ */
 declare function ensurePluginDir(): void;
 /**
-* 获取插件目录的绝对路径
-*/
+ * 获取插件目录的绝对路径
+ */
 declare function getAbsPluginDir(defaultDir?: string): string;
-declare function enablePlugin(bot: NapCat, plugin: MiokiPlugin, type?: "builtin" | "external"): Promise<MiokiPlugin>;
+declare function enablePlugin(bot: NapCat, plugin: MiokiPlugin, type?: 'builtin' | 'external'): Promise<MiokiPlugin>;
 declare function findLocalPlugins(): Promise<{
   name: string;
   absPath: string;