前言¶
在 DeepSeek Harness(DSH)开发中,有时需要实时获取天气信息、预警或台风路径。手动打开天气网站不仅打断工作流,而且信息分散在多个页面。dsh-weather-panel 把这些信息集中到 DSH 侧边栏,在启动时自动检查今日降水与生效预警,并在出现新预警时弹窗提醒。
插件概况¶
dsh-weather-panel 是一个运行在浏览器端的天气面板插件,由 python3603 维护,收录在 GitHub(6 stars)。它从 Open-Meteo 获取天气数据,从中央气象台获取预警与台风信息,从国家卫星气象中心获取卫星云图,所有数据在浏览器本地处理,无需 API key。插件要求 DSH 0.2.x 的 Web UI,安装与构建需要 Node.js ≥ 22(插件本身跑在浏览器)。
核心功能¶
当前天气与参数¶
- 当前气温、天气现象(WMO 码本地化)、体感温度、今日最高/最低
- 湿度、海平面气压、风向+风速、阵风、降水、云量、紫外线(含等级)、降水概率、日出、日落、观测时刻
未来预报¶
- 未来 5 天:每天最高/最低、天气现象、降水概率、降水量、最大风速、紫外线最大值
- 未来 24 小时:逐时温度、天气图标、降水概率
逐小时降水图¶
- 24 小时降水柱状图 + 降水概率虚线
- 右侧带 0 / 50 / 100% 概率刻度
- 悬停显示每个小时的具体数值
气象预警¶
- 独立「预警」页签
- 按本区/县 → 本市 → 本省三级精度匹配
- 列表只显示等级、类型、时间,点开展开要点摘要 + 防范要点 + 官方原文链接
- 同市其他区县的预警单列「参考」组,不弹窗
分级提醒¶
- 蓝/黄/橙/红每级独立开关提醒
- 可标记「加强」,被标记的等级弹窗使用该等级配色、顶部警示条与脉冲圆点
台风路径¶
- 活跃台风或最近一次
- 离线海岸线底图、轨迹、预报路径、强度配色、7 / 10 / 12 级风圈
- 可点选轨迹点查看当时气压/风速/移动,一键「回到当前时刻」
- 中央气象台无活跃台风时显示「近期无活跃台风」并可查看最近一次
启动提醒¶
- 打开 DSH 后,若今日有降水或达到设定等级的预警则弹窗(需确认)
- 当天已确认不再打扰,出现新预警会再次提醒
- 在「预警 → 提醒设置」里按等级开关与加强
位置与代理提示¶
- 网络定位(公网 IP)/ 系统定位(浏览器高精度,持久生效)二选一,随时切回
- 手动搜索支持精确到区县(内置 2895 个区县索引)
- 出口 IP 不在中国大陆时,顶部提示「可能开了代理/VPN,请手动切换城市」
雷达¶
- 官方雷达拼图:全国 + 华北/东北/华东/华中/华南/西南/西北,与 nmc.cn 同一产品划分
- 时次滑杆 + 播放动画,图片直连 image.nmc.cn
历史气温¶
- 天气页底部:近 7 天 / 近 30 天(默认 7 天)日最高、最低与平均气温折线
- 带温度带与极值标注
卫星云图¶
- 国家卫星气象中心官方产品(6 个):FY-4B 中国区域(伪彩/真彩 72h 回看)、FY-4B 全圆盘(自然色/长波红外)、FY-2G 中国区可见光、全球红外 15 分钟
- 按官方 XML 清单逐帧,滑杆 + 上一帧/下一帧 + 点击放大
专业(Pro)¶
- 西北太平洋海表温度(8 个海域、按日回看 15 天)
- ECMWF 中国区域天气图(4 种产品、00Z/12Z 两个起报时次、0–240h 时效)
- 图片可点击放大
交互¶
- 刷新、°C/°F 与 km/h / mph 切换(持久化)、关闭面板
- 数据每 10 分钟自动刷新(页面隐藏时暂停,切回补刷)
安装与启用¶
方式一:插件面板(推荐,版本最及时)¶
- 打开侧栏的「插件」面板,点安装——输入框的标签是「包名或地址」。
- 填
dsh-weather-panel。
- 连不上 npm 时,把「安装源」换成「中国大陆镜像源」;
- 也可以改填github:python3603/dsh-weather-panel(需要本机装了 Git)。 - 装完点「启用」,按提示重启 dsh;左侧栏出现「天气」图标。
命令行等价写法(dsh ≥ 0.2.1,参数原样转给 pnpm):
dsh plugin add dsh-weather-panel # 默认 profile
dsh plugin --profile web add dsh-weather-panel # 指定 profile
方式二:插件市场¶
- 打开 设置 → 插件 → 发现,在「索引源」里添加:
https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json
(备用:https://awesome-dsh-plugin.com/index.json、https://dshmarket.com/index.json) - 搜
dsh-weather-panel,点安装。
⚠️ 市场索引比 npm 慢半拍:索引由
dsh-plugin-catalog包提供,版本号要等它重新发布才会更新。想第一时间用上最新版,请使用方式一。
方式三:本地目录(开发 / 自改)¶
- 把仓库放到任意目录,例如
C:\path\to\dsh-weather-panel。 - 让 Agent 执行插件安装(
plugin_manager的install_bundle,目标填仓库目录的绝对路径):
install_bundle target: C:\path\to\dsh-weather-panel
返回 application: "applied" 即为生效。
3. 刷新 Web 页面,左侧栏出现「天气」图标。
数据来源与许可¶
| 用途 | 服务 | 说明 |
|---|---|---|
| 天气/预报 | Open-Meteo | 免 Key;数据 CC BY 4.0,面板底部保留署名 |
| 网络定位 | ipwho.is、ipinfo.io、api.ip.sb | 三源并发竞速,先可用者胜;单源失败不影响面板 |
| 逆地理编码 | BigDataCloud | 坐标 → 「北京市 · 朝阳区」 |
| 城市搜索 | Open-Meteo Geocoding | 中文查询自动追加「市」变体并重排 |
| 气象预警 | 中央气象台 www.nmc.cn/rest/findAlarm |
全国生效预警(实测 CORS *),按标题里的台站层级匹配;详情页无 CORS,因此详情用内置的要点摘要 + 官方原文链接 |
| 台风 | 中央气象台台风网 typhoon.nmc.cn |
JSONP 接口,取回后自行剥壳解析;轨迹/预报/风圈/强度 |
适用场景与注意¶
- 适合需要频繁查看天气、预警或台风路径的开发者与 DSH 用户
- 插件以当前 dsh 进程权限运行,安装前建议检查源码与许可证
- 数据在浏览器本地处理,但需联网获取天气、定位、预警、台风与卫星云图
结尾¶
dsh-weather-panel 把天气、预警、台风与卫星云图集中到 DSH 侧边栏,在启动时自动检查今日降水与生效预警,并在出现新预警时弹窗提醒。所有数据在浏览器本地处理,无需 API key。更多详情与源码见:
- 目录页:https://www.skillhub.cn/plugins/python3603/dsh-weather-panel
- GitHub:https://github.com/python3603/dsh-weather-panel