The core design philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” When building agent applications, weather lookup is a high-frequency and general-purpose feature. The DSH plugin ecosystem provides multiple web-integration options, but directly displaying weather in the Web GUI and enabling the model to invoke it often requires custom development.

This article introduces the dsh-weather plugin. It is maintained by XCKjacksparrow, released under the MIT license, and positioned as a web tool. The plugin provides a visual weather card for DSH’s Web GUI and a tool that models can invoke, eliminating the need for developers to manually integrate weather APIs.

Core Features

The plugin mainly includes the following capabilities:

  • Floating weather card: Provides a ☀️ button in the lower-right corner of the webpage. Clicking it opens a draggable card showing current weather and a three-day forecast.
  • Automatic IP-based location: The first time the card is opened, the plugin infers an approximate city from the visitor’s IP address via a third-party service (for example, “Nanjing”). If location detection fails, it falls back to “Beijing” by default.
  • Search for any city: Supports search by Chinese or English name, such as “Beijing,” “Shanghai,” “New York,” or “Tokyo.”
  • Model tool invocation: Exposes a weather function to the model. When answering weather-related questions, the agent can directly invoke this function.
  • Easter eggs and theme adaptation: Includes fun weather-related messages (such as heat advisories) and supports dark/light mode switching.

Installation and Enablement

Installing the plugin requires DSH’s command-line tool. Make sure you have installed the DeepSeek Harness environment.

Option 1: Install the release package

Use the officially provided release package URL to install it:

dsh plugin --profile web add https://github.com/XCKjacksparrow/dsh-weather/archive/refs/tags/v0.1.0.tar.gz

After installation, restart the dsh web process so that the host side and browser client reload the plugin.

Option 2: Build and install locally

If you need to modify the source code or build from local:

npm install
npm run build
npm pack
dsh plugin --profile web add ./dsh-weather-0.1.0.tgz

Usage

View it in the Web GUI

  1. Open the DeepSeek Harness Web GUI.
  2. Find the ☀️ button in the lower-right corner of the page.
  3. Click the button and enter a city name (Chinese or English is supported).
  4. Press Enter or click the “Search” button; the card will display weather information.

Let the model invoke the weather tool

Ask the agent directly in the conversation; the plugin automatically registers the tool.

Example 1:

“Should I bring an umbrella in Shanghai tomorrow?”

Example 2:

“What is the weather in Beijing tomorrow?”

The agent recognizes the intent and invokes the weather function, then returns the retrieved data to the user.

Notes and Use Cases

  • No configuration required: The plugin works without any additional configuration.
  • Privacy notice: To enable automatic IP-based location detection, the plugin sends the IP address to a third-party geolocation service (such as api.ipapi.is or get.geojs.io) the first time it is opened to infer the city. This process sends data only once and does not store any user information.
  • Data source: Weather data comes from Open-Meteo (free and requires no API key).
  • Permissions and ecosystem: The plugin runs with the permissions of the DSH process and has internet access. Note that it is maintained by a community developer and is not affiliated with DeepSeek or High-Flyer official. Please review the source code and license before use.

Summary

The dsh-weather plugin packages a floating card and a model tool, reducing the cost of integrating weather features in a DSH environment. For developers who need to build agents capable of retrieving real-time information, this is a solution that can be implemented directly. For more details, see the plugin directory or the source repository.