用途：在 PySide6 架构中以声明式 .qml 文件定义全部界面，QML 视图绑定 Python bridge 属性、调用 bridge 槽，自身不承载业务逻辑。
主要能力：给出推荐的 resources 目录结构（qml/main.qml、components、pages、dialogs、styles，icons 与可选 qml.qrc），并展示根窗口 ApplicationWindow 加 StackLayout 分页、全局 ToolBar、错误横幅 ErrorBanner、加载遮罩 LoadingOverlay 的写法。页面以 Page 为单位、通过 ListView 与 delegate 绑定模型，含空状态提示。可复用组件示例包括带 loading 状态与自定义属性的 ActionButton、带防抖 Timer 与自定义信号 searchTriggered 的 SearchBar、Dialog 模式的 CreateJobDialog（含校验与打开时重置）。样式上用 pragma Singleton 的 Theme.qml 集中定义颜色、间距、字号与圆角，并通过 qmldir 注册模块后在 QML 中引用。还提供 LoadingOverlay、StatusBadge 等状态指示组件，以及图标从文件系统或 qrc 加载的写法。
最佳实践：组件控制在 150 行内、每文件一个根项、仅在需要引用时使用 id、优先属性绑定而非命令式 JS、用 Loader 懒加载、禁止在 QML JS 中嵌入 SQL/HTTP/文件 I/O、限定属性访问、用 anchors 或布局而非手写 x/y。
适用场景：用 Qt Quick Controls 与 Layouts 为 Python 后端构建桌面 GUI。
限制：为文档与代码示例，不含安装步骤、依赖版本要求、收费或性能数据，这些暂未提供。