dsh-weather-panel

dsh-weather-panel · 天气面板

「工作时也不能忘记天气情况哦！」

呜啾～ 这里是主人的天气小管家

主人又在对着屏幕敲代码了吧。窗外是晴是雨、要不要带伞、有没有台风——这些小事就交给我盯着好啦。

侧边栏多一个小小的天气图标，点开来就能看到当前城市的气温、风、湿度和未来几天的变化；开 DSH 的时候如果今天会下雨、或者中央气象台发了预警，我会先跳出来提醒主人的，主人点一下「知道了」就好啦。呜啾～

下面开始是严谨部分：数据来自哪里、怎么保证兼容、性能如何、怎样自己构建。可爱到此为止，技术描述不再卖萌。

一张图看懂数据流

数据链路（严谨版）：浏览器端并发定位（三个 IP 源竞速，可选系统高精度定位）→ BigDataCloud 逆地理得到城市名 → 以该坐标向 Open-Meteo 请求当前 / 逐时 / 逐日数据；同一轮并行拉取中央气象台全国预警（按市 → 省匹配标题）与台风列表/轨迹；全部结果进入一个共享 store，供面板与启动提醒共用，缓存写入 localStorage。

功能

区块 · 内容 当前天气 · 温度、天气现象（WMO 码本地化）、体感、今日最高/最低 主要参数 · 湿度、海平面气压、风向+风速、阵风、降水、云量、紫外线（含等级）、降水概率、日出、日落、观测时刻 未来 5 天 · 每天最高/最低、天气现象、降水概率、降水量、最大风速、紫外线最大值 未来 24 小时 · 逐时温度、天气图标、降水概率 逐小时降水图 · 24 小时降水柱状图 + 降水概率虚线，右侧带 0 / 50 / 100% 概率刻度，悬停显示每个小时的具体数值 气象预警 · 独立「预警」页签：按本区/县 → 本市 → 本省三级精度匹配；列表只给等级、类型、时间，点开才展开要点摘要 + 防范要点，末尾才是官方原文链接；同市其他区县的预警单列「参考」组，不弹窗、不打扰 分级提醒 · 蓝/黄/橙/红每级独立开关提醒；再单独标记「加强」，被标记的等级弹窗会换成该等级的配色、加顶部警示条与脉冲圆点 台风路径 · 活跃台风或最近一次：离线海岸线底图、轨迹、预报路径、强度配色、带等级标注的风圈（7 / 10 / 12 级）；可点选轨迹点看当时气压/风速/移动，一键「回到当前时刻」；中央气象台无活跃台风时显示「近期无活跃台风」并可查看最近一次 启动提醒 · 打开 DSH 后，若今日有降水或达到你设定等级的预警则弹窗（需确认）；当天已确认不再打扰，出现新预警会再次提醒；可在「预警 → 提醒设置」里按等级开关与加强 位置 · 网络定位（公网 IP）/ 系统定位（浏览器高精度，持久生效）二选一，随时切回；手动搜索支持精确到区县（内置 2895 个区县索引，「徐汇区」「浦东新区」都能直接搜到，离线可用）；副标题标明来源、IP 与精度 代理提示 · 出口 IP 不在中国大陆时，顶部提示「可能开了代理/VPN，请手动切换城市」 雷达 · 官方雷达拼图：全国 + 华北/东北/华东/华中/华南/西南/西北，与 nmc.cn 相同的产品划分；时次滑杆 + 播放动画，图片直连 image.nmc.cn 历史气温 · 天气页底部：近 7 天 / 近 30 天（默认 7 天）日最高、最低与平均气温折线，带温度带与极值标注（不是 K 线） 卫星云图 · 国家卫星气象中心官方产品（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 分钟自动刷新（页面隐藏时暂停，切回补刷）

实际界面

天气页 · 当前天气 + 8 项气象参数 + 未来 5 天 + 逐小时降水 + 历史气温（示例定位为手动选择的上海）

预警页 · 按本区/本市/本省匹配，点开看要点摘要与防范要点，下方是分级提醒设置 卫星云图 · 国家卫星气象中心 FY-4B / FY-2G 共六个产品，逐帧滑杆与点击放大

