使用 Qt AI 助手

Qt AI Assistant 是一款编码助手。当连接到大型语言模型（LLM）时，它能自动完成你的代码，提供专业的编码建议、代码修复建议，以及编写测试用例和代码文档。

Qt AI Assistant 面向特定的商业 Qt 开发人员许可证持有者。有关许可证的更多信息，请在Qt 定价中选择Compare 。

Qt AI Assistant 目前处于实验阶段，由生成式人工智能提供支持。请检查所有建议，以确保它们适合在您的项目中使用。

安装 Qt AI Assistant

从网上加载 Qt AI Assistant 扩展：

1. 访问Extensions 。

   

2. 选择Use external repository 。
3. 选择AI Assistant 。
4. 选择Install 。

在内联聊天窗口中启用代码语法高亮显示

要在内联聊天窗口中启用代码语法高亮，请转到首选项>Text Editor >Generic Highlighter ，然后选择Download Definitions 。

更多信息，请参阅下载高亮定义。

安装和使用 Ollama

要使用 Qt AI Assistant 扩展在本地计算机上运行的 LLM，请安装 Ollama。您可以运行 Ollama 选择中的可用模型以及添加到 Ollama 的自定义模型。

在 Ollama 上运行模型

要运行模型，请输入

ollama run <model-name>

例如

ollama run codellama:7b-code

Ollama 支持的模型

您可以直接从 Ollama 使用以下模型：

• codellama:7b-code
• deepseek-coder-v2:lite
• theqtcompany/codellama-7b-qml
• theqtcompany/codellama-13b-qml

自定义模型

对于自定义模型，请遵循该模式的特定安装说明。您可以使用以下自定义模式：

• codellama:7b-code-qml
• codellama:13b-code-qml

连接到 LLM

您可以连接到以下 LLM：

• Code Llama 13B QML（用于 Qt 6，在您选择的云部署中运行）
• Code Llama 13B（用于 Qt 5，在您选择的云部署中运行）
• Codestral（由 Mistral 提供）
• Llama 3.3 70B（在您选择的云部署中运行）
• Claude 3.7 Sonnet（由 Anthropic 提供，请记住您需要为您的 Anthropic 账户配置基于令牌的计费支付方式：console.anthropic.com）
• GPT 4o（由 OpenAI 提供，请记住，您需要为 OpenAI 账户配置基于令牌的计费支付方式：platform.openai.com）
• GPT 4.1-mini（由 OpenAI 提供）
• DeepSeek V3（由 DeepSeek 提供）
• Code Llama 13B QML（通过 Ollama 在您的计算机上本地运行）
• Code Llama 7B QML（通过 Ollama 在本地计算机上运行）
• 通过 Ollama 运行的 Code Llama 7B（在本地计算机上运行）
• 通过 Ollama 运行 DeepSeek Coder V2 Lite（在本地计算机上运行）

连接 LLM：

1. 转至首选项>AI Assistant >General 。

   

2. 为每个可配置的用例选择一个 LLM。
3. 访问Advanced 。

   

4. 输入每个 LLM 的 API 验证令牌和服务器 URL。有关从何处获取访问信息的详细信息，请参阅第三方 LLM 提供商文档。

自动完成代码

Qt AI Assistant 可以通过建议下一步写什么来帮助你编写代码。当你停止输入时，它会提示 LLM 提出一个代码建议。

要接受整个建议，请选择Tab键。

要接受部分建议，请选择Alt+Right。

要取消建议，请选择Esc或导航到代码编辑器的另一个位置。

要使用鼠标与 Qt AI Assistant 交互，请将鼠标悬停在建议上。

将鼠标悬停在建议上时，可以逐字或逐行接受建议代码片段的部分内容。

要关闭代码补全栏，请选择Esc键或将光标移到其他位置。

要选择代码自动补全的模式，请转到首选项>AI Assistant >General 。

在General 中，你还可以全局打开或关闭所有项目的代码自动补全功能。Qt AI Assistant 会消耗大量来自 LLM 的令牌。为降低成本，请在不需要时关闭自动完成功能，并使用键盘快捷键完成代码。

通过键盘完成代码

要手动触发代码建议，请选择Ctrl+'。

输入提示和智能命令

在文本编辑器的内联提示窗口中，您可以用人类语言提示助手执行您的请求、提问或执行智能命令。要打开聊天窗口，请选择Ctrl+Shift+A。或者，要打开内联提示窗口，可以选择代码，然后选择 。

要关闭内联提示窗口，请选择Esc或 。

要从内联提示窗口进入 Qt AI Assistant 偏好设置，请选择 。在那里，您可以设置用于提示和代码审查的模型。

使用人类语言请求建议

要使用人类语言请求建议，请在输入字段中输入您的请求。如果您高亮了代码，AI 助手会将其作为上下文添加到提示中。Qt XML AI 助手会显示一个建议，您可在内联提示窗口中选择Copy 将其复制到剪贴板。

请求代码审查

使用 Qt AI Assistant 查看代码：

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/review smart 命令。

Qt AI Assistant 会审查代码并提出改进建议。如果Enable QML linter 在Preferences>AI Assistant >General 中开启，它就会使用QML Lint来审查 QML 代码。

以Qt Test 语法请求测试用例

使用 Qt AI Assistant 编写测试用例：

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/qtest smart 命令。

Qt AI Assistant 会生成一个测试用例，其格式为 Qt Test格式的测试用例，你可以复制并粘贴到你的Qt Test 项目中。

请求 Markdown 格式的代码文档

创建代码文档

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/doc smart 命令。

Qt AI Assistant 会生成代码文档格式，您可以复制并粘贴到您的文档文件中。

请求修复代码

请求修复代码

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/fix smart 命令。
4. 可选择将更改应用到代码中。

Qt AI Assistant 会建议一个修复，您可以应用到您的代码中。

请求解释代码

请求解释现有代码

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/explain smart 命令。

Qt AI Assistant 会对高亮显示的代码进行解释。

添加内联注释

使用 Qt AI Assistant 为现有代码添加内联注释：

1. 在代码编辑器中突出显示代码。
2. 打开内联提示窗口。
3. 选择/inlinecomments 智能命令。
4. 可选择将注释应用到代码中。

Qt AI Assistant 会添加内联注释，您可以将其应用到代码中。