自动补全模型

1 自动补全是什么？

自动补全会在你编辑 Markdown 或文本文件时显示 AI ghost text。它适合补完一句话、继续一个列表，或生成文档的下一小段。

当建议出现时：

• 按 Tab 接受建议；
• 按 Escape 取消建议；
• 继续输入会用你的内容替代建议。

2 打开自动补全设置

点击标题栏左上角 OpAgent logo，选择 Models，然后滚动到 Inline completion 区域。

3 选择模式

Completion mode 决定自动补全使用哪个模型。

• Auto：优先使用 OpAgent 的自动补全策略，没有时回退到默认模型。
• Default：使用 completion agent 的默认模型，再回退到全局默认模型。
• Custom model：固定使用一个 enabled 模型。
• Off：关闭自动补全。

4 使用专用补全模型

1. 添加或启用模型

   在 Models 页面确认你要使用的模型已经 enabled。如果还没有，先按 添加自定义模型 添加。

2. 启用 Inline completion

   勾选 Inline completion 区域里的 Enable。

3. 选择 Custom model

   把 completion mode 设置为 Custom model。

4. 选择模型

   在 custom model 下拉框里选择补全模型。

5. 在文档中测试

   打开 Markdown 或文本文件，把光标放在一段文字后面，稍等一下看是否出现建议。

5 选什么模型更合适？

自动补全更适合使用速度快、成本低的模型。它不一定需要最强的推理模型。

好的补全模型应该：

• 响应快；
• 输出较短；
• 能跟随当前文档风格；
• 适合频繁调用。

复杂规划、推理和大段改写，建议仍然放到聊天或 Agent 任务里使用更强模型。

6 如果没有建议出现

先检查：

• Inline completion 已启用；
• mode 不是 Off；
• 选择的 custom model 已 enabled；
• 当前文件是 Markdown 或文本文件；
• 编辑器有焦点，光标在文档中；
• 模型 provider 可以正常访问。

如果自定义模型太慢，可以把自动补全切换到更快的模型，把强模型留给聊天和 Agent。