🐉 Leviathan UI v1.0.0 — Python 中的现代图形界面

Source: Dev.to

请提供您希望翻译的完整文本内容，我将为您翻译成简体中文并保留原有的格式、代码块和链接。

📦 什么是 Leviathan UI?

Leviathan UI 是一个轻量级的 Python 图形界面创建包，适用于：

• 教育、技术或实验性应用。
• 需要快速 GUI 而不依赖重量级框架的项目。
• 具有透明、模糊和 UWP 风格等视觉效果的界面。

👉 简而言之：它让你用极少的代码为 Python 程序 添加外观和样式。

⚙️ 安装

要安装 Leviathan UI，你需要已配置好 Python 和 pip。

在终端中输入：

pip install leviathan-ui==1.0.0

这将下载发布在 PyPI 上的稳定版本。

🚀 入门

基本使用非常简单：

import sys
from PyQt5.QtWidgets import (
    QApplication,
    QPushButton,
    QVBoxLayout,
    QWidget,
    QLabel,
)
from PyQt5.QtCore import Qt
from lib.shared import (
    InmersiveSplash,
    InmojiTrx,
    WipeWindow,
    CustomTitleBar,
)


class MiAppPrincipal(QWidget):
    def __init__(self):
        super().__init__()
        self.setObjectName("MainWindow")
        self.resize(900, 550)

        # 1️⃣ WipeWindow – modo “polished” (vidrio redondeado con sombra)
        (
            WipeWindow.create()
            .set_mode("polished")
            .set_background("auto")   # “auto”: sincroniza con la paleta de Windows
            .set_radius(10)           # radio recomendado para una ventana cuadrada
            .apply(self)               # iniciar modo
        )

        layout = QVBoxLayout(self)
        layout.setContentsMargins(0, 0, 0, 0)
        layout.setSpacing(0)

        # 2️⃣ CustomTitleBar – estilo Windows 11 (botones SVG + integración de acento)
        self.title_bar = CustomTitleBar(self, title="LEVIATHAN ENGINE V2.0")
        layout.addWidget(self.title_bar)

        # Área de contenido
        content = QWidget()
        content_lay = QVBoxLayout(content)
        content_lay.setAlignment(Qt.AlignCenter)

        label = QLabel("Test de Leviathan‑UI: Polished Mode")
        label.setStyleSheet(
            "color: white; font-size: 24px; font-weight: bold; font-family: 'Segoe UI';"
        )
        content_lay.addWidget(label, alignment=Qt.AlignCenter)

        self.btn = QPushButton("Cerrar app")
        self.btn.setFixedSize(280, 50)
        self.btn.setStyleSheet(
            """
            QPushButton {
                background-color: rgba(255,255,255,0.08);
                color: white;
                border: 1px solid rgba(255,255,255,0.3);
                border-radius: 12px;
                font-weight: bold;
                font-size: 14px;
            }
            QPushButton:hover {
                background-color: white;
                color: black;
            }
            """
        )
        content_lay.addWidget(self.btn, alignment=Qt.AlignCenter)
        layout.addWidget(content, 1)

        self.btn.clicked.connect(self.close)


if __name__ == "__main__":
    app = QApplication(sys.argv)

    # 3️⃣ InmojiTrx – icono premium (emoji o logo BETA)
    InmojiTrx("🐉").apply(app)

    # 4️⃣ Splash de entrada (modo adaptive: no tapa la barra de tareas)
    mi_app = MiAppPrincipal()
    splash = (
        InmersiveSplash(title="Iniciando...", logo="🐉", color="auto")
        .set_mode("adaptive")               # se adapta al DPI
        .set_phrases(["Iniciando UWP"])
        .on_finish(mi_app.show)            # se ejecuta al terminar el splash
        .attach_to_window(
            mi_app,
            exit_phrases=["Saliendo de la UWP"],  # mensaje al cerrar
        )
    )

    # ¡Despegue!
    splash.start()
    sys.exit(app.exec_())

模式参数

👉 如果不传入任何参数，应用将以基础模式打开。

🔌 启动画面 — 应用的启动与关闭

此启动画面在打开或关闭使用 Leviathan UI 构建的应用时出现。动画龙和暗色背景营造出技术感与神秘感。

在应用启动和关闭时，你可以放置任意想要的文字。

✨ Polished Mode — 经典 UWP 风格

此模式提供干净现代的界面，具有纯色背景和清晰定义的按钮。非常适合追求清晰结构的桌面类应用。

• Windows UWP 风格。
• 按钮可见，无复杂视觉效果。
• 适用于专业或教育环境。

👻 Ghosted Mode — 优雅的透明感

在此模式下，Leviathan UI 在自然背景上应用一层透明玻璃。非常适合追求极简美学和与环境连接的应用。

• 界面后方可见背景。
• 按钮悬浮在风景或自定义背景上。
• 适用于仪表盘或创意类应用。

💧 Ghosted Blur Mode — 玻璃液体模糊

这是视觉上最先进的模式。它将透明度与动态模糊相结合，模拟现代 UWP 风格的液态玻璃界面。

• 带有深度效果的模糊背景。
• 适用于想要在视觉上脱颖而出的应用。
• 灵感来源于 Fluent Design 风格的界面。

🌐 官方链接

• PyPI: leviathan-ui v1.0.0 – Leviathan UI 官方仓库
• GitHub: JesusQuijada34
• Website: Flarm Store
• Telegram: Jesus Quijada | Influent Projects
• Patreon: JesusQuijada34

🎯 结论

Leviathan UI 对 想在 Python 中尝试图形界面的初学者 来说是完美的，不会太复杂。只需几行代码，你就可以拥有一个功能齐全且美观的窗口。

推荐： 从 polished 开始熟悉，然后尝试透明和模糊模式，为你的应用增添风格。

如果你喜欢这个项目，请考虑在 GitHub 或 Patreon 上支持它。感谢阅读！