注意：说明：
注意：自动补全默认开启。若未看到建议弹窗，可在设置 > 通用设置 > 终端设置中确认已启用自动补全。
一、补全内容来源
OrcaTerm 的补全建议来自以下来源，按优先级与场景组合呈现：
| 来源 | 说明 | 触发时机 |
| 内置热门命令 | 客户端内置的常用命令清单（git、docker、npm、kubectl 等） | 启动早期、远程规格未加载时作为兜底 |
| 远程命令规格 | 从服务端拉取的命令规格（含子命令、参数定义） | 终端就绪约 3 秒后加载完成 |
| 系统命令清单 | 登录后从服务器拉取的已安装命令（bash / zsh） | 首次需要时后台拉取，100ms 超时 |
| 文件路径 | 当前工作目录下的文件与目录 | 输入路径片段时 |
| 历史命令 | 当前会话的命令历史 | 输入命令前缀时 |
| AI 命令预测 | 基于 AI 模型预测的下一条命令 | 空提示符或输入前缀时（需开启） |
二、建议列表交互
输入命令时，候选建议以列表形式弹出在光标下方：
| 按键 | 作用 |
| ↑ / ↓ | 上下选择建议项 |
| Enter 或 Tab | 采纳当前选中的建议（取决于采纳键设置） |
| Esc | 关闭建议列表 |
| 继续输入 | 实时筛选建议（防抖 180ms） |
三、循环选择
开启循环选择后，↑ / ↓ 到达列表首尾时会循环跳转，而非停留在边界。默认关闭，可在设置中开启。
四、AI 命令预测（ghost text）
默认开启 AI 命令预测，终端会在空提示符或输入前缀时显示 AI 预测的下一条命令，以灰色 ghost text 内联展示在光标后：
| 按键 | 作用 |
| →（默认） | 采纳整条预测命令 |
| Tab | 采纳整条预测命令（可选） |
| Shift+→ | 采纳整条预测命令（可选） |
| 继续输入 | 若与预测前缀匹配则保留 ghost text，否则消失 |
五、预测规则
·前缀匹配：AI 预测的命令必须以当前已输入文本为前缀，才会显示为 ghost text；不匹配则不显示。
·空提示符预测：命令执行完成后，若终端处于空提示符状态（无输入、无输出、光标在行尾），会直接显示整条预测命令。
·追加而非替换：内联补全只追加后缀，不做关键字替换，避免与用户已输入内容冲突。
·大小写：Windows / PowerShell / CMD 环境下忽略大小写匹配；Linux / macOS 默认大小写敏感。
·缓存上限：AI 预测结果缓存最多 50 条，超出后淘汰最早的一条。
注意：说明：
六、设置项
在设置 > 通用设置 > 终端设置可配置以下选项：
| 设置项 | 默认值 | 说明 |
| 命令自动补全 | 开启 | 总开关，关闭后不弹出建议列表 |
| 选中补全项 | Tab | 采纳当前选中的建议 |
| 切换补全项 | 上下键 | 切换当前选中补全项 |
七、没有出现建议列表
·检查设置 > 通用设置中命令自动补全是否开启。
·远程规格加载约需 3 秒，刚登录时可能仅显示内置热门命令，稍候即可完整加载。
·系统命令清单首次使用时后台拉取，若服务器响应慢（超过 100ms）会回退到不使用系统命令清单。
八、采纳键不生效
·建议仍在计算中时采纳键不消费，等待建议列表稳定后再采纳。
·检查采纳键设置是否与预期一致。