如何用JavaScript实现一个支持自动补全的命令行界面？

const readline = require('readline');

// 假设我们有一组预定义的命令
const availableCommands = [
    'connect <host> [port]',
    'disconnect',
    'status',
    'send <message>',
    'history',
    'help',
    'exit'
];

// 一个更结构化的命令列表，便于扩展
const commandDefinitions = {
    'connect': {
        description: 'Connects to a specified host.',
        args: ['host', '[port]'],
        handler: (args) => console.log(`Connecting to ${args.host}:${args.port || 8080}...`)
    },
    'disconnect': {
        description: 'Disconnects from the current session.',
        handler: () => console.log('Disconnected.')
    },
    'status': {
        description: 'Shows current connection status.',
        handler: () => console.log('Status: Connected to somewhere.')
    },
    'send': {
        description: 'Sends a message.',
        args: ['message'],
        handler: (args) => console.log(`Sending: "${args.message}"`)
    },
    'history': {
        description: 'Displays command history.',
        handler: () => console.log('Command history not implemented yet.')
    },
    'help': {
        description: 'Shows available commands.',
        handler: () => {
            console.log('\nAvailable Commands:');
            Object.keys(commandDefinitions).forEach(cmd => {
                const def = commandDefinitions[cmd];
                const args = def.args ? ` ${def.args.map(a => `<${a}>`).join(' ')}` : '';
                console.log(`  ${cmd}${args} - ${def.description}`);
            });
            console.log('');
        }
    },
    'exit': {
        description: 'Exits the application.',
        handler: () => {
            console.log('Exiting...');
            process.exit(0);
        }
    }
};

// 提取所有命令名称，用于简单的补全
const commandNames = Object.keys(commandDefinitions);

// completer 函数是核心，它接收用户当前输入，返回建议列表
function completer(line) {
    const hits = commandNames.filter((c) => c.startsWith(line));
    // 如果有匹配项，返回匹配项和当前输入的长度，否则返回所有命令和当前输入的长度
    // 这里的第二个参数是line，表示补全时替换的起始位置，即从line的开始替换
    return [hits.length ? hits : commandNames, line];
}

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    completer: completer // 将我们的补全函数传递给readline
});

// 设置提示符
rl.setPrompt('> ');
rl.prompt();

// 监听用户输入
rl.on('line', (line) => {
    const trimmedLine = line.trim();
    if (!trimmedLine) {
        rl.prompt();
        return;
    }

    const parts = trimmedLine.split(/\s+/);
    const command = parts[0];
    const args = parts.slice(1);

    const cmdDef = commandDefinitions[command];

    if (cmdDef) {
        // 简单参数解析，这里可以做得更复杂
        const parsedArgs = {};
        if (cmdDef.args) {
            cmdDef.args.forEach((argName, index) => {
                // 移除 <> 或 []
                const cleanArgName = argName.replace(/[<>[\]]/g, '');
                parsedArgs[cleanArgName] = args[index];
            });
        }
        cmdDef.handler(parsedArgs);
    } else {
        console.log(`Unknown command: "${command}". Type 'help' for available commands.`);
    }

    rl.prompt();
}).on('close', () => {
    console.log('Have a great day!');
    process.exit(0);
});

console.log("Welcome to the JS CLI. Type 'help' for commands, 'exit' to quit.");

function advancedCompleter(line) {
    const parts = line.trim().split(/\s+/);
    const lastPart = parts[parts.length - 1]; // 用户正在输入的最后一个词
    const currentCommand = parts[0];

    // 1. 补全命令名
    if (parts.length === 1 && !line.endsWith(' ')) { // 如果只输入了一个词，且后面没有空格
        const hits = commandNames.filter(cmd => cmd.startsWith(lastPart));
        return [hits.length ? hits : commandNames, lastPart];
    }

    // 2. 补全参数或选项
    const cmdDef = commandDefinitions[currentCommand];
    if (cmdDef) {
        // 这里需要更复杂的逻辑来判断是补全哪个参数或选项
        // 比如，如果命令是 'connect'，并且用户输入了 'connect somehost '
        // 那么下一个可能是端口号，或者如果 'connect' 有其他选项，则补全选项

        // 简单示例：补全 'connect' 的第一个参数（假设是主机名）
        if (currentCommand === 'connect' && parts.length === 2 && !line.endsWith(' ')) {
            // 假设我们有一个主机列表
            const knownHosts = ['localhost', '192.168.1.1', 'example.com'];
            const hostHits = knownHosts.filter(h => h.startsWith(lastPart));
            return [hostHits.length ? hostHits : knownHosts, lastPart];
        }

        // 补全选项 (flags)，这通常需要命令定义中包含可用的flags
        // 比如，如果 `send` 命令支持 `--urgent` 选项
        if (lastPart.startsWith('--')) {
            const availableFlags = ['--urgent', '--compress']; // 假设这是send命令的flags
            const flagHits = availableFlags.filter(f => f.startsWith(lastPart));
            return [flagHits, lastPart];
        }
    }

    // 如果以上都没有匹配，或者是不支持补全的上下文，则不提供建议
    return [[], line];
}

// 替换掉之前的 completer
// const rl = readline.createInterface({
//     input: process.stdin,
//     output: process.stdout,
//     completer: advancedCompleter
// });