桌面模式
桌面模式把面板从"一页一页的网页"变成一个多窗口桌面:可以同时打开实例控制台、文件管理器、终端等多个窗口,自由摆放。它由 desktop 插件提供;关闭该插件,界面就回到普通模式。
打开桌面模式
登录后在顶栏/导航中切换到桌面入口即可。桌面上的"应用"来自各个已安装插件,例如:
| 应用 | 提供者 |
|---|---|
实例管理、实例控制台、实例配置、计划任务窗口 |
|
终端选择器 |
|
文件管理相关窗口 |
|
节点、市场、备份、用户等 |
各自的插件 |
应用属于拥有它的插件:卸载提供者插件,它的应用、窗口视图和已经打开的窗口会一起消失,桌面本身不受影响。
窗口与布局
-
窗口可以打开、关闭、移动、调整大小、最小化与聚焦;
-
窗口的布局与状态按用户 UUID 保存,生产目录为
web/data/desktop_layouts/<用户UUID>.json,源码仓库为panel/data/…; -
换设备或重开页面后,面板会按保存的布局恢复窗口;
-
恢复时,找不到或参数已失效的窗口会被跳过,不会导致桌面加载失败。
同一个应用可以被打开多次(例如同时看两个实例的控制台),桌面会按参数区分它们。
与普通模式的关系
两种模式共用同一套后端与插件。桌面模式只是 console(Web UI 外壳)之上由 desktop 插件提供的一层窗口化外壳:
-
插件若要提供桌面应用,通过
console暴露的桌面注册接口登记(ctx.desktop.app(…)/ctx.desktop.view(…)); -
插件注册的应用在未安装
desktop插件时是惰性的——没有桌面外壳来打开它,但注册本身不会报错。
开发者接口详见 插件结构 的前端上下文一节。
常见问题
- 切到桌面后看不到某个应用。
-
该应用对应的插件被停用了;到插件页面重新启用。
- 布局没有保存/恢复。
-
确认当前登录用户未变;布局按用户存储,匿名或切换账号会看到各自的布局。清理
desktop_layouts/下的文件可重置为默认布局。