rl-rockcli 0.0.14 → 0.0.16

package/README.md

@@ -5,7 +5,6 @@ ROCK CLI 是一个开源的命令行工具，用于管理和操作沙箱环境
 ## 功能特性
 
 - **沙箱管理** - 启动、停止、执行、上传/下载文件、交互式 REPL
-- **会话管理** - 持久化执行环境，支持环境变量继承
 
 ## 安装
 
@@ -28,9 +27,7 @@ rockcli <command> [options]
 ### 全局选项
 
 - `--verbose, -v` - 启用详细日志输出
-- `--config` - 配置文件路径（默认：~/.rock/settings.json）
 - `--base-url` - 服务器地址（覆盖配置文件）
-- `--api-key` - API 密钥（覆盖配置文件）
 
 ## 命令详解
 
@@ -161,9 +158,6 @@ rockcli sandbox <sandbox-id> session close --session my-session
 ```bash
 # 进入交互式 REPL
 rockcli sandbox <sandbox-id> attach
-
-# 或使用旧语法
-rockcli attach <sandbox-id>
 ```
 
 REPL 模式支持：
@@ -186,20 +180,16 @@ REPL 模式支持：
 ```json
 {
   "sandbox": {
-    "base_url": "http://localhost:8080",
-    "api_key": "your-api-key"
+    "base_url": "http://localhost:8080"
   }
 }
 ```
 
 ## 环境变量
 
