Floating Panel 开发 / Development

Floating Panel 是工作区的第六种面板表面，适合设置、商店、成就、反馈和插件的独立工具页。它不参与 Dockview 布局，也不占用主区标签：

桌面 Floating、Mini 与从 Dockview 拖出的独立窗口都是已运行应用的卫星窗口，必须直接显示目标内容，不得重播只属于 Forsion 主窗口首次启动的品牌 Splash。

• macOS / Windows：宿主创建主窗口的原生子窗口，可拖动、缩放、最小化和关闭；相同 id 再次打开会聚焦并更新现有窗口。

• Web：宿主在当前页面上方显示固定居中的面板，不支持拖动；主工作台仍留在后方。

• 移动端：不模拟桌面窗口，继续使用全屏二级页面。

插件先用 ctx.registerView() 注册普通 DOM 视图，再用相对 view id 打开 Floating Panel。宿主负责添加 plugin:<pluginId>: 命名空间，插件不能打开或覆盖其他插件的视图。

ctx.registerView({
  id: 'inspector',
  title: 'Inspector',
  mount(el, view) {
    el.textContent = `Surface: ${view?.surface}`
  },
})

ctx.registerCommand({
  id: 'open-inspector',
  title: 'Open Inspector',
  run() {
    ctx.openFloatingPanel?.('inspector', {
      title: 'Inspector',
      params: { source: 'command' },
      width: 880,
      height: 640,
    })
  },
})

openFloatingPanel 选项：

mount(el, view) 在该表面收到 view.surface === 'floating'。getParams、setParams、onParamsChanged 与主面板一致；showInMainPanel() 把当前参数交回主工作区。Floating 不提供 extendView。窗口关闭或插件停用时，宿主调用 mount 返回的清理函数；已打开的插件视图被反注册后，对应窗口/网页浮层自动关闭。

插件应 feature-detect ctx.openFloatingPanel?.(...) 以兼容旧宿主。当前桌面和 Web 都支持 Floating；移动端没有桌面悬浮语义，插件应继续提供正常主视图作为回退。