雷达拼图 · 全国 + 七大分区，6 分钟时次，逐帧播放

台风页 · 实况轨迹（按强度着色）+ 预报路径 + 7 / 10 / 12 级风圈 + 参考城市与经纬网

专业栏 · 西北太平洋海表温度（按日回看 15 天）+ ECMWF 中国区域天气图（00Z / 12Z、0–240h）

界面说明

• 预警页：本区/本市 + 省级预警列表，点开看要点摘要与防范指南，末尾给官方原文；下方是分级提醒设置与「预览弹窗」（按当前定位生成示例预警）。
• 天气页：当前天气大卡（含 8 项参数）+ 未来 5 天卡片 + 逐小时降水图与 24 小时条带 + 历史气温（近 7 / 30 天折线）。
• 卫星页：国家卫星气象中心六个产品（FY-4B 中国区域 / 全圆盘、FY-2G、全球红外 15 分钟），按官方 XML 清单逐帧读取，滑杆 + 上一帧/下一帧 + 点击放大。
• 雷达页：中央气象台雷达拼图，产品划分与 nmc.cn 一致（全国 + 七大分区）；时次按官方 6 分钟规则生成，滑杆逐帧 + 播放动画，未发布的时次自动回退。
• 台风页：活跃台风或最近一次；实况轨迹按强度着色、预报路径虚线、7/10/12 级风圈按颜色区分；无活跃台风时显示「近期无活跃台风」，仍可查看最近一次。
• 专业栏：西北太平洋海表温度（8 个海域、按日回看 15 天）+ ECMWF 中国区域天气图（4 种产品、00Z/12Z 起报、0–240h），图片均可点击放大。
• 启动提醒：弹窗汇总今日降水与生效预警；确认按钮使用主题文字色（不使用「品牌色填充 + 白字」），浅色与深色主题下均保持可读。

安装

要求：DeepSeek Harness 0.2.x 的 Web UI，本机 Node.js ≥ 22（只用于安装与构建，插件本身跑在浏览器）。

方式一：插件市场（dsh-market / Awesome DSH Plugin 索引）

本插件已被收录在 Awesome DSH Plugin 与 dsh-market 市场里，可以在图形界面里一键装：

1. 打开 设置 → 插件 → 发现（Discover），在「索引源」里添加：

https://cdn.jsdelivr.net/npm/dsh-plugin-catalog/index.json （备用：https://awesome-dsh-plugin.com/index.json、https://dshmarket.com/index.json）

若在 jsDelivr 的索引里搜不到本插件：那个索引是 dsh-plugin-catalog 的 npm 快照，收录后要等它重新发布；换成 https://awesome-dsh-plugin.com/index.json 通常就能看到。

1. 搜 dsh-weather-panel，点安装。
2. 想要更好的市场体验（一键升级、主题切换），可以再装 dsh-market：

dsh plugin --profile web add dshmarket

⚠️ 市场索引比 npm 慢半拍：索引由 dsh-plugin-catalog 包提供，版本号要等它重新发布才会更新。

想第一时间用上最新版，请手动装 npm 包（下面方式二，或命令行 dsh plugin add dsh-weather-panel），

不要等市场刷新。

方式二：插件面板（推荐，版本最及时）

1. 打开侧栏的「插件」面板，点安装——输入框的标签是「包名或地址」。
2. 填 dsh-weather-panel。

• 连不上 npm 时，把「安装源」换成「中国大陆镜像源」；
• 也可以改填 github:python3603/dsh-weather-panel（需要本机装了 Git）。

1. 装完点「启用」，按提示重启 dsh；左侧栏出现「天气」图标。

命令行等价写法（dsh ≥ 0.2.1，参数原样转给 pnpm）：

dsh plugin add dsh-weather-panel                  # 默认 profile
dsh plugin --profile web add dsh-weather-panel    # 指定 profile

方式三：本地目录（开发 / 自改）

1. 把仓库放到任意目录，例如 C:\path\to\dsh-weather-panel。
2. 让 Agent 执行插件安装（plugin_manager 的 install_bundle，目标填仓库目录的绝对路径）：

