前言¶
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 倉庫。
