📄 工具详情 ⚙️ 安装教程 📚 使用教程

能力标签

🔌 MCP 🤖 Agent 🔄 工作流 💻 CLI 🔗 REST API 🧠 Claude ✨ GPT 🖥 本地 LLM

⚙️

Agent工作流

QodeAssist

基于 C++ · 无代码搭建完整 AI 自动化流程

⭐ 398 Stars 🍴 58 Forks 💻 C++ 📄 GPL-3.0 🏷 AI 7.5分

7.5AI 综合评分

workflowaiassistant

⬇ 下载源码（GPL） ⚙️ 配置说明

✦ AI Skill Hub 推荐

QodeAssist 是 AI Skill Hub 本期精选Agent工作流之一。综合评分 7.5 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

QodeAssist 是一套完整的 AI Agent 自动化工作流方案。随着 AI 能力的不断提升，基于 Agent 的自动化工作流正在成为提升个人和团队效率的核心方式。区别于传统的 RPA 自动化（模拟鼠标键盘操作），AI Agent 工作流通过理解任务意图、动态规划执行路径，能够处理更复杂的非结构化任务。

QodeAssist 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。

在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 7.5 分，是同类 Agent 工作流中的精选推荐。

📋 工具概览

QodeAssist 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。

GitHub Stars

⭐ 398

开发语言

C++

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

GPL-3.0

AI 综合评分

7.5 分

工具类型

Agent工作流

Forks

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

可视化 Agent 工作流编排，无需编写复杂代码
支持多步骤自动化任务链，实现全流程无人值守
与外部 API、数据库和第三方服务无缝集成
内置错误处理与自动重试机制，保障稳定运行
提供可复用的自动化模板，快速在同类场景部署

🎯 主要使用场景

自动化日常重复性工作，将精力集中于创造性任务
构建数据采集 → 处理 → 输出的完整自动化管线
实现跨平台、跨系统的数据流转和业务协同

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 克隆仓库
git clone https://github.com/Palm1r/QodeAssist
cd QodeAssist

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用

📋 安装步骤说明

访问 GitHub 仓库获取工作流文件
在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
上传工作流文件
按照提示配置必要的环境变量和 API Key
运行测试确认流程正常后投入使用

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 查看帮助
qodeassist --help

# 基本运行
qodeassist [options] <input>

# 详细使用说明请查阅文档
# https://github.com/Palm1r/QodeAssist

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# qodeassist 配置说明
# 查看配置选项
qodeassist --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量（覆盖配置文件）
export QODEASSIST_CONFIG="/path/to/config.yml"

📑 README 深度解析真实文档完整度 70/100 查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

QodeAssist — AI coding assistant for Qt Creator

GitHub Downloads (all assets, all releases)

qodeassist-icon QodeAssist brings a full AI coding workflow to Qt Creator for C++ and QML — smart code completion, multi-panel chat, inline quick refactoring, and project-aware tool calling. It works with local runtimes (Ollama, llama.cpp, LM Studio) and cloud providers (Claude, OpenAI, Google AI, Mistral), can run as an MCP server so other clients reuse its project context, and can also act as an MCP client to consume tools from external MCP servers (authenticated MCP servers are not supported yet).

⚠️ Important Notice About Paid Providers > When using paid providers like Claude, OpenRouter or OpenAI-compatible services: > - These services will consume API tokens which may result in charges to your account > - The QodeAssist developer bears no responsibility for any charges incurred > - Please carefully review the provider's pricing and your account settings before use

Overview

QodeAssist enhances Qt Creator with AI-powered coding assistance:

Code Completion — intelligent, context-aware suggestions (FIM and chat models) for C++ and QML, with multiline support
Chat Assistant — side panel, bottom panel, or detached window; history with auto-save, token monitoring, extended thinking
Quick Refactoring — inline AI-assisted edits directly in the editor with a searchable custom-instructions library
Agent Tools — read, search, create and edit files; build the project; run terminal commands; access linter/compiler issues; manage TODOs
Agent Skills — reusable folders of specialized instructions loaded on demand; discovered from .qodeassist/skills/ and .claude/skills/, invoked automatically, with /skill, or always-on
MCP Server — expose QodeAssist's project-aware tools to external MCP clients (Claude Code, VS Code, Claude Desktop via bridge)
MCP Client Hub — connect QodeAssist to external MCP servers and use their tools in Chat and Quick Refactor (authenticated MCP servers are not supported yet)
File Context — attach, link, or auto-sync open editor files for richer prompts
Many Providers — Ollama, llama.cpp, LM Studio (Chat + Responses), Claude, OpenAI (Chat + Responses), Google AI, Mistral, Codestral, OpenRouter, any OpenAI-compatible endpoint
Customizable — per-project rules (.qodeassist/rules/), agent roles, reusable refactor templates, full prompt-template control

Join our Discord Community to get support and connect with other users!

<details> <summary>Code completion: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/255a52f1-5cc0-4ca3-b05c-c4cf9cdbe25a" width="600" alt="QodeAssistPreview"> </details>

