跳转到主要内容

主页小组件

主页是一个可自由编辑的小组件桌面,类似手机桌面的小组件:水印、账户、公告、实例启动栏都是一个个”组件”,你可以随意移动、调整大小、隐藏它们,装了提供小组件的插件后还能把插件组件也摆上来。

认识主页

默认布局长这样:

编辑布局

点击主页**右上角的「编辑布局」**按钮(铅笔图标),进入编辑模式: 组件不会被强制对齐堆叠——拖走一个组件后,其他组件保持原位不动,留出的空位你可以随意利用,就像关闭了”自动排列图标”的电脑桌面。 编辑模式下组件只负责被拖动/缩放,里面的按钮不会响应点击。完成后记得点「完成」保存。

组件会自己适应大小

每个组件都会根据占据的格子数智能显示内容:
  • 小尺寸(如 1×1):只显示最关键的信息。比如账户组件缩小后只显示头像和名字,公告缩小后只显示标题。
  • 大尺寸:显示更详细的内容。比如公告放大后会显示正文摘要,实例栏放大后会显示上次游玩时间等。
把组件拉大缩小试试看,内容会自动切换。

布局保存在哪

你的布局调整会自动保存在本机(浏览器本地存储),不用手动保存,重启启动器后依然生效。
  • 「恢复默认布局」会把所有组件放回出厂位置,你隐藏过的组件也会全部恢复显示。
  • 升级启动器不会丢失你的布局。

插件组件

安装了提供小组件的插件后(见插件文档的主页小组件章节),插件组件也会出现在主页网格中:
  • 与内置组件一样可以拖动、缩放、隐藏;
  • 插件停用或卸载后组件自动消失,重新启用后原位恢复;
  • 组件内容完全由插件决定,例如天气、服务器状态、倒计时等。
组件被隐藏后不会显示在网格里。进入编辑模式,点工具条上的 + 或 👁 把它找回来。

自定义组件

除了内置组件和插件组件,你还可以直接用 XML 写自己的组件(QWidget),例如新闻卡片、快捷搜索、音乐播放器、服务器状态:
  • 单个 .qwidget 文件,可本地导入或从 URL 导入;
  • 内置编辑器支持行号、语法高亮、补全、实时校验和 TypeScript 函数;
  • 支持数据源、资源、触发器、嵌套组件、媒体和插件 API。
详见 主页自定义组件。