DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在構建智能體應用時，天氣查詢是一個高頻且通用的功能。DSH 插件生態提供了多種聯網方案，但直接在 Web GUI 中展示天氣並讓模型具備調用能力，往往需要自行開發。
這裏介紹 dsh-weather 插件。它由 XCKjacksparrow 維護，開源協議爲 MIT，定位爲聯網工具。該插件爲 DSH 的 Web GUI 提供了可視化的天氣卡片和模型可調用的工具，解決了開發者需要手動集成天氣接口的需求。
核心功能¶
插件主要包含以下能力：
- 懸浮天氣卡片：在網頁右下角提供一個 ☀️ 按鈕。點擊後展開一個可拖拽的卡片，顯示當前天氣和未來三天的預報。
- IP 自動定位：首次打開卡片時，插件會通過第三方服務根據訪問者的 IP 推斷大致城市（例如“南京”），定位失敗時默認回退到“北京”。
- 任意城市搜索：支持中文或英文名稱搜索，例如“北京”、“上海”、“New York”或“Tokyo”。
- 模型工具調用：插件向模型暴露了一個
weather函數。智能體在回答天氣相關問題時，可以直接調用該函數。 - 彩蛋與主題適配：包含天氣相關的趣味文案（例如高溫提示），並支持深色/淺色模式切換。
安裝與啓用¶
安裝插件需要使用 DSH 的命令行工具。請確保你已安裝 DeepSeek Harness 環境。
方式一：直接安裝發佈包¶
使用官方提供的發佈包地址進行安裝：
dsh plugin --profile web add https://github.com/XCKjacksparrow/dsh-weather/archive/refs/tags/v0.1.0.tar.gz
安裝完成後，需要重啓 dsh web 進程，使 Host 端和瀏覽器客戶端重新加載插件。
方式二：本地構建安裝¶
如果你需要修改源碼或從本地構建：
npm install
npm run build
npm pack
dsh plugin --profile web add ./dsh-weather-0.1.0.tgz
使用方法¶
在 Web GUI 中查看¶
- 打開 DeepSeek Harness 的 Web GUI。
- 在頁面右下角找到 ☀️ 按鈕。
- 點擊按鈕，輸入城市名稱（支持中文或英文）。
- 按 Enter 鍵或點擊“查詢”按鈕，卡片會顯示天氣信息。
讓模型調用天氣工具¶
在對話中直接向智能體提問，插件會自動註冊工具。
示例 1：
“上海明天要帶傘嗎？”
示例 2：
“北京明天天氣。”
智能體會識別意圖並調用 weather 函數，獲取數據後返回給用戶。
注意事項與適用場景¶
- 無配置需求：插件無需任何額外配置即可工作。
- 隱私說明：爲了實現 IP 自動定位，插件會在首次打開時將 IP 地址發送給第三方地理位置服務（如
api.ipapi.is或get.geojs.io）以推斷城市。該過程僅發送一次數據，不存儲任何用戶信息。 - 數據源：天氣數據來源於 Open-Meteo（免費且無需 API Key）。
- 權限與生態：該插件運行在 DSH 進程的權限下，具備聯網能力。請注意，該插件由社區開發者維護，與 DeepSeek 或幻方官方無從屬關係，使用前請檢查源碼與許可證。
總結¶
dsh-weather 插件通過封裝懸浮卡片和模型工具，降低了在 DSH 環境下集成天氣功能的成本。對於需要構建具備實時信息獲取能力的智能體開發者，這是一個可以直接落地的方案。更多詳情可查看插件目錄或源碼倉庫。
