✨ Floating Particles

🧑‍💻 开发者碎碎念(๑•̀ㅂ•́)و✧

我是wangxinyangヽ(✿ﾟ▽ﾟ)ノ，一个只会依靠AI写代码的编程小白🥺，这个插件全程借助Codex辅助开发✨。
这个小插件也许还不是那么完善，大家也可以自己魔改或者去俺的博客留言板提建议哈～
插件Github开源地址：https://github.com/WXY-333/halo-floating-particles
俺的博客地址：https://wangxinyang.top/ 欢迎互换友链或互访哦～(σ≧︎▽︎≦︎)σ

Floating Particles 是一个 Halo 前台动效插件，可以为博客页面添加粒子漂浮、鼠标交互动效和个性化鼠标样式。插件所有功能都可以在 Halo 后台配置，不需要修改主题代码。🍁

当前版本：1.0.9 🚀

🚀 功能亮点

• ⚙️ 前台动效开关：支持在 Halo 后台一键开启或关闭前台动效。
• 🧩 独立配置：页面粒子效果、鼠标动效、鼠标样式分开配置，互不干扰。
• 📱 移动端优化：支持移动端专属开关，适合按站点性能和阅读体验自行调整。
• 🎯 精准控制：支持按页面启用或禁用粒子效果，可自由填写包含路径或排除路径。
• 🎛️ 高度自定义：支持调整粒子数量、动效颜色、透明度、速度和动效层级（z-index）。
• 🖱️ 个性化光标：支持内置鼠标光标模板，也支持从 Halo 附件库选择自定义鼠标文件。
• 📦 本地化部署：Three.js 已打包到插件本地静态资源，完全不依赖外部 CDN。
• 🧼 绿色无残留：关闭或卸载插件后，不会修改主题模板，也不会在主题中留下任何冗余代码。

❄️ 页面粒子效果

插件内置多种页面粒子效果，适合不同类型的博客页面、个人站点和活动页面。🎨

• ❄️ 雪花飘落
• ✨ 星空漂浮
• 🫧 气泡上升
• 🌟 萤火闪烁
• 🌸 樱花飘落
• 🌊 水波涟漪
• 🌠 流星雨
• 🍂 落叶飘落
• 🕸️ 粒子连线
• 🌌 星尘漂浮
• 🎉 彩纸飘落
• 🌧️ 细雨
• 🌾 蒲公英飘散
• 🪶 羽毛飘落
• 🔮 极光流动
• 🔯 星座连线
• 🎵 漂浮音符
• 🔆 光斑漂浮
• 🪰 萤火虫聚散

🖱️ 鼠标动效

鼠标动效用于增强访问者在前台页面中的交互体验，可以选择安静轻量的光环、拖尾，也可以选择更明显的点击礼花、点击爱心等效果。💥

• 🎆 点击礼花
• 🌊 水波涟漪
• ✨ 拖尾光点
• ⭐ 跟随小星星
• 🌟 光标星星跟随
• ❤️ 点击爱心
• ⭕ 鼠标光环
• 💫 WebGL 光标尾巴
• 🫧 点击气泡
• 🌸 点击小花
• 🌈 鼠标彩虹拖尾
• 🧲 鼠标磁吸粒子

🎨 鼠标样式

插件支持开启个性化鼠标样式。开启后，鼠标样式默认全站使用，不受“粒子效果页面生效范围”影响。⭐

内置鼠标模板包括：

• 🐷 粉色小猪
• 🐱 猫咪老师
• 🎤 Miku
• 🎤 Miku BLZ
• 🥜 阿尼亚
• 🎸 孤独摇滚 - 伊地知虹夏
• 🎸 孤独摇滚 - 后藤独
• 🎸 孤独摇滚 - 山田凉
• 🏀 黑子哲也
• 🐾 罗小黑
• 🎤 洛天依
• 💙 蕾姆
• ✨ 流荧

💡 自定义鼠标图片建议上传 CUR 或 GIF 鼠标样式文件。

📖 使用说明

1. 📥 在 Halo 后台进入插件管理页面。
2. 🆙 上传并启用 Floating Particles 插件。
3. ⚙️ 进入插件设置页面。
4. 🟢 打开 开启前台动效 开关。
5. 🌌 在 粒子效果 中选择满意的页面动效。
6. 🖱️ 在 鼠标动效 中选择鼠标交互动效。
7. 🎨 如需更换光标，打开 启用鼠标样式 并选择内置模板或自定义鼠标文件。
8. 🎛️ 按需调整数量、颜色、透明度、速度和动效层级。
9. 💾 保存设置后，刷新前台页面即可查看惊艳效果！

🌐 页面生效范围

粒子效果支持三种页面生效方式：

• 🗺️ 全站启用
• 📌 仅指定路径启用
• 🚫 排除指定路径

路径每行填写一个，例如：

/
/about
/archives

⚠️ 注意：鼠标样式默认全站使用，不受粒子效果页面生效范围影响。

💡 推荐配置
如果希望长期默认开启，建议选择更轻量、不会遮挡阅读内容的组合，以保证最佳的阅读体验：

🌌 页面粒子效果：星尘漂浮、星空漂浮、萤火闪烁、光斑漂浮

🖱️ 鼠标动效：拖尾光点、鼠标光环、跟随小星星

🏁 透明度：0.35 到 0.65

🔢 粒子数量：60 到 100

📝 提示：如果页面文字较多，建议适当降低透明度，避免同时开启彩纸、流星雨、水波等视觉存在感较强的效果，以免分散读者注意力。

🔧 兼容性
🟢 支持 Halo >=2.23.0

🌐 支持现代桌面端和移动端浏览器

⚡ WebGL 光标尾巴 和 水波涟漪 需要浏览器支持 WebGL

🧩 如果主题启用了 PJAX、页面缓存、静态缓存或自定义渲染机制，插件保存配置后可能不会立刻在前台显示最新效果。遇到这种情况时，可以先清理主题缓存、浏览器缓存，或使用 Ctrl + Shift + R 强制刷新页面。

❓ 常见问题
❓ 是否需要修改主题代码？
答：不需要。插件通过 Halo 插件机制向前台自动注入动效脚本，启用后即可直接使用，简单快捷。

❓ 保存设置后前台没有立刻生效怎么办？
答：请先确认插件已启用并保存配置，然后清理主题缓存、浏览器缓存，或使用 Ctrl + Shift + R 强制刷新页面。部分启用 PJAX、页面缓存或自定义渲染机制的特殊主题，可能需要刷新缓存后才会加载最新动效。

❓ 是否依赖外部 CDN？
答：不依赖。插件所需的前端脚本、鼠标资源和 Three.js 文件都已全部打包到插件本地静态资源中，加载更稳定。

❓ 会影响主题菜单、搜索框或弹窗吗？
答：动效层使用了全局 pointer-events: none 属性，正常情况下不会阻挡任何点击事件。如果主题层级比较特殊，可以在后台设置中灵活调整 动效层级 数值。

❓ 关闭或卸载后会有代码残留吗？
答：不会。插件采用非侵入式设计，不会修改主题模板文件。关闭或卸载插件后，前台将不再注入任何动效脚本，干净整洁。

❓ 自定义鼠标应该上传什么格式？
答：强烈建议上传标准鼠标指针格式 .cur 或动态格式 .gif 鼠标样式文件，以获得最佳兼容表现。

📄 许可证
⚖️ GPL-3.0 © Wangxinyang