WeatherSidebar：Excel/WPS天气侧边栏插件

作品简介

WeatherSidebar 是一个基于 Excel-DNA 框架开发的 Excel/WPS 插件，使用 .NET 6.0 + WPF 构建，并集成 HandyControl 第三方 UI 库提供现代化界面。

安装后会在 Excel/WPS 中增加「天气助手」选项卡，点击即可在表格右侧打开天气侧边栏：通过和风天气 GeoAPI 搜索并添加多个城市，侧边栏内展示实时温度、体感、风速、湿度、气压、能见度，以及逐小时预报、7 日预报和运动、穿衣、紫外线、舒适度、感冒等生活指数。

处理表格的同时无需切换软件即可查看天气，还能把天气数据直接复制到剪贴板或导出到活动工作表，供后续统计分析使用。

核心亮点

• 多城市管理：通过和风天气 GeoAPI 搜索城市并添加到侧边栏，多城市快速切换
• 信息全面：实时天气含温度、天气状况、体感温度、风速、湿度、气压、能见度，另附 7 日预报与 24 小时逐小时预报
• 生活指数：运动、穿衣、紫外线、舒适度、感冒指数带颜色等级标识，直观易读
• 智能配色：根据晴、多云、雨、雪、雾等天气状况自动切换渐变背景色，图标支持离线回退为 emoji 显示
• 自动刷新：每 5 分钟自动更新天气数据，也可手动刷新
• 数据导出：一键复制天气数据到剪贴板，或直接导出到活动 Excel 工作表
• Ribbon 功能区：提供侧边栏显隐、API 设置、使用说明等入口，引导用户完成 Key 配置

技术与工具

• 基于 Excel-DNA 框架开发，兼容 Excel 与 WPS 双平台
• .NET 6.0 + WPF 构建界面，集成 HandyControl UI 库
• 天气数据来自和风天气 API（GeoAPI 城市搜索 + 天气数据接口），支持自定义 API Key 与 Host
• 天气图标预加载并本地缓存，网络异常时可回退显示

开发过程

• 项目因工作原因断断续续推进，总计约 8 天：核心功能约 4 天，兼容性调试与问题修复约 3 天，测试和文档约 1 天
• 最大挑战在于 Excel-DNA + WPF 的技术栈集成以及 Excel/WPS 双平台兼容
• WPS 自定义任务窗格按原方案实现持续报错，最终调整思路另辟途径实现了类似效果，这部分占据了约 60% 的开发调试时间

适用场景

• 日常办公：处理表格数据时随时查看天气，无需切换软件，便于安排外出、外勤计划
• 业务表格搭配：农产品销售、户外工程进度等与天气相关的表格，可直接把天气数据导出到工作表，减少手工抄录

原始提交内容（点开查看，可复制全文去问 AI）

功能模块 1. 天气侧边栏（核心功能）

• 城市管理 ：通过和风天气 GeoAPI 搜索城市并添加到侧边栏

• 实时天气 ：显示当前温度、天气状况、体感温度、风速、湿度、气压、能见度

• 7 日预报 ：每日最高/最低温、天气状况

• 24 小时逐小时预报 ：逐小时温度、风况

• 生活指数 ：运动、穿衣、紫外线、舒适度、感冒指数（带颜色等级标识）

• 天气图标缓存 ：预加载和风天气官方图标，支持离线回退到 emoji 显示

• 天气配色 ：根据天气状况（晴/多云/雨/雪/雾等）自动切换渐变背景色

• 自动刷新 ：每 5 分钟自动刷新天气数据

• 复制/导出 ：一键复制天气数据到剪贴板，或导出到活动 Excel 工作表 2. Ribbon 功能区 在 Excel/WPS 中增加「天气助手」选项卡，包含：

• 天气侧边栏 ：显示/隐藏侧边栏

• API 设置 ：配置和风天气 API Key 和 Host

• 使用说明 ：引导用户注册和配置 API

• 关于 ：版本信息、环境信息、窗格状态 3. 工作表函数（UDF） ）