Window Float Ball - Noctalia 窗口管理悬浮球

一个为Noctalia桌面环境设计的窗口管理悬浮球插件。

功能特性

• ✨ 始终置顶 - 始终显示在所有窗口之上
• 🖱️ 自由拖动 - 鼠标可随意拖动定位
• 🎯 边缘隐藏 - 拖动到屏幕边缘自动吸附隐藏
• 🔄 智能箭头 - 根据隐藏位置自动调整箭头方向
• 🎨 半透明设计 - 黑色半透明背景，不遮挡视线
• ⚡ 快捷操作 - 一键关闭/最大化当前窗口

使用方法

基本操作

1. 拖动 - 按住悬浮球任意位置可自由拖动
2. 边缘隐藏 - 拖动到屏幕边缘（50px范围内）会自动吸附隐藏
3. 展开 - 鼠标悬停在隐藏的箭头上会自动展开
4. 关闭窗口 - 点击红色 × 按钮关闭当前激活窗口
5. 最大化窗口 - 点击蓝色 □ 按钮切换窗口最大化状态

边缘隐藏说明

隐藏位置	箭头方向	说明
左边缘	→	悬浮球隐藏在屏幕左侧，箭头指向右
右边缘	←	悬浮球隐藏在屏幕右侧，箭头指向左
上边缘	↓	悬浮球隐藏在屏幕顶部，箭头指向下
下边缘	↑	悬浮球隐藏在屏幕底部，箭头指向上

安装方法

1. 将插件目录复制到Noctalia插件目录：

   cp -r window-float-ball ~/.config/noctalia/plugins/

2. 在Noctalia中启用插件：

   • 打开设置 → 插件
   • 找到 "Window Float Ball" 并启用
   • 在桌面widget设置中添加此widget到桌面

3. 如需重新扫描插件：

   • 重启Noctalia，或
   • 在插件设置中点击"扫描插件"

配置选项

插件支持以下配置（可在插件设置中修改）：

配置项	类型	默认值	说明
hideAtEdge	boolean	true	是否启用边缘隐藏功能
edgeThreshold	number	50	边缘检测阈值（像素）
bgOpacity	number	0.8	背景透明度（0-1）
buttonSize	number	28	按钮尺寸（像素）

系统要求

• Noctalia >= 3.6.0
• Hyprland Wayland 合成器（用于窗口控制命令）

技术实现

• 使用QML/QtQuick构建界面
• 通过hyprctl命令实现窗口控制
• 使用Qt动画系统实现平滑的展开/收起效果
• 支持四周边缘吸附隐藏

许可证

MIT License