<details> <summary>Quick refactor in code: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/4a9092e0-429f-41eb-8723-cbb202fd0a8c" width="600" alt="QodeAssistPreview"> </details>

<details> <summary>Chat View Mode: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/5914dd78-c8a4-4d35-889a-10ec493d4c4b" width="600" alt="QodeAssistChat2"> </details>

<details> <summary>Multiline Code completion: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/c18dfbd2-8c54-4a7b-90d1-66e3bb51adb0" width="600" alt="QodeAssistPreview"> </details>

<details> <summary>Chat with LLM models in side panels: (click to expand)</summary> <img src="https://github.com/user-attachments/assets/ead5a5d9-b40a-4f17-af05-77fa2bcb3a61" width="600" alt="QodeAssistChat"> </details>

<details> <summary>Chat with LLM models in bottom panel: (click to expand)</summary> <img width="326" alt="QodeAssistBottomPanel" src="https://github.com/user-attachments/assets/4cc64c23-a294-4df8-9153-39ad6fdab34b"> </details>

<details> <summary>Chat in addtional window: (click to expand)</summary> <img width="851" height="865" alt="image" src="https://github.com/user-attachments/assets/a68894b7-886e-4501-a61b-7161ae34b427" /> </details>

<details> <summary>Automatic syncing with open editor files: (click to expand)</summary> <img width="600" alt="OpenedDocumentsSync" src="https://github.com/user-attachments/assets/08efda2f-dc4d-44c3-927c-e6a975090d2f"> </details>

<details> <summary>Example how tools works: (click to expand)</summary> <img width="600" alt="ToolsDemo" src="https://github.com/user-attachments/assets/cf6273ad-d5c8-47fc-81e6-23d929547f6c"> </details>

description: What the skill does and when to use it.

Features

Prerequisites

CMake 3.16+
C++20 compatible compiler
Qt Creator development files

Install plugin to QtCreator

Install latest version

./qodeassist-updater --install ```

For more information, visit the QodeAssistUpdater repository.

Method 2: Manual Installation

1. Install Latest Qt Creator 2. Download the QodeAssist plugin for your Qt Creator - Remove old version plugin if already was installed - on macOS for QtCreator 16: ~/Library/Application Support/QtProject/Qt Creator/plugins/16.0.0/petrmironychev.qodeassist - on windows for QtCreator 16: C:\Users\<user>\AppData\Local\QtProject\qtcreator\plugins\16.0.0\petrmironychev.qodeassist\lib\qtcreator\plugins 3. Launch Qt Creator and install the plugin: - Go to: - MacOS: Qt Creator -> About Plugins... - Windows\Linux: Help -> About Plugins... - Click on "Install Plugin..." - Select the downloaded QodeAssist plugin archive file

Quick Setup (Recommended for Beginners)

The Quick Setup feature provides one-click configuration for popular cloud AI models. Get started in 3 easy steps: <details> <summary>Quick setup: (click to expand)</summary> <img width="600" alt="Quick Setup" src="https://github.com/user-attachments/assets/20df9155-9095-420c-8387-908bd931bcfa"> </details>

1. Open QodeAssist Settings 2. Select a Preset - Choose from the Quick Setup dropdown: - Anthropic Claude (Sonnet 4.5, Haiku 4.5, Opus 4.5) - OpenAI (gpt-5.2-codex) - Mistral AI (Codestral 2501) - Google AI (Gemini 2.5 Flash) 3. Configure API Key - Click "Configure API Key" button and enter your API key in Provider Settings

All settings (provider, model, template, URL) are configured automatically. Just add your API key and you're ready to go!

How to Build

Build Steps

Create a build directory:

mkdir build && cd build

Configure and build:

cmake -DCMAKE_PREFIX_PATH=<path_to_qtcreator> -DCMAKE_BUILD_TYPE=RelWithDebInfo <path_to_plugin_source>
cmake --build .

Path specifications: - <path_to_qtcreator>: - Windows/Linux: Qt Creator build directory or combined binary package - macOS: Qt Creator.app/Contents/Resources/ - <path_to_plugin_source>: Path to this plugin directory

Development Guidelines

For detailed development guidelines, architecture patterns, and best practices, see the project workspace rules.

qodeassist-icon qodeassist-icon-small

Configuration

Manual Provider Configuration

For advanced users or local models, choose your preferred provider and follow the detailed configuration guide:

Local providers: - Ollama — native Ollama API - Ollama (OpenAI-compatible) — Ollama's /v1 endpoint for tool-calling models - llama.cpp — local llama-server - LM Studio — OpenAI-compatible Chat API - LM Studio (Responses API) — newer models that require the Responses endpoint

Cloud providers: - Anthropic Claude — manual setup guide - OpenAI — Chat Completions and Responses API - Mistral AI / Codestral - Google AI — Gemini - OpenAI-compatible — OpenRouter and any custom endpoint