# utools-snow

**Repository Path**: SnowmanNunu/utools-snow

## Basic Information

- **Project Name**: utools-snow
- **Description**: 一款唯美治愈的 uTools 桌面粒子飘落插件，让你的屏幕随时上演大雪纷飞、樱花飘落、星光闪烁的浪漫场景。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

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

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

![logo](public/logo.svg)

## ✨ 功能特性

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

- **实时参数调节**
  - 密度：从稀稀落落到大雪纷飞（30 ~ 380 片）
  - 风力：无风微风到强风（0 ~ 3 级）
  - 强度预设：小雪 / 中雪 / 大雪一键切换

- **趣味交互**（uTools 版支持）
  - 🖱️ **鼠标推开** — 粒子会感应鼠标位置并温柔避让
  - ✨ **点击绽放** — 在屏幕上点击会爆开一团粒子

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

## 🖼️ 两种使用方式

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

---

## 🚀 一、uTools 插件版

### 前置要求

- [uTools](https://www.u.tools/) 已安装（Windows / macOS / Linux）
- [Node.js](https://nodejs.org/) ≥ 18

### 本地构建

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

# 2. 安装依赖
npm install

# 3. 构建插件
npm run build
```

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

### 开发模式（热更新）

```bash
npm run dev
```

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

### uTools 中加载

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

> 提示：uTools 插件开发详情可参考 [官方文档](https://u.tools/docs/)。

---

## 💻 二、独立桌面版（无需 uTools）

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

### 快速开始

```bash
# 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/`

### 打包成可执行文件

```bash
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 的插件配置文件：

```json
{
  "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](LICENSE)

---

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