概述
在 Qt Creator 中集成 AI 大模型，能显著提升编码效率。本文介绍如何通过 QodeAssist 插件实现代码自动补全与聊天助手功能。
环境准备
推荐使用 Qt 5.14.2 配合独立安装的 Qt Creator 17.0.0。自带版本可能较旧，建议单独下载高版本 IDE。
安装插件
前往 QodeAssist 官方 Release 页面下载对应版本的插件包（如 Windows x64）。解压后，将 lib 文件夹复制到 Qt Creator 的安装目录下，通常位于 C:\Qt\qtcreator-17.0.0。重启 IDE 即可识别插件。
配置 AI 模型
进入 编辑 > Preferences，找到 QodeAssist 选项卡。
- Provider Settings：填入你的 API Key。支持多种模型，可根据需求自定义。
- AI 大模型设置：基础参数包括 Temperature（随机性）和 Max Tokens（生成长度）。高级参数涉及 Top P、Top K 等采样策略。
自动补全设置
在 Code Completion 面板中调整以下关键项：
- Enable Auto Complete：主开关。
- Enable Multiline Completion：建议开启，支持跨行补全。
- Enable stream option：建议开启，流式输出体验更流畅。
- Smart Process Instuct Text：建议开启，避免结果以注释开头。
- 字符阈值：设置触发建议所需的输入字符数及时间窗口。
- 上下文读取：谨慎使用'读取完整文件'，默认读取光标前后行数即可，避免性能开销。
聊天助手配置
切换到 Chat Assistant 标签页：
- Chat history token limit：限制历史消息 Token 数量，防止上下文溢出。
- Sync open files：默认不建议同步所有打开文件，按需开启。
- System Prompt：可自定义系统提示词，引导 AI 扮演特定角色（如 C++/Qt 专家）。
- Ollama Settings：若使用本地 Ollama，需配置连接地址及上下文窗口大小。
使用技巧
配置完成后，底部状态栏会显示日志信息。若未启用自动补全，可通过快捷键 Ctrl Alt Q 或右键菜单手动激活。聊天窗口位于底部 QodeAssist Chat 区域。根据实际反馈微调参数，往往能获得更精准的代码建议。