install_bundle  target: C:\path\to\dsh-weather-panel

返回 application: "applied" 即为生效。

1. 刷新 Web 页面，左侧栏出现「天气」图标。

卸载：在「插件」页停用/移除 dsh-weather-panel；本地仓库不会被改动。

插件面板与命令行的安装方式，参考社区项目 Fei2411/DeepSeek-Bot 的安装说明。

数据来源与许可

用途 · 服务 · 说明 天气/预报 · 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 接口，取回后自行剥壳解析；轨迹/预报/风圈/强度 底图 · Natural Earth 1:50m 陆地 · 公有领域；构建期裁剪西北太平洋并抽稀，打进 bundle，约 36 KiB 雷达 · 中央气象台雷达拼图 image.nmc.cn · 官方产品图（PNG），按官方 6 分钟时次规则取帧；图片加载不需要 CORS 卫星云图 · 国家卫星气象中心 img.nsmc.org.cn · 产品清单 XML（实测 CORS *）逐帧列出官方 JPG；覆盖 FY-4B / FY-2G / 静止卫星全球拼图

区县索引 · GeoNames download.geonames.org（CC BY 4.0） · 中国 ADM1/ADM2/ADM3 的行政中心点，构建期生成、随包内置，运行时不联网 历史气温 · Open-Meteo past_days · 逐日最高 / 最低 / 平均；forecast_days=0 只回完整日（截至昨天） 专业图 · easterlywave.com 社区站点 · 海表温度按日；ECMWF 图按 00Z/12Z 起报 + 24h 步长。该站 JSON 接口需 cookie + CSRF 且无 CORS，这里只取静态产品图，并保留官方页面链接

隐私：定位只把公网 IP 交给上述定位服务；天气只把坐标交给 Open-Meteo；预警与台风请求不携带任何个人信息。缓存只写本机 localStorage。

README 中的表情包：来自本项目作者自用的表情包图库，仅用于本仓库页面展示，不随代码授权（请勿另作商用）。

兼容性与性能设计

兼容

• 只占增量席位，全部用自定义 id：main（页面）、sidebar.panellist（图标）、shell.overlay（启动提醒）。不复用、不覆盖宿主或其它插件的 id。
• shell.overlay 图层本身是 click-through 的，弹窗根节点显式 pointer-events:auto，只在自己范围内接管点击。
• 不读其它插件的 DOM/CSS，不向 document.body 追加节点，不替换 root。
• 样式全部写在组件自行渲染的 ` 元素中（dshw- 前缀），卸载即消失；颜色只使用 --dsw-alias-*` 主题令牌并带兜底值，且避免「品牌色填充 + 白字」这类在浅色主题下失效的组合。
• 文案通过 Client locale 服务注册，中英双语即时切换；插件卸载时先 selectPanel(null) 再注销，不留空白页。

性能

• 共享 store：面板与启动提醒共用同一份数据，页面打开只定位/取数一次。
• 单次请求覆盖当前 + 逐时 + 逐日；预警每次并行取前 5 页（最多 500 条），这样同一座城市散落在不同页的几条预警不会漏。
• 缓存 TTL：预报/预警 10 分钟、定位 6 小时、台风 1 小时；重开面板与轮询通常零请求。
• 每个刷新周期使用独立 AbortController，新刷新取消旧刷新；所有请求有硬超时。
• 页面隐藏时不轮询，切回时若数据已过期立即补刷。
• 台风投影与约 36 KiB 的陆地 path 以 useMemo 按台风缓存，点选轨迹点不触发重算。
• 无第三方运行时依赖，产物约 229 KiB（未压缩，其中约 36 KiB 为离线底图）。

目录结构

