🌤️ 天气桌面小工具 — 多城市同屏天气桌面插件

一款支持多城市同屏显示、可自定义的桌面天气小工具，专为 Deepin/UOS 桌面环境设计。
基于 Python + Tkinter 构建，2071 行代码，6 个模块化组件。

---

📦 源码仓库

[GitHub 仓库链接 - 上传后替换]
（运行 python3 push_to_github.py 自动上传）

---

✨ 功能特性

特性	说明
🏙️多城市同屏	同时展示多个城市的实时天气，支持搜索/添加/删除/排序
📅3天预报	每个城市展示未来3天天气趋势（温度、天气描述）
🔍城市搜索	支持拼音/汉字实时搜索过滤，129个常用城市一键添加
📦数据缓存	10分钟缓存 + 断网自动显示旧数据 + 提示用户
🔄自动重试	网络请求失败自动指数退避重试，确保数据可靠性
🌙深色主题	现代化深色 UI，护眼舒适，与 Deepin 完美融合
🎨自定义背景	支持本地图片作为背景，自动压暗+模糊处理
🖱️拖拽移动	自由拖动窗口，位置自动保存记忆
⌨️快捷键	F5 刷新、Esc 最小化
💾配置持久化	城市列表、背景图片、窗口位置全部自动保存

---

🚀 安装方式

# 方式1：直接运行
python3 src/main.py

# 方式2：一键安装（桌面快捷方式 + 开机自启）
./setup.sh

# 卸载
./setup.sh uninstall

---

🖼️ 效果截图

---

🧩 项目结构

weather-widget/
├── src/
│   ├── main.py              # 入口文件（100行）
│   ├── weather_api.py       # 天气数据获取+缓存+重试（300行）
│   ├── weather_ui.py        # 桌面窗口UI渲染（846行）
│   ├── settings_dialog.py   # 城市搜索/添加/删除/排序（653行）
│   ├── config_manager.py    # 配置持久化管理（150行）
│   └── __init__.py          # 包定义
├── assets/                  # 应用图标
├── screenshots/             # 效果截图
├── README.md                # 完整项目文档
├── setup.sh                 # 一键安装/卸载脚本
└── 天气桌面小工具_作品集.docx # 作品集文档

---

🏗️ 技术架构

技术	用途
Python 3.8+ / Tkinter	GUI 桌面界面
wttr.in API	免费天气数据源（无需 API Key）
多线程并发	同时获取多城市天气数据
Pillow	背景图片缩放、亮度调节、模糊处理
指数退避重试	网络请求失败自动重试
JSON 配置	城市列表、背景路径、窗口位置持久化

架构模式：MVC 三层架构

• 数据层（Model）：weather_api.py — 数据获取、缓存、重试
• 视图层（View）：weather_ui.py — 窗口渲染、卡片布局
• 控制层（Controller）：settings_dialog.py + config_manager.py — 城市管理、配置持久化

---

💬 开发过程说明（基于 deepin Skills）

本作品全程通过 UOS AI（小U同学） 辅助开发，核心使用了以下 deepin Skills：

1. data-analysis — 天气数据处理、图表渲染逻辑
2. dtk-development — 桌面应用架构设计指导

开发历程：

1. 需求分析：与 AI 讨论多城市天气插件的功能需求，确定技术栈（Python + Tkinter）
2. 架构设计：AI 建议采用 MVC 模块化架构，分离数据层、视图层、控制层
3. 核心开发：
   • AI 编写天气数据获取模块（weather_api.py），含多线程并发、缓存、重试机制
   • AI 编写 UI 渲染模块（weather_ui.py），含圆角卡片、图文混排、悬停效果
   • AI 编写城市管理对话框（settings_dialog.py），含搜索过滤、排序功能
4. 问题修复：AI 协助修复了城市名校验误报、窗口位置记忆、断网保护等 bug
5. 优化迭代：AI 协助优化了代码结构、添加注释、完善文档
6. 作品包装：AI 协助生成作品集文档、README、安装脚本

AI 对话记录截图：（见下方附件）

---

📋 更新日志 v2.0.0

• ✨ 重构模块化 MVC 架构，代码清晰可维护
• 🔍 新增城市搜索功能（129个常用城市，拼音/汉字过滤）
• 📦 新增数据缓存与断网保护
• 🔄 新增网络请求自动重试（指数退避）
• 📊 新增 UV 指数、能见度展示
• ⌨️ 新增快捷键 F5/Esc
• 🗑️ 新增卸载支持（setup.sh uninstall）
• 🐛 修复城市名校验误报、启动路径兼容性
• 🎨 新增应用图标 + 背景模糊效果

---

🔗 相关链接

• deepin Skills 项目：https://github.com/linuxdeepin/deepin-skills
• 天气数据源：https://wttr.in
• 活动帖子：https://bbs.deepin.org.cn/post/300665

===============================================================================

天气桌面小工具_v2.0.0_提交版.zip