Files
fluent_widgets_pyside6/docs/README_zh.md

84 lines
4.1 KiB
Markdown
Raw Normal View History

2025-08-14 18:45:16 +08:00
<p align="center">
<img width="18%" align="center" src="https://raw.githubusercontent.com/zhiyiYo/PyQt-Fluent-Widgets/master/docs/source/_static/logo.png" alt="logo">
</p>
<h1 align="center">
PySide6-Fluent-Widgets
</h1>
<p align="center">
基于 PySide6 的 Fluent Design 风格组件库
</p>
<div align="center">
[![Version](https://img.shields.io/pypi/v/pyside6-fluent-widgets?color=%2334D058&label=Version)](https://pypi.org/project/PyQt-Fluent-Widgets)
[![Download](https://static.pepy.tech/personalized-badge/pyside6-fluent-widgets?period=total&units=international_system&left_color=grey&right_color=brightgreen&left_text=Downloads)]()
[![GPLv3](https://img.shields.io/badge/License-GPLv3-blue?color=#4ec820)](LICENSE)
[![Platform Win32 | Linux | macOS](https://img.shields.io/badge/Platform-Win32%20|%20Linux%20|%20macOS-blue?color=#4ec820)]()
</div>
<p align="center">
<a href="../README.md">English</a> | 简体中文 | <a href="https://qfluentwidgets.com/">官网</a>
</p>
![Interface](https://raw.githubusercontent.com/zhiyiYo/PyQt-Fluent-Widgets/master/docs/source/_static/Interface.jpg)
## 安装📥
安装轻量版 (亚克力组件不可用)
```shell
pip install PySide6-Fluent-Widgets -i https://pypi.org/simple/
```
安装完整版:
```shell
pip install "PySide6-Fluent-Widgets[full]" -i https://pypi.org/simple/
```
[商用高级版](https://qfluentwidgets.com/zh/pages/pro) 组件库包含更多组件,可从 [发行页面](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases) 下载体验编译好的示例程序 `PyQt-Fluent-Widgets-Pro-Gallery.zip`
C++ QFluentWidgets 组件库非开源,可从 [发行页面](https://github.com/zhiyiYo/PyQt-Fluent-Widgets/releases) 下载体验编译好的示例程序 `C++_QFluentWidgets.zip`,价格见 [官网](https://qfluentwidgets.com/zh/price)。
> [!Warning]
> 请勿同时安装 PyQt-Fluent-Widgets、PyQt6-Fluent-Widgets、PySide2-Fluent-Widgets 和 PySide6-Fluent-Widgets因为他们的包名都是 `qfluentwidgets`
## 运行示例▶️
使用 pip 安装好 PySide6-Fluent-Widgets 包并下载好此仓库的代码之后,就可以运行 examples 目录下的任意示例程序,比如:
```shell
cd examples/gallery
python demo.py
```
如果遇到 `ImportError: cannot import name 'XXX' from 'qfluentwidgets'`,这表明安装的包版本过低。可以按照上面的安装指令将 pypi 源替换为 https://pypi.org/simple 并重新安装.
## 在线文档📕
想要了解 PyQt-Fluent-Widgets 的正确使用姿势?请仔细阅读 [帮助文档](https://qfluentwidgets.com/zh/) 👈
## 许可证📄
PySide6-Fluent-Widgets 使用双许可证。非商业用途使用 [GPLv3](../LICENSE) 许可证进行授权,商用请购买 [商用许可证](https://qfluentwidgets.com/zh/price) 以获得商用授权。
组件库受软件著作权保护软著登字第12532763号任何盗用、破解组件库或未经授权的商业使用均被视为侵权行为。
Copyright © 2021 by zhiyiYo.
## Fluent Client🚩
[Fluent Client](https://qfluentwidgets.com/zh/pages/designer) 集成了设计师插件和脚手架功能,支持在 Designer 中直接拖拽使用 QFluentWidgets 的组件,所见即所得,让现代化界面搭建如丝般顺滑!可在 [淘宝](https://item.taobao.com/item.htm?ft=t&id=767961666600) 购买使用 Fluent Client。
![Fluent Designer](https://img.fastmirror.net/s/2024/02/18/65d22363d4a73.jpg)
## 另见👀
下面是一些基于 PyQt-Fluent-Widgets 的项目:
* [**zhiyiYo/Fluent-M3U8**: 美观易用的跨平台 m3u8 下载器](https://fluent-m3u8.org)
* [**zhiyiYo/Groove**: 基于 PyQt5 的跨平台音乐播放器](https://github.com/zhiyiYo/Groove)
* [**zhiyiYo/Alpha-Gobang-Zero**: 基于强化学习的五子棋机器人](https://github.com/zhiyiYo/Alpha-Gobang-Zero)
## 参考
* [**Windows design**: Design guidelines and toolkits for creating native app experiences](https://learn.microsoft.com/zh-cn/windows/apps/design/)
* [**Microsoft/WinUI-Gallery**: An app demonstrates the controls available in WinUI and the Fluent Design System](https://github.com/microsoft/WinUI-Gallery)