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