Overview
dsh-weather-panel
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- 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` 只影响显示,请求始终使用公制。 <div align="center"> <img src="https://raw.githubusercontent.com/python3603/dsh-weather-panel/main/docs/assets/memes/tangping.webp" alt="先躺一会儿" width="96" /> </div>
