clawt 2.12.1 → 2.14.0

package/docs/spec.md

@@ -26,6 +26,7 @@
   - [5.12 将主分支代码同步到目标 Worktree](#512-将主分支代码同步到目标-worktree)
   - [5.13 重置主 Worktree 工作区和暂存区](#513-重置主-worktree-工作区和暂存区)
   - [5.14 项目全局状态总览](#514-项目全局状态总览)
+  - [5.15 命令别名管理](#515-命令别名管理)
 - [6. 错误处理规范](#6-错误处理规范)
 - [7. 非功能性需求](#7-非功能性需求)
   - [7.1 性能](#71-性能)
@@ -179,6 +180,7 @@ git show-ref --verify refs/heads/<branchName> 2>/dev/null
 | `clawt sync`          | 将主分支最新代码同步到目标 worktree                  | 5.12     |
 | `clawt reset`         | 重置主 worktree 工作区和暂存区                       | 5.13     |
 | `clawt status`        | 显示项目全局状态总览（支持 `--json` 格式输出）          | 5.14     |
+| `clawt alias`         | 管理命令别名（列出 / 设置 / 移除）                       | 5.15     |
 
 **全局选项：**
 
@@ -842,7 +844,8 @@ clawt merge [-m <commitMessage>]
   "autoPullPush": false,
   "confirmDestructiveOps": true,
   "maxConcurrency": 0,
-  "terminalApp": "auto"
+  "terminalApp": "auto",
+  "aliases": {}
 }
 ```
 
@@ -856,6 +859,7 @@ clawt merge [-m <commitMessage>]
 | `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean、config reset）前是否提示确认 |
 | `maxConcurrency` | `number` | `0` | run 命令默认最大并发数，`0` 表示不限制 |
 | `terminalApp` | `string` | `"auto"` | 批量 resume 使用的终端应用：`auto`（自动检测）、`iterm2`、`terminal`（macOS） |
+| `aliases` | `Record<string, string>` | `{}` | 命令别名映射，键为别名，值为目标内置命令名 |
 
 ---
 
@@ -1350,6 +1354,112 @@ clawt status [--json]
 
 ---
 
+### 5.15 命令别名管理
+
+**命令：**
+
+```bash
+# 列出所有命令别名
+clawt alias
+clawt alias list
+
+# 设置命令别名
+clawt alias set <alias> <command>
+
+# 移除命令别名
+clawt alias remove <alias>
+```
+
+**子命令：**
+
+| 子命令 | 说明 |
+| ------ | ---- |
+| `clawt alias` / `clawt alias list` | 列出所有已配置的命令别名 |
+| `clawt alias set <alias> <command>` | 设置命令别名，将 `<alias>` 映射到 `<command>` |
+| `clawt alias remove <alias>` | 移除指定的命令别名 |
+
+**参数：**
+
+| 参数 | 必填 | 说明 |
+| ---- | ---- | ---- |
+| `<alias>` | 是（set / remove） | 别名名称 |
+| `<command>` | 是（set） | 目标内置命令名 |
+
+**约束规则：**
+
+1. **别名不能覆盖内置命令名**：别名不能与已注册的内置命令同名（`list`、`create`、`remove`、`run`、`resume`、`validate`、`merge`、`config`、`sync`、`reset`、`status`、`alias`）。如果用户尝试设置与内置命令同名的别名，报错退出
+2. **目标必须是内置命令**：别名的目标（`<command>`）必须是已注册的内置命令名。如果指定了不存在的目标命令，报错退出
+3. **参数透传**：通过别名调用时，所有选项和参数会完全透传给目标命令，行为与直接调用目标命令完全一致
+
+**持久化：**
+
+别名配置存储在 `~/.clawt/config.json` 的 `aliases` 字段中（类型 `Record<string, string>`，默认 `{}`）。
+
+**运行流程：**
+
+#### `alias list`（默认）
+
+1. 读取配置文件中的 `aliases` 字段
+2. 如果没有配置任何别名，输出提示 `当前没有配置任何命令别名`
+3. 如果有别名，逐行输出所有别名映射
+
+**输出格式：**
+
+```
+命令别名列表：
+
+  l → list
+  r → run
+  v → validate
+```
+
+#### `alias set <alias> <command>`
+
+1. **校验别名不与内置命令冲突**：检查 `<alias>` 是否为内置命令名，是则报错退出
+2. **校验目标命令存在**：检查 `<command>` 是否为已注册的内置命令名，不是则报错退出
+3. 将别名写入配置文件的 `aliases` 字段（如果别名已存在，覆盖旧值）
+4. 输出成功提示
+
+**输出格式：**
+
+```
+✓ 已设置别名: l → list
+```
+
+#### `alias remove <alias>`
+
+1. 读取配置文件中的 `aliases` 字段
+2. 检查指定的别名是否存在，不存在则报错退出
+3. 从 `aliases` 中删除该别名并写入配置文件
+4. 输出成功提示
+
+**输出格式：**
+
+```
+✓ 已移除别名: l
+```
+
+**别名使用示例：**
+
+```bash
+# 设置别名
+clawt alias set l list
+clawt alias set r run
+clawt alias set v validate
+
+# 使用别名（等同于对应的完整命令）
+clawt l          # 等同于 clawt list
+clawt r task.md  # 等同于 clawt run task.md
+
+# 查看所有别名
+clawt alias list
+
+# 移除别名
+clawt alias remove l
+```
+
+---
+
 ## 6. 错误处理规范
 
 ### 6.1 通用错误处理

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawt",
-  "version": "2.12.1",
+  "version": "2.14.0",
   "description": "本地并行执行多个Claude Code Agent任务，融合 Git Worktree 与 Claude Code CLI 的命令行工具",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/alias.ts

@@ -0,0 +1,132 @@
+import type { Command } from 'commander';
+import chalk from 'chalk';
+import { MESSAGES } from '../constants/index.js';
+import { logger } from '../logger/index.js';
+import { loadConfig, writeConfig, printInfo, printSuccess, printError, printSeparator } from '../utils/index.js';
+
+/**
+ * 从 Commander 实例动态获取所有已注册的命令名
+ * @param {Command} program - Commander 实例
+ * @returns {string[]} 已注册的命令名列表
+ */
+function getRegisteredCommandNames(program: Command): string[] {
+  return program.commands.map((cmd) => cmd.name());
+}
+
+/**
+ * 校验别名名称是否与已注册命令冲突
+ * @param {Command} program - Commander 实例
+ * @param {string} alias - 别名
+ * @returns {boolean} 是否冲突
+ */
+function isBuiltinCommand(program: Command, alias: string): boolean {
+  return getRegisteredCommandNames(program).includes(alias);
+}
+
+/**
+ * 列出所有已配置的别名
+ */
+function handleAliasList(): void {
+  const config = loadConfig();
+  const { aliases } = config;
+  const entries = Object.entries(aliases);
+
+  logger.debug('alias list 命令执行，展示别名列表');
+
+  if (entries.length === 0) {
+    printInfo(MESSAGES.ALIAS_LIST_EMPTY);
+    return;
+  }
+
+  printInfo(`\n${MESSAGES.ALIAS_LIST_TITLE}\n`);
+  printSeparator();
+
+  for (const [alias, command] of entries) {
+    printInfo(`  ${chalk.bold(alias)} → ${chalk.cyan(command)}`);
+  }
+
+  printInfo('');
+  printSeparator();
+}
+
+/**
+ * 设置命令别名
+ * @param {Command} program - Commander 实例
+ * @param {string} alias - 别名
+ * @param {string} command - 目标命令名
+ */
+function handleAliasSet(program: Command, alias: string, command: string): void {
+  logger.debug(`alias set 命令执行，别名: ${alias}，目标: ${command}`);
+
+  // 校验别名不能与内置命令冲突
+  if (isBuiltinCommand(program, alias)) {
+    printError(MESSAGES.ALIAS_CONFLICTS_BUILTIN(alias));
+    return;
+  }
+
+  // 校验目标命令必须是已注册的内置命令
+  if (!isBuiltinCommand(program, command)) {
+    printError(MESSAGES.ALIAS_TARGET_NOT_FOUND(command));
+    return;
+  }
+
+  const config = loadConfig();
+  config.aliases[alias] = command;
+  writeConfig(config);
+
+  printSuccess(MESSAGES.ALIAS_SET_SUCCESS(alias, command));
+}
+
+/**
+ * 移除命令别名
+ * @param {string} alias - 要移除的别名
+ */
+function handleAliasRemove(alias: string): void {
+  logger.debug(`alias remove 命令执行，别名: ${alias}`);
+
+  const config = loadConfig();
+
+  if (!(alias in config.aliases)) {
+    printError(MESSAGES.ALIAS_NOT_FOUND(alias));
+    return;
+  }
+
+  delete config.aliases[alias];
+  writeConfig(config);
+
+  printSuccess(MESSAGES.ALIAS_REMOVE_SUCCESS(alias));
+}
+
+/**
+ * 注册 alias 命令组：管理命令别名
+ * @param {Command} program - Commander 实例
+ */
+export function registerAliasCommand(program: Command): void {
+  const aliasCmd = program
+    .command('alias')
+    .description('管理命令别名')
+    .action(() => {
+      handleAliasList();
+    });
+
+  aliasCmd
+    .command('list')
+    .description('列出所有别名')
+    .action(() => {
+      handleAliasList();
+    });
+
+  aliasCmd
+    .command('set <alias> <command>')
+    .description('设置命令别名')
+    .action((alias: string, command: string) => {
+      handleAliasSet(program, alias, command);
+    });
+
+  aliasCmd
+    .command('remove <alias>')
+    .description('移除命令别名')
+    .action((alias: string) => {
+      handleAliasRemove(alias);
+    });
+}

package/src/commands/config.ts

@@ -1,8 +1,22 @@
 import type { Command } from 'commander';
 import chalk from 'chalk';
-import { CONFIG_PATH, DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES } from '../constants/index.js';
+import Enquirer from 'enquirer';
+import { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, MESSAGES } from '../constants/index.js';
 import { logger } from '../logger/index.js';
-import { loadConfig, writeDefaultConfig, printInfo, printSuccess, printSeparator, confirmDestructiveAction } from '../utils/index.js';
+import {
+  loadConfig,
+  saveConfig,
+  writeDefaultConfig,
+  printInfo,
+  printSuccess,
+  printError,
+  confirmDestructiveAction,
+  isValidConfigKey,
+  getValidConfigKeys,
+  parseConfigValue,
+  promptConfigValue,
+  formatConfigValue,
+} from '../utils/index.js';
 import type { ClawtConfig } from '../types/index.js';
 
 /**
@@ -12,9 +26,9 @@ import type { ClawtConfig } from '../types/index.js';
 export function registerConfigCommand(program: Command): void {
   const configCmd = program
     .command('config')
-    .description('查看和管理全局配置')
-    .action(() => {
-      handleConfig();
+    .description('交互式查看和修改全局配置')
+    .action(async () => {
+      await handleConfigSet();
     });
 
   configCmd
@@ -23,36 +37,20 @@ export function registerConfigCommand(program: Command): void {
     .action(async () => {
       await handleConfigReset();
     });
-}
-
-/**
- * 执行 config 命令的核心逻辑，读取并展示配置列表
- */
-function handleConfig(): void {
-  const config = loadConfig();
-
-  logger.info('config 命令执行，展示全局配置');
 
-  printInfo(`\n${chalk.dim('配置文件路径:')} ${CONFIG_PATH}\n`);
-  printSeparator();
-
-  const keys = Object.keys(DEFAULT_CONFIG) as Array<keyof ClawtConfig>;
-
-  for (let i = 0; i < keys.length; i++) {
-    const key = keys[i];
-    const value = config[key];
-    const description = CONFIG_DESCRIPTIONS[key];
-    const formattedValue = formatConfigValue(value);
-
-    // 第一个配置项前增加空行，与下横线前的空行对称
-    if (i === 0) printInfo('');
-    printInfo(`  ${chalk.bold(key)}: ${formattedValue}`);
-    printInfo(`  ${chalk.dim(description)}`);
-    // 配置项之间及最后一项与下横线之间保持统一空行间距
-    printInfo('');
-  }
+  configCmd
+    .command('set [key] [value]')
+    .description('修改配置项（无参数进入交互式配置）')
+    .action(async (key?: string, value?: string) => {
+      await handleConfigSet(key, value);
+    });
 
-  printSeparator();
+  configCmd
+    .command('get <key>')
+    .description('获取单个配置项的值')
+    .action((key: string) => {
+      handleConfigGet(key);
+    });
 }
 
 /**
@@ -76,13 +74,91 @@ async function handleConfigReset(): Promise<void> {
 }
 
 /**
- * 格式化配置值的显示样式
- * @param {ClawtConfig[keyof ClawtConfig]} value - 配置值
- * @returns {string} 格式化后的字符串
+ * 执行 config set 子命令：直接设置或交互式配置
+ * @param {string} [key] - 配置项名称（可选，无参数进入交互式）
+ * @param {string} [value] - 配置值（可选）
  */
-function formatConfigValue(value: ClawtConfig[keyof ClawtConfig]): string {
-  if (typeof value === 'boolean') {
-    return value ? chalk.green('true') : chalk.yellow('false');
+async function handleConfigSet(key?: string, value?: string): Promise<void> {
+  // 无参数进入交互式配置
+  if (!key) {
+    await handleInteractiveConfigSet();
+    return;
+  }
+
+  // 校验 key 有效性
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
+  }
+
+  // 有 key 无 value 时提示缺少参数
+  if (value === undefined) {
+    printError(MESSAGES.CONFIG_MISSING_VALUE(key));
+    return;
+  }
+
+  // 解析并校验值
+  const result = parseConfigValue(key, value);
+  if (!result.success) {
+    printError(result.error);
+    return;
   }
-  return chalk.cyan(String(value));
+
+  // 加载、修改、持久化
+  const config = loadConfig();
+  (config as unknown as Record<string, unknown>)[key] = result.value;
+  saveConfig(config);
+
+  logger.info(`config set 命令执行，设置 ${key} = ${String(result.value)}`);
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(key, String(result.value)));
+}
+
+/**
+ * 交互式配置修改：列出所有配置项供用户选择并修改
+ */
+async function handleInteractiveConfigSet(): Promise<void> {
+  const config = loadConfig();
+  const keys = Object.keys(DEFAULT_CONFIG) as Array<keyof ClawtConfig>;
+
+  logger.info('config set 命令执行，进入交互式配置');
+
+  // 构建选择列表，显示配置项名称、当前值和描述
+  const choices = keys.map((k) => ({
+    name: k,
+    message: `${k}: ${formatConfigValue(config[k])}  ${chalk.dim(`— ${CONFIG_DESCRIPTIONS[k]}`)}`,
+  }));
+
+  // @ts-expect-error enquirer 类型声明未导出 Select 类，但运行时存在
+  const selectedKey: keyof ClawtConfig = await new Enquirer.Select({
+    message: MESSAGES.CONFIG_SELECT_PROMPT,
+    choices,
+  }).run();
+
+  // 根据类型和 allowedValues 自动选择提示策略
+  const currentValue = config[selectedKey];
+  const newValue = await promptConfigValue(selectedKey, currentValue);
+
+  // 持久化并提示成功
+  (config as unknown as Record<string, unknown>)[selectedKey] = newValue;
+  saveConfig(config);
+
+  printSuccess(MESSAGES.CONFIG_SET_SUCCESS(selectedKey, String(newValue)));
+}
+
+/**
+ * 执行 config get 子命令：获取单个配置项的值
+ * @param {string} key - 配置项名称
+ */
+function handleConfigGet(key: string): void {
+  // 校验 key 有效性
+  if (!isValidConfigKey(key)) {
+    printError(MESSAGES.CONFIG_INVALID_KEY(key, getValidConfigKeys()));
+    return;
+  }
+
+  const config = loadConfig();
+  const value = config[key];
+
+  logger.info(`config get 命令执行，获取 ${key} = ${String(value)}`);
+  printInfo(MESSAGES.CONFIG_GET_VALUE(key, String(value)));
 }

package/src/constants/config.ts

@@ -1,4 +1,5 @@
 import type { ClawtConfig, ConfigDefinitions } from '../types/index.js';
+import { VALID_TERMINAL_APPS } from './terminal.js';
 
 /** Claude Code 系统约束提示，禁止代码执行完成后构建项目验证 */
 export const APPEND_SYSTEM_PROMPT =
@@ -32,6 +33,11 @@ export const CONFIG_DEFINITIONS: ConfigDefinitions = {
   terminalApp: {
     defaultValue: 'auto',
     description: '批量 resume 使用的终端应用：auto（自动检测）、iterm2、terminal（macOS）',
+    allowedValues: VALID_TERMINAL_APPS,
+  },
+  aliases: {
+    defaultValue: {} as Record<string, string>,
+    description: '命令别名映射（通过 clawt alias 命令管理）',
   },
 };
 

package/src/constants/index.ts

@@ -3,7 +3,7 @@ export { INVALID_BRANCH_CHARS } from './branch.js';
 export { MESSAGES } from './messages/index.js';
 export { EXIT_CODES } from './exitCodes.js';
 export { ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, PASTE_THRESHOLD_MS, VALID_TERMINAL_APPS, ITERM2_APP_PATH } from './terminal.js';
-export { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, APPEND_SYSTEM_PROMPT } from './config.js';
+export { DEFAULT_CONFIG, CONFIG_DESCRIPTIONS, CONFIG_DEFINITIONS, APPEND_SYSTEM_PROMPT } from './config.js';
 export { AUTO_SAVE_COMMIT_MESSAGE } from './git.js';
 export { DEBUG_LOG_PREFIX, DEBUG_TIMESTAMP_FORMAT } from './logger.js';
 export {

package/src/constants/messages/alias.ts

@@ -0,0 +1,22 @@
+/** alias 命令专属提示消息 */
+export const ALIAS_MESSAGES = {
+  /** 别名列表为空 */
+  ALIAS_LIST_EMPTY: '(无别名)',
+  /** 别名设置成功 */
+  ALIAS_SET_SUCCESS: (alias: string, command: string) =>
+    `✓ 已设置别名: ${alias} → ${command}`,
+  /** 别名移除成功 */
+  ALIAS_REMOVE_SUCCESS: (alias: string) =>
+    `✓ 已移除别名: ${alias}`,
+  /** 别名不存在 */
+  ALIAS_NOT_FOUND: (alias: string) =>
+    `别名 "${alias}" 不存在`,
+  /** 别名与内置命令冲突 */
+  ALIAS_CONFLICTS_BUILTIN: (alias: string) =>
+    `别名 "${alias}" 与内置命令冲突，不允许覆盖内置命令`,
+  /** 目标命令不存在 */
+  ALIAS_TARGET_NOT_FOUND: (command: string) =>
+    `目标命令 "${command}" 不存在，请指定已注册的内置命令名`,
+  /** 别名列表标题 */
+  ALIAS_LIST_TITLE: '当前别名列表：',
+} as const;

package/src/constants/messages/config.ts

@@ -2,4 +2,26 @@
 export const CONFIG_CMD_MESSAGES = {
   /** 配置已恢复为默认值 */
   CONFIG_RESET_SUCCESS: '✓ 配置已恢复为默认值',
+  /** 配置项设置成功 */
+  CONFIG_SET_SUCCESS: (key: string, value: string) => `✓ ${key} 已设置为 ${value}`,
+  /** 获取配置值显示 */
+  CONFIG_GET_VALUE: (key: string, value: string) => `${key} = ${value}`,
+  /** 无效配置项名称 */
+  CONFIG_INVALID_KEY: (key: string, validKeys: string[]) =>
+    `无效的配置项: ${key}\n可用的配置项: ${validKeys.join(', ')}`,
+  /** 布尔类型值无效 */
+  CONFIG_INVALID_BOOLEAN: (key: string) =>
+    `配置项 ${key} 为布尔类型，仅接受 true 或 false`,
+  /** 数字类型值无效 */
+  CONFIG_INVALID_NUMBER: (key: string) =>
+    `配置项 ${key} 为数字类型，请输入有效的数字`,
+  /** 枚举类型配置项值无效（通用版） */
+  CONFIG_INVALID_ENUM: (key: string, validValues: readonly string[]) =>
+    `配置项 ${key} 仅接受以下值: ${validValues.join(', ')}`,
+  /** 交互式选择配置项提示 */
+  CONFIG_SELECT_PROMPT: '选择要修改的配置项',
+  /** 交互式输入新值提示 */
+  CONFIG_INPUT_PROMPT: (key: string) => `输入 ${key} 的新值`,
+  /** 缺少 value 参数提示 */
+  CONFIG_MISSING_VALUE: (key: string) => `缺少配置值，用法: clawt config set ${key} <value>`,
 } as const;

package/src/constants/messages/index.ts

@@ -9,6 +9,7 @@ import { REMOVE_MESSAGES } from './remove.js';
 import { RESET_MESSAGES } from './reset.js';
 import { CONFIG_CMD_MESSAGES } from './config.js';
 import { STATUS_MESSAGES } from './status.js';
+import { ALIAS_MESSAGES } from './alias.js';
 
 /**
  * 提示消息模板
@@ -26,4 +27,5 @@ export const MESSAGES = {
   ...RESET_MESSAGES,
   ...CONFIG_CMD_MESSAGES,
   ...STATUS_MESSAGES,
+  ...ALIAS_MESSAGES,
 } as const;

package/src/index.ts

@@ -3,7 +3,7 @@ import { Command } from 'commander';
 import { ClawtError } from './errors/index.js';
 import { logger, enableConsoleTransport } from './logger/index.js';
 import { EXIT_CODES } from './constants/index.js';
-import { printError, ensureClawtDirs } from './utils/index.js';
+import { printError, ensureClawtDirs, loadConfig, applyAliases } from './utils/index.js';
 import { registerListCommand } from './commands/list.js';
 import { registerCreateCommand } from './commands/create.js';
 import { registerRemoveCommand } from './commands/remove.js';
@@ -15,6 +15,7 @@ import { registerConfigCommand } from './commands/config.js';
 import { registerSyncCommand } from './commands/sync.js';
 import { registerResetCommand } from './commands/reset.js';
 import { registerStatusCommand } from './commands/status.js';
+import { registerAliasCommand } from './commands/alias.js';
 
 // 从 package.json 读取版本号，避免硬编码
 const require = createRequire(import.meta.url);
@@ -50,6 +51,11 @@ registerConfigCommand(program);
 registerSyncCommand(program);
 registerResetCommand(program);
 registerStatusCommand(program);
+registerAliasCommand(program);
+
+// 加载配置并应用命令别名
+const config = loadConfig();
+applyAliases(program, config.aliases);
 
 // 全局未捕获异常处理
 process.on('uncaughtException', (error) => {

package/src/types/config.ts

@@ -12,6 +12,8 @@ export interface ClawtConfig {
   maxConcurrency: number;
   /** 批量 resume 使用的终端应用：'auto'（自动检测）、'iterm2'、'terminal'（macOS） */
   terminalApp: string;
+  /** 命令别名映射，键为别名，值为目标内置命令名 */
+  aliases: Record<string, string>;
 }
 
 /** 单个配置项的完整定义（默认值 + 描述） */
@@ -20,6 +22,8 @@ export interface ConfigItemDefinition<T> {
   defaultValue: T;
   /** 配置项描述，用于 config 命令展示 */
   description: string;
+  /** 可选：允许的枚举值列表，仅对 string 类型有效 */
+  allowedValues?: T extends string ? readonly string[] : never;
 }
 
 /** 所有配置项的完整定义映射 */

package/src/utils/alias.ts

@@ -0,0 +1,20 @@
+import type { Command } from 'commander';
+import type { ClawtConfig } from '../types/index.js';
+import { logger } from '../logger/index.js';
+
+/**
+ * 根据配置中的别名映射，为已注册的命令添加 Commander.js 别名
+ * @param {Command} program - Commander 实例
+ * @param {ClawtConfig['aliases']} aliases - 别名映射
+ */
+export function applyAliases(program: Command, aliases: ClawtConfig['aliases']): void {
+  for (const [alias, commandName] of Object.entries(aliases)) {
+    const targetCmd = program.commands.find((cmd) => cmd.name() === commandName);
+    if (targetCmd) {
+      targetCmd.alias(alias);
+      logger.debug(`已注册别名: ${alias} → ${commandName}`);
+    } else {
+      logger.warn(`别名 "${alias}" 的目标命令 "${commandName}" 不存在，已跳过`);
+    }
+  }
+}