Skip to content

SnowmanNunu/utools-snow

Repository files navigation

❄️ 满屏飘落 — 桌面粒子特效

一款唯美治愈的桌面粒子飘落插件,让你的屏幕随时上演大雪纷飞、樱花飘落、星光闪烁的浪漫场景。

logo

✨ 功能特性

  • 15 种精美粒子图案

    • ❄️ 雪花 — 经典六角冰晶与圆点簇
    • ⭐ 星星 — 温暖闪烁的五角星
    • 💗 爱心 — 浪漫粉色爱心
    • 🌸 花瓣 — 轻盈飘落的花瓣
    • 🫧 泡泡 — 透明光泽气泡
    • 🍁 枫叶 — 秋日感枫叶
    • 🎵 音符 — 金色八分音符,听歌氛围
    • 🧧 红包 — 红色长方形红包,中间金色「福」字
    • 🦋 蝴蝶 — 粉紫淡蓝彩色蝴蝶,轻盈飞舞
    • 📝 福字 — 随机显示 福/吉/喜/财/乐/安 吉祥字
    • 💧 雨滴 — 逼真雨滴下落,触地溅起水花与涟漪,偶现闪电
    • 🪙 金元宝 — 中国传统元宝造型,富贵喜庆
    • ✨ 萤火虫 — 黄绿色发光小虫,带尾迹缓缓飘飞
    • 🏮 灯笼 — 中国传统红灯笼,喜庆节日氛围
    • 🌼 蒲公英 — 白色绒球,放射状绒毛轻盈飘飞
  • 实时参数调节

    • 密度:从稀稀落落到大雪纷飞(30 ~ 380 片)
    • 风力:无风微风到强风(0 ~ 3 级)
    • 强度预设:小雪 / 中雪 / 大雪一键切换
  • 趣味交互(uTools 版支持)

    • 🖱️ 鼠标推开 — 粒子会感应鼠标位置并温柔避让
    • 点击绽放 — 在屏幕上点击会爆开一团粒子
  • 视觉体验

    • 三层景深粒子,近大远小,营造立体空间感
    • 发光辉光与闪烁动画
    • 支持系统深色/浅色模式自动适配

🖼️ 两种使用方式

方式 特点 适用场景
uTools 插件版 呼出即用,支持鼠标交互 已安装 uTools 的用户
独立桌面版 双击运行,无需任何依赖 未安装 uTools 的用户

🚀 一、uTools 插件版

前置要求

本地构建

# 1. 克隆仓库
git clone <仓库地址>
cd utools-snow-src

# 2. 安装依赖
npm install

# 3. 构建插件
npm run build

构建完成后,会在项目根目录生成 dist/ 文件夹,包含完整的插件文件。

开发模式(热更新)

npm run dev

webpack 会监视文件变化并自动重新构建,方便开发调试。

uTools 中加载

  1. 打开 uTools,输入「插件管理」或进入「开发者工具」
  2. 选择「新建项目」→「本地导入」
  3. 选择构建后的 dist/ 目录
  4. 项目会出现在「我的插件」中,点击即可运行

提示:uTools 插件开发详情可参考 官方文档


💻 二、独立桌面版(无需 uTools)

双击即可运行,不依赖任何外部环境。

快速开始

# 1. 先构建插件源码
cd utools-snow-src
npm install
npm run build

# 2. 安装 Electron 并启动独立版
cd standalone
npm install
npm start

如果 Electron 下载慢,可先设置镜像: npm config set electron_mirror https://npmmirror.com/mirrors/electron/

打包成可执行文件

cd standalone
npm run build

打包完成后在 standalone/release/ 目录生成:

  • Windows: snow-desktop-1.0.1-x64.exe(便携版,双击运行)
  • macOS: snow-desktop-1.0.1-arm64.dmg
  • Linux: snow-desktop-1.0.1-x64.AppImage

独立版使用说明

  1. 双击运行后弹出控制面板
  2. 点击「开始飘落」在桌面开启全屏粒子特效
  3. 粒子窗口不影响桌面操作(鼠标可穿透到下层软件)
  4. 随时通过以下方式控制:
    • 控制面板的「停止飘落」按钮
    • 任务栏右下角 ❄️ 托盘图标 → 右键菜单
    • 快捷键 Ctrl + Shift + S 显示/隐藏控制面板

