前言¶

DeepSeek Harness (DSH) 插件生態允許開發者擴展功能。dsh-qweather 是一個聯網工具，旨在將實時天氣數據無縫集成到工作流中。該插件由 youngforblbl 維護，採用和風天氣 API 提供服務。

安裝與啓用¶

先通過命令行安裝插件。

dsh plugin --profile web add github:youngforblbl/dsh-qweather

安裝後，重啓 dsh web 或刷新頁面。

配置¶

安裝完成後，需要在 DSH 中配置和風天氣的憑據。

1. 登錄和風天氣控制台，獲取 API KEY、項目 ID 和 API Host。
2. 打開 DSH 的設置頁面，進入插件 → 和風天氣。
3. 填入上述信息，開啓總開關。
4. 設置位置。支持自動定位（市/區級）或手動輸入城市名/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