前言¶
DeepSeek Harness (DSH) 插件生态允许开发者扩展功能。dsh-qweather 是一个联网工具，旨在将实时天气数据无缝集成到工作流中。该插件由 youngforblbl 维护，采用和风天气 API 提供服务。
安装与启用¶
先通过命令行安装插件。
dsh plugin --profile web add github:youngforblbl/dsh-qweather
安装后，重启 dsh web 或刷新页面。
配置¶
安装完成后，需要在 DSH 中配置和风天气的凭据。
- 登录和风天气控制台，获取 API KEY、项目 ID 和 API Host。
- 打开 DSH 的设置页面，进入插件 → 和风天气。
- 填入上述信息，开启总开关。
- 设置位置。支持自动定位（市/区级）或手动输入城市名/LocationID/经纬度。
密钥与配置保存在本机 DSH 设置文件 ~/.dsh/settings.yaml 中。
核心功能¶
该插件主要包含以下功能：
- 设置卡片：支持配置 API Host、API KEY、项目 ID、一键总开关、自动定位或手动位置。
- 侧边栏天气组件：底部显示当前天气、未来 5 小时逐时预报、预警、空气质量等，支持展开收起，适配 DSH 明暗主题。
- LLM 天气接口：提供工具
qweather_weather(location?, range?, hours?, days?, fields?)，按位置、时间区间和关心字段取数。 - 对话内天气卡片：提供工具
qweather_card(location?)，在对话流中渲染交互式 HTML 卡片。 - 错误码体系：内置
QW_*错误码，用于统一处理配置错误、网络错误和上游错误。
典型用法¶
在对话中调用工具即可查询天气。
- 查询实时天气：
“北京现在天气怎么样？” - 查询未来几小时：
“上海未来 5 小时会下雨吗？” - 获取结构化数据：
“广州明天适不适合跑步？” - 获取可视化卡片：
“把杭州天气画成卡片给我看”
安全与隐私¶
- 数据存储：密钥与配置保存在本地
~/.dsh/settings.yaml中，日志对密钥自动脱敏。 - 网络请求：插件不向任何第三方上报数据，只发往配置的 API Host。
- 卡片安全：对话内卡片运行在 sandbox iframe 中，无网络能力。
结语¶
dsh-qweather 为 DSH 插件生态提供了一个完整的天气解决方案，从侧边栏组件到 LLM 工具再到可视化卡片，满足了开发者对天气数据的多种需求。
- GitHub: https://github.com/youngforblbl/dsh-qweather