-支持通过环境变量设置认证信息：
+支持通过环境变量设置服务器地址：
 
 ```bash
-# 设置 API Key
-export ROCK_API_KEY=your-api-key
-
 # 设置服务器地址
 export ROCKCLI_BASE_URL=http://localhost:8080
 
@@ -212,68 +202,6 @@ rockcli sandbox <sandbox-id> status
 
 优先级：命令行参数 > 环境变量 > 配置文件
 
-## 配置管理 (config)
-
-配置管理命令用于设置和查看本地配置参数。
-
-### 基本语法
-
-```bash
-rockcli config [options]
-```
-
-### 选项说明
-
-- `--api-key <key>` - 设置 API 密钥
-- `--base-url <url>` - 设置服务器基础 URL
-- `--list` - 显示当前配置（脱敏敏感值）
-
-### 示例
-
-```bash
-# 设置 API Key 和服务器地址
-rockcli config --api-key xxx --base-url http://localhost:8080
-
-# 显示当前配置
-rockcli config --list
-
-# 仅设置 API Key，其他值保持不变
-rockcli config --api-key xxx
-```
-
-## 开发指南
-
-### 项目结构
-
-```
-opensource/
-├── bin/
-│   └── rockcli.js       # CLI 主入口
-└── package.json         # 包配置
-
-（引用上层目录的共享代码）
-├── commands/            # 命令模块
-├── sdks/                # SDK 客户端
-└── utils/               # 工具类
-```
-
-### 本地开发
-
-```bash
-# 克隆项目
-git clone <repository-url>
-
-# 安装依赖
-npm install
-
-# 本地链接
-npm link
-
-# 测试命令
-rockcli --help
-rockcli sandbox --help
-```
-
 ## 相关资源
 
 - GitHub: https://github.com/your-org/rock-cli

package/commands/attach/ink-repl/InkREPL.js

@@ -99,6 +99,7 @@ import {
   isBuiltinCommand,
   executeBuiltinCommand,
   checkInteractiveCommand,
+  mergePluginAttachCommands,
 } from './builtinCommands.js';
 import { initConsoleLogger, clearConsoleLogger, consoleLogger } from './utils/consoleLogger.js';
 import { copyToClipboard } from './utils/clipboard.js';
@@ -122,6 +123,24 @@ export function InkREPL({
   const { exit } = useApp();
   const { stdout } = useStdout();
 
+  // Merge plugin attach commands on mount
+  const hasMergedPluginCommands = useRef(false);
+  useEffect(() => {
+    if (hasMergedPluginCommands.current) return;
+    hasMergedPluginCommands.current = true;
+
+    try {
+      const PluginManager = require('../../../utils/plugin-manager');
+      const pluginManager = PluginManager.getInstance();
+      const attachCommands = pluginManager.getRegisteredAttachCommands();
+      if (attachCommands.length > 0) {
+        mergePluginAttachCommands(attachCommands);
+      }
+    } catch (e) {
+      // PluginManager not initialized, ignore
+    }
+  }, []);
+
   // Load history outputs on mount
   const [initialOutputs, setInitialOutputs] = useState(null);
   const [initialCommandHistory, setInitialCommandHistory] = useState(null);

package/commands/attach/ink-repl/builtinCommands.js

@@ -13,7 +13,6 @@ export const COMMAND_HELP = {
   // Primary commands
   status: 'Show sandbox status',
   sessions: 'List attach sessions',
-    log: 'View sandbox logs. Usage: /log [-f file] [-k keyword] [-n lines]',
   tail: 'View last lines of a file. Usage: /tail [-n lines] [-k keyword] [-f] <file>',
   upload: 'Upload file/directory to sandbox. Usage: /upload @<local> @<remote>',
   download: 'Download file from sandbox. Usage: /download @<remote> @<local>',
@@ -379,91 +378,6 @@ export const commandHandlers = {
     }
   },
 
-  /**
-   * /log - View sandbox logs
-   */
-  log: async (ctx, args) => {
-    let keyword = null;
-    let lines = 100;
-    let logFile = 'command.log';
-
-    for (let i = 0; i < args.length; i++) {
-      if (args[i] === '-k' && args[i + 1]) {
-        keyword = args[++i];
-      } else if (args[i] === '-n' && args[i + 1]) {
-        lines = clampNumber(args[++i], { min: 1, max: 5000, fallback: 100 });
-      } else if ((args[i] === '-f' || args[i] === '--file') && args[i + 1]) {
-        logFile = args[++i];
-      }
-    }
-
-    // Reject obvious shell injection for user-provided values. This is not an auto-triggered path,
-    // but we still keep it safe since it runs in the sandbox shell.
-    if (hasDangerousShellChars(logFile) || (keyword && hasDangerousShellChars(keyword))) {
-      return { output: 'Invalid log parameters.', exitCode: 1 };
-    }
-
-    try {
-      // Try Loghouse first (only supports safe basenames for logFile)
-      const safeLoghouseFile = isSafeLogFileName(logFile) ? logFile : null;
-      const handleLogSearch =
-        typeof ctx.handleLogSearch === 'function'
-          ? ctx.handleLogSearch
-          : require('../../log/search').handleLogSearch;
-
-      const searchArgv = {
-        sandboxId: ctx.sandboxId,
-        logFile: safeLoghouseFile || 'command.log',
-        minutes: 60,
-        limit: lines,
-        keyword: keyword || undefined,
-        raw: false,
-        highlight: true,
-        highlightSandboxId: false,
-        truncate: 200,
-      };
-
-      // Capture console output
-      const output = [];
-      const originalLog = console.log;
-      const originalError = console.error;
-
-      console.log = (...args) => output.push(args.join(' '));
-      console.error = (...args) => output.push(args.join(' '));
-
-      try {
-        await handleLogSearch(searchArgv);
-      } finally {
-        console.log = originalLog;
-        console.error = originalError;
-      }
-
-      if (output.length > 0) {
-        return { output: output.join('\n'), exitCode: 0 };
-      }
-      return { output: 'No logs found.', exitCode: 0 };
-    } catch (error) {
-      // Fallback to local log
-      try {
-        const remotePath = resolveRemoteLogPath(logFile);
-        if (hasDangerousShellChars(remotePath)) {
-          return { output: 'Invalid log file path.', exitCode: 1 };
-        }
-
-        let command = `tail -n ${lines} -- ${shellEscapePosix(remotePath)} 2>/dev/null`;
-        if (keyword) {
-          command = `${command} | grep -i -- ${shellEscapePosix(keyword)}`;
-        }
-        command = `${command} || echo ${shellEscapePosix(keyword ? 'No matching logs' : 'No logs available')}`;
-
-        const result = await ctx.sessionManager.execute(command);
-        return { output: result.output || 'No logs available', exitCode: 0 };
-      } catch (e) {
-        return { output: `Failed to get logs: ${e.message}`, exitCode: 1 };
-      }
-    }
-  },
-
   /**
    * /upload - Upload file or directory to sandbox
    * Supports @ prefix for paths (e.g., /upload @local.txt @/remote.txt)
@@ -1251,3 +1165,32 @@ export function checkInteractiveCommand(command) {
 
   return { isInteractive: false, cmdName, alternative: null };
 }
+
+/**
+ * Merge plugin attach commands into builtin commands
+ * @param {Array<Object>} pluginCommands - Array of plugin command definitions
+ * @param {string} pluginCommands[].name - Command name (without / prefix)
+ * @param {string} pluginCommands[].description - Command description
+ * @param {Function} pluginCommands[].handler - Command handler function
+ */
+export function mergePluginAttachCommands(pluginCommands) {
+  if (!pluginCommands || !Array.isArray(pluginCommands)) {
+    return;
+  }
+
+  for (const cmd of pluginCommands) {
+    if (!cmd || !cmd.name) {
+      continue;
+    }
+
+    // Merge into COMMAND_HELP
+    if (cmd.description) {
+      COMMAND_HELP[cmd.name] = cmd.description;
+    }
+
+    // Merge into commandHandlers
+    if (cmd.handler && typeof cmd.handler === 'function') {
+      commandHandlers[cmd.name] = cmd.handler;
+    }
+  }
+}

package/commands/attach/opentui-repl/App.tsx

@@ -15,7 +15,7 @@ import { Console } from './components/Console.tsx';
 import { Toast } from './components/Toast.tsx';
 import { ConnectingScreen } from './components/ConnectingScreen.tsx';
 import { useResources } from './hooks/useResources.ts';
-import { executeBuiltinCommand, isBuiltinCommand, checkInteractiveCommand } from './builtinCommands.ts';
+import { executeBuiltinCommand, isBuiltinCommand, checkInteractiveCommand, mergePluginAttachCommands } from './builtinCommands.ts';
 import {
   parseAtContext,
   getLocalCompletions,
@@ -76,6 +76,20 @@ function ReplShell(props: { onExit?: () => void }) {
   // Stats tracking
   const stats = { startTime: Date.now(), shellCommands: 0, builtinCommands: 0 };
 
+  // Merge plugin attach commands on mount
+  onMount(() => {
+    try {
+      const PluginManager = require('../../../utils/plugin-manager');
+      const pluginManager = PluginManager.getInstance();
+      const attachCommands = pluginManager.getRegisteredAttachCommands();
+      if (attachCommands.length > 0) {
+        mergePluginAttachCommands(attachCommands);
+      }
+    } catch (e) {
+      // PluginManager not initialized, ignore
+    }
+  });
+
   // AbortController for cancelling execution
   let abortController: AbortController | null = null;
 

package/commands/attach/opentui-repl/builtinCommands.ts

@@ -78,3 +78,15 @@ export async function checkInteractiveCommand(
   const mod = getBuiltinModule();
   return mod.checkInteractiveCommand(command);
 }
+
+export interface AttachCommandDef {
+  name: string;
+  description: string;
+  handler: (context: BuiltinContext, args: string[]) => Promise<BuiltinResult>;
+  pluginName?: string;
+}
+
+export function mergePluginAttachCommands(commands: AttachCommandDef[]): void {
+  const mod = getBuiltinModule();
+  return mod.mergePluginAttachCommands(commands);
+}

package/commands/attach/repl.js

@@ -20,9 +20,9 @@ const DEFAULT_OPEN_SOURCE_BASE_URL = 'http://127.0.0.1:8080';
 
 /**
  * List of all builtin commands available in the REPL
+ * Note: /log is registered by loghouse plugin via registerAttachCommand
  */
 const BUILTIN_COMMANDS = [
-  { name: 'log', description: 'View sandbox logs' },
   { name: 'upload', description: 'Upload file to sandbox' },
   { name: 'download', description: 'Download file from sandbox' },
   { name: 'status', description: 'Show sandbox status' },

package/commands/sandbox.js

@@ -69,7 +69,8 @@ const sandboxExports = module.exports = {
       .option('api-key', {
         describe: 'API key for authentication',
         type: 'string',
-        group: 'Command Options:'
+        group: 'Command Options:',
+        hidden: isOpenSource // Hide in open source version
       })
       .option('base-url', {
         describe: 'Base URL for sandbox service',
@@ -109,17 +110,20 @@ const sandboxExports = module.exports = {
         alias: 'c',
         describe: 'Cluster ID (sets X-Cluster header)',
         type: 'string',
-        group: 'Command Options:'
+        group: 'Command Options:',
+        hidden: isOpenSource // Hide in open source version
       })
       .option('experiment-id', {
         describe: 'Experiment ID (sets X-Experiment-Id header)',
         type: 'string',
-        group: 'Command Options:'
+        group: 'Command Options:',
+        hidden: isOpenSource // Hide in open source version
       })
       .option('user-id', {
         describe: 'User ID (sets X-User-Id header)',
         type: 'string',
-        group: 'Command Options:'
+        group: 'Command Options:',
+        hidden: isOpenSource // Hide in open source version
       })
       .option('extra-header', {
         alias: 'H',
@@ -147,68 +151,79 @@ const sandboxExports = module.exports = {
         default: false,
         group: 'Command Options:'
       })
+      // Log Options - hidden in open source version (log command not supported)
       .option('n', {
         alias: 'lines',
         describe: 'Number of recent log lines to display (default: 10)',
         type: 'number',
         default: 10,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('f', {
         alias: 'follow',
         describe: 'Follow mode: continuously monitor logs (like tail -f)',
         type: 'boolean',
         default: false,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('sleep-interval', {
         alias: 'i',
         describe: 'Refresh interval in seconds for follow mode (default: 5)',
         type: 'number',
         default: 5,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('q', {
         alias: 'quiet',
         describe: 'Quiet mode: hide internal fields (timestamp, time_iso8601, etc.)',
         type: 'boolean',
         default: false,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('keyword', {
         alias: 'k',
         describe: 'Filter logs by keyword',
         type: 'string',
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('log-file', {
         describe: 'Filter by log file name',
         type: 'string',
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('debug', {
         describe: 'Enable debug mode to display SQL query',
         type: 'boolean',
         default: false,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('raw', {
         describe: 'Display raw output (flatten to single line)',
         type: 'boolean',
         default: false,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('multilines', {
         describe: 'Display multi-line logs with separators',
         type: 'boolean',
         default: false,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .option('highlight', {
         describe: 'Enable keyword highlighting (default: true)',
         type: 'boolean',
         default: true,
-        group: 'Log Options:'
+        group: 'Log Options:',
+        hidden: isOpenSource
       })
       .example([
         ['$0 sandbox start --image python:3.11', 'Start a new sandbox'],

package/help/renderer.js

@@ -36,24 +36,24 @@ function renderHelp(commandPath, pluginManager = null) {
   // 检查是否是插件命令（带有 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}`;
