# slogan-wallpaper

**Repository Path**: ping1991/slogan-wallpaper

## Basic Information

- **Project Name**: slogan-wallpaper
- **Description**: 星幕壁纸-bing接口免费壁纸
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Slogan Wallpaper

智能桌面美化整理工具 — 集壁纸管理与桌面整理于一体的 Windows 桌面应用。

## 特性

- **壁纸管理**：静态壁纸、定时/手动切换、在线 API 壁纸源（必应/Wallhaven/Pexels/Vanderwaals）
- **风格多选**：16 种风格标签多选，按偏好自动轮播
- **在线壁纸源管理**：可启用/禁用多个在线壁纸 API 源，支持自定义 API Key
- **桌面整理**：右侧浮动侧边栏，文件按类型分类（文件夹/普通/办公），支持实时文件监听
- **信息面板**：天气、时钟、待办事项
- **多窗口架构**：壁纸管理窗口 + 桌面整理侧边栏独立窗口
- **系统托盘**：最小化到系统托盘，托盘菜单快捷操作
- **轻量高效**：基于 Tauri 2.x，安装包约 5MB，内存占用约 50MB

## 技术栈

| 层 | 技术 |
|---|---|
| 框架 | Tauri 2.x |
| 前端 | React 18 + TypeScript + Vite |
| 样式 | Tailwind CSS |
| 状态管理 | Zustand |
| 后端 | Rust |
| 数据库 | SQLite (rusqlite) |
| 文件监听 | notify crate |
| HTTP 请求 | reqwest crate |

## 环境要求

- Node.js 20+
- Rust 1.77+
- **Visual Studio 2022 Build Tools**（含 MSVC v143 生成工具 + Windows 10/11 SDK）
- pnpm（推荐）或 npm

## 快速开始

```bash
# 1. 安装前端依赖
pnpm install

# 2. 启动开发模式（仅前端）
pnpm dev

# 3. 启动 Tauri 桌面应用（含 Rust 后端）
pnpm tauri dev

# 4. 生产构建
pnpm tauri build
```

## 项目结构

```
src/                          # React 前端
├── components/
│   ├── sidebar/              # 侧边栏组件（天气/时钟/待办/文件列表）
│   └── wallpaper/            # 壁纸组件（风格选择/在线源管理/预览）
├── stores/                   # Zustand 状态管理
├── hooks/                    # 自定义 Hooks
├── types/                    # TypeScript 类型定义
└── styles/                   # 全局样式

src-tauri/                    # Rust 后端
├── src/
│   ├── wallpaper/            # 壁纸引擎（静态/动态/调度/在线 API）
│   ├── file_index/           # 桌面文件索引（扫描/监听/分类）
│   ├── weather/              # 天气数据拉取
│   └── db/                   # SQLite 数据库（迁移/模型）
├── Cargo.toml
└── tauri.conf.json
```

## 壁纸 API 源

| 源 | API Key | 频率限制 |
|---|---|---|
| Peapix（必应每日） | 无需 | 无限制 |
| Bing Wallpaper | 无需 | 无限制 |
| Wallhaven | 可选 | 45次/分 |
| Pexels | 免费注册 | 200次/时 |
| Vanderwaals | 无需 | 无限制 |

## 壁纸风格

支持 16 种风格标签多选：自然、城市、山川、海洋、动漫、游戏、科幻、极简、动物、花卉、建筑、星空、抽象、美食、复古、暗黑。

## 许可

MIT