Fluent-Kit

面向 Qt Widgets 的 Fluent 控件

原生 C++17 控件，可继续使用现有的 signals、slots、布局和工程结构。

C++17 Qt 5.15+ / 6.2+

在线打开 Gallery 查看接入说明

在线 Gallery 无需安装 Qt。

Python / PySide6 Python 项目可通过 PySide6 使用同一套控件 pip install FluentQt Gallery
Windows Mica 效果下的 Fluent-Kit Gallery 首页，展示控件分类和示例
UI 运行时
Qt Widgets
Qt 支持
5.15+ / 6.2+
工具链
CMake + C++17
运行平台
Windows / macOS / Linux / Web

开始使用

开始使用 Fluent-Kit

先打开在线 Gallery 查看控件效果，或直接查看 C++ / Python 接入说明。

01 在线 Gallery

搜索控件、切换主题，直接操作 C++ WebAssembly 示例。

打开 Gallery 02 C++ / Qt Widgets

复制 CMake 配置，按最小示例接入现有 Qt Widgets 项目。

查看 C++ 接入 03 Python / PySide6

从 PyPI 安装 FluentQt，通过 PySide6 使用同一套控件。

查看 PyPI 安装

03 / GUI SKILL

用 AI 开发桌面 GUI

  • 工程C++ / PySide6 项目结构
  • 界面Fluent 组件、主题与配色
  • 快速预览先在 Live Scene 里边改边看，再用 C++ 示例确认效果
  • 检查Light / Dark、窄窗口与交互
查看 Skill 文档 查看用法
参考实现 DeepSeek Desktop
C++ · FluentQt
使用 build-fluentqt-gui 构建的 DeepSeek Desktop 原生桌面参考界面

任务分组、运行时间线、输入与 Light / Dark 主题。

FluentQt 独立实现，非 DeepSeek 官方应用。

上游项目

04 / POSITIONING

原生控件 C++ 接口

每个控件都有独立的 C++ API、状态与布局行为

  1. 01

    Qt Widgets 原生用法

    沿用 signals、slots、layout 与事件循环

  2. 02

    Qt 5 / Qt 6 共用接口

    应用侧无需为 Qt 主版本维护两套调用

  3. 03

    CMake 接入

    包含 FluentQt/FluentQt.h，链接 FluentQt::FluentQt

05 / COMPONENTS

控件按用途分类

以下为 Gallery 中的部分控件

Windows Mica 效果下的 Fluent-Kit Gallery Button 控件页面
01

BASIC INPUT

Button

包含默认、强调、禁用和图标状态

SplitButtonComboBoxCheckBox
Windows Mica 效果下的 Fluent-Kit Gallery 集合视图页面
02 / COLLECTIONSListView · GridView · TreeView
Windows Mica 效果下的 Fluent-Kit Gallery 导航与窗口界面
03 / SHELLNavigation · Windowing
查看完整 API 目录
FoundationTheme · Typography · FontIcon
Basic inputButton · ComboBox · ToggleSwitch
CollectionsListView · GridView · TreeView
Date & timeCalendarView · DatePicker · TimePicker
Dialogs & flyoutsContentDialog · Flyout · TeachingTip
LayoutCard · Accordion · Expander
Menus & toolbarsMenu · MenuBar · CommandBar
NavigationNavigationView · TabView · Breadcrumb
ScrollingScrollView · PipsPager · AnnotatedScrollBar
Status & infoInfoBar · ProgressRing · Toast
Text fieldsLineEdit · PasswordBox · AutoSuggestBox
WindowingWindow · TitleBar · WindowBackdrop

06 / QUICK START

快速接入

将片段放在 add_executable(my_app ...) 之后。新建工程可参考完整的 hello_world 示例。

  • 保留现有 Widgets 工程与事件循环
  • 库目标只依赖 Qt Widgets
  • Qt 5 / Qt 6 使用同一应用层接口
查看完整 hello_world Python / PySide6 · pip install FluentQt 提问与获取帮助
CMakeLists.txt 
# Add Fluent-Kit to your existing project
# FluentQt must be installed from a release/source package first
find_package(FluentQt CONFIG REQUIRED)
target_link_libraries(my_app PRIVATE FluentQt::FluentQt)

target_link_libraries(
  my_app PRIVATE FluentQt::FluentQt
)

07 / DOWNLOAD

下载 Gallery

桌面安装包用于离线体验；应用接入仍使用 CMake 或 PyPI。

为当前设备推荐 下载 Gallery Windows · x64
最新 ReleaseLatest 全部版本与校验文件
Windows x64 Windows ARM64 macOS x64 macOS ARM64 Linux x64 Linux ARM64
可选兼容 Python / PySide6 python -m pip install FluentQt
FluentQt · PyPI Python Gallery