.
├── package.json          # bundle + dsh.client 声明、exports、脚本
├── cordis.patch.yml      # 插入一行 Host 插件（bundle 载体）
├── index.js              # Host 半侧：故意空实现，逻辑全在浏览器端
├── client.js             # 构建产物（npm run build 生成，勿手改）
├── icon.svg / locale/    # 插件管理器里的图标与标题描述
├── docs/assets/          # README 插图与表情包（原创 SVG / 自用图库）
├── docs/screenshots/     # 真实界面截图
├── src/
│   ├── lib/              # 纯逻辑，Node 里可直接 import 测试
│   │   ├── i18n.js       # 双语词典、插值、Host 翻译降级
│   │   ├── links.js      # 仓库/Issue 链接（换仓库只改这里）
│   │   ├── wmo.js        # WMO 4677 → 文案/图标组/严重度
│   │   ├── format.js     # 温度/风/气压/降水/方位/时间/星期
│   │   ├── cache.js      # TTL 缓存 + 安全 Storage
│   │   ├── geo.js        # IP 定位竞速、逆地理、城市搜索（合并区县索引）
│   │   ├── districts.js  # 区县级搜索：别名、去后缀、打分
│   │   ├── districts-data.js # 内置行政区索引（构建期生成，99 KiB）
│   │   ├── weather.js    # Open-Meteo 请求构造与归一化
│   │   ├── alerts.js     # 中央气象台预警解析、台站层级匹配、签名
│   │   ├── alert-guides.js # 各类型预警的防范要点（详情面板用）
│   │   ├── typhoon.js    # 台风 JSONP 解析、轨迹/预报/边界/强度/风圈等级
│   │   ├── radar.js      # 雷达产品与时次规则、官方图片 URL
│   │   ├── satellite.js  # NSMC / 向日葵九号 / NASA GIBS 的取图规则
│   │   ├── history.js    # 历史气温取数与归一化
│   │   ├── procharts.js  # 海温 / ECMWF 产品图规则
│   │   ├── notice-core.js# 是否该弹窗的纯决策逻辑
│   │   └── store.js      # 共享状态、缓存、10 分钟刷新、React 绑定
│   ├── ui/
│   │   ├── styles.js     # 基础/面板/弹窗三段样式
│   │   ├── icons.js      # 天气插画与 UI 图标（内联 SVG）
│   │   ├── chart.js      # 逐小时降水柱状图
│   │   ├── basemap-data.js # 生成产物：西北太平洋陆地轮廓（约 36 KiB）
│   │   ├── typhoon-view.js # 台风轨迹图（经纬网 + 参考城市 + 风圈等级）
│   │   ├── radar-view.js # 雷达拼图（区域 / 时次 / 播放）
│   │   ├── satellite-view.js # 卫星云图（三家源）
│   │   ├── history-chart.js  # 历史气温折线
│   │   ├── pro-chart-view.js # 专业栏（海温 + ECMWF）
│   │   ├── media-zoom.js     # 共用的大图查看层
│   │   ├── alerts-view.js # 预警页（列表 / 详情 / 分级设置 / 预览）
│   │   ├── notice.js     # 启动/新预警提醒弹窗（分级过滤 + 加强样式）
│   │   └── panel.js      # 面板组件与位置选择器
│   └── plugin.js         # 注册入口（三个席位 + store 生命周期）
├── scripts/build.mjs     # 零依赖打包：拼接 src → client.js
├── scripts/build-basemap.mjs # 生成离线海岸线（Natural Earth 裁剪+抽稀）
└── test/                 # node:test：87 个用例（含渲染冒烟测试）

开发

npm run build     # src/** → client.js（单文件浏览器模块）
npm run basemap   # 重新生成离线海岸线（需要联网下载 Natural Earth）
npm run lint      # node --check
npm test          # node:test，需要 Node ≥ 22
npm run check     # 三连