@@ -66,11 +66,11 @@ function renderHelp(commandPath, pluginManager = null) {
         return renderPluginCommandHelp(pluginCmd, pluginManager);
       }
     }
-    
+
     // 否则查找匹配的一级命令
     // 优先查找精确匹配的父命令（如 "formula"），而不是子命令（如 "formula list"）
     let pluginCmd = pluginCommands.find(cmd => cmd.command === command);
-    
+
     // 如果没有精确匹配，再查找命令名称匹配的
     if (!pluginCmd) {
       pluginCmd = pluginCommands.find(cmd => {
@@ -134,6 +134,9 @@ function getAsciiLogo() {
  * 渲染一级帮助（根帮助）
  */
 function renderRootHelp(pluginManager = null) {
+  // Check if running in open source mode (evaluated at function call time)
+  const isOpenSource = process.env.ROCKCLI_MODE === 'opensource';
+
   const lines = [];
 
   // Logo (with leading empty line like opencode)
@@ -176,14 +179,14 @@ function renderRootHelp(pluginManager = null) {
   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('<')))) {
@@ -198,7 +201,7 @@ function renderRootHelp(pluginManager = null) {
         subCommands.get(parent).push(cmd);
       }
     }
-    
+
     // 创建父命令的描述（用于显示）
     // 优先使用插件注册的父命令描述
     const parentCommandDescriptions = new Map();
@@ -214,20 +217,20 @@ function renderRootHelp(pluginManager = null) {
         }
       }
     }
-    
+
     // 过滤掉与内置命令冲突的一级命令（排除纯父命令描述）
     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) {
@@ -242,7 +245,7 @@ function renderRootHelp(pluginManager = null) {
           lines.push(INDENT + padEnd(name, CMD_WIDTH) + desc);
         }
       }
