@jsbot-tellus/core 2.0.3 → 2.2.0

package/dist/core/plugin/types.d.ts

@@ -7,6 +7,7 @@ import type { SendOptions } from '../messaging/sender.js';
 import type { PluginKV } from '../plugin/kv.js';
 import type { Permission } from '../security/permission.js';
 import type { SessionStore } from '../storage/session.js';
+import type { CommandParamArgs } from './command-params.js';
 export type EventType = 'message' | 'notice' | 'request' | 'meta';
 export interface CommandMatch {
     command: string;
@@ -19,6 +20,7 @@ export interface CommandInfo {
     aliases: string[];
     permission: Permission;
     description?: string | undefined;
+    usage?: string | undefined;
     pluginId: string;
 }
 export interface EventContext<TEvent extends SnowLumaEvent = SnowLumaEvent> {
@@ -29,17 +31,25 @@ export interface EventContext<TEvent extends SnowLumaEvent = SnowLumaEvent> {
     send(message: OutgoingMessage, options?: SendOptions): Promise<unknown>;
     stopPropagation(): void;
 }
-export type CommandHandler<TEvent extends OneBotMessageEvent = OneBotMessageEvent> = (event: TEvent, context: EventContext<TEvent>, match: CommandMatch) => void | Promise<void>;
+export type CommandHandler<TEvent extends OneBotMessageEvent = OneBotMessageEvent, TArgs extends unknown[] = []> = (event: TEvent, context: EventContext<TEvent>, match: CommandMatch, ...args: TArgs) => void | Promise<void>;
 export type MessageHandler = (event: OneBotMessageEvent, context: EventContext<OneBotMessageEvent>) => void | Promise<void>;
 export type NoticeHandler = (event: OneBotNoticeEvent, context: EventContext<OneBotNoticeEvent>) => void | Promise<void>;
 export type RequestHandler = (event: OneBotRequestEvent, context: EventContext<OneBotRequestEvent>) => void | Promise<void>;
 export type PluginMiddleware = (event: SnowLumaEvent, context: EventContext, next: () => Promise<void>) => void | Promise<void>;
-export interface CommandOptions {
+export interface CommandOptions<Declaration extends string = string> {
     name: string;
     aliases?: string[] | undefined;
     prefixes?: string[] | undefined;
     permission?: Permission | undefined;
     description?: string | undefined;
+    params?: Declaration | undefined;
+}
+export interface CommandGroupOptions<Declaration extends string = string> extends CommandOptions<Declaration> {
+    handler?: CommandHandler<OneBotMessageEvent, CommandParamArgs<Declaration>> | undefined;
+}
+export interface CommandGroupRegistrar {
+    register<Declaration extends string = string>(options: CommandOptions<Declaration>, handler: CommandHandler<OneBotMessageEvent, CommandParamArgs<Declaration>>): () => void;
+    group<Declaration extends string = string>(options: CommandGroupOptions<Declaration>, setup: (group: CommandGroupRegistrar) => void): () => void;
 }
 export interface NoticeOptions {
     noticeType?: string | undefined;
@@ -53,8 +63,7 @@ export interface MiddlewareOptions {
     eventTypes?: EventType[] | undefined;
     priority?: number | undefined;
 }
-export interface CommandRegistrar {
-    register(options: CommandOptions, handler: CommandHandler): () => void;
+export interface CommandRegistrar extends CommandGroupRegistrar {
     list(): ReadonlyArray<CommandInfo>;
 }
 export interface EventRegistrar {
@@ -114,7 +123,7 @@ export interface CoreServices {
         can(actual: Permission, required: Permission): boolean;
     };
     commands: {
-        list(): ReadonlyArray<CommandInfo>;
+        list(event?: SnowLumaEvent): ReadonlyArray<CommandInfo>;
     };
     plugins: PluginStatus;
     installer: PluginInstaller;

package/dist/core/plugin/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/plugin/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/plugin/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EAChB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAE3D,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAA;AAEjE,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,UAAU,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IAEzB,IAAI,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAEvE,eAAe,IAAI,IAAI,CAAA;CAC1B;AAED,MAAM,MAAM,cAAc,CACtB,MAAM,SAAS,kBAAkB,GAAG,kBAAkB,EACtD,KAAK,SAAS,OAAO,EAAE,GAAG,EAAE,IAC5B,CACA,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,EAC7B,KAAK,EAAE,YAAY,EACnB,GAAG,IAAI,EAAE,KAAK,KACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,cAAc,GAAG,CACzB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,YAAY,CAAC,kBAAkB,CAAC,KACxC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,aAAa,GAAG,CACxB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,YAAY,CAAC,iBAAiB,CAAC,KACvC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,cAAc,GAAG,CACzB,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,YAAY,CAAC,kBAAkB,CAAC,KACxC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,MAAM,gBAAgB,GAAG,CAC3B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACxB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAEzB,MAAM,WAAW,cAAc,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM;IAC/D,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IAC/B,UAAU,CAAC,EAAE,UAAU,GAAG,SAAS,CAAA;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,mBAAmB,CAChC,WAAW,SAAS,MAAM,GAAG,MAAM,CACrC,SAAQ,cAAc,CAAC,WAAW,CAAC;IACjC,OAAO,CAAC,EACF,cAAc,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAC,GACjE,SAAS,CAAA;CAClB;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,EACxC,OAAO,EAAE,cAAc,CAAC,WAAW,CAAC,EACpC,OAAO,EAAE,cAAc,CACnB,kBAAkB,EAClB,gBAAgB,CAAC,WAAW,CAAC,CAChC,GACF,MAAM,IAAI,CAAA;IACb,KAAK,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,EACrC,OAAO,EAAE,mBAAmB,CAAC,WAAW,CAAC,EACzC,KAAK,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAC9C,MAAM,IAAI,CAAA;CAChB;AAED,MAAM,WAAW,aAAa;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC3B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAChC;AAED,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC3D,IAAI,IAAI,aAAa,CAAC,WAAW,CAAC,CAAA;CACrC;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAAA;IAC9C,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,IAAI,CAAA;IACpE,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,IAAI,CAAA;CAC1E;AAED,MAAM,WAAW,mBAAmB;IAChC,GAAG,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAAA;CACzE;AAED,MAAM,WAAW,iBAAiB;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,IAAI,iBAAiB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,mBAAmB,EAAE,CAAA;IAC9B,MAAM,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC1D;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,IAAI,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IACvC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACzE,MAAM,CACF,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,GACtD,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC9B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;CAC7E;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE;QACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;QAClC,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAA;KACzD,CAAA;IACD,QAAQ,EAAE;QACN,IAAI,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC,WAAW,CAAC,CAAA;KAC1D,CAAA;IACD,OAAO,EAAE,YAAY,CAAA;IACrB,SAAS,EAAE,eAAe,CAAA;IAC1B,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAA;IACnC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAA;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc,CAAC,OAAO,GAAG,OAAO;IAC7C,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACpC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,GAAG,IAAI;IAC9D,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAChE,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3C,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7C;AAED,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAEpE,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAC/C,UAAU,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,GAC9C,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAEnC"}

package/dist/core/plugin/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/plugin/types.ts"],"names":[],"mappings":"AA+MA,MAAM,UAAU,YAAY,CACxB,UAA6C;IAE7C,OAAO,UAAU,CAAA;AACrB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/plugin/types.ts"],"names":[],"mappings":"AAyOA,MAAM,UAAU,YAAY,CACxB,UAA6C;IAE7C,OAAO,UAAU,CAAA;AACrB,CAAC"}

package/dist/plugins/admin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/admin/index.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,WAAW,6EA4StB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/admin/index.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,WAAW,6EA+WtB,CAAA"}

package/dist/plugins/admin/index.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { definePlugin } from '../../core/index.js';
+const INSTALLER_DISABLED = '插件安装功能未启用（installer.enabled=false）。';
 const PLUGIN_USAGE = `用法：
 /plugin install <npm包[@版本|tag]>
 /plugin list
@@ -21,50 +22,49 @@ export const adminPlugin = definePlugin({
         configSchema: z.object({}).strict(),
     },
     setup(ctx) {
-        ctx.commands.register({
+        ctx.commands.group({
             name: 'utter',
             permission: 'Admin',
             description: '向当前会话发送文本',
-        }, async (_event, context, match) => {
-            if (!match.rest) {
-                await context.send('用法：/utter <文本>');
-                return;
-            }
-            await context.send(match.rest, {
-                quote: false,
-                autoEscape: true,
-            });
-        });
-        ctx.commands.register({
-            name: 'utter.raw',
-            permission: 'SuperAdmin',
-            description: '发送原始 CQ 消息',
-        }, async (_event, context, match) => {
-            if (!match.rest) {
-                await context.send('用法：/utter.raw <CQ 消息>');
-                return;
-            }
-            await context.send(match.rest, {
-                quote: false,
-                autoEscape: false,
+            handler: async (_event, context, match) => {
+                if (!match.rest) {
+                    await context.send('用法：/utter <文本>');
+                    return;
+                }
+                await context.send(match.rest, {
+                    quote: false,
+                    autoEscape: true,
+                });
+            },
+        }, (utter) => {
+            utter.register({
+                name: 'raw',
+                permission: 'SuperAdmin',
+                description: '发送原始 CQ 消息',
+            }, async (_event, context, match) => {
+                if (!match.rest) {
+                    await context.send('用法：/utter raw <CQ 消息>');
+                    return;
+                }
+                await context.send(match.rest, {
+                    quote: false,
+                    autoEscape: false,
+                });
             });
         });
-        ctx.commands.register({
+        ctx.commands.group({
             name: 'plugin',
             permission: 'SuperAdmin',
             description: '管理已安装的插件包',
-        }, async (_event, context, match) => {
-            const sub = (match.args[0] ?? '').toLowerCase();
-            const argument = match.rest
-                .slice(match.args[0]?.length ?? 0)
-                .trim();
-            const installer = ctx.core.installer;
-            const sessionId = context.sessionId;
-            if (sub.length === 0 || sub === 'help') {
+            handler: async (_event, context) => {
                 await context.send(PLUGIN_USAGE, { quote: false });
-                return;
-            }
-            if (sub === 'list') {
+            },
+        }, (plugin) => {
+            plugin.register({
+                name: 'list',
+                description: '列出已安装的插件包',
+            }, async (_event, context) => {
+                const installer = ctx.core.installer;
                 try {
                     const packages = await installer.list();
                     if (packages.length === 0) {
@@ -74,7 +74,9 @@ export const adminPlugin = definePlugin({
                         return;
                     }
                     const lines = packages.map((item) => {
-                        const status = item.loaded ? '已加载' : '重启后生效';
+                        const status = item.loaded
+                            ? '已加载'
+                            : '重启后生效';
                         return `- ${item.packageName}@${item.version} → ${formatIds(item.pluginIds)}（${status}）`;
                     });
                     await context.send([
@@ -85,17 +87,20 @@ export const adminPlugin = definePlugin({
                 catch (error) {
                     await context.send(`❌ 读取插件包失败：${errorMessage(error)}`, { quote: false });
                 }
-                return;
-            }
-            if (sub !== 'install' && sub !== 'remove' && sub !== 'update') {
-                await context.send(PLUGIN_USAGE, { quote: false });
-                return;
-            }
-            if (!installer.enabled) {
-                await context.send('插件安装功能未启用（installer.enabled=false）。', { quote: false });
-                return;
-            }
-            if (sub === 'install') {
+            });
+            plugin.register({
+                name: 'install',
+                description: '安装 npm 插件包',
+            }, async (_event, context, match) => {
+                const installer = ctx.core.installer;
+                const sessionId = context.sessionId;
+                if (!installer.enabled) {
+                    await context.send(INSTALLER_DISABLED, {
+                        quote: false,
+                    });
+                    return;
+                }
+                const argument = match.rest.trim();
                 if (argument.length === 0) {
                     await context.send('用法：/plugin install <npm包[@版本|tag]>', { quote: false });
                     return;
@@ -126,9 +131,20 @@ export const adminPlugin = definePlugin({
                         await ctx.api.send(sessionId, `❌ 安装失败：${errorMessage(error)}`, { quote: false });
                     }
                 });
-                return;
-            }
-            if (sub === 'remove') {
+            });
+            plugin.register({
+                name: 'remove',
+                description: '卸载插件包',
+            }, async (_event, context, match) => {
+                const installer = ctx.core.installer;
+                const sessionId = context.sessionId;
+                if (!installer.enabled) {
+                    await context.send(INSTALLER_DISABLED, {
+                        quote: false,
+                    });
+                    return;
+                }
+                const argument = match.rest.trim();
                 if (argument.length === 0) {
                     await context.send('用法：/plugin remove <包名|插件id> [--force]', { quote: false });
                     return;
@@ -147,7 +163,9 @@ export const adminPlugin = definePlugin({
                 ctx.tasks.enqueue('plugin-installer', async (signal) => {
                     try {
                         const result = await installer.remove(target, signal, { force });
-                        const lines = [`✅ 已卸载 ${result.packageName}。`];
+                        const lines = [
+                            `✅ 已卸载 ${result.packageName}。`,
+                        ];
                         if (result.pluginIds.length > 0) {
                             lines.push(`插件 id: ${formatIds(result.pluginIds)}`);
                         }
@@ -171,44 +189,59 @@ export const adminPlugin = definePlugin({
                         await ctx.api.send(sessionId, `❌ 卸载失败：${errorMessage(error)}`, { quote: false });
                     }
                 });
-                return;
-            }
-            await context.send(argument.length > 0
-                ? `正在更新 ${argument} ...`
-                : '正在更新全部插件包 ...', { quote: false });
-            ctx.tasks.enqueue('plugin-installer', async (signal) => {
-                try {
-                    const result = await installer.update(argument.length > 0 ? argument : undefined, signal);
-                    const lines = [];
-                    const warnings = result.updated.flatMap((item) => item.warnings);
-                    for (const item of result.updated) {
-                        lines.push(`✅ ${item.packageName}@${item.version}（插件 id: ${formatIds(item.pluginIds)}）`);
-                    }
-                    for (const item of result.failed) {
-                        lines.push(`❌ ${item.packageName}：${item.message}`);
-                    }
-                    for (const warning of warnings) {
-                        lines.push(`⚠️ ${warning}`);
-                    }
-                    if (lines.length === 0) {
-                        lines.push('没有可更新的插件包。');
-                    }
-                    if (result.updated.length > 0) {
-                        lines.push(warnings.length === 0
-                            ? '正在重启。'
-                            : '请处理以上问题后手动重启。');
-                    }
-                    await ctx.api.send(sessionId, lines.join('\n'), {
+            });
+            plugin.register({
+                name: 'update',
+                description: '更新插件包',
+            }, async (_event, context, match) => {
+                const installer = ctx.core.installer;
+                const sessionId = context.sessionId;
+                if (!installer.enabled) {
+                    await context.send(INSTALLER_DISABLED, {
                         quote: false,
                     });
-                    if (result.updated.length > 0 &&
-                        warnings.length === 0) {
-                        ctx.core.restart();
-                    }
-                }
-                catch (error) {
-                    await ctx.api.send(sessionId, `❌ 更新失败：${errorMessage(error)}`, { quote: false });
+                    return;
                 }
+                const argument = match.rest.trim();
+                await context.send(argument.length > 0
+                    ? `正在更新 ${argument} ...`
+                    : '正在更新全部插件包 ...', { quote: false });
+                ctx.tasks.enqueue('plugin-installer', async (signal) => {
+                    try {
+                        const result = await installer.update(argument.length > 0
+                            ? argument
+                            : undefined, signal);
+                        const lines = [];
+                        const warnings = result.updated.flatMap((item) => item.warnings);
+                        for (const item of result.updated) {
+                            lines.push(`✅ ${item.packageName}@${item.version}（插件 id: ${formatIds(item.pluginIds)}）`);
+                        }
+                        for (const item of result.failed) {
+                            lines.push(`❌ ${item.packageName}：${item.message}`);
+                        }
+                        for (const warning of warnings) {
+                            lines.push(`⚠️ ${warning}`);
+                        }
+                        if (lines.length === 0) {
+                            lines.push('没有可更新的插件包。');
+                        }
+                        if (result.updated.length > 0) {
+                            lines.push(warnings.length === 0
+                                ? '正在重启。'
+                                : '请处理以上问题后手动重启。');
+                        }
+                        await ctx.api.send(sessionId, lines.join('\n'), {
+                            quote: false,
+                        });
+                        if (result.updated.length > 0 &&
+                            warnings.length === 0) {
+                            ctx.core.restart();
+                        }
+                    }
+                    catch (error) {
+                        await ctx.api.send(sessionId, `❌ 更新失败：${errorMessage(error)}`, { quote: false });
+                    }
+                });
             });
         });
     },

package/dist/plugins/admin/index.js.map

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

package/dist/plugins/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/core/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,UAAU,6EAqFrB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/core/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,UAAU,6EAyFrB,CAAA"}

package/dist/plugins/core/index.js

@@ -31,9 +31,12 @@ export const corePlugin = definePlugin({
         }, async (event, context) => {
             const role = ctx.core.roles.roleOf(event.user_id);
             const commands = ctx.core.commands
-                .list()
+                .list(event)
                 .filter((command) => ctx.core.roles.can(role, command.permission))
                 .map((command) => {
+                const usage = command.usage !== undefined
+                    ? ` ${command.usage}`
+                    : '';
                 const aliases = command.aliases.length > 0
                     ? ` (${command.aliases
                         .map((alias) => `/${alias}`)
@@ -42,7 +45,7 @@ export const corePlugin = definePlugin({
                 const description = command.description
                     ? ` - ${command.description}`
                     : '';
-                return `/${command.name}${aliases}${description}`;
+                return `/${command.name}${usage}${aliases}${description}`;
             });
             await context.send(`可用命令：\n${commands.join('\n')}`);
         });

package/dist/plugins/core/index.js.map

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

package/docs/architecture.md

@@ -4,7 +4,7 @@
 
 ```text
 src/plugins/*  ->  src/core/index.ts 的公共 API（内置插件）
-外部插件包     ->  @jsbot-tellus/core 的公共 API
+本地/npm 插件包 ->  @jsbot-tellus/core 的公共 API
 src/core/*     ->  SDK adapter、Node 内置模块、SQLite
 src/core/*     -X-> src/plugins/*
 ```
@@ -16,8 +16,8 @@ src/core/*     -X-> src/plugins/*
 - 插件只能通过 `PluginContext`、`EventContext` 和 `BotApi` 使用能力。
 - `core` 不 import 任何插件；`core`、`admin` 在 `src/plugins/index.ts` 显式注册。
 - 内置插件是普通源码，随内核一起编译；没有独立依赖，不单独建包。
-- 外部插件由 `src/app.ts` 在启动前扫描并追加到内置插件之后。
-- 本地插件放在不跟踪的 `plugins/`，每个插件是独立包，通过 `--plugin-dir` 加载。
+- 本地插件由 `src/app.ts` 在启动前扫描 `plugins/<id>/dist` 并追加到内置插件之后；缺少 `dist` 时加载器会尝试执行插件的 `build` 脚本。
+- 本地插件放在不跟踪的 `plugins/`，每个插件是独立包，构建后自动加载。
 
 ## 运行时主链路
 
@@ -25,7 +25,7 @@ src/core/*     -X-> src/plugins/*
 SDK WebSocket
   -> client.use(router.dispatch)
      -> Router 中间件（按 priority 降序，逐插件 gating）
-     -> CommandRegistry.match
+     -> CommandRegistry.match（前缀最长优先，完整路径最长优先）
         -> 命中命令：stopPropagation
         -> 插件启用 / 群组 / 私聊 gating
         -> 权限检查
@@ -48,7 +48,7 @@ src/
     config/               配置 schema 和加载
     dispatch/
       router.ts           唯一 SDK middleware
-      command.ts          命令索引和冲突检测
+      command.ts          命令索引、组注册、多级匹配和冲突检测
       handler.ts          事件 handler 注册表
       middleware.ts       插件中间件注册表
       task-queue.ts       按 key 串行任务队列
@@ -58,14 +58,14 @@ src/
       host.ts             插件排序、配置校验、setup/start/stop
       gating.ts           enabled/private/groups
       kv.ts               SQLite KV
-      loader.ts           外部插件目录加载
+      loader.ts           本地插件目录加载（缺 dist 时自动构建）
     security/             角色、权限、拒绝提示
     messaging/            reply/forward 发送和回复分段
     storage/              SQLite 和 Session
     lifecycle/            启动/停止状态机
   plugins/
     core/index.ts         /help、/status、/role
-    admin/index.ts        /utter、/utter.raw
+    admin/index.ts        /utter、/utter raw
     index.ts              内置插件清单
 plugins/                  本地插件根目录，整个目录不跟踪
   poke/
@@ -75,7 +75,7 @@ plugins/                  本地插件根目录，整个目录不跟踪
 ## 启动顺序
 
 ```text
-加载配置和外部插件
+加载配置和本地插件
   -> 打开数据库
   -> 创建 Kernel
      -> 创建 Router、PluginGate、SessionStore、TaskQueue、BotApi
@@ -128,24 +128,21 @@ npm run smoke   # node dist/app.js --help
 npm install --prefix plugins/poke
 npm install --prefix plugins/llm
 npm run build:local
-node dist/app.js \
-    --plugin-dir plugins/poke/dist \
-    --plugin-dir plugins/llm/dist
+node dist/app.js
 ```
 
-`--plugin-dir` 可以重复。应用会跳过与内置插件同 ID 的外部插件，避免重复注册。
+应用会固定扫描 `plugins/<id>/dist`，并跳过与内置插件同 ID 的本地插件，避免重复注册。没有 `dist` 的本地插件如果带有 `build` 脚本且依赖已安装，会先自动构建再加载；没有 `build` 脚本、缺少 `node_modules` 或构建失败时会记录警告并跳过。
 
 ## 在线安装插件
 
-`admin` 插件注册 `/plugin` 命令，通过 `ctx.core.installer` 调用 `NpmPluginInstaller`。安装器位于 `src/core/plugin/`：
+`admin` 插件注册 `/plugin` 指令组，通过 `ctx.core.installer` 调用 `NpmPluginInstaller`。安装器位于 `src/core/plugin/`：
 
 ```text
 spec.ts             解析并校验 npm 包名 / 精确版本 / dist-tag
 npm-runner.ts       execFile 调用 npm，支持超时和取消
-install-dir.ts      <data-dir>/plugins 的 manifest、状态文件和 @jsbot-tellus/core 链接
-install-validate.ts 在子进程中 import 包，确认它导出插件定义
-installer.ts        安装 / 列表 / 卸载 / 更新、串行化、备份与回滚
-installed.ts        启动时从安装目录加载已安装包
+install-dir.ts      plugins/ 的安装状态、校验脚本和 @jsbot-tellus/core 链接
+install-validate.ts 在子进程中扫描插件 dist，确认它导出插件定义
+installer.ts        安装 / 列表 / 卸载 / 更新、串行化、目录替换与回滚
 ```
 
 安装流程：
@@ -153,17 +150,18 @@ installed.ts        启动时从安装目录加载已安装包
 ```text
 /plugin install <spec>
   -> 校验 npm registry 来源和允许列表
-  -> npm install <spec> --save-exact [--ignore-scripts]
-  -> 重建 node_modules/@jsbot-tellus/core 链接
-  -> 子进程 import 包，收集 manifest.id / version / dependencies
+  -> 在 plugins/.staging-<uuid> 中 npm install <spec> --save-exact [--ignore-scripts]
+  -> 把包内容移到插件目录根，依赖留在 <插件目录>/node_modules
+  -> 创建 <插件目录>/node_modules/@jsbot-tellus/core 链接
+  -> 子进程扫描 dist，收集 manifest.id / version / dependencies
   -> 检查 id 冲突和完整依赖图（缺失、自依赖、循环）
-  -> 原子写入 .jsbot-installed.json
-  -> 自动重建运行时，由 installed.ts 重新加载
+  -> 原子替换 plugins/<插件id>，写入 plugins/.jsbot-installed.json
+  -> 自动重建运行时，由同一个本地插件加载器重新加载
 ```
 
-npm 或校验失败时，安装器恢复安装前的 `package.json` / `package-lock.json` / `.jsbot-installed.json`，并运行 `npm ci`（没有旧 lockfile 时运行 `npm install`）恢复 `node_modules`。所有安装操作通过内部队列串行执行。状态文件损坏时安装器会明确报错，不会用空状态覆盖其它包记录。
+安装或校验失败时目标目录不会被替换；更新会先用暂存目录完成下载和校验，再替换旧目录。所有安装操作通过内部队列串行执行。状态文件损坏时安装器会明确报错，不会用空状态覆盖其它包记录。
 
-加载顺序是内置插件 → `--plugin-dir` 外部插件 → `<data-dir>/plugins` 已安装插件。重复 ID 保留先加载的插件并记录警告。安装器不直接修改运行中的插件状态；操作成功后由应用重建运行时并重新加载。卸载时如果检测到配置残留，会跳过自动重启并提示手动处理；如果其它已安装包依赖被卸载的插件，默认拒绝卸载，`--force` 可强制继续。安装器默认关闭，安装的插件是完全可信的宿主进程代码。
+启动时加载顺序是内置插件 → `plugins/` 中的全部目录（本地插件和在线安装的插件没有区别）。重复 ID 保留先加载的插件并记录警告。安装器不直接修改运行中的插件状态；操作成功后由应用重建运行时并重新加载。卸载时如果检测到配置残留，会跳过自动重启并提示手动处理；如果其它已安装包依赖被卸载的插件，默认拒绝卸载，`--force` 可强制继续。安装器默认关闭，安装的插件是完全可信的宿主进程代码。
 
 ## 测试边界