@zhin.js/command 1.0.11 → 1.0.13

package/lib/command-index.d.ts

@@ -1,5 +1,5 @@
 import type { CapabilitySlot, PluginId, RuntimeSnapshot } from '@zhin.js/plugin-runtime';
-import { type CommandDefinition, type CommandParameterDefinition, type CommandParameterType, type CommandSegment } from './definition.js';
+import { type CommandDefinition, type CommandParameterDefinition, type CommandParameterType, type CommandSegment, type CommandPromptFactory } from './definition.js';
 export interface CommandParameterDescriptor extends CommandParameterDefinition {
     readonly required: boolean;
 }
@@ -20,15 +20,18 @@ export interface CommandDispatchResult {
     readonly value?: unknown;
 }
 export type CommandMatchInput = string | readonly Readonly<CommandSegment>[];
+export interface CommandMenuConfig {
+    readonly keyword: string;
+}
 export declare class CommandIndex {
     #private;
     private readonly snapshot;
     readonly $projection: "zhin.command-index/1";
-    constructor(slots: readonly Readonly<CapabilitySlot<CommandDefinition>>[], snapshot: RuntimeSnapshot);
+    constructor(slots: readonly Readonly<CapabilitySlot<CommandDefinition>>[], snapshot: RuntimeSnapshot, menu?: CommandMenuConfig);
     list(): readonly CommandDescriptor[];
     has(name: string): boolean;
     execute(name: string, args?: readonly string[]): Promise<unknown>;
-    dispatch(input: CommandMatchInput, source?: unknown): Promise<CommandDispatchResult>;
+    dispatch(input: CommandMatchInput, source?: unknown, promptFactory?: CommandPromptFactory, commandPrefix?: string): Promise<CommandDispatchResult>;
 }
 export declare function isCommandIndex(value: unknown): value is CommandIndex;
 export declare class CommandParameterValueError extends TypeError {

package/lib/command-index.js

@@ -19,8 +19,10 @@ export class CommandIndex {
     #commands;
     #routes;
     #shortcuts;
-    constructor(slots, snapshot) {
+    #menu;
+    constructor(slots, snapshot, menu) {
         this.snapshot = snapshot;
+        this.#menu = menu;
         const commands = [];
         const routes = [];
         const occupancy = new Map();
@@ -117,13 +119,25 @@ export class CommandIndex {
         // Host / 无 session：跳过 permit；无 source 时函数默认值得到空 session。
         return match.command.slot.definition.execute(createCommandContext(this.snapshot, match.command.slot.owner, args, resolveDynamicParams(match.params, undefined)));
     }
-    async dispatch(input, source = undefined) {
+    async dispatch(input, source = undefined, promptFactory, commandPrefix = '') {
+        if (this.#menu) {
+            const menuValue = this.#dispatchMenu(input, commandPrefix);
+            if (menuValue !== undefined) {
+                return Object.freeze({
+                    matched: true,
+                    command: this.#menu.keyword,
+                    owner: this.snapshot.root,
+                    value: menuValue,
+                });
+            }
+        }
+        const prompt = promptFactory?.(source);
         const shortcut = this.#matchShortcut(input);
         if (shortcut) {
             if (!(await this.#permitAllows(shortcut.record, source))) {
                 return Object.freeze({ matched: false });
             }
-            const value = await shortcut.record.slot.definition.execute(createCommandContext(this.snapshot, shortcut.record.slot.owner, Object.freeze([]), resolveDynamicParams(shortcut.params, source), source, Object.freeze([])));
+            const value = await shortcut.record.slot.definition.execute(createCommandContext(this.snapshot, shortcut.record.slot.owner, Object.freeze([]), resolveDynamicParams(shortcut.params, source), source, Object.freeze([]), prompt));
             return Object.freeze({
                 matched: true,
                 command: shortcut.record.name,
@@ -138,7 +152,7 @@ export class CommandIndex {
             return Object.freeze({ matched: false });
         }
         const args = textArgs(match.remaining);
-        const value = await match.command.slot.definition.execute(createCommandContext(this.snapshot, match.command.slot.owner, args, resolveDynamicParams(match.params, source), source, match.remaining));
+        const value = await match.command.slot.definition.execute(createCommandContext(this.snapshot, match.command.slot.owner, args, resolveDynamicParams(match.params, source), source, match.remaining, prompt));
         return Object.freeze({
             matched: true,
             command: match.command.name,
@@ -232,6 +246,65 @@ export class CommandIndex {
             throw new CommandParameterValueError(parameter.name, parameter.type, value);
         }
     }
+    // ==========================================================================
+    // 内置菜单命令
+    // ==========================================================================
+    #dispatchMenu(input, commandPrefix = '') {
+        const text = typeof input === 'string' ? input.trim() : exactMessageText(input);
+        if (text === undefined)
+            return undefined;
+        const keyword = this.#menu.keyword;
+        if (text === keyword)
+            return this.#buildMenu(undefined, commandPrefix);
+        if (text.startsWith(keyword + ' ')) {
+            const key = text.slice(keyword.length + 1).trim();
+            if (key)
+                return this.#buildMenu(key, commandPrefix);
+            return this.#buildMenu(undefined, commandPrefix);
+        }
+        return undefined;
+    }
+    #buildMenu(pluginKey, commandPrefix = '') {
+        const root = this.snapshot.root;
+        const targetId = pluginKey
+            ? `${root}/${pluginKey.split('.').join('/')}`
+            : root;
+        const node = this.snapshot.tree.get(targetId);
+        if (!node)
+            return `未找到插件: ${pluginKey}`;
+        const directCommands = this.#commands.filter((cmd) => cmd.slot.owner === targetId);
+        const children = node.children
+            .map((childId) => this.snapshot.tree.get(childId))
+            .filter((child) => !!child);
+        const keyword = this.#menu.keyword;
+        const displayKey = pluginKey ?? node.instanceKey;
+        const lines = [`=== ${displayKey} 指令菜单 ===`];
+        if (directCommands.length > 0) {
+            lines.push('');
+            for (const cmd of directCommands) {
+                const desc = cmd.description ? `  - ${cmd.description}` : '';
+                lines.push(`  ${commandPrefix}${cmd.name}${desc}`);
+            }
+        }
+        if (children.length > 0) {
+            lines.push('');
+            lines.push('子插件：');
+            for (const child of children) {
+                const childKey = pluginKey ? `${pluginKey}.${child.instanceKey}` : child.instanceKey;
+                const label = child.metadata?.displayName ?? child.instanceKey;
+                lines.push(`  ${childKey}  (${label})`);
+            }
+        }
+        if (directCommands.length === 0 && children.length === 0) {
+            lines.push('');
+            lines.push('（暂无指令和子插件）');
+        }
+        if (children.length > 0) {
+            lines.push('');
+            lines.push(`提示：使用「${commandPrefix}${keyword} <插件名>」查看子插件的指令`);
+        }
+        return lines.join('\n');
+    }
 }
 export function isCommandIndex(value) {
     return !!value && typeof value === 'object'

package/lib/definition.d.ts

@@ -143,6 +143,56 @@ export interface CommandSession {
     /** 发送者对象（id / name / role[]）。 */
     readonly sender?: CommandSender;
 }
+export interface CommandPromptOptions {
+    readonly timeout?: number;
+    readonly timeoutText?: string;
+    /** Cancel the pending claim when the owning turn aborts. */
+    readonly signal?: AbortSignal;
+}
+export interface CommandPromptListOptions extends CommandPromptOptions {
+    readonly type?: 'text' | 'number' | 'boolean';
+    readonly separator?: string;
+    readonly default?: readonly (string | number | boolean)[];
+}
+export interface CommandPromptPickOptions<V = unknown> extends CommandPromptOptions {
+    readonly options: readonly {
+        readonly label: string;
+        readonly value: V;
+    }[];
+    readonly multiple?: boolean;
+    readonly separator?: string;
+    readonly default?: V | readonly V[];
+}
+/**
+ * 命令内对话式交互输入。
+ *
+ * IM 派发时自动注入（`context.prompt`）；Host / CLI 无消息来源时为 `undefined`。
+ *
+ * ```ts
+ * defineCommand({
+ *   execute: async (context) => {
+ *     const name = await context.prompt!.text('请输入你的名字');
+ *     const age = await context.prompt!.number('请输入你的年龄');
+ *     return `你好 ${name}，你 ${age} 岁了`;
+ *   },
+ * });
+ * ```
+ */
+export interface CommandPrompt {
+    text(tips: string, options?: CommandPromptOptions & {
+        readonly default?: string;
+    }): Promise<string>;
+    number(tips: string, options?: CommandPromptOptions & {
+        readonly default?: number;
+    }): Promise<number>;
+    confirm(tips: string, options?: CommandPromptOptions & {
+        readonly condition?: string;
+        readonly default?: boolean;
+    }): Promise<boolean>;
+    list(tips: string, options?: CommandPromptListOptions): Promise<readonly (string | number | boolean)[]>;
+    pick<V = unknown>(tips: string, options: CommandPromptPickOptions<V>): Promise<V | readonly V[]>;
+}
+export type CommandPromptFactory = (source: unknown) => CommandPrompt | undefined;
 export interface CommandContext<TConfig = unknown, TInput extends CommandMessage = CommandMessage> extends CapabilityContext<TConfig>, CommandSession {
     readonly args: readonly string[];
     readonly params: Readonly<Record<string, CommandParameterValue>>;
@@ -153,6 +203,10 @@ export interface CommandContext<TConfig = unknown, TInput extends CommandMessage
      * Host / `CommandIndex.execute` 等无消息路径可能为 `undefined`。
      */
     readonly input?: TInput;
+    /**
+     * 对话式交互输入。IM 派发时自动注入；无消息来源时为 `undefined`。
+     */
+    readonly prompt?: CommandPrompt;
 }
 export interface CommandDefinition<TConfig = unknown, TResult = unknown, TInput extends CommandMessage = CommandMessage> {
     readonly $feature: typeof commandBrand;
@@ -197,7 +251,7 @@ export declare function parseCommandDefinition(value: unknown): CommandDefinitio
  * 函数值接收从 `source`（通常是 IM Runtime `Message`）解析出的 {@link CommandSession}。
  */
 export declare function resolveDynamicParams(params: Readonly<Record<string, CommandDynamicValue>>, source: unknown): Readonly<Record<string, CommandParameterValue>>;
-export declare function createCommandContext(snapshot: RuntimeSnapshot, ownerId: PluginId, args: readonly string[], params?: Readonly<Record<string, CommandParameterValue>>, input?: unknown, segments?: readonly Readonly<CommandSegment>[]): CommandContext;
+export declare function createCommandContext(snapshot: RuntimeSnapshot, ownerId: PluginId, args: readonly string[], params?: Readonly<Record<string, CommandParameterValue>>, input?: unknown, segments?: readonly Readonly<CommandSegment>[], prompt?: CommandPrompt): CommandContext;
 /**
  * 从派发来源（通常是 Runtime `Message`）解析入站快捷字段。
  * 不依赖 `@zhin.js/core`，按 {@link CommandMessage} 结构鸭式识别。

package/lib/definition.js

@@ -112,7 +112,7 @@ export function resolveDynamicParams(params, source) {
     }
     return Object.freeze(resolved);
 }
-export function createCommandContext(snapshot, ownerId, args, params = Object.freeze({}), input = undefined, segments = Object.freeze([])) {
+export function createCommandContext(snapshot, ownerId, args, params = Object.freeze({}), input = undefined, segments = Object.freeze([]), prompt) {
     const context = createCapabilityContext(snapshot, ownerId);
     const session = resolveCommandSession(input);
     return Object.freeze({
@@ -122,6 +122,7 @@ export function createCommandContext(snapshot, ownerId, args, params = Object.fr
         params: Object.freeze({ ...params }),
         segments: freezeSegments(segments),
         ...(input !== undefined ? { input: input } : {}),
+        ...(prompt !== undefined ? { prompt } : {}),
     });
 }
 /**
@@ -179,15 +180,10 @@ function resolveSender(input, metadata) {
     if (isCommandSender(structured)) {
         return freezeSender(structured);
     }
-    const $sender = input.$sender;
-    const id = input.sender?.id
-        || (typeof $sender?.id === 'string' ? $sender.id : undefined)
-        || firstString(metadata?.user_id, metadata?.userId);
+    const id = input.sender?.id || firstString(metadata?.user_id, metadata?.userId);
     if (!id)
         return undefined;
-    const name = input.sender?.name
-        || (typeof $sender?.name === 'string' ? $sender.name : undefined)
-        || firstString(metadata?.nickname, metadata?.senderName, metadata?.name);
+    const name = input.sender?.name || firstString(metadata?.nickname, metadata?.senderName, metadata?.name);
     const role = resolveRoles(input, metadata);
     return Object.freeze({
         id,
@@ -207,19 +203,16 @@ function resolveRoles(input, metadata) {
         if (trimmed && !roles.includes(trimmed))
             roles.push(trimmed);
     };
-    // IM Message 的 $sender 携带 enrich 快照（isMaster/isTrusted）和平台群角色（role）
-    const $sender = input.$sender;
-    if ($sender?.isMaster === true || metadata?.isMaster === true)
-        push('master');
-    else if ($sender?.isTrusted === true || metadata?.isTrusted === true)
-        push('trusted');
-    push($sender?.role);
     if (Array.isArray(metadata?.roles)) {
         for (const item of metadata.roles)
             push(item);
     }
     push(metadata?.senderRole);
     push(metadata?.role);
+    if (metadata?.isMaster === true)
+        push('master');
+    if (metadata?.isTrusted === true)
+        push('trusted');
     if (roles.length === 0)
         roles.push('user');
     return Object.freeze(roles);

package/lib/provider.js

@@ -132,7 +132,12 @@ const commandFeature = defineFeatureProvider({
     },
     runtime: {
         project(slots, context) {
-            return { value: new CommandIndex(slots, context.snapshot) };
+            const rootConfig = context.snapshot.config.get(context.snapshot.root);
+            const rawKeyword = rootConfig?.menuKeyword;
+            const menu = rawKeyword === false || rawKeyword === ''
+                ? undefined
+                : { keyword: typeof rawKeyword === 'string' ? rawKeyword : '菜单' };
+            return { value: new CommandIndex(slots, context.snapshot, menu) };
         },
     },
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/command",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Convention-based Command Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,9 +18,9 @@
   ],
   "dependencies": {
     "segment-matcher": "^1.0.5",
-    "@zhin.js/feature-kit": "1.0.8",
-    "@zhin.js/permission": "1.0.1",
-    "@zhin.js/plugin-runtime": "1.1.5"
+    "@zhin.js/feature-kit": "1.0.10",
+    "@zhin.js/permission": "1.0.2",
+    "@zhin.js/plugin-runtime": "1.1.6"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",

package/src/command-index.ts

@@ -17,6 +17,7 @@ import {
   type CommandParameterValue,
   type CommandSegment,
   type CommandDynamicValue,
+  type CommandPromptFactory,
   resolveDynamicParams,
 } from './definition.js';
 import { permissionHostToken, type PermissionHost } from '@zhin.js/permission';
@@ -83,16 +84,23 @@ const segmentFields = {
   rps: 'result',
 };
 
+export interface CommandMenuConfig {
+  readonly keyword: string;
+}
+
 export class CommandIndex {
   readonly $projection = 'zhin.command-index/1' as const;
   readonly #commands: readonly CommandRecord[];
   readonly #routes: readonly CommandRoute[];
   readonly #shortcuts: ReadonlyMap<string, ShortcutEntry>;
+  readonly #menu?: CommandMenuConfig;
 
   constructor(
     slots: readonly Readonly<CapabilitySlot<CommandDefinition>>[],
     private readonly snapshot: RuntimeSnapshot,
+    menu?: CommandMenuConfig,
   ) {
+    this.#menu = menu;
     const commands: CommandRecord[] = [];
     const routes: CommandRoute[] = [];
     const occupancy = new Map<string, string>();
@@ -213,7 +221,21 @@ export class CommandIndex {
   async dispatch(
     input: CommandMatchInput,
     source: unknown = undefined,
+    promptFactory?: CommandPromptFactory,
+    commandPrefix = '',
   ): Promise<CommandDispatchResult> {
+    if (this.#menu) {
+      const menuValue = this.#dispatchMenu(input, commandPrefix);
+      if (menuValue !== undefined) {
+        return Object.freeze({
+          matched: true,
+          command: this.#menu.keyword,
+          owner: this.snapshot.root,
+          value: menuValue,
+        });
+      }
+    }
+    const prompt = promptFactory?.(source);
     const shortcut = this.#matchShortcut(input);
     if (shortcut) {
       if (!(await this.#permitAllows(shortcut.record, source))) {
@@ -227,6 +249,7 @@ export class CommandIndex {
           resolveDynamicParams(shortcut.params, source),
           source,
           Object.freeze([]),
+          prompt,
         ),
       );
       return Object.freeze({
@@ -251,6 +274,7 @@ export class CommandIndex {
         resolveDynamicParams(match.params, source),
         source,
         match.remaining,
+        prompt,
       ),
     );
     return Object.freeze({
@@ -341,6 +365,72 @@ export class CommandIndex {
       throw new CommandParameterValueError(parameter.name, parameter.type, value);
     }
   }
+
+  // ==========================================================================
+  // 内置菜单命令
+  // ==========================================================================
+
+  #dispatchMenu(input: CommandMatchInput, commandPrefix = ''): string | undefined {
+    const text = typeof input === 'string' ? input.trim() : exactMessageText(input);
+    if (text === undefined) return undefined;
+    const keyword = this.#menu!.keyword;
+    if (text === keyword) return this.#buildMenu(undefined, commandPrefix);
+    if (text.startsWith(keyword + ' ')) {
+      const key = text.slice(keyword.length + 1).trim();
+      if (key) return this.#buildMenu(key, commandPrefix);
+      return this.#buildMenu(undefined, commandPrefix);
+    }
+    return undefined;
+  }
+
+  #buildMenu(pluginKey?: string, commandPrefix = ''): string {
+    const root = this.snapshot.root;
+    const targetId = pluginKey
+      ? `${root}/${pluginKey.split('.').join('/')}` as PluginId
+      : root;
+
+    const node = this.snapshot.tree.get(targetId);
+    if (!node) return `未找到插件: ${pluginKey}`;
+
+    const directCommands = this.#commands.filter((cmd) => cmd.slot.owner === targetId);
+    const children = node.children
+      .map((childId) => this.snapshot.tree.get(childId))
+      .filter((child): child is NonNullable<typeof child> => !!child);
+
+    const keyword = this.#menu!.keyword;
+    const displayKey = pluginKey ?? node.instanceKey;
+    const lines: string[] = [`=== ${displayKey} 指令菜单 ===`];
+
+    if (directCommands.length > 0) {
+      lines.push('');
+      for (const cmd of directCommands) {
+        const desc = cmd.description ? `  - ${cmd.description}` : '';
+        lines.push(`  ${commandPrefix}${cmd.name}${desc}`);
+      }
+    }
+
+    if (children.length > 0) {
+      lines.push('');
+      lines.push('子插件：');
+      for (const child of children) {
+        const childKey = pluginKey ? `${pluginKey}.${child.instanceKey}` : child.instanceKey;
+        const label = child.metadata?.displayName ?? child.instanceKey;
+        lines.push(`  ${childKey}  (${label})`);
+      }
+    }
+
+    if (directCommands.length === 0 && children.length === 0) {
+      lines.push('');
+      lines.push('（暂无指令和子插件）');
+    }
+
+    if (children.length > 0) {
+      lines.push('');
+      lines.push(`提示：使用「${commandPrefix}${keyword} <插件名>」查看子插件的指令`);
+    }
+
+    return lines.join('\n');
+  }
 }
 
 export function isCommandIndex(value: unknown): value is CommandIndex {

package/src/definition.ts

@@ -193,6 +193,51 @@ export interface CommandSession {
   readonly sender?: CommandSender;
 }
 
+export interface CommandPromptOptions {
+  readonly timeout?: number;
+  readonly timeoutText?: string;
+  /** Cancel the pending claim when the owning turn aborts. */
+  readonly signal?: AbortSignal;
+}
+
+export interface CommandPromptListOptions extends CommandPromptOptions {
+  readonly type?: 'text' | 'number' | 'boolean';
+  readonly separator?: string;
+  readonly default?: readonly (string | number | boolean)[];
+}
+
+export interface CommandPromptPickOptions<V = unknown> extends CommandPromptOptions {
+  readonly options: readonly { readonly label: string; readonly value: V }[];
+  readonly multiple?: boolean;
+  readonly separator?: string;
+  readonly default?: V | readonly V[];
+}
+
+/**
+ * 命令内对话式交互输入。
+ *
+ * IM 派发时自动注入（`context.prompt`）；Host / CLI 无消息来源时为 `undefined`。
+ *
+ * ```ts
+ * defineCommand({
+ *   execute: async (context) => {
+ *     const name = await context.prompt!.text('请输入你的名字');
+ *     const age = await context.prompt!.number('请输入你的年龄');
+ *     return `你好 ${name}，你 ${age} 岁了`;
+ *   },
+ * });
+ * ```
+ */
+export interface CommandPrompt {
+  text(tips: string, options?: CommandPromptOptions & { readonly default?: string }): Promise<string>;
+  number(tips: string, options?: CommandPromptOptions & { readonly default?: number }): Promise<number>;
+  confirm(tips: string, options?: CommandPromptOptions & { readonly condition?: string; readonly default?: boolean }): Promise<boolean>;
+  list(tips: string, options?: CommandPromptListOptions): Promise<readonly (string | number | boolean)[]>;
+  pick<V = unknown>(tips: string, options: CommandPromptPickOptions<V>): Promise<V | readonly V[]>;
+}
+
+export type CommandPromptFactory = (source: unknown) => CommandPrompt | undefined;
+
 export interface CommandContext<
   TConfig = unknown,
   TInput extends CommandMessage = CommandMessage,
@@ -206,6 +251,10 @@ export interface CommandContext<
    * Host / `CommandIndex.execute` 等无消息路径可能为 `undefined`。
    */
   readonly input?: TInput;
+  /**
+   * 对话式交互输入。IM 派发时自动注入；无消息来源时为 `undefined`。
+   */
+  readonly prompt?: CommandPrompt;
 }
 
 export interface CommandDefinition<
@@ -371,6 +420,7 @@ export function createCommandContext(
   params: Readonly<Record<string, CommandParameterValue>> = Object.freeze({}),
   input: unknown = undefined,
   segments: readonly Readonly<CommandSegment>[] = Object.freeze([]),
+  prompt?: CommandPrompt,
 ): CommandContext {
   const context = createCapabilityContext(snapshot, ownerId);
   const session = resolveCommandSession(input);
@@ -381,6 +431,7 @@ export function createCommandContext(
     params: Object.freeze({ ...params }),
     segments: freezeSegments(segments),
     ...(input !== undefined ? { input: input as CommandMessage } : {}),
+    ...(prompt !== undefined ? { prompt } : {}),
   });
 }
 
@@ -458,15 +509,10 @@ function resolveSender(
     return freezeSender(structured);
   }
 
-  const $sender = (input as { readonly $sender?: Readonly<Record<string, unknown>> }).$sender;
-  const id = input.sender?.id
-    || (typeof $sender?.id === 'string' ? $sender.id : undefined)
-    || firstString(metadata?.user_id, metadata?.userId);
+  const id = input.sender?.id || firstString(metadata?.user_id, metadata?.userId);
   if (!id) return undefined;
 
-  const name = input.sender?.name
-    || (typeof $sender?.name === 'string' ? $sender.name : undefined)
-    || firstString(metadata?.nickname, metadata?.senderName, metadata?.name);
+  const name = input.sender?.name || firstString(metadata?.nickname, metadata?.senderName, metadata?.name);
   const role = resolveRoles(input, metadata);
 
   return Object.freeze({
@@ -490,18 +536,13 @@ function resolveRoles(
     if (trimmed && !roles.includes(trimmed)) roles.push(trimmed);
   };
 
-  // IM Message 的 $sender 携带 enrich 快照（isMaster/isTrusted）和平台群角色（role）
-  const $sender = (input as { readonly $sender?: Readonly<Record<string, unknown>> }).$sender;
-
-  if ($sender?.isMaster === true || metadata?.isMaster === true) push('master');
-  else if ($sender?.isTrusted === true || metadata?.isTrusted === true) push('trusted');
-
-  push($sender?.role);
   if (Array.isArray(metadata?.roles)) {
     for (const item of metadata.roles) push(item);
   }
   push(metadata?.senderRole);
   push(metadata?.role);
+  if (metadata?.isMaster === true) push('master');
+  if (metadata?.isTrusted === true) push('trusted');
   if (roles.length === 0) roles.push('user');
   return Object.freeze(roles);
 }

package/src/provider.ts

@@ -183,7 +183,13 @@ const commandFeature = defineFeatureProvider({
   },
   runtime: {
     project(slots, context) {
-      return { value: new CommandIndex(slots, context.snapshot) };
+      const rootConfig = context.snapshot.config.get(context.snapshot.root) as
+        | Record<string, unknown> | undefined;
+      const rawKeyword = rootConfig?.menuKeyword;
+      const menu = rawKeyword === false || rawKeyword === ''
+        ? undefined
+        : { keyword: typeof rawKeyword === 'string' ? rawKeyword : '菜单' };
+      return { value: new CommandIndex(slots, context.snapshot, menu) };
     },
   },
 });