关于

PrismQML 是什么

PrismQML 是基于 PySide6 + QML 的多皮肤 UI 引擎，由 FluentQML 升级而来—— 从单一 Fluent Design 组件库，演进为支持 Fluent、新粗野、复古票据与新拟态的 多设计语言引擎。

核心特性

• 多皮肤引擎：setSkin() 一键切换 Fluent、新粗野、复古票据与新拟态，四套皮肤均支持明暗主题
• token 驱动：颜色、几何、阴影全部走主题 token，皮肤与控件解耦，新增皮肤几乎不动控件代码
• 纯 QML 渲染：控件渲染全部在 QML 侧完成，无帧率上限，动画流畅
• PySide6 原生：直接用 Python 创建窗口、注册类型、编写业务逻辑，无需为业务界面写 C++
• 180+ QML 类型：按钮、输入、卡片、对话框、表格、图表、导航等常见场景全覆盖
• 完整桌面能力：配置持久化、响应式状态、系统托盘、云母效果、自动更新开箱即用
• 跨平台：Windows、macOS、Linux

四种设计语言

PrismQML 内置四套完整的设计语言，同一套控件代码无需修改即可整体换肤，均支持明暗主题：

• Fluent：圆角控件、柔和阴影、蓝色主色
• 新粗野：粗边框、硬阴影、橙色主色
• 复古票据：暖纸背景、旧油墨前景、细线分隔与印章语义色
• 新拟态：同色表面、双向软阴影、凹凸交互

各皮肤的 token 结构与定制方法见皮肤系统。

项目信息

• 作者：aki-riko
• 许可证：MIT
• 来源：由 FluentQML 升级而来的多皮肤引擎
• GitHub：github.com/aki-riko/PrismQML
• 文档：aki-riko.github.io/PrismQML

从 FluentQML 迁移

如果你在用旧的 FluentQML（PyPI 包名 fqml，导入名 fluentqml），迁移到 PrismQML：

旧（FluentQML）	新（PrismQML）
pip install fqml	pip install prismqml
import fluentqml	import prismqml
from fluentqml import App	from prismqml import App
QML import FluentQML	QML import PrismQML
~/.fluentqml/	~/.prismqml/

迁移步骤：

1. pip uninstall fqml && pip install prismqml
2. 全局替换 fluentqml → prismqml（Python）、FluentQML → PrismQML（QML）
3. requirements 中 fqml → prismqml

包名、导入名与 QML 模块名是迁移的核心步骤。PrismQML 在 v1.0.0 前不保留 废弃兼容别名；若旧项目使用了 FluentQML 的内部路径或已移除 API，应按当前 Python API 与控件总览迁移。

为什么改名

FluentQML 这个名字锁死在"Fluent"单一设计语言上。加入新粗野（Neobrutalism）皮肤后，库已是多皮肤引擎，名实不符。PyPI / GitHub 不支持仓库改名，故新建 PrismQML（取"棱镜"意——一束光折射成多种面貌，对应一套控件呈现多种设计语言），旧 FluentQML 仓库存档保留，已分发的 fqml 包继续可用。

License

PrismQML 采用 MIT 许可证。内置 Fluent UI System Icons 图标集亦为 MIT。