Palm1r/QodeAssist

QodeAssist – 为 Qt Creator 打造的 AI 驱动编程助手

什么是它 – QodeAssist 是一个 Qt Creator 插件，它将大语言模型 (LLM) 能力直接引入 IDE。它增加了 AI 驱动的代码补全、聊天面板、行内“快速重构”编辑，以及一套模型可以调用的工具（文件读/写、构建、终端、诊断等）。该插件可以与多种提供商协作——包括本地运行时（如 Ollama, llama.cpp, LM Studio）以及云端 API（如 Anthropic Claude, OpenAI, Google Gemini, Mistral/Codestral, Qwen, DeepSeek 以及任何兼容 OpenAI 的端点）。

核心功能

• 上下文感知代码补全（单行和多行）适用于 C++ 和 QML，支持填空式 (FIM) 模型和聊天式模型。
• 聊天助手，提供侧边栏、底部面板或分离窗口，具备历史记录持久化、Token 使用量显示以及长对话的可选摘要功能。
• 快速重构 – 调用模型根据选定的指令库进行行内重写选定代码。
• 智能体工具 (Agent tools) – 模型可以调用函数来列出/展示文件、读/写文件、运行构建、执行 Shell 命令、获取 Linter 诊断信息，并管理 TODO 风格的任务。
• 智能体技能 (Agent Skills) – 基于 Markdown 的可重用指令文件夹（兼容开放的 Agent Skills 规范），可以自动加载、通过 /skill 调用，或设置为“始终开启”。
• MCP (Model Context Protocol) 服务器 – 通过 HTTP/SSE 或 stdio 将 QodeAssist 的工具暴露出来，以便其他兼容 MCP 的客户端（Claude Code, VS Code, Cursor 等）可以复用相同的项目上下文。
• MCP 客户端中心 – 连接到外部 MCP 服务器并使其工具在 QodeAssist 内部可用。
• 多提供商支持 – 通过简单的 UI 配置本地或云端模型；快速设置预设涵盖了最受欢迎的服务。
• 可定制的提示词组合 – 针对每个功能的系统提示词、打开的文件上下文以及可选的文件附件处理。

安装

1. 扩展注册表方法 (推荐) – 通过 Qt Creator → Extensions → Browser 添加与您的 Qt Creator 版本匹配的 QodeAssist 注册表 URL（例如 https://github.com/Palm1r/extension-registry/archive/refs/heads/qodeassist.tar.gz）。在同一界面进行安装和更新。
2. 手动方法 – 下载编译好的插件归档文件，将其放入您对应版本的 Qt Creator 插件目录（例如 macOS 上的 ~/Library/Application Support/QtProject/Qt Creator/plugins/16.0.0/），然后通过 Help → About Plugins… → Install Plugin… 启用它。

配置

• 使用 Quick Setup 下拉菜单选择一个预设（Claude, OpenAI, Mistral, Google Gemini, Qwen, DeepSeek）并输入 API key；插件会自动填充提供商 URL、模型名称和提示词模板。
• 对于本地模型，请参考 Ollama, llama.cpp 或 LM Studio 的相关文档，将 QodeAssist 指向正确的端点。
• 高级用户可以手动编辑提供商设置、启用/禁用单个工具，并添加全局或项目特定的 Agent Skills 目录。

使用方法

• 代码补全 – 正常输入；输入三个字符后会出现提示（基于提示的模式）或自动请求补全（自动模式）。按下配置的按键（默认为 Space）来接受。
• 聊天 – 打开聊天面板，输入查询，附加文件/图像，或使用 /skillname 调用技能。 模型可以在对话过程中调用诸如 read_file 或 build_project 之类的工具。
• 快速重构 – 选择代码，触发重构构思，模型会根据所选的指令模板返回编辑后的代码片段。
• MCP – 在 Tools → Options → QodeAssist → MCP Server 中启用服务器，以便让其他编辑器使用项目感知型工具，或在 MCP Client 下配置外部 MCP 服务器。

项目状态

• 该仓库是已归档 (archived) 的。作者在版权声明争议后停止了开发。最后一个发布的版本仍然可以下载，但预计不会再有进一步的更新或错误修复。

许可证 – GPL v3。

---

以上所有信息直接取自仓库的 README；未进行额外的功能推断。