哲风壁纸 - 项目文档

1. 项目概述

项目名称: 哲风壁纸
项目类型: Windows 桌面壁纸管理应用
技术栈: Python + Tkinter + requests + BeautifulSoup
运行方式: Python 脚本直接运行 (main.py)

2. 功能特性

2.1 壁纸浏览

• 分类浏览：推荐、魅力|迷人、自制|艺术、安逸|自由、科幻|星云、动漫|二次元、自然|风景、游戏|玩具、程序|代码、未定义、手机壁纸
• 瀑布流布局：4列网格展示
• 支持翻页加载

2.2 手机壁纸专区（新增）

• 专门分类展示手机壁纸
• 尺寸适配：420×700 垂直比例，更适合手机壁纸展示
• 下载按钮：蓝色"下载"按钮，一键下载到桌面
• 下载路径：默认保存到桌面（C:\Users\<用户名>\Desktop）
• 无需设置：下载后自动保存，不尝试设置桌面壁纸

2.2 壁纸下载

• 一键下载到本地
• 自动保存到 E:\Sample Pictures\桌面 目录

2.3 壁纸设置

• 支持将任意壁纸设为桌面背景
• 使用 Windows API (SystemParametersInfoW) 设置壁纸

2.4 我的下载

• 查看已下载的壁纸
• 支持删除已下载的壁纸

3. 项目结构

live-wallpaper/
├── main.py           # 主程序入口，包含全部业务逻辑
├── requirements.txt  # Python 依赖
├── build.bat         # 构建脚本
└── README.md         # 项目文档（本文档）

4. 依赖安装

pip install -r requirements.txt

依赖列表：

• requests==2.31.0 - HTTP 请求
• beautifulsoup4==4.12.2 - HTML 解析
• Pillow - 图片处理（Tkinter 内置）
• pyinstaller==5.13.2 - 打包工具（可选）

5. 运行方式

python main.py

6. 核心类说明

WallpaperApp

主应用程序类，负责：

• UI 界面构建
• 壁纸数据获取与展示
• 壁纸下载与设置
• 本地下载管理

关键方法

方法	功能
setup_ui()	构建主界面
load_wallpapers()	加载壁纸列表
refresh_wallpapers()	加载下一页
_fetch_wallpapers()	从网络获取壁纸数据
_display_wallpapers()	展示壁纸卡片
set_wallpaper()	下载并设置壁纸（电脑壁纸）
download_wallpaper()	下载壁纸到本地（手机壁纸）
show_downloads()	显示已下载壁纸

7. 配置说明

配置项	值	说明
API_BASE	https://haowallpaper.com	壁纸数据源
SAVE_DIR	E:\Sample Pictures\桌面	下载保存目录
默认布局	4列	瀑布流网格

8. 注意事项

1. 本程序仅适用于 Windows 平台
2. 需要联网才能获取在线壁纸
3. 下载目录需具有写入权限

9. 版本说明

9.1 哲风壁纸（手机壁纸版）- 当前版本

更新日期: 2026年3月9日

新增功能:

• 📱 手机壁纸专区：专门分类展示手机壁纸
• 🎨 尺寸适配：420×700 垂直比例，更适合手机壁纸展示
• ⬇️ 下载按钮：蓝色"下载"按钮，一键下载到桌面
• 📁 默认路径：手机壁纸默认保存到桌面（C:\Users\<用户名>\Desktop）
• 🎯 无需设置：下载后自动保存，不尝试设置桌面壁纸

版本特性:

• 分类浏览：推荐、魅力|迷人、自制|艺术、安逸|自由、科幻|星云、动漫|二次元、自然|风景、游戏|玩具、程序|代码、未定义、手机壁纸
• 电脑壁纸：显示绿色"设为壁纸"按钮
• 手机壁纸：显示蓝色"下载"按钮
• 瀑布流布局：4列网格展示
• 支持翻页加载

9.2 免安装版本

使用方法:

1. 解压 ZIP 文件
2. 双击 哲风壁纸.exe 即可运行
3. 无需安装 Python 或任何依赖

注意：所有代码全部由AI Agent生成。