rl-rockcli 0.0.2 → 0.0.4

package/help/renderer.js

@@ -1,800 +0,0 @@
-/**
- * 帮助信息渲染器
- * 从 help.json 读取配置，输出 gh 风格的帮助文本
- */
-
-const path = require('path');
-const helpConfig = require('./help.json');
-const { isCommandEnabled } = require('../utils/featureManager');
-const { showAsciiArt } = require('../utils/asciiArt');
-
-// 格式化常量
-const INDENT = '  ';
-const CMD_WIDTH = 14;  // 命令名列宽
-const FLAG_WIDTH = 32; // 选项列宽
-
-/**
- * 左对齐填充字符串
- */
-function padEnd(str, width) {
-  return str.length >= width ? str + '  ' : str + ' '.repeat(width - str.length);
-}
-
-/**
- * 渲染帮助信息
- * @param {string[]} commandPath - 命令路径，如 ['sandbox', 'upload']
- * @param {Object} pluginManager - 插件管理器实例（可选）
- * @returns {string} 格式化的帮助文本
- */
-function renderHelp(commandPath, pluginManager = null) {
-  if (!commandPath || commandPath.length === 0) {
-    return renderRootHelp(pluginManager);
-  }
-
-  const [command, subcommand, ...rest] = commandPath;
-
-  // 检查是否是插件命令（带有 helpConfig）
-  if (pluginManager) {
-    const pluginCommands = pluginManager.getRegisteredCommands();
-    
-    // 查找父命令（如 "log"）
-    const parentCmd = pluginCommands.find(cmd => cmd.command === command);
-    
-    if (parentCmd && parentCmd.helpConfig) {
-      // 使用插件的 helpConfig 渲染帮助
-      return renderPluginHelpConfig(command, parentCmd.helpConfig, subcommand, rest);
-    }
-    
-    // 首先检查是否是插件一级命令（有子命令）
-    const hasSubCommands = pluginCommands.some(cmd => cmd.command.startsWith(command + ' '));
-    
-    if (hasSubCommands && !subcommand) {
-      // 这是一个有子命令的父命令，显示子命令列表
-      const subCommands = pluginCommands.filter(cmd => cmd.command.startsWith(command + ' '));
-      return renderPluginSubcommandsHelp(command, subCommands, pluginManager);
-    }
-    
-    // 检查是否是插件二级命令
-    if (hasSubCommands && subcommand) {
-      const fullCommand = `${command} ${subcommand}`;
-      const pluginCmd = pluginCommands.find(cmd => {
-        // 精确匹配或匹配到参数变体
-        return cmd.command === fullCommand || cmd.command.startsWith(fullCommand + ' ');
-      });
-
-      if (pluginCmd) {
-        return renderPluginCommandHelp(pluginCmd, pluginManager);
-      }
-    }
-    
-    // 否则查找匹配的一级命令
-    // 优先查找精确匹配的父命令（如 "formula"），而不是子命令（如 "formula list"）
-    let pluginCmd = pluginCommands.find(cmd => cmd.command === command);
-    
-    // 如果没有精确匹配，再查找命令名称匹配的
-    if (!pluginCmd) {
-      pluginCmd = pluginCommands.find(cmd => {
-        // 移除参数部分，只保留命令名称
-        const cmdName = cmd.command.split(' ')[0];
-        return cmdName === command;
-      });
-    }
-
-    if (pluginCmd) {
-      return renderPluginCommandHelp(pluginCmd, pluginManager);
-    }
-  }
-
-  if (!helpConfig.commands[command]) {
-    return renderRootHelp(pluginManager);
-  }
-
-  if (!subcommand) {
-    return renderCommandHelp(command);
-  }
-
-  // 处理嵌套子命令 (如 sandbox session create)
-  const cmdConfig = helpConfig.commands[command];
-  if (cmdConfig.subcommands) {
-    // 首先尝试精确匹配子命令名
-    if (cmdConfig.subcommands[subcommand]) {
-      const subcmdConfig = cmdConfig.subcommands[subcommand];
-      if (rest.length > 0 && subcmdConfig.subcommands && subcmdConfig.subcommands[rest[0]]) {
-        return renderNestedSubcommandHelp(command, subcommand, rest[0]);
-      }
-      return renderSubcommandHelp(command, subcommand);
-    }
-
-    // 尝试匹配 <id> <subcommand> 格式的通配符子命令
-    // 例如: sandbox abc123 exec -> 匹配 <id> exec
-    if (rest.length > 0) {
-      const wildcardKey = `<id> ${rest[0]}`;
-      if (cmdConfig.subcommands[wildcardKey]) {
-        const subcmdConfig = cmdConfig.subcommands[wildcardKey];
-        // 检查是否有更深层的嵌套子命令 (如 <id> log search)
-        if (rest.length > 1 && subcmdConfig.subcommands && subcmdConfig.subcommands[rest[1]]) {
-          return renderNestedSubcommandHelp(command, wildcardKey, rest[1]);
-        }
-        return renderSubcommandHelp(command, wildcardKey);
-      }
-    }
-  }
-
-  return renderCommandHelp(command);
-}
-
-/**
- * Get ASCII logo with gradient colors
- */
-function getAsciiLogo() {
-  return showAsciiArt();
-}
-
-/**
- * 渲染一级帮助（根帮助）
- */
-function renderRootHelp(pluginManager = null) {
-  const lines = [];
-
-  // Logo (with leading empty line like opencode)
-  lines.push('');
-  lines.push('');
-  lines.push(getAsciiLogo());
-  lines.push('');
-
-  // 标题和描述
-  lines.push(helpConfig.description);
-  if (helpConfig.tagline) {
-    lines.push(helpConfig.tagline);
-  }
-  lines.push('');
-  lines.push('');
-
-  // 用法
-  lines.push('用法');
-  lines.push(INDENT + helpConfig.usage);
-  lines.push('');
-
-  // 按分组渲染命令
-  for (const group of helpConfig.groups) {
-    // 过滤掉未启用的命令
-    const visibleCommands = group.commands.filter(cmd => isCommandEnabled(cmd));
-
-    if (visibleCommands.length === 0) continue; // 跳过空分组
-
-    lines.push(group.name);
-    for (const cmdName of visibleCommands) {
-      const cmd = helpConfig.commands[cmdName];
-      if (cmd) {
-        lines.push(INDENT + padEnd(cmdName, CMD_WIDTH) + cmd.description);
-      }
-    }
-    lines.push('');
-  }
-
-  // 渲染插件命令
-  if (pluginManager) {
-    const pluginCommands = pluginManager.getRegisteredCommands();
-    const existingCommands = helpConfig.groups.flatMap(g => g.commands);
-    
-    // 按命令层级分组：一级命令和二级命令
-    const topLevelCommands = [];
-    const subCommands = new Map(); // key: parent command, value: sub commands list
-    
-    for (const cmd of pluginCommands) {
-      const parts = cmd.command.split(' ');
-      
-      // 判断是否是一级命令
-      // 如果只有一个部分，或者第二个部分以 [ 或 < 开头（参数），则是一级命令
-      if (parts.length === 1 || (parts.length === 2 && (parts[1].startsWith('[') || parts[1].startsWith('<')))) {
-        // 一级命令
-        topLevelCommands.push(cmd);
-      } else {
-        // 二级命令
-        const parent = parts[0];
-        if (!subCommands.has(parent)) {
-          subCommands.set(parent, []);
-        }
-        subCommands.get(parent).push(cmd);
-      }
-    }
-    
-    // 创建父命令的描述（用于显示）
-    // 优先使用插件注册的父命令描述
-    const parentCommandDescriptions = new Map();
-    for (const [parent, subCmds] of subCommands.entries()) {
-      if (subCmds.length > 0) {
-        // 查找是否有插件注册了父命令描述
-        const parentCmd = topLevelCommands.find(cmd => cmd.command === parent);
-        if (parentCmd && parentCmd.describe) {
-          parentCommandDescriptions.set(parent, parentCmd.describe);
-        } else {
-          // 使用通用描述
-          parentCommandDescriptions.set(parent, '插件命令');
-        }
-      }
-    }
-    
-    // 过滤掉与内置命令冲突的一级命令（排除纯父命令描述）
-    const filteredTopLevel = topLevelCommands.filter(cmd => {
-      const cmdName = cmd.command.split(' ')[0];
-      return !existingCommands.includes(cmdName);
-    });
-    
-    // 创建一个包含所有一级命令名称的集合（包括有子命令的父命令）
-    const allTopLevelNames = new Set(filteredTopLevel.map(cmd => cmd.command.split(' ')[0]));
-    subCommands.forEach((_, parent) => allTopLevelNames.add(parent));
-    
-    if (allTopLevelNames.size > 0) {
-      lines.push('插件命令');
-      
-      // 按名称排序并显示所有一级命令
-      const sortedNames = Array.from(allTopLevelNames).sort();
-      for (const name of sortedNames) {
-        // 查找匹配的命令
-        const matchedCmd = filteredTopLevel.find(cmd => cmd.command.split(' ')[0] === name);
-        if (matchedCmd) {
-          // 显示完整的命令（包含参数）
-          lines.push(INDENT + padEnd(matchedCmd.command, CMD_WIDTH) + (matchedCmd.describe || ''));
-        } else {
-          // 有子命令的父命令
-          const desc = parentCommandDescriptions.get(name) || '';
-          lines.push(INDENT + padEnd(name, CMD_WIDTH) + desc);
-        }
-      }
-      
-      lines.push('');
-    }
-  }
-
-  // 全局选项
-  lines.push('全局选项');
-  for (const opt of helpConfig.globalOptions) {
-    const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-    lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr);
-  }
-  lines.push('');
-
-  // 示例
-  if (helpConfig.examples && helpConfig.examples.length > 0) {
-    lines.push('示例');
-    for (const example of helpConfig.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + '$ ' + example.cmd);
-      lines.push('');
-    }
-  }
-
-  // 页脚
-  lines.push(helpConfig.footer);
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染命令帮助（二级）
- */
-function renderCommandHelp(command) {
-  const cmdConfig = helpConfig.commands[command];
-  if (!cmdConfig) {
-    return `未知命令: ${command}`;
-  }
-
-  const lines = [];
-
-  // 描述
-  lines.push(cmdConfig.description);
-  lines.push('');
-
-  // 用法
-  lines.push('用法');
-  lines.push(INDENT + cmdConfig.usage);
-  lines.push('');
-
-  // 备注
-  if (cmdConfig.note) {
-    lines.push('说明');
-    lines.push(INDENT + cmdConfig.note);
-    lines.push('');
-  }
-
-  // 子命令
-  if (cmdConfig.subcommands) {
-    lines.push('子命令');
-    for (const [name, subcmd] of Object.entries(cmdConfig.subcommands)) {
-      const aliasStr = subcmd.aliases ? ` (别名: ${subcmd.aliases.join(', ')})` : '';
-      lines.push(INDENT + padEnd(name, CMD_WIDTH) + subcmd.description + aliasStr);
-    }
-    lines.push('');
-  }
-
-  // 通用选项
-  if (cmdConfig.commonOptions && cmdConfig.commonOptions.length > 0) {
-    lines.push('通用选项');
-    for (const opt of cmdConfig.commonOptions) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-  
-  // 选项 (适用于无子命令的命令，如 config)
-  if (cmdConfig.options && cmdConfig.options.length > 0) {
-    lines.push('选项');
-    for (const opt of cmdConfig.options) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-
-  // 示例
-  if (cmdConfig.examples && cmdConfig.examples.length > 0) {
-    lines.push('示例');
-    for (const example of cmdConfig.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + example.cmd);
-      lines.push('');
-    }
-  }
-
-  // 页脚
-  if (cmdConfig.footer) {
-    lines.push(cmdConfig.footer);
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染子命令帮助（三级）
- */
-function renderSubcommandHelp(command, subcommand) {
-  const cmdConfig = helpConfig.commands[command];
-  if (!cmdConfig || !cmdConfig.subcommands || !cmdConfig.subcommands[subcommand]) {
-    return `未知子命令: ${command} ${subcommand}`;
-  }
-
-  const subcmdConfig = cmdConfig.subcommands[subcommand];
-  const lines = [];
-
-  // 描述
-  lines.push(subcmdConfig.description);
-  if (subcmdConfig.aliases) {
-    lines.push(`别名: ${subcmdConfig.aliases.join(', ')}`);
-  }
-  lines.push('');
-
-  // 用法
-  lines.push('用法');
-  lines.push(INDENT + (subcmdConfig.usage || `rock-cli ${command} ${subcommand} [选项]`));
-  lines.push('');
-
-  // 嵌套子命令
-  if (subcmdConfig.subcommands) {
-    lines.push('子命令');
-    for (const [name, nested] of Object.entries(subcmdConfig.subcommands)) {
-      lines.push(INDENT + padEnd(name, CMD_WIDTH) + nested.description);
-    }
-    lines.push('');
-  }
-
-  // 选项
-  if (subcmdConfig.options && subcmdConfig.options.length > 0) {
-    lines.push('选项');
-    for (const opt of subcmdConfig.options) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-
-  // 示例
-  if (subcmdConfig.examples && subcmdConfig.examples.length > 0) {
-    lines.push('示例');
-    for (const example of subcmdConfig.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + example.cmd);
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染嵌套子命令帮助（四级，如 sandbox session create）
- */
-function renderNestedSubcommandHelp(command, subcommand, nestedCmd) {
-  const cmdConfig = helpConfig.commands[command];
-  const subcmdConfig = cmdConfig?.subcommands?.[subcommand];
-  const nestedConfig = subcmdConfig?.subcommands?.[nestedCmd];
-
-  if (!nestedConfig) {
-    return `未知命令: ${command} ${subcommand} ${nestedCmd}`;
-  }
-
-  const lines = [];
-
-  lines.push(nestedConfig.description);
-  lines.push('');
-
-  lines.push('用法');
-  lines.push(INDENT + (nestedConfig.usage || `rock-cli ${command} ${subcommand} ${nestedCmd} [选项]`));
-  lines.push('');
-
-  if (nestedConfig.options && nestedConfig.options.length > 0) {
-    lines.push('选项');
-    for (const opt of nestedConfig.options) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-
-  if (nestedConfig.examples && nestedConfig.examples.length > 0) {
-    lines.push('示例');
-    for (const example of nestedConfig.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + example.cmd);
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染插件子命令帮助
- */
-function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
-  const lines = [];
-
-  // 检查是否有真正的子命令（不是参数变体）
-  const hasRealSubcommands = subCommands.some(c => {
-    const parts = c.command.split(' ');
-    if (parts.length < 2) return false;
-    const secondPart = parts[1];
-    // 如果第二个部分以 [ 或 < 开头，则是参数变体，不是子命令
-    return !secondPart.startsWith('[') && !secondPart.startsWith('<');
-  });
-
-  // 获取插件名称
-  const pluginCmd = subCommands[0];
-  const pluginName = pluginCmd.pluginName || 'unknown';
-
-  // 尝试获取父命令描述
-  let parentDescribe = '插件命令';
-  if (pluginManager) {
-    const allCommands = pluginManager.getRegisteredCommands();
-    const parentCmd = allCommands.find(cmd => cmd.command === command);
-    if (parentCmd && parentCmd.describe) {
-      parentDescribe = parentCmd.describe;
-    }
-  }
-
-  if (hasRealSubcommands) {
-    // 有真正的子命令，显示子命令列表
-    lines.push(parentDescribe);
-    lines.push('');
-    
-    lines.push('用法');
-    lines.push(INDENT + `rockcli ${command} <子命令> [选项]`);
-    lines.push('');
-    
-    lines.push('子命令');
-    for (const subCmd of subCommands) {
-      const parts = subCmd.command.split(' ');
-      // 只显示真正的子命令（不是参数变体）
-      if (parts.length >= 2 && !parts[1].startsWith('[') && !parts[1].startsWith('<')) {
-        const subCmdName = subCmd.command.substring(command.length + 1);
-        lines.push(INDENT + padEnd(subCmdName, CMD_WIDTH) + (subCmd.describe || ''));
-      }
-    }
-    lines.push('');
-    
-    lines.push('来源');
-    lines.push(INDENT + `插件: ${pluginName}`);
-    lines.push('');
-  } else {
-    // 没有真正的子命令，都是参数变体，显示命令列表
-    lines.push('用法');
-    subCommands.forEach(subCmd => {
-      lines.push(INDENT + `rockcli ${subCmd.command}`);
-    });
-    lines.push('');
-    
-    // 显示第一个参数变体的选项
-    if (subCommands[0].options) {
-      lines.push('选项');
-      for (const [name, opt] of Object.entries(subCommands[0].options)) {
-        const aliasStr = opt.alias ? `, -${opt.alias}` : '';
-        const defaultStr = opt.default !== undefined ? ` (默认: ${opt.default})` : '';
-        lines.push(INDENT + padEnd(`--${name}${aliasStr}`, FLAG_WIDTH) + (opt.describe || '') + defaultStr);
-      }
-      lines.push('');
-    }
-    
-    lines.push('来源');
-    lines.push(INDENT + `插件: ${pluginName}`);
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染插件命令帮助
- */
-function renderPluginCommandHelp(cmd, pluginManager = null) {
-  const lines = [];
-  const parts = cmd.command.split(' ');
-  
-  // 检查是否是父命令（有子命令）
-  if (pluginManager && parts.length === 1) {
-    const allPluginCommands = pluginManager.getRegisteredCommands();
-    const relatedCommands = allPluginCommands.filter(c => c.command.startsWith(cmd.command + ' '));
-    
-    if (relatedCommands.length > 0) {
-      // 检查这些相关命令的第二个部分是否都是参数标记（子命令还是参数变体）
-      const hasRealSubcommands = relatedCommands.some(c => {
-        const parts = c.command.split(' ');
-        if (parts.length < 2) return false;
-        const secondPart = parts[1];
-        // 如果第二个部分以 [ 或 < 开头，则是参数变体，不是子命令
-        return !secondPart.startsWith('[') && !secondPart.startsWith('<');
-      });
-      
-      if (hasRealSubcommands) {
-        // 有真正的子命令，显示子命令列表
-        lines.push(cmd.describe || '插件命令');
-        lines.push('');
-        
-        lines.push('用法');
-        lines.push(INDENT + `rockcli ${cmd.command} <子命令> [选项]`);
-        lines.push('');
-        
-        lines.push('子命令');
-        for (const subCmd of relatedCommands) {
-          const parts = subCmd.command.split(' ');
-          // 只显示真正的子命令（不是参数变体）
-          if (parts.length >= 2 && !parts[1].startsWith('[') && !parts[1].startsWith('<')) {
-            const subCmdName = subCmd.command.substring(cmd.command.length + 1);
-            lines.push(INDENT + padEnd(subCmdName, CMD_WIDTH) + (subCmd.describe || ''));
-          }
-        }
-        lines.push('');
-        
-        if (cmd.pluginName) {
-          lines.push('来源');
-          lines.push(INDENT + `插件: ${cmd.pluginName}`);
-          lines.push('');
-        }
-        
-        return lines.join('\n');
-      } else {
-        // 没有真正的子命令，都是参数变体，显示命令列表
-        lines.push('用法');
-        relatedCommands.forEach(relCmd => {
-          lines.push(INDENT + `rockcli ${relCmd.command}`);
-        });
-        lines.push('');
-        
-        // 显示第一个参数变体的选项
-        if (relatedCommands[0].options) {
-          lines.push('选项');
-          for (const [name, opt] of Object.entries(relatedCommands[0].options)) {
-            const aliasStr = opt.alias ? `, -${opt.alias}` : '';
-            const defaultStr = opt.default !== undefined ? ` (默认: ${opt.default})` : '';
-            lines.push(INDENT + padEnd(`--${name}${aliasStr}`, FLAG_WIDTH) + (opt.describe || '') + defaultStr);
-          }
-          lines.push('');
-        }
-        
-        if (cmd.pluginName) {
-          lines.push('来源');
-          lines.push(INDENT + `插件: ${cmd.pluginName}`);
-          lines.push('');
-        }
-        
-        return lines.join('\n');
-      }
-    }
-  }
-  
-  // 单个命令或没有子命令的情况
-  lines.push(cmd.describe || '插件命令');
-  lines.push('');
-
-  lines.push('用法');
-  lines.push(INDENT + `rockcli ${cmd.command}`);
-  lines.push('');
-
-  // 选项
-  if (cmd.options) {
-    lines.push('选项');
-    for (const [name, opt] of Object.entries(cmd.options)) {
-      const aliasStr = opt.alias ? `, -${opt.alias}` : '';
-      const defaultStr = opt.default !== undefined ? ` (默认: ${opt.default})` : '';
-      lines.push(INDENT + padEnd(`--${name}${aliasStr}`, FLAG_WIDTH) + (opt.describe || '') + defaultStr);
-    }
-    lines.push('');
-  }
-
-  // 插件来源
-  if (cmd.pluginName) {
-    lines.push('来源');
-    lines.push(INDENT + `插件: ${cmd.pluginName}`);
-    lines.push('');
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染插件的帮助配置
- * @param {string} command - 命令名称
- * @param {Object} helpConfig - 插件的帮助配置
- * @param {string} [subcommand] - 子命令名称
- * @param {string[]} [rest] - 剩余的命令路径
- * @returns {string} 格式化的帮助文本
- */
-function renderPluginHelpConfig(command, helpConfig, subcommand, rest) {
-  if (!subcommand) {
-    // 渲染父命令帮助
-    return renderPluginCommandHelpConfig(command, helpConfig);
-  }
-  
-  // 渲染子命令帮助
-  if (helpConfig.subcommands && helpConfig.subcommands[subcommand]) {
-    const subcmdConfig = helpConfig.subcommands[subcommand];
-    
-    // 检查是否有更深层的嵌套子命令
-    if (rest.length > 0 && subcmdConfig.subcommands && subcmdConfig.subcommands[rest[0]]) {
-      return renderPluginNestedSubcommandHelpConfig(command, subcommand, rest[0], helpConfig);
-    }
-    
-    return renderPluginSubcommandHelpConfig(command, subcommand, subcmdConfig);
-  }
-  
-  // 没有找到子命令配置，回退到父命令
-  return renderPluginCommandHelpConfig(command, helpConfig);
-}
-
-/**
- * 渲染插件父命令帮助
- */
-function renderPluginCommandHelpConfig(command, config) {
-  const lines = [];
-
-  lines.push(config.description || '插件命令');
-  lines.push('');
-
-  if (config.usage) {
-    lines.push('用法');
-    lines.push(INDENT + config.usage);
-    lines.push('');
-  }
-
-  // 子命令
-  if (config.subcommands) {
-    lines.push('子命令');
-    for (const [name, subcmd] of Object.entries(config.subcommands)) {
-      lines.push(INDENT + padEnd(name, CMD_WIDTH) + subcmd.description);
-    }
-    lines.push('');
-  }
-
-  // 通用选项
-  if (config.commonOptions && config.commonOptions.length > 0) {
-    lines.push('通用选项');
-    for (const opt of config.commonOptions) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr);
-    }
-    lines.push('');
-  }
-
-  if (config.footer) {
-    lines.push(config.footer);
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染插件子命令帮助
- */
-function renderPluginSubcommandHelpConfig(command, subcommand, config) {
-  const lines = [];
-
-  lines.push(config.description || '插件子命令');
-  lines.push('');
-
-  if (config.usage) {
-    lines.push('用法');
-    lines.push(INDENT + config.usage);
-    lines.push('');
-  }
-
-  // 选项
-  if (config.options && config.options.length > 0) {
-    lines.push('选项');
-    for (const opt of config.options) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-
-  // 示例
-  if (config.examples && config.examples.length > 0) {
-    lines.push('示例');
-    for (const example of config.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + example.cmd);
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n');
-}
-
-/**
- * 渲染插件嵌套子命令帮助
- */
-function renderPluginNestedSubcommandHelpConfig(command, subcommand, nestedCmd, config) {
-  const subcmdConfig = config.subcommands?.[subcommand];
-  const nestedConfig = subcmdConfig?.subcommands?.[nestedCmd];
-
-  if (!nestedConfig) {
-    return `未知命令: ${command} ${subcommand} ${nestedCmd}`;
-  }
-
-  const lines = [];
-
-  lines.push(nestedConfig.description || '插件嵌套子命令');
-  lines.push('');
-
-  if (nestedConfig.usage) {
-    lines.push('用法');
-    lines.push(INDENT + nestedConfig.usage);
-    lines.push('');
-  }
-
-  if (nestedConfig.options && nestedConfig.options.length > 0) {
-    lines.push('选项');
-    for (const opt of nestedConfig.options) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
-      const requiredStr = opt.required ? ' (必填)' : '';
-      lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr + requiredStr);
-    }
-    lines.push('');
-  }
-
-  if (nestedConfig.examples && nestedConfig.examples.length > 0) {
-    lines.push('示例');
-    for (const example of nestedConfig.examples) {
-      lines.push(INDENT + '# ' + example.desc);
-      lines.push(INDENT + example.cmd);
-      lines.push('');
-    }
-  }
-
-  return lines.join('\n');
-}
-
-module.exports = {
-  renderHelp,
-  renderRootHelp,
-  renderCommandHelp,
-  renderSubcommandHelp,
-  renderNestedSubcommandHelp,
-  renderPluginCommandHelp,
-  renderPluginHelpConfig
-};