概览
dsh-weather-panel
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义;完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- 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>
