PRISMQML · 棱镜映界

一套 QML 控件，多种设计语言一键切换¶

基于 PySide6 + QML 的多皮肤 UI 引擎：同一套控件可在 Fluent、新粗野、复古票据与新拟态之间实时切换，并独立选择明暗主题。 setSkin() 一行换肤，120fps+ 流畅动画。

快速开始皮肤系统控件总览

多皮肤引擎¶

setSkin() 一键切换 Fluent / 新粗野 / 复古票据 / 新拟态，四套皮肤均支持明暗模式。

token 驱动架构¶

颜色、几何、阴影全部走 token。新增一套皮肤几乎不动控件代码，皮肤与控件解耦。

纯 QML 渲染¶

无帧率上限，120fps+ 流畅动画，Python 侧专注业务逻辑。

180+ QML 类型¶

按钮 / 输入 / 卡片 / 对话框 / 表格 / 图表 / 导航等常见场景全覆盖。

四套皮肤¶

Fluent¶

圆角控件、模糊阴影、蓝色主题色，可选 Mica 云母效果。

新粗野¶

粗边框、零模糊硬阴影、橙色主色，按下时压平硬阴影。

复古票据¶

暖纸背景、旧油墨前景与印章语义色，直角表面细线分隔。

新拟态¶

同色表面、双向软阴影、凹凸交互。

PrismQML 四套皮肤组件实景对比

安装¶

pip install prismqml

分发名与导入名一致：pip install prismqml 后 from prismqml import ...。要求 Python 3.9+ 与 PySide6 6.9+（Qt 6.9+）。Windows 宿主在创建首个 QQuickWindow 前固定使用 D3D11；其他平台保留 Qt 的平台默认后端。

from prismqml import App, WindowType, setSkin, Skin

setSkin(Skin.NEOBRUTALISM)   # 一行切换整个应用的设计语言

app = App()
window = app.create_window(WindowType.BAR)
window.setWindowTitle("我的应用")
window.resize(1200, 800)
window.show()
app.exec()

下一步¶

快速开始 — 几行代码跑起第一个窗口
安装 — pip 安装与开发模式
皮肤系统 — PrismQML 的招牌能力
控件总览 — 全部可用控件
组件速查表 — 全部类型的按分类快速索引
自动更新接入 — 检查、下载进度、安装交接与真实升级验收

PrismQML 由 FluentQML 升级而来（多皮肤引擎定位），MIT 许可证。