QtCreator接入外部AI大模型

Nathan'

已于 2025-07-02 14:07:37 修改

阅读量1.6k

点赞数 22

CC 4.0 BY-SA版权

文章标签：人工智能

于 2025-07-01 19:05:17 首次发布

本文链接：https://blog.csdn.net/fjunchao/article/details/148143256

一、概要

本篇文章主要通过让QtCreator接入外部AI插件，实现在QtCretor里调用AI模型完成代码自动补全（Code Completion）和聊天助手（Chat Assistant）的目的。下面是需要操作的工具列表。
Qt版本：Qt5.14.2（自带QtCreator4.11.1，但是这里不用它）
QtCreator版本：QtCreator17.0.0（独立安装程序）
AI插件：QodeAssist项目【文章用到的插件release版本】

二、安装Qt5.14.2，配置高版本QtCreator

访问： Qt5.14.2使用高版本QtCreator

三、下载AI插件

访问：QodeAssist Releases可以直接下载最新版本的插件，记的选择和自己安装的QtCreator一致的版本，这里选择QodeAssist-v0.6.0-QtC17.0.0-Windows-x64.7z。
在这里插入图片描述
下载解压后，里面会有按照QtCreator插件路径创建的lib文件夹，把它放到安装QtCreator17时所选择的文件夹下，一般是C:\Qt\qtcreator-17.0.0。

四、配置插件

4.1、AI大模型设置

前面几步操作完成后，打开QtCreator17.0.0=>编辑=>Preferences，找到QodeAssist，如下图配置。配置后在Provider Settings一栏中填上对应模型的API Key即可，非常简单。大家可以根据自己的需求和模型自定义。
在这里插入图片描述

4.2、自动补全配置

打开Code Completion选项，如下图：
在这里插入图片描述

QodeAssist的自动补全配置分为以下几个主要类别（按界面布局排布），附上个人建议供参考：

自动补全基础设置

Enable Auto Complete (autoCompletion): 启用或禁用自动补全功能的主开关
Enable Multiline Completion (multiLineCompletion): 允许生成跨多行的代码补全建议【建议】
Enable stream option (stream): 启用流式响应，让补全结果逐步显示【建议】
Enable smart process text from instruct model (smartProcessInstuctText): 智能处理指令模型的文本输出，如果不设置返回结果大概率会以注释开头。【建议】
AI suggestion triggers after typing (autoCompletionCharThreshold): 设置触发AI建议所需的字符数量（0-10个字符）
character(s) within(ms) (autoCompletionTypingInterval): 设置字符阈值必须在多长时间窗口内满足（500-5000毫秒）
with delay(ms) (startSuggestionTimer): 设置建议显示的延迟时间（10-10000毫秒）
Show progress indicator during code completion: 在代码补全过程中显示进度指示器
Include context from open files: 在补全时包含打开文件的上下文【不建议】

模型参数设置

基础参数：

Temperature: 控制生成文本的随机性（0.0-2.0，默认0.2）
Max Tokens: 设置生成的最大token数量（-1到900000，默认100）

高级参数：

Top P: 核采样参数，控制候选词汇的累积概率（0.0-1.0）
Top K: 限制候选词汇数量（1-1000）
Presence Penalty: 存在惩罚，减少重复内容（-2.0到2.0）
Frequency Penalty: 频率惩罚，进一步控制重复（-2.0到2.0）

上下文设置

Read Full File: 读取完整文件内容作为上下文【不建议】
Read Strings Before Cursor: 设置光标前读取的行数（0-10000行，默认50行）
Read Strings After Cursor: 设置光标后读取的行数（0-10000行，默认30行）

提示词设置

这项设置取决你使用的模型是否为FIM模型。

Use System Prompt: 启用系统提示词
System Prompt: 为FIM模型配置的系统提示词
Use special system prompt and user message for non FIM models: 为非FIM模型使用特殊的提示词模板
Max Changes Cache Size: 项目变更缓存的最大大小（2-1000，默认10）【不建议】
Additional Programming Languages: 添加自定义编程语言支持

Quick Refactor Settings（快速重构设置）

Quick Refactor Settings是专门为快速重构功能配置的设置组，包含以下选项：

Include context from open files in quick refactor (useOpenFilesInQuickRefactor): 在快速重构时包含打开文件的上下文信息
Quick Refactor System Prompt (quickRefactorSystemPrompt): 专门为快速重构功能配置的系统提示词，默认内容为专业的C++、Qt和QML代码补全助手提示

Ollama Settings（Ollama设置）

Ollama Settings是专门为Ollama提供商配置的设置组，包含以下选项：

Livetime (ollamaLivetime): 控制Ollama在完成请求后保持活跃的时间（以分钟为单位），设置为-1可禁用此功能，默认值为"5m"
Context Window (contextWindow): 设置Ollama的上下文窗口大小，范围为-1到10000，默认值为2048

4.3、聊天助手配置

打开Chat Assistant设置页面，如下图：
在这里插入图片描述

QodeAssist的聊天助手配置分为以下几个主要类别（按界面布局排布）：

Chat Settings（聊天设置）

Chat history token limit (chatTokensThreshold): 聊天历史记录的token限制，当超过此限制时会移除最旧的消息，范围1-99999999，默认值20000
Sync open files with assistant by default (linkOpenFiles): 默认情况下与助手同步所有打开的文件，默认值false【不建议】
Enable stream option (stream): 启用流式响应选项，让回复逐步显示，默认值true
Enable autosave when message received (autosave): 收到消息时启用自动保存功能，默认值true