注意:独立版为不影响桌面操作,暂不支持鼠标交互(鼠标推开 / 点击绽放)。


📁 项目结构

utools-snow-src/
├── public/                 # 静态资源
│   ├── index.html          # 设置面板入口
│   ├── snow.html           # 飘落窗口页面
│   ├── snow.js             # Canvas 粒子核心动画
│   ├── snow_preload.js     # 飘落窗口 preload
│   ├── plugin.json         # uTools 插件配置
│   └── logo.*              # 插件图标
├── src/                    # React 设置面板源码
│   ├── App.js              # 主界面
│   ├── index.js            # React 入口
│   └── index.less          # 样式
├── bridge/
│   └── preload.js          # uTools 版 preload
├── standalone/             # 独立桌面版
│   ├── main.js             # Electron 主进程
│   ├── preload.js          # 模拟 uTools API
│   ├── package.json        # 独立版打包配置
│   └── README.md           # 独立版说明
├── webpack.config.js       # 构建配置
└── package.json

🛠️ 技术栈

  • 设置面板:React 19 + MUI 7 + Emotion
  • 粒子渲染:原生 Canvas 2D API,无需任何图形库
  • 构建工具:Webpack 5 + Babel 7
  • 独立版框架:Electron 31

📝 配置说明

public/plugin.json 是 uTools 的插件配置文件:

{
  "main": "index.html",
  "logo": "logo.png",
  "preload": "preload.js",
  "features": [
    {
      "code": "snow",
      "explain": "满屏飘落 - 唯美治愈桌面粒子特效",
      "icon": "logo.svg",
      "cmds": ["满屏飘落", "大雪纷飞", "下雪", "xiaxue", "snow"]
    }
  ]
}

你可以通过修改 cmds 来添加自己喜欢的呼出关键词。

📦 版本历史

v1.2.0(2026-06-12)

  • 🎨 重新设计控制面板 UI,卡片式布局更现代简洁
  • ❄️ 新增积雪效果:雪花落底堆积,鼠标划过扫开/加速融化
  • 🌀 新增鼠标漩涡:按住左键吸引粒子形成漩涡
  • 🎚️ 精简交互开关,保留最核心的 4 个:鼠标推开、点击绽放、积雪融化、鼠标漩涡
  • 🎉 节日主题包:春节、圣诞、情人节一键切换

v1.1.0(2026-06-12)

  • ✨ 新增 5 种粒子图案:雨滴、金元宝、萤火虫、灯笼、蒲公英
  • 🌧️ 雨滴重绘为细长水滴,新增落地水花与涟漪效果
  • 🪙 金元宝采用中国传统元宝造型
  • 🎨 移除「混合」图案,界面更简洁
  • 🖥️ 独立桌面版托盘菜单支持直接切换粒子图案

v1.0.1(2026-06-12)

  • ✨ 新增 4 种粒子图案:音符、红包、蝴蝶、福字
  • 🎨 重新设计插件 Logo,采用极光渐变雪花风格
  • 🔧 修复独立桌面版应用图标尺寸问题
  • 📝 更新 README 文档与 Release 说明

v1.0.0(2026-06-05)

  • ✨ 首发上线,支持 7 种精美粒子飘落图案
  • 🎚️ 实时调节粒子密度与风力,三档强度预设一键切换
  • 🖱️ uTools 版支持鼠标交互(推开 / 点击绽放)
  • 💻 新增独立桌面版,无需 uTools 即可双击运行
  • 🌙 自动适配系统深色 / 浅色模式
  • ⚡ 基于原生 Canvas 2D 渲染,流畅低耗,全平台兼容

🤝 参与贡献

欢迎提交 Issue 和 PR!如果你有任何新点子(比如新增粒子图案、更多交互效果),随时来聊。

📄 License

MIT


愿你的桌面四季有景,心中有光 ❄️

About

是一款为桌面增添浪漫氛围的 uTools 粒子特效插件。无需复杂设置,呼出即享 —— 让雪花、樱花、星光在屏幕上轻盈飞舞,为你的工作与学习时光带来一丝治愈与惬意

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors