FancyAnima For Linux

这是什么

ClassIsland 自带的提醒特效在低端电脑上容易卡顿掉帧。

FancyAnima 用 CPU 渲染的原生窗口特效 实现同样的涟漪特效，让提醒动画在低端设备上也能流畅运行。

插件在暑假制作，低端机测试不是很广泛，目前测试 I7 - 9750H 和 AMD Ryzen 7 8745HS 在 60 FPS 精细模式下可以流畅渲染

实现流程：关闭 CI 内置特效 → 提醒触发 → 单独创建一个由 CPU 绘制的提醒特效窗口

插件代码部分由 Deepseek - V4 - flash 完成

跨平台支持（v2.0.0.0）

• 支持 Windows 10 / Windows 11 与 Linux（Debian 10+ / 统信 UOS 20/21，X11 环境）
• Linux 下特效渲染使用纯 X11 原生方案（内存像素 + XPutImage，无任何图形库，与 Windows GDI 原理对等），Windows 沿用原有 GDI 渲染（零回归）
• 同一安装包（.cipx）同时包含 Windows 与 Linux 的原生依赖，按平台自动加载
• 特效效果、设置项、性能策略与 Windows 版完全一致

⚠️ Linux 注意事项：

• 需要 X11 环境（WSLg / 常规 X11 桌面均可），不支持 Wayland
• 窗口透明依赖合成器（WSLg、GNOME/KDE 等默认开启）；无合成器时插件自动跳过特效，不会黑屏
• 鼠标穿透基于 XFixes 扩展（libxfixes3），绝大多数发行版自带
• 统信 UOS 需开启开发者模式后安装插件
• 不依赖 DBus：缺失时插件功能不受影响（ClassIsland 自身的托盘/通知能力由官方处理）

使用方法

1. 安装插件后，首次打开 FancyAnima 设置页会弹出引导弹窗

2. 点击 「自动关闭并启用」 —— 插件会自动关闭 ClassIsland 官方全屏提醒特效并启用 FancyAnima，无需手动操作

3. 之后提醒触发时，特效自动由 FancyAnima 接管

如果自动关闭失败（设置文件异常），弹窗会提示手动关闭：设置 → 提醒 → 高级设置 → 关闭「启用提醒强调特效」。

自动检测失效时，也可以手动打开「手动覆盖：官方特效已关闭」强制接管。

设置项说明

渲染后端

特效渲染抽象为 IRippleOverlay 接口，双后端按平台自动选择：

调试/自测：设置环境变量 FANCYANIMA_RENDERER=x11 / =skia / =gdi 可强制指定后端 （例如在 Windows 上验证 X11 后端逻辑、或对照 Skia 后端差异）。插件启动日志会打印实际使用的后端。

仓库内附带独立预览器（FancyAnima.Preview/），无需 ClassIsland 即可驱动 两个后端验证特效：

dotnet run --project FancyAnima.Preview            # 交互模式：Space 播放，B 切换后端
dotnet run --project FancyAnima.Preview -- --auto 3   # 自动连播 3 次后退出

兼容性

• 支持 Windows 10 / Windows 11、Debian 10+ / 统信 UOS（X11）
• 支持 Classisland 2.1 与 2.0
• 与 ClassIsland 所有渲染模式（AngleEgl / Wgl / Vulkan / Software）兼容

作者

• Tiny-Nick

• B站：Tiny_11_25H2

Tiny_11_25H2的个人空间-哔哩哔哩视频

更新日志

2.0.0.0

• 新增 Linux（Debian 10+ / 统信 UOS，X11）支持，渲染引擎迁移至 SkiaSharp
• 渲染后端抽象为接口（IRippleOverlay），Windows 沿用 GDI 后端零回归
• 窗口管理迁移至 Avalonia 原生窗口（透明 / 置顶 / 鼠标穿透跨平台生效）
• 同一 .cipx 包同时支持 Windows 与 Linux

1.0.1.0

• 进入插件设置后，现在可以自动关闭官方特效

• 现在可以自选特效颜色

1.0.0.0

• 首个正式版本