Introduction

DSH (DeepSeek Harness)’s plugin ecosystem allows for the overlaying of external capabilities on the Web GUI. dsh-weather-sky is one such weather-type plugin: it overlays a pointer-passing animation layer on the page to display weather and sky states. It does not register model tools and primarily targets UI display. Below is an introduction to its capabilities, installation methods, and applicable boundaries.

What is it

dsh-weather-sky is an external plugin maintained by guoPhineas, licensed under MIT. It is used for the DSH Web GUI to overlay a real-time weather and sky animation layer. The plugin is primarily browser-side: weather data is fetched from Open-Meteo in the browser, and rendering is also completed on the browser side; the host side does not register any model tools.

Core Features

  • Localization: Prioritizes navigator.geolocation, falling back to ipwho.is.
  • Weather Data: Retrieves temperature, weather code, day/night, cloud cover, and precipitation via Open-Meteo, requiring no API key.
  • Day/Night Display: Shows the sun during the day, and the moon and stars at night.
  • Moon Phases: Calculates and visualizes new moon, waxing crescent, first quarter, waxing gibbous, full moon, waning gibbous, last quarter, and waning crescent.
  • Solar/Lunar Trajectories: The sun follows an arc from rising in the east to meridian to setting in the west based on solar time; the moon follows an arc based on time and moon phases.
  • Weather Visualization: Clouds, rain (scales with intensity), snow, fog, and thunderstorm lightning.
  • Reducing Obstruction: Sets pointer-events:none on the entire layer, uses low opacity, and displays a semi-transparent status capsule in the bottom right corner.

Installation and Enabling

Command line method:

git clone https://github.com/guoPhineas/dsh-weather-sky
cd <harness>
dsh plugin --profile web add ../dsh-weather-sky

Alternatively, it can be sent in a DSH session:

Install this weather plugin: https://github.com/guoPhineas/dsh-weather-sky

The plugin depends on the release version @deepseek-ai/cordis required for running DSH external plugins, with a version range of ^4.0.1. According to verified information, installation is completed via dsh plugin --profile web add <path>, with no need to modify the DSH source code.

Typical Usage

If building from source, first install dependencies, then execute the build:

pnpm install
pnpm build   # tsdown

Build artifacts are output to lib/: lib/index.js is the host entry, and lib/client.js is the browser side.

Applicable Scenarios and Notes

  • Suitable for users who wish to overlay weather and sky animations in the DSH Web GUI.
  • Weather and location requests are initiated on the browser side, using Open-Meteo and ipwho.is for fallback geolocation.
  • If the weather API or location service fails intermittently, the plugin retains the previous frame and automatically retries after the next 15-second cycle.
  • The plugin uses pointer-events:none and low opacity to reduce obstruction.
  • It is recommended to review the repository source code, dependencies, and MIT license before installation. Plugin code runs under the current dsh process permissions and should be evaluated based on your own trust boundaries.

Conclusion

dsh-weather-sky provides a weather and sky animation overlay for the DSH Web GUI, with the core being browser-side weather fetching and rendering. Repository address:

  • GitHub: https://github.com/guoPhineas/dsh-weather-sky