DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-china-weather

d

dsh-china-weather

Manifest valid

China-only weather tool with IP auto-location, AQI and 1-7 day forecast from free keyless sources.

hasBundlePatch

中国天气查询(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 个)。工具的处理方式:

  1. 按地名类型排名:城市(30 分)> 镇(20)> 区/县(16)> 村(8)> 小地名(2~5);山头、景点、桥这类非居民点扣 25 分。
  2. 从输入里榨省份线索:写了「湖北省天门市」就命中湖北的候选 +20 分,且直接判高置信度。
  3. 没写省名就用本机 IP 的省兜底:同名打平时优先留在你所在的省。 这个 +20 只给居民点、且压不过「名字完全匹配」(100 分),所以人在湖北问「北京朝阳区」不会被打成湖北。
  4. 输出 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 一致;缺体感/紫外线
2Open-Meteo字段最全(体感、紫外线、日出日落);线路抽风
3wttr.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

dsh-tool-weather

Model-facing weather tool that queries current conditions and 7-day forecasts from public Open-Meteo APIs, with no API key required.

Tools & CapabilitiesManifest valid

★ 0

↓ 43/wk

dsh plugin --profile web add dsh-tool-weather

by sunshine-lang

Weather tool for DeepSeek Harness: current conditions and multi-day forecasts via Open-Meteo (free, no API key)

Tools & CapabilitiesManifest valid

★ 7

↓ 112/wk

MIT

TypeScript

Aug 14, 2026

dsh plugin --profile web add dsh-weather

by XCKjacksparrow

Weather forecast for the DeepSeek Harness web GUI: a draggable floating weather card plus a model-callable weather tool.

Manifest valid

★ 0

↓ 66/wk

MIT

TypeScript

Aug 15, 2026

dsh plugin --profile web add dsh-weather

by 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.

Development & InfrastructureManifest valid

★ 0

MIT

JavaScript

Oct 4, 2026

dsh plugin --profile web add dsh-plugin-weather

by python3603

DeepSeek Harness 天气面板:自动定位、5 天预报、逐小时降水、中央气象台预警与台风路径(纯浏览器端,无需 API key)

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 9

↓ 582/wk

MIT

JavaScript

Nov 13, 2026

dsh plugin --profile web add dsh-weather-panel

by QianLuo-Ly

dsh的天气插件(没有高大上的东西,生活不易,出门记得看天气~)

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 0

MIT

TypeScript

Sep 24, 2026

dsh plugin --profile web add dsh-weather