dsh-qweather

配置

1. 登录 QWeather 控制台：
   • API KEY：控制台 → 项目和凭据 → API KEY（必需）；
   • 项目 ID：同上（可选，仅记录，为后续 JWT 认证预留）；
   • API Host：控制台 → 设置 → API Host（可选）。留空默认使用公共域名 https://devapi.qweather.com（旧公共域名将从 2026 年起逐步停止服务，建议填入你的专属 Host，形如 abc1234xyz.def.qweatherapi.com）。
2. 打开 DSH → 设置 → 插件 → 和风天气，填入上述信息并「保存」；先点「测试连接」确认可用。
3. 位置：
   • 自动定位（市/区级）：侧边栏组件用浏览器定位拿经纬度，经 GeoAPI 反查最近市/区并写回设置，LLM 工具直接复用；首次需允许定位权限，失败自动回退到手动位置；
   • 手动输入：支持城市/区县名、LocationID（如 101010100）或“经度,纬度”（如 116.41,39.92）。

密钥与配置保存在本机 DSH 设置文件（~/.dsh/settings.yaml）中，请勿把该文件提交到任何仓库。和风 API 面向浏览器的跨域（CORS）已由官方开放，无需额外配置；数据标注“数据来源：和风天气”，符合其注明来源要求。

使用

侧边栏组件

展开侧边栏即可看到底部天气卡片：地点、当前天气（图标+文字+气温+体感/湿度）、未来 5 小时（时间/图标/气温/降水概率+雨滴/风向箭头+风级）、蓝色及以上预警（最多 2 条）、空气质量/日月起落/生活指数、更新时间；右上角 ↻ 手动刷新，数据每 10 分钟自动刷新。收起侧边栏只剩图标 + 气温，点击即可展开。

对 LLM 说

北京现在天气怎么样？                              # 模型会调 qweather_weather
上海未来 5 小时会下雨吗？                          # range=hours
把杭州天气画成卡片给我看                            # 模型会调 qweather_card
广州明天适不适合跑步？（看温度、降水、空气质量）        # fields=temp,precipitation,air

两个工具的参数（模型通过内置 qweather 技能了解这些约定）：

• qweather_weather：location（缺省用设置位置）、range=now|hours|days、hours=1-240、days=1-10、fields=condition,temp,humidity,wind,precipitation,air,warnings,astro（all 或默认 summary）。
• qweather_card：location（缺省用设置位置）。卡片固定渲染未来 5 小时（布局按 5 列硬编码）。

卡片内容

当前天气（图标+文字+气温）→ 未来 5 小时逐时（气温/降水概率+雨滴/风向箭头+风级）→ 蓝色及以上预警（仅过滤未知级别）→ 空气质量/日月起落/生活指数 → 信息更新时间 + 数据来源。卡片随 DSH 明暗主题切换，会话重放时逐字节还原，不依赖网络。