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