Palm1r/QodeAssist

QodeAssist – 為 Qt Creator 提供 AI 驅動的程式碼輔助工具

什麼是 QodeAssist – QodeAssist 是一款 Qt Creator 外掛程式，可將大型語言模型 (LLM) 的能力直接引入 IDE。它增加了 AI 驅動的程式碼補全、聊天面板、行內「快速重構」編輯，以及一組模型可以調用的 tools（檔案讀寫、建置、終端機、診斷等）。該外掛程式可與多種供應商配合使用——包括本地運行環境如 Ollama、llama.cpp、LM Studio，以及雲端 API 如 Anthropic Claude、OpenAI、Google Gemini、Mistral/Codestral、Qwen、DeepSeek，以及任何與 OpenAI 相容的端點。

關鍵功能

• 具備上下文感知能力的程式碼補全（單行與多行）用於 C++ 和 QML，支援填補中間內容 (FIM) 模型與聊天式模型。
• 聊天助手，提供側邊面板、底部面板或分離式視窗，具備歷史紀錄持久化、Token 使用量顯示，以及長對話的可選摘要功能。
• 快速重構 (Quick Refactor) – 調用模型來行內重寫所選程式碼，並使用可搜尋的自定義指令庫。
• 代理工具 (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 client hub) – 連接至外部 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。
• 快速重構 (Quick Refactor) – 選擇程式碼，觸發重構構建命令，重構模型會根據所選的指令模板返回一個編輯後的程式碼片段。
• MCP – 在 Tools → Options → QodeAssist → MCP Server 啟用伺服器，讓其他編輯器使用專案感知能力強的工具，- 透過 MCP Client 配置外部 MCP 伺服器。

專案狀態

• 該儲存庫是 archived（已封存）。作者在版權聲明爭議後停止了開發。最後一個發佈的版本仍可下載，但預期不會再有進一步的更新或錯誤修復。

授權 – GPL v3。

---

以上所有資訊均直接取自儲存庫的 README；未進行額外的功能推測。