client.js 是产物但需要提交：本地目录安装直接 link 仓库，Harness 只读这个入口文件。src/lib/*.js 是标准 ESM，测试直接 import；scripts/build.mjs 拼接时去掉 import/export 并包进 window.__ModuleLoader__.load(...)。

测试包含渲染冒烟测试：在 vm 里启动真实 bundle，用极简 React shim 真正执行组件树（天气页 / 打开位置选择器 / 台风页 / 选中历史点 / 提醒弹窗 / 侧边栏图标），任何分支里的引用错误都会在 CI 阶段暴露，而不是让用户看到空白页。

测试提醒弹窗

「预警」页 →「设置」→ 选等级 → 点「预览弹窗」：按当前定位生成一条示例预警并直接弹窗（不写入真实数据、不参与真实匹配）。

• 预览数据只写 dsh-weather-panel:demo-alert（值为 preview:），不参与真实预警匹配，也不进缓存；
• 弹窗里点「知道了」会自动清掉演示开关；
• 演示模式忽略「今日已确认」去重，便于反复查看样式；
• 也可在浏览器控制台（Electron 中 Ctrl+Shift+I）手动切换：

localStorage.setItem('dsh-weather-panel:demo-alert', 'preview:red'); location.reload();     // 红色预览
  localStorage.setItem('dsh-weather-panel:demo-alert', 'preview:blue'); location.reload();    // 蓝色预览
  localStorage.removeItem('dsh-weather-panel:demo-alert');
  localStorage.removeItem('dsh-weather-panel:notice'); location.reload();                  // 完全复位

已知限制

• IP 定位只到城市级，且可能落在运营商或代理出口；面板会显示来源与 IP，并用顶部提示建议手动切换（手动搜索可精确到区县）。
• 预警来自全国实时流并按标题匹配：本区/县 → 本市 → 本省，区县名必须落在行政边界上（避免「市南区」被「葫芦岛市南票区」误命中），并做省界校验（外省台站的预警直接丢弃）。NMC 标题只写发布台站的全称，所以「本市有多个区、但你没设到区」时，同城各区的预警会并列为市级；同市其他区县的预警放在「参考」组里，不弹窗。
• 台风底图为离线陆地轮廓（Natural Earth 1:50m，公有领域，仅陆地、不画国界）：无需 Key、不受 CORS/额度限制、可离线使用；代价是没有地名与行政区划，海岸线在 1:50m 粒度下约有 1–2 km 概化误差。
• 系统定位请求的是高精度位置（watchPosition + enableHighAccuracy，不取缓存），但桌面端的实际精度由系统定位服务决定；精度差于 3 km 时面板会降级到市级（不显示区县、预警也只按市匹配），并提示「重新定位 / 改用网络定位」。
• 系统定位依赖浏览器权限：首次开启会请求授权，被拒绝时回退网络定位并给出提示（开关状态保留）。
• 雷达图按官方 6 分钟时次生成候选帧：nmc.cn 的帧清单页面没有 CORS 头，浏览器读不到，因此缺帧时靠图片 onerror 回退（最新时次通常滞后 1-2 帧）。全国可回看 24 小时、分区约 2 小时，与官网一致。
• 卫星云图只接国内官方源（国家卫星气象中心）：清单 XML 与产品图都直连 img.nsmc.org.cn（实测 CORS 允许读取清单），影像按官方节奏更新（FY-4B 每 15 分钟、FY-2 每 30 分钟）。
• 历史气温取的是 Open-Meteo 的逐日统计，forecast_days=0 不返回今天，所以曲线截止到昨天（完整日）。
• 专业栏的图来自社区站点 easterlywave.com：API 有 CORS + CSRF 限制，只能按命名规则直连静态图，因此新起报时次的出图会滞后（ECMWF 每天 00Z/12Z 两次，海温按日）；若图片缺失会自动回退到上一时次，仍缺则提示。
• 区县索引是 GeoNames 的快照：个别后来更名/撤并的区县没有新名字（如两江新区），代码里补了常用别名（两江新区 → 渝北区），其余以索引里的现行名为准。
• °F 只影响显示，请求始终使用公制。

反馈

发现 bug、想要新功能，或者觉得某处文字看不清，都欢迎提 issue：

面板底部同样有「反馈 / 提 issue」入口。

许可

代码 MIT（见 LICENSE）。天气数据 CC BY 4.0 © Open-Meteo.com；预警与台风数据 © 中国气象局 / 中央气象台（仅作个人查看，请遵守其使用条款）；底图数据 © Natural Earth（公有领域）；逆地理编码 © BigDataCloud；IP 定位 © 各自服务方。图标与插图（SVG）为本项目原创；README 表情包来自作者自用图库，仅用于本仓库展示。

愿主人出门时，天正好是晴的。 ☀️ 🐋