-      
+
       lines.push('');
     }
   }
@@ -250,7 +253,11 @@ function renderRootHelp(pluginManager = null) {
   // 全局选项
   lines.push('全局选项');
   for (const opt of helpConfig.globalOptions) {
-    const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
+    // Hide --api-key and --cluster in open source version
+    if (isOpenSource && (opt.flags.includes('--api-key') || opt.flags.includes('--cluster'))) {
+      continue;
+    }
+    const defaultStr = opt.default ? ` (默认：${opt.default})` : '';
     lines.push(INDENT + padEnd(opt.flags, FLAG_WIDTH) + opt.description + defaultStr);
   }
   lines.push('');
@@ -275,9 +282,12 @@ function renderRootHelp(pluginManager = null) {
  * 渲染命令帮助（二级）
  */
 function renderCommandHelp(command) {
+  // Check if running in open source mode (evaluated at function call time)
+  const isOpenSource = process.env.ROCKCLI_MODE === 'opensource';
+
   const cmdConfig = helpConfig.commands[command];
   if (!cmdConfig) {
-    return `未知命令: ${command}`;
+    return `未知命令：${command}`;
   }
 
   const lines = [];
@@ -302,7 +312,7 @@ function renderCommandHelp(command) {
   if (cmdConfig.subcommands) {
     lines.push('子命令');
     for (const [name, subcmd] of Object.entries(cmdConfig.subcommands)) {
-      const aliasStr = subcmd.aliases ? ` (别名: ${subcmd.aliases.join(', ')})` : '';
+      const aliasStr = subcmd.aliases ? ` (别名：${subcmd.aliases.join(', ')})` : '';
       lines.push(INDENT + padEnd(name, CMD_WIDTH) + subcmd.description + aliasStr);
     }
     lines.push('');
@@ -312,13 +322,17 @@ function renderCommandHelp(command) {
   if (cmdConfig.commonOptions && cmdConfig.commonOptions.length > 0) {
     lines.push('通用选项');
     for (const opt of cmdConfig.commonOptions) {
-      const defaultStr = opt.default ? ` (默认: ${opt.default})` : '';
+      // Hide --api-key and --cluster in open source version
+      if (isOpenSource && (opt.flags.includes('--api-key') || opt.flags.includes('--cluster'))) {
+        continue;
+      }
+      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('选项');
@@ -481,11 +495,11 @@ function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
     // 有真正的子命令，显示子命令列表
     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(' ');
@@ -496,7 +510,7 @@ function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
       }
     }
     lines.push('');
-    
+
     lines.push('来源');
     lines.push(INDENT + `插件: ${pluginName}`);
     lines.push('');
@@ -507,7 +521,7 @@ function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
       lines.push(INDENT + `rockcli ${subCmd.command}`);
     });
     lines.push('');
-    
+
     // 显示第一个参数变体的选项
     if (subCommands[0].options) {
       lines.push('选项');
@@ -518,7 +532,7 @@ function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
       }
       lines.push('');
     }
-    
+
     lines.push('来源');
     lines.push(INDENT + `插件: ${pluginName}`);
     lines.push('');
@@ -533,12 +547,12 @@ function renderPluginSubcommandsHelp(command, subCommands, pluginManager) {
 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 => {
@@ -548,16 +562,16 @@ function renderPluginCommandHelp(cmd, pluginManager = null) {
         // 如果第二个部分以 [ 或 < 开头，则是参数变体，不是子命令
         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(' ');
@@ -568,13 +582,13 @@ function renderPluginCommandHelp(cmd, pluginManager = null) {
           }
         }
         lines.push('');
-        
+
         if (cmd.pluginName) {
           lines.push('来源');
           lines.push(INDENT + `插件: ${cmd.pluginName}`);
           lines.push('');
         }
-        
+
         return lines.join('\n');
       } else {
         // 没有真正的子命令，都是参数变体，显示命令列表
@@ -583,7 +597,7 @@ function renderPluginCommandHelp(cmd, pluginManager = null) {
           lines.push(INDENT + `rockcli ${relCmd.command}`);
         });
         lines.push('');
-        
+
         // 显示第一个参数变体的选项
         if (relatedCommands[0].options) {
           lines.push('选项');
@@ -594,18 +608,18 @@ function renderPluginCommandHelp(cmd, pluginManager = null) {
           }
           lines.push('');
         }
-        
+
         if (cmd.pluginName) {
           lines.push('来源');
           lines.push(INDENT + `插件: ${cmd.pluginName}`);
           lines.push('');
         }
-        
+
         return lines.join('\n');
       }
     }
   }
-  
+
   // 单个命令或没有子命令的情况
   lines.push(cmd.describe || '插件命令');
   lines.push('');
@@ -648,19 +662,19 @@ function renderPluginHelpConfig(command, helpConfig, subcommand, rest) {
     // 渲染父命令帮助
     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);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "rl-rockcli",
-    "version": "0.0.14",
+    "version": "0.0.16",
     "description": "Open-source ROCK CLI - Sandbox and Log management tool",
     "bin": {
         "rockcli": "./index.js"

package/utils/plugin-manager.js

@@ -17,6 +17,12 @@ class PluginManager {
     this._resolver = new DependencyResolver();
     this._loadedPlugins = [];
     this._registeredCommands = [];
+    this._registeredAttachCommands = [];
+    this._builtInAttachCommands = [
+      'status', 'sessions', 'tail', 'upload', 'download',
+      'stop', 'clear', 'stats', 'copy', 'about', 'retry', 'theme',
+      'cleanup-history', 'help', 'docs', 'bug', 'close', 'exit', 'quit', 'resume'
+    ];
     this._currentPluginMetadata = null;
   }
 
@@ -309,6 +315,36 @@ class PluginManager {
        * @param {number} code - 退出码
        */
       gracefulExit,
+
+      /**
+       * 注册 attach 内置命令
+       * @param {Object} commandDef - 命令定义
+       * @param {string} commandDef.name - 命令名称（不含 / 前缀）
+       * @param {string} commandDef.description - 命令描述
+       * @param {Function} commandDef.handler - 命令处理函数 (ctx, args) => Promise<{output, exitCode}>
+       */
+      registerAttachCommand: (commandDef) => {
+        // 检查是否覆盖内置命令
+        if (this._builtInAttachCommands.includes(commandDef.name)) {
+          throw new Error(
+            `Cannot override built-in attach command: ${commandDef.name}`
+          );
+        }
+
+        // 检查命令冲突
+        if (this._isAttachCommandRegistered(commandDef.name)) {
+          throw new Error(
+            `Attach command "${commandDef.name}" is already registered`
+          );
+        }
+
+        this._registeredAttachCommands.push({
+          ...commandDef,
+          pluginName
+        });
+
+        logger.debug(`Attach command registered by plugin ${pluginName}: /${commandDef.name}`);
+      },
     };
   }
 
@@ -328,6 +364,22 @@ class PluginManager {
     return [...this._registeredCommands];
   }
 
+  /**
+   * 检查 attach 命令是否已注册
+   * @private
+   */
+  _isAttachCommandRegistered(name) {
+    return this._registeredAttachCommands.some(cmd => cmd.name === name);
+  }
+
+  /**
+   * 获取所有插件注册的 attach 命令
+   * @returns {Array<Object>}
+   */
+  getRegisteredAttachCommands() {
+    return [...this._registeredAttachCommands];
+  }
+
   /**
    * 获取所有已加载的插件信息
    * @returns {Array<Object>}
@@ -345,4 +397,30 @@ class PluginManager {
   }
 }
 
+/**
+ * 单例实例
+ * @type {PluginManager|null}
+ * @private
+ */
+PluginManager._instance = null;
+
+/**
+ * 获取 PluginManager 单例实例
+ * @returns {PluginManager}
+ */
+PluginManager.getInstance = function() {
+  if (!PluginManager._instance) {
+    throw new Error('PluginManager not initialized. Call setInstance() first.');
+  }
+  return PluginManager._instance;
+};
+
+/**
+ * 设置 PluginManager 单例实例
+ * @param {PluginManager} instance
+ */
+PluginManager.setInstance = function(instance) {
+  PluginManager._instance = instance;
+};
+
 module.exports = PluginManager;