@zhin.js/command 1.1.10 → 1.1.11

package/src/permission-explanation.ts

@@ -2,6 +2,8 @@ import { operationClientAdapter } from '@zhin.js/feature-kit';
 import { explainPermitRules, toPermissionSubject, type PermissionSubject, type PermissionConditionExplanation } from '@zhin.js/permission';
 import { resolveCommandSender, resolveCommandSession, type CommandMessage } from './definition.js';
 import type { CommandDescriptor } from './command-index.js';
+import { resolveLocale, type Locale } from '@zhin.js/plugin-runtime';
+import { commandMessages } from './messages.js';
 
 /** The exact subject projection used by the real command permit gate. No factories or checkers run. */
 export function toCommandPermissionSubject(source: unknown): PermissionSubject {
@@ -20,8 +22,9 @@ export type CommandPermissionHostStatus = 'present' | 'missing' | 'unverified';
 /** Read-only hypothetical conditions. A match is not permission to execute the command. */
 export function explainCommandPermissions(
   command: Pick<CommandDescriptor, 'adapter' | 'permit'>,
-  options: Readonly<{ source?: unknown; rolesKnown?: boolean; permissionHost: CommandPermissionHostStatus }>,
+  options: Readonly<{ source?: unknown; rolesKnown?: boolean; permissionHost: CommandPermissionHostStatus; locale?: Locale }>,
 ) {
+  const locale = resolveLocale(options.locale);
   const projected = toCommandPermissionSubject(options.source);
   const inputSender = options.source && typeof options.source === 'object'
     ? (options.source as Pick<CommandMessage, 'sender'>).sender : undefined;
@@ -36,23 +39,23 @@ export function explainCommandPermissions(
     && subject.sender?.role.length === 1 && subject.sender.role[0] === 'user';
   const actualAdapter = operationClientAdapter(options.source);
   const adapter: PermissionConditionExplanation = !command.adapter
-    ? { outcome: 'not_evaluated', reason: '命令未声明 adapter 约束' }
-    : !actualAdapter ? { outcome: 'unknown', reason: '未选择当前 Endpoint，无法判断命令的精确 adapter 约束' }
-      : { outcome: commandAdapterMatches(command, options.source) ? 'match' : 'mismatch', reason: '命令 adapter 与当前 Endpoint 声明的原生适配器精确比较；未探测在线状态' };
-  const rules = explainPermitRules(command.permit ?? [], subject, { rolesKnown: options.rolesKnown });
+    ? { outcome: 'not_evaluated', reason: commandMessages(locale, 'noAdapter') }
+    : !actualAdapter ? { outcome: 'unknown', reason: commandMessages(locale, 'missingEndpoint') }
+      : { outcome: commandAdapterMatches(command, options.source) ? 'match' : 'mismatch', reason: commandMessages(locale, 'adapterComparison') };
+  const rules = explainPermitRules(command.permit ?? [], subject, { rolesKnown: options.rolesKnown, locale });
   const conditions = [...(command.adapter ? [adapter] : []), ...rules];
   let summary: PermissionConditionExplanation;
-  if (conditions.some(item => item.outcome === 'mismatch')) summary = { outcome: 'mismatch', reason: '至少一个声明条件与假设输入不符；这不是实际准入检查' };
+  if (conditions.some(item => item.outcome === 'mismatch')) summary = { outcome: 'mismatch', reason: commandMessages(locale, 'conditionMismatch') };
   else if ((rules.length > 0 && options.permissionHost !== 'present') || conditions.some(item => item.outcome === 'unknown')) {
     summary = { outcome: 'unknown', reason: rules.length > 0 && options.permissionHost !== 'present'
-      ? 'PermissionHost 缺失或无法确认；不能推断命令可执行' : '存在缺少依据的条件，不能推断命令可执行' };
-  } else if (rules.length === 0) summary = { outcome: 'not_evaluated', reason: '命令未声明 permit 限制；这不表示已获得执行权限' };
-  else if (conditions.some(item => item.outcome === 'not_evaluated')) summary = { outcome: 'not_evaluated', reason: '存在未执行的平台或自定义条件，不能推断命令可执行' };
-  else summary = { outcome: 'match', reason: '已解释的 builtin 条件与假设输入匹配；不代表真实授权或命令可执行' };
+      ? commandMessages(locale, 'missingPermissionHost') : commandMessages(locale, 'missingEvidence') };
+  } else if (rules.length === 0) summary = { outcome: 'not_evaluated', reason: commandMessages(locale, 'noPermit') };
+  else if (conditions.some(item => item.outcome === 'not_evaluated')) summary = { outcome: 'not_evaluated', reason: commandMessages(locale, 'uncheckedConditions') };
+  else summary = { outcome: 'match', reason: commandMessages(locale, 'conditionsMatch') };
   return Object.freeze({ permissionHost: options.permissionHost, adapter: Object.freeze(adapter), rules, summary: Object.freeze(summary),
-    unconstrained: Object.freeze(['已解释的 builtin 规则不检查具体 Endpoint、parent 或 thread；保留完整目标不等于这些维度受规则限制']),
-    assumptions: Object.freeze(['身份与角色仅用于模拟，未向平台核实', '未执行命令、动态默认值、平台或自定义 checker',
+    unconstrained: Object.freeze([commandMessages(locale, 'unconstrained')]),
+    assumptions: Object.freeze([commandMessages(locale, 'simulatedIdentity'), commandMessages(locale, 'unevaluatedCode'),
       ...(defaultedRoles
-        ? ['canonical 输入未附角色时按命令运行时默认 user 解释；这不是已核验的平台角色'] : [])]),
+        ? [commandMessages(locale, 'defaultedRole')] : [])]),
   });
 }

package/src/provider.ts

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