koishi-plugin-mai-bridge 0.1.4 → 0.1.5

package/README.md

@@ -60,6 +60,7 @@ webuiPort: 8002
 messageMode: coexist
 groupMessageTriggerCount: 1
 directMessageTriggerCount: 1
+commandResultMode: source
 ```
 
 说明：
@@ -71,6 +72,8 @@ directMessageTriggerCount: 1
 - `webuiPublicUrl` 可填写反代或宿主机映射后的 WebUI 地址，用于 Koishi 控制台显示入口。
 - `groupMessageTriggerCount` 控制群聊累计多少条消息后批量转发并强制触发 maibot 思考。设为 `3` 时，同一群前两条先缓存，第 3 条会连同前两条一起转发。
 - `directMessageTriggerCount` 控制私聊累计多少条消息后批量转发并强制触发 maibot 思考。默认 `1`，表示每条私信都会触发；设为 `3` 时，同一私聊前两条只缓存，第 3 条统一转发并触发回复。
+- `commandResultMode` 控制聊天中执行 `mai.ko.*` 管理指令后的结果发送方式。`source` 发回原群聊/私聊，`admin` 发到管理员私聊，`silent` 不发送结果。
+- `commandResultAdminUserId` 仅在 `commandResultMode: admin` 时使用。填写管理员 QQ 号；留空时发给指令调用者。
 
 ## 消息模式
 

package/out/commands/index.d.ts

@@ -1,5 +1,6 @@
-import type { Context } from 'koishi';
+import { type Context, type Fragment, type Session } from 'koishi';
 import type { Config } from '../config';
 import type { RuntimeStatus } from '../types';
 export declare function renderStatus(status: RuntimeStatus): string;
+export declare function sendCommandResult(session: Session, config: Config, content: string): Promise<Fragment | void>;
 export declare function registerCommands(ctx: Context, config: Config): void;

package/out/commands/index.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderStatus = renderStatus;
+exports.sendCommandResult = sendCommandResult;
 exports.registerCommands = registerCommands;
+const koishi_1 = require("koishi");
+const logger = new koishi_1.Logger('mai.ko/commands');
 function formatTime(value) {
     return value ? new Date(value).toLocaleString() : '-';
 }
@@ -39,27 +42,53 @@ function renderStatus(status) {
     }
     return lines.join('\n');
 }
+async function sendCommandResult(session, config, content) {
+    if (config.commandResultMode === 'silent')
+        return;
+    if (config.commandResultMode !== 'admin')
+        return content;
+    const userId = config.commandResultAdminUserId.trim() || session.userId;
+    if (!userId)
+        return 'mai.ko 指令结果发送失败：没有可用的管理员用户 ID。';
+    if (!session.bot?.sendPrivateMessage)
+        return 'mai.ko 指令结果发送失败：当前平台不支持私聊发送。';
+    try {
+        const guildId = config.commandResultAdminGuildId.trim() || undefined;
+        await session.bot.sendPrivateMessage(userId, content, guildId, { session });
+        if (config.commandResultNotifySource)
+            return 'mai.ko 指令结果已发送给管理员。';
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warn(`send command result failed: user=${userId} error=${message}`);
+        return `mai.ko 指令结果发送失败：${message}`;
+    }
+}
+async function handleCommandResult(session, config, status) {
+    const content = renderStatus(await status);
+    return session ? sendCommandResult(session, config, content) : content;
+}
 function registerCommands(ctx, config) {
     const options = { authority: config.commandAuthority };
     ctx.command('mai.ko', '查看 mai.ko 托管状态', options)
         .alias('maibot')
-        .action(() => renderStatus(ctx.maimai.getStatus()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.getStatus()));
     ctx.command('mai.ko.status', '查看 mai.ko 托管状态', options)
-        .action(() => renderStatus(ctx.maimai.getStatus()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.getStatus()));
     ctx.command('mai.ko.start', '启动 mai.ko', options)
-        .action(async () => renderStatus(await ctx.maimai.launch()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.launch()));
     ctx.command('mai.ko.stop', '停止 mai.ko', options)
-        .action(async () => renderStatus(await ctx.maimai.shutdown()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.shutdown()));
     ctx.command('mai.ko.restart', '重启 mai.ko', options)
-        .action(async () => renderStatus(await ctx.maimai.restart()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.restart()));
     ctx.command('mai.ko.reconnect', '重连 mai.ko Bridge', options)
-        .action(async () => renderStatus(await ctx.maimai.reconnect()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.reconnect()));
     ctx.command('mai.ko.prepare', '准备 MaiBot 源码、补丁与 Docker 镜像', options)
-        .action(async () => renderStatus(await ctx.maimai.prepare()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.prepare()));
     ctx.command('mai.ko.docker.start', '启动 maimai-ko Docker 容器', options)
-        .action(async () => renderStatus(await ctx.maimai.dockerStart()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerStart()));
     ctx.command('mai.ko.docker.stop', '停止 maimai-ko Docker 容器', options)
-        .action(async () => renderStatus(await ctx.maimai.dockerStop()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerStop()));
     ctx.command('mai.ko.docker.restart', '重建并重启 maimai-ko Docker 容器', options)
-        .action(async () => renderStatus(await ctx.maimai.dockerRestart()));
+        .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerRestart()));
 }

package/out/config.d.ts

@@ -1,5 +1,5 @@
 import { Schema } from 'koishi';
-import type { MessageLogLevel, MessageMode, ProcessMode } from './types';
+import type { CommandResultMode, MessageLogLevel, MessageMode, ProcessMode } from './types';
 export interface Config {
     processMode: ProcessMode;
     maibotRoot: string;
@@ -30,6 +30,10 @@ export interface Config {
     imageDownloadMaxBytes: number;
     messageLogLevel: MessageLogLevel;
     commandAuthority: number;
+    commandResultMode: CommandResultMode;
+    commandResultAdminUserId: string;
+    commandResultAdminGuildId: string;
+    commandResultNotifySource: boolean;
     acceptMaibotAgreements: boolean;
     startupTimeout: number;
     shutdownTimeout: number;

package/out/config.js

@@ -54,6 +54,14 @@ exports.Config = koishi_1.Schema.intersect([
             koishi_1.Schema.const('detail').description('详细：输出每一步消息中转细节。'),
         ]).default('summary').description('mai.ko 消息中转日志详细程度。'),
         commandAuthority: koishi_1.Schema.number().min(0).max(5).default(3).description('管理指令需要的权限等级。'),
+        commandResultMode: koishi_1.Schema.union([
+            koishi_1.Schema.const('source').description('原会话：指令结果发送到触发指令的群聊或私聊。'),
+            koishi_1.Schema.const('admin').description('管理员私聊：指令结果发送到指定管理员；未填写管理员时发送给指令调用者。'),
+            koishi_1.Schema.const('silent').description('静默：执行指令但不发送结果。'),
+        ]).default('source').description('聊天中执行 mai.ko 管理指令后的结果发送方式。'),
+        commandResultAdminUserId: koishi_1.Schema.string().default('').description('管理员用户 ID。仅 commandResultMode=admin 时使用；留空时发送给指令调用者。'),
+        commandResultAdminGuildId: koishi_1.Schema.string().default('').description('发送管理员私聊时附带的群组/频道 ID。通常可留空。'),
+        commandResultNotifySource: koishi_1.Schema.boolean().default(false).description('结果发送给管理员后，是否在原会话发送一条简短提示。'),
     }).description('消息路由'),
     koishi_1.Schema.object({
         startupTimeout: koishi_1.Schema.number().min(1000).default(60000).description('等待 mai.ko API 可连接的超时时间，单位毫秒。'),

package/out/types.d.ts

@@ -1,5 +1,6 @@
 import type { Awaitable, Context, Fragment, Session } from 'koishi';
 export type MessageMode = 'coexist' | 'exclusive' | 'command';
+export type CommandResultMode = 'source' | 'admin' | 'silent';
 export type ProcessMode = 'docker' | 'managed' | 'external';
 export type ProcessState = 'idle' | 'starting' | 'running' | 'stopping' | 'stopped' | 'blocked' | 'error';
 export type TransportState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'error';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-mai-bridge",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "将 maibot 作为 docker 托管的消息回复后端运行，使用 mai.ko 桥接消息收发。",
   "author": "Jelly10086 <wow40469600@gmail.com>",
   "contributors": [

package/src/commands/index.ts

@@ -1,7 +1,9 @@
-import type { Context } from 'koishi'
+import { Logger, type Awaitable, type Context, type Fragment, type Session } from 'koishi'
 import type { Config } from '../config'
 import type { RuntimeStatus } from '../types'
 
+const logger = new Logger('mai.ko/commands')
+
 function formatTime(value?: number) {
   return value ? new Date(value).toLocaleString() : '-'
 }
@@ -34,37 +36,61 @@ export function renderStatus(status: RuntimeStatus) {
   return lines.join('\n')
 }
 
+export async function sendCommandResult(session: Session, config: Config, content: string): Promise<Fragment | void> {
+  if (config.commandResultMode === 'silent') return
+  if (config.commandResultMode !== 'admin') return content
+
+  const userId = config.commandResultAdminUserId.trim() || session.userId
+  if (!userId) return 'mai.ko 指令结果发送失败：没有可用的管理员用户 ID。'
+  if (!session.bot?.sendPrivateMessage) return 'mai.ko 指令结果发送失败：当前平台不支持私聊发送。'
+
+  try {
+    const guildId = config.commandResultAdminGuildId.trim() || undefined
+    await session.bot.sendPrivateMessage(userId, content, guildId, { session })
+    if (config.commandResultNotifySource) return 'mai.ko 指令结果已发送给管理员。'
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error)
+    logger.warn(`send command result failed: user=${userId} error=${message}`)
+    return `mai.ko 指令结果发送失败：${message}`
+  }
+}
+
+async function handleCommandResult(session: Session | undefined, config: Config, status: Awaitable<RuntimeStatus>) {
+  const content = renderStatus(await status)
+  return session ? sendCommandResult(session, config, content) : content
+}
+
 export function registerCommands(ctx: Context, config: Config) {
   const options = { authority: config.commandAuthority }
 
   ctx.command('mai.ko', '查看 mai.ko 托管状态', options)
     .alias('maibot')
-    .action(() => renderStatus(ctx.maimai.getStatus()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.getStatus()))
 
   ctx.command('mai.ko.status', '查看 mai.ko 托管状态', options)
-    .action(() => renderStatus(ctx.maimai.getStatus()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.getStatus()))
 
   ctx.command('mai.ko.start', '启动 mai.ko', options)
-    .action(async () => renderStatus(await ctx.maimai.launch()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.launch()))
 
   ctx.command('mai.ko.stop', '停止 mai.ko', options)
-    .action(async () => renderStatus(await ctx.maimai.shutdown()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.shutdown()))
 
   ctx.command('mai.ko.restart', '重启 mai.ko', options)
-    .action(async () => renderStatus(await ctx.maimai.restart()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.restart()))
 
   ctx.command('mai.ko.reconnect', '重连 mai.ko Bridge', options)
-    .action(async () => renderStatus(await ctx.maimai.reconnect()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.reconnect()))
 
   ctx.command('mai.ko.prepare', '准备 MaiBot 源码、补丁与 Docker 镜像', options)
-    .action(async () => renderStatus(await ctx.maimai.prepare()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.prepare()))
 
   ctx.command('mai.ko.docker.start', '启动 maimai-ko Docker 容器', options)
-    .action(async () => renderStatus(await ctx.maimai.dockerStart()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerStart()))
 
   ctx.command('mai.ko.docker.stop', '停止 maimai-ko Docker 容器', options)
-    .action(async () => renderStatus(await ctx.maimai.dockerStop()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerStop()))
 
   ctx.command('mai.ko.docker.restart', '重建并重启 maimai-ko Docker 容器', options)
-    .action(async () => renderStatus(await ctx.maimai.dockerRestart()))
+    .action((argv) => handleCommandResult(argv.session, config, ctx.maimai.dockerRestart()))
 }

package/src/config.ts

@@ -1,5 +1,5 @@
 import { Schema } from 'koishi'
-import type { MessageLogLevel, MessageMode, ProcessMode } from './types'
+import type { CommandResultMode, MessageLogLevel, MessageMode, ProcessMode } from './types'
 
 export interface Config {
   processMode: ProcessMode
@@ -31,6 +31,10 @@ export interface Config {
   imageDownloadMaxBytes: number
   messageLogLevel: MessageLogLevel
   commandAuthority: number
+  commandResultMode: CommandResultMode
+  commandResultAdminUserId: string
+  commandResultAdminGuildId: string
+  commandResultNotifySource: boolean
   acceptMaibotAgreements: boolean
   startupTimeout: number
   shutdownTimeout: number
@@ -105,6 +109,14 @@ export const Config: Schema<Config> = Schema.intersect([
       Schema.const('detail').description('详细：输出每一步消息中转细节。'),
     ]).default('summary').description('mai.ko 消息中转日志详细程度。'),
     commandAuthority: Schema.number().min(0).max(5).default(3).description('管理指令需要的权限等级。'),
+    commandResultMode: Schema.union([
+      Schema.const('source').description('原会话：指令结果发送到触发指令的群聊或私聊。'),
+      Schema.const('admin').description('管理员私聊：指令结果发送到指定管理员；未填写管理员时发送给指令调用者。'),
+      Schema.const('silent').description('静默：执行指令但不发送结果。'),
+    ]).default('source').description('聊天中执行 mai.ko 管理指令后的结果发送方式。'),
+    commandResultAdminUserId: Schema.string().default('').description('管理员用户 ID。仅 commandResultMode=admin 时使用；留空时发送给指令调用者。'),
+    commandResultAdminGuildId: Schema.string().default('').description('发送管理员私聊时附带的群组/频道 ID。通常可留空。'),
+    commandResultNotifySource: Schema.boolean().default(false).description('结果发送给管理员后，是否在原会话发送一条简短提示。'),
   }).description('消息路由'),
   Schema.object({
     startupTimeout: Schema.number().min(1000).default(60000).description('等待 mai.ko API 可连接的超时时间，单位毫秒。'),

package/src/types.ts

@@ -1,6 +1,7 @@
 import type { Awaitable, Context, Fragment, Session } from 'koishi'
 
 export type MessageMode = 'coexist' | 'exclusive' | 'command'
+export type CommandResultMode = 'source' | 'admin' | 'silent'
 export type ProcessMode = 'docker' | 'managed' | 'external'
 export type ProcessState = 'idle' | 'starting' | 'running' | 'stopping' | 'stopped' | 'blocked' | 'error'
 export type TransportState = 'idle' | 'connecting' | 'connected' | 'disconnected' | 'error'