# 天气动态壁纸与小组件

## 项目概述
本项目实现了一款基于天气状况与时间变化的动态壁纸系统，核心功能包括：根据时间动态调整壁纸颜色（天空、山脉、太阳/月亮）；依据实时天气数据添加雨、雪、云、雷电等视觉效果；支持天气数据本地存储管理；基于时间和天气实现亮度自适应调整。

## 主要组件

### 数据模型
- **WeatherData.kt**：存储和传递天气信息的数据模型。
- **WeatherManager.kt**：负责天气数据的存储、获取与更新的管理类。

### 视觉效果
- **WeatherEffectRenderer.kt**：天气效果渲染核心，支持雨、雪、云等效果。其特点包括：使用VectorChildFinder加载SVG雪花（snow_new.xml），实现前中后三层深度效果（支持缩放、旋转、透明度变化），提供位图和圆形绘制回退方案。
- **WallpaperColorHelper.kt**：处理壁纸颜色转换及时间相关颜色逻辑的工具类。

### 壁纸服务与设置
- **LiveWallpaperService.kt**：集成时间与天气效果的动态壁纸服务。
- **SettingsScreen.kt**：包含天气数据获取与保存功能的壁纸设置界面。

### 资源文件
包括雨滴（raindrop.xml）、雪花（snowflake.xml、snow_new.xml）、云朵（cloud_1.xml、cloud_2.xml）等图形资源。

## 核心功能升级

### 天体系统重构（v4.2）：真实农历月相系统
#### 24小时闭环天体循环
- **太阳周期**：6AM-6PM运动，6PM-6:30PM渐消，6:30PM-5:30AM隐藏，5:30AM-6AM渐现。
- **月亮周期**：7PM-12AM上升，12AM-2AM保持，2AM-5AM下降，5AM-5:30AM渐消，5:30AM-7PM隐藏。

#### 太阳与月亮结构
- **太阳三层设计**：核心层（80dp，100%不透明）、中间层（半径+18dp，30%透明）、外层（半径再+18dp，10%透明）。颜色随时间变化：日出（EC7D8C粉色）、白天（FFFFFF白色）、日落（EBE600黄色），夜晚隐藏。
- **月亮三层设计**：月相中心（8种月相动态变化，100%透明）、中层圆圈（白色，40%透明）、外层圆圈（白色，15%透明）。

#### 月相系统
- **29.5天真实周期**：基于2024年1月11日新月基准，对应农历日期：新月（农历1日）→蛾眉月（3-6日）→上弦月（7-8日）→盈凸月（11-14日）→满月（15-16日）→亏凸月（18-21日）→下弦月（22-23日）→残月（25-29日）。
- **SVG渲染**：采用8个独立SVG文件（如moon_new.xml、moon_full.xml），替代复杂Path绘制，提升性能与视觉效果。

#### 天气限制与技术实现
- 仅晴朗天气（WeatherType.CLEAR）显示太阳和月亮，其他天气隐藏。
- 基于CelestialBodyManager架构，实现对称轨迹算法（太阳左上角、月亮右上角）、时间单位统一及dp/px精确转换。

### HSL颜色系统重构（v2.0）：专业配色管理
#### 核心改进
- **WeatherColorManager**：独立颜色管理类，使用HSL（色相、饱和度、亮度）三元组统一管理颜色，实现标准HSL-RGB转换。
- **WeatherColorScheme**：为每种天气类型配置完整配色，支持白天/夜晚自动切换。

#### 专项天气配色
- **下雪天气**：白天采用浅灰蓝色系（背景hsl(215,14%,79%)、前山hsl(0,0%,94%)等），夜晚降低亮度为深灰蓝色系，雪花保持纯白色（hsl(0,0%,100%)）。
- **雨天天气**：白天为浅灰色系（背景hsl(173,4%,81%)），夜晚为深灰蓝色系（背景hsl(220,36%,33%)），前山、后山、云层颜色与场景匹配。

### 天气特效优化

#### 雪花渲染（v1.3）
- SVG雪花支持：预渲染为位图缓存，尺寸控制在4-12dp，分三层（前景8-12dp、中景6-10dp、背景4-8dp），动画与风速联动。
- 专用配色：下雪时切换固定HSL配色，忽略24小时时间变化。

#### 雨水特效（v2.3）
- 优化雨滴速度（15-35像素/帧）、分布（10x8网格）、连续性（重置间隔10-50像素）。
- 密度分级：小雨60个、中雨90个、大雨120个，雨滴长度（20-60像素）、透明度、宽度随强度变化。

#### 雷电特效（v2.5）
- SVG矢量雷电：加载lightning8.xml等资源，通过颜色滤镜设为纯白色，随机旋转（-180°至+180°）。
- 闪光效果：雷电出现时提升全屏亮度（25%峰值），通过HSL亮度/饱和度调整实现渐变闪光，配合径向光圈增强层次感。

### 降水强度与调试功能

#### 降水强度系统（v2.4）
- 为降雨、雷电、降雪提供“小、中、大、特大”四级强度，映射具体降水量（如小雨2mm/h、中雨8mm/h）。
- 悬浮窗实时调整：仅在降水天气显示强度选项，设置后立即生效。

#### 天气调试悬浮窗
- 功能：支持11种天气类型、4级风速、日出/日落模式实时调整，切换调试模式（20秒检查间隔）与正常模式（30分钟）。
- 权限管理：自动引导授予悬浮窗权限，界面采用Material Design 3设计。

## 扩展性设计
- 新增天气类型需：在WeatherType添加类型、在WeatherEffectRenderer实现渲染、添加资源文件、在悬浮窗添加选项。
- 预留AR特效接口，支持自定义特效强度与颜色配置，兼容多设备适配。

本系统融合天文学准确性与视觉美观性，通过24小时天体循环、29.5天月相周期、动态配色及精细化特效，实现了科学与美学的统一。