dsh-china-weather
Manifest validChina-only weather tool with IP auto-location, AQI and 1-7 day forecast from free keyless sources.
中国天气查询(weather)
一个常驻 DSH 的天气工具:查询中国境内(含港澳台)的实时天气、空气质量与 1–7 天预报。
- 零费用:全部使用免费、无需 API 密钥的公开服务,没有注册、没有额度、没有账单。
- 自动定位:不传地区时,按本机公网 IP 定位(优先中文源 ipip.net,坐标由 Photon 解析)。
- 指定地区:支持城市、区县、新区,例如“杭州”“北京市朝阳区”“上海市浦东新区”“乌鲁木齐”“湖北省天门市”。
- 仅限中国境内:境外地区会直接报错,不会返回国外天气。
安装
直接用 DSH 的插件安装命令:
dsh plugin add https://github.com/YEHO-gg/dsh-china-weather
或者手工 link(开发调试用):
cd %USERPROFILE%\.dsh\profiles\desktop
pnpm add link:<本仓库路径>
然后在 profile 的 package.json → dsh.profile.bundles 里加上 "dsh-china-weather",重启 DSH。
本插件不需要任何 API 密钥,不需要配置文件。
在对话里怎么用
直接说“查一下天气”“杭州明天会下雨吗”“北京朝阳区现在多少度”即可,模型会自动调用 weather 工具。
也可以显式调用:
{ "location": "杭州", "days": 3 }
days 取 1–7,默认 3;省略 location 即自动定位。
数据来源
| 用途 | 服务 | 说明 |
|---|---|---|
| 天气、空气质量 | Open-Meteo | 免费、免密钥,ECMWF/ICON 等模式 |
| 地名解析 | Photon(OpenStreetMap) | 免费、免密钥,支持中国区县/新区 |
| IP 省市 | ipip.net | 免费接口,中文省市名更贴近国内 IP |
| IP 坐标 | ipwho.is | 免费、免密钥,提供经纬度兜底 |
结果缓存 10 分钟,避免重复请求。
可选:高德地理编码(推荐中国境内用)
地名解析默认走免费链路(Photon → Open-Meteo)。想要更准,可以配一个高德 Web 服务 Key:
export AMAP_KEY=你的高德key
(lbs.amap.com → 控制台 → 应用管理 → 添加 Key → 平台选「Web服务」)
配了之后县级市/乡镇解析会优先走高德,location.geocoder 会显示 amap。没配就自动跳过,不影响其它功能。
地名歧义与置信度
同一个名字在中国往往有好几个地方(“天门”有 7 个,“朝阳”有 5 个)。工具的处理方式:
- 按地名类型排名:城市(30 分)> 镇(20)> 区/县(16)> 村(8)> 小地名(2~5);山头、景点、桥这类非居民点扣 25 分。
- 从输入里榨省份线索:写了「湖北省天门市」就命中湖北的候选 +20 分,且直接判高置信度。
- 没写省名就用本机 IP 的省兜底:同名打平时优先留在你所在的省。 这个 +20 只给居民点、且压不过「名字完全匹配」(100 分),所以人在湖北问「北京朝阳区」不会被打成湖北。
- 输出 confidence:
high/medium/low。low时会在结果最上面加一行提示,建议改用「省+市」再查。
建议调用方统一传「省+市/县」全称,别传裸地名。
数据源轮换(v1.3.0)
api.open-meteo.com 从国内只有一个 A 记录(OVH,RTT ~350ms),实测三次里只有一两次能连上,TCP 443 会随机超时——插件原来没有重试,一次握手失败就直接把 fetch failed 抛给模型,看起来像插件坏了。
现在预报改成三个源轮换,一个超时/失败就换下一个,谁先答应用谁:
| 顺序 | 数据源 | 特点 |
|---|---|---|
| 1 | 中国天气网(中央气象台体系) | 国内直连 0.1~1s,口径和手机天气 App 一致;缺体感/紫外线 |
| 2 | Open-Meteo | 字段最全(体感、紫外线、日出日落);线路抽风 |
| 3 | wttr.in | 第三套基础设施,兜底 |
- 单源超时 10 秒;刚失败的源冷却 5 分钟,冷却期内直接跳过,不白等。
- 中国天气网命中后,会顺手用 Open-Meteo 补体感/紫外线/日出日落(最多等 3.5 秒,拿不到就算了,不影响主流程)。
- 返回里的
weatherSource写明这次用的是哪家;renderWeather的最后一行也会显示。 - 地名 → 中国天气网城市码走
toy1.weather.com.cn/search(必须带 Referer),景点码(带A后缀)会被排除。 - 编码自动识别:先按严格 UTF-8 解,解不动才退 GBK(中国天气网两个接口编码不一致)。
输出内容
当前天气(气温、体感、湿度、降水、风向风速)、空气质量 AQI/PM2.5/PM10、逐日预报(最高/最低温、降水概率、日出日落、紫外线)以及数据来源说明。
已知限制
- IP 定位到城市级,可能与实际位置存在偏差;需要更精确时请直接给地区名。
- 区县名存在同名时,工具按「城市>镇>村」的强弱挑一个,并在
confidence=low时提示;带上省份最稳妥。 - 天气为网格预报,不等同于官方气象台逐小时实况。
开发
index.js:工具注册(名称、描述、参数、输出 schema、渲染)。weather.js:定位、地名解析、天气与空气质量请求、中文摘要渲染。selftest.mjs:本地自测脚本(node selftest.mjs)。
Comments
Loading…
Similar plugins
Model-facing weather tool that queries current conditions and 7-day forecasts from public Open-Meteo APIs, with no API key required.
★ 0
↓ 43/wk
dsh plugin --profile web add dsh-tool-weatherby sunshine-lang
Weather tool for DeepSeek Harness: current conditions and multi-day forecasts via Open-Meteo (free, no API key)
★ 7
↓ 112/wk
MIT
TypeScript
Aug 14, 2026
dsh plugin --profile web add dsh-weatherby XCKjacksparrow
Weather forecast for the DeepSeek Harness web GUI: a draggable floating weather card plus a model-callable weather tool.
★ 0
↓ 66/wk
MIT
TypeScript
Aug 15, 2026
dsh plugin --profile web add dsh-weatherby whaoran1018-cmd
Global weather, multi-day forecast and air quality for DeepSeek Harness, Claude Code, Codex, Cursor and any MCP/shell agent - Open-Meteo, no API key.
★ 0
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add dsh-plugin-weatherby python3603
DeepSeek Harness 天气面板:自动定位、5 天预报、逐小时降水、中央气象台预警与台风路径(纯浏览器端,无需 API key)
★ 9
↓ 582/wk
MIT
JavaScript
Nov 13, 2026
dsh plugin --profile web add dsh-weather-panelby QianLuo-Ly
dsh的天气插件(没有高大上的东西,生活不易,出门记得看天气~)
★ 0
MIT
TypeScript
Sep 24, 2026
dsh plugin --profile web add dsh-weather