命令补全
本文介绍 XTerminal 的智能命令补全功能，提供类似 IDE 的自动补全体验，支持 600 多种命令行工具。
功能概述
XTerminal 提供多层次的命令补全能力：
| 补全类型 | 说明 | 示例 |
|---|---|---|
| IDE 风格补全 | 支持 600+ CLI 工具 | docker、git、kubectl |
| 命令管理器补全 | 基于用户自定义的快速命令 | 自定义脚本片段 |
| 历史命令补全 | 基于服务器的历史命令记录 | 常用命令组合 |
| 脚本补全 (Beta) | 基于运行脚本获取的动态补全 | cd 后的目录列表 |
补全效果
输入命令时，补全建议会自动出现在光标下方：
补全列表显示：
- 命令/参数名称
- 图标标识类型
- 描述说明
使用补全
| 操作 | 方式 |
|---|---|
| 选择建议 | 方向键 ↑ ↓ 或鼠标 |
| 确认补全 | Enter 键或鼠标点击 |
| 取消补全 | Esc 键或继续输入 |
配置选项
设置路径：设置 > 通用终端 > 命令提示
基础开关
| 选项 | 说明 | 默认 |
|---|---|---|
| 是否启用 | 启用 IDE 风格的自动补全功能 | 开启 |
| 是否开启命令管理器补全 | 根据命令管理器中的快速命令进行补全 | 开启 |
| 是否开启历史命名补全 | 根据服务器历史命令进行补全 | 开启 |
| 是否开启命令脚本补全 (Beta) | 根据运行脚本获取补全（如 cd 后运行 ls） | 开启 |
高级选项
| 选项 | 说明 | 默认 |
|---|---|---|
| 轻提示 | 命令后跟随两个空格时才触发提示，适合高手使用 | 关闭 |
| 是否默认选中第一个 | 自动选中第一个建议，可能影响输入体验但提高效率 | 关闭 |
AI 模式
XTerminal 还提供 AI 辅助模式，可以对命令进行智能补全、解释和提示。
启用 AI 模式
设置路径：设置 > 通用终端 > AI模式 > 是否启用
使用方式
在命令末尾输入 ?? 触发 AI 建议：
AI 建议功能：
- 智能补全命令参数
- 解释命令用途
- 提供使用示例
- 支持参数填充
AI 建议界面
AI 建议弹窗包含：
| 区域 | 说明 |
|---|---|
| 命令预览 | 显示完整命令和参数 |
| 命令说明 | 解释命令的用途和功能 |
| 参数说明 | 详细说明各参数的含义 |
| 示例 | 提供实际使用示例 |
| 参数输入 | 可填写参数值 |
操作按钮：
- 重试：重新生成建议
- 取消：关闭建议窗口
- 粘贴：将命令粘贴到终端
- 运行：直接执行命令
支持的 Shell
命令补全功能支持以下 Shell 环境：
| Shell | 支持状态 |
|---|---|
| Bash | 完整支持 |
| Zsh | 完整支持 |
| Fish | 完整支持 |
| PowerShell | 完整支持 |
支持的工具
IDE 风格补全，支持 600 多种命令行工具，包括：
系统工具
ls、cd、cp、mv、rm、mkdir、chmod、chown
开发工具
git、npm、yarn、pnpm、pip、cargo、go
容器与云
docker、docker-compose、kubectl、helm、aws、gcloud、az
网络工具
curl、wget、ssh、scp、rsync
编辑器与工具
vim、code、nano、tmux、screen
补全优先级
当多个补全来源同时提供建议时，按以下优先级排序：
- IDE 补全 - 提供的精确建议
- 命令管理器 - 用户自定义的快速命令
- 历史命令 - 服务器历史记录（优先多词命令）
备注
为安全考虑，历史命令补全会自动过滤包含 rm 的危险命令。
性能说明
- 补全功能在后台异步运行，不会阻塞输入
- 首次使用某工具的补全时可能有短暂延迟
- 如感觉卡顿，可尝试关闭部分补全来源