前言¶
DeepSeek Harness（DSH）采用「一切皆插件」的设计理念。在 Web GUI 的使用场景中，开发者往往需要快速获取外部环境信息。dsh-client-ui-weather 插件旨在解决这一问题，通过一个无侵入的仪表盘界面，直接在浏览器端展示天气数据，无需配置后端服务或 API 密钥。
核心功能¶
该插件作为 DeepSeek Harness Web GUI 的客户端组件运行，提供以下能力：
- 多城市支持与数据展示：支持上海、北京、深圳、东京、伦敦、纽约等城市切换。界面显示当前温度、体感温度、湿度、风速、能见度、气压及风向。
- 趋势与预报：渲染可访问的 8 小时温度趋势图表，并提供 5 天天气预报（包含最高/最低温度及降水概率）。
- 交互与性能优化：默认展示完整仪表盘，可折叠为紧凑的天气药丸。覆盖层设计为点击穿透，除了控件区域外不阻塞底层 Shell 操作。
- 数据可靠性：使用 Open-Meteo 服务（无需 API Key）。当提供者失败、超时或返回无效数据时，会回退到确定性样本数据。具备请求取消机制和 10 秒超时限制。支持 DST（夏令时）安全的时区日历日期。
安装与启用¶
通过 DSH 的插件管理工具安装：
dsh plugin --profile web add github:mercy719/dsh-client-ui-weather
典型用法¶
安装后，插件会作为 Web GUI 的覆盖层加载。用户在界面中切换城市，即可查看当前天气指标及趋势图表。由于插件不支持自动轮询，用户需手动刷新页面或点击相关控件来获取最新数据。
适用场景与注意¶
- 数据源限制：当前仅使用公开的 Open-Meteo 服务。若部署环境需要私有凭证、服务器端缓存或严格的限流策略，需自行替换注入的请求能力。
- 状态管理：无持久化存储，城市选择和展开/折叠状态在页面刷新后重置。
- 模型交互：该插件仅作为人机界面的投影，不修改提示词、消息内容、模型请求或会话日志，也不会产生 Token 消耗或 KV Cache 影响。
结尾¶
该插件为 DSH Web GUI 提供了一个轻量级、无后端依赖的天气数据解决方案。若需查看源码或提交 Issue，请访问其 GitHub 仓库。
