When developing plugins for DeepSeek Harness (DSH), understanding the behavioral differences between setting scopes is the foundation for building complex configuration interfaces. To intuitively demonstrate how the three setting levels—session (session), workspace (workspace), and global (global)—behave during context switching, developers have provided a visual sample plugin.

Plugin Positioning

This is a plugin for DeepSeek Harness and also serves as an example project for dsh-granular-settings.

  • Maintainer: joao-paulo-santos
  • Category: Fun Dress-Up
  • Positioning: Using three bouncing squares on the screen, each corresponding to a different setting scope, to help developers understand the behavioral differences of settings under different scopes.

Core Features

This plugin demonstrates the following capabilities:

  1. Scope visualization: Three bouncing squares appear on the screen, driven by the session, workspace, and global scopes, respectively.
  2. Setting type coverage: Demonstrates multiple control types, including toggles, color pickers, text, sliders, numbers, enumerations, and multi-selection.
  3. Code pattern:
    • Host side: Uses gs.register to register settings.
    • Client side: Uses gs.useSetting to retrieve settings and bind them to the UI.

Installation and Enablement

Before installation, make sure you have a local checkout of DeepSeek Harness and a configured profile (using web in this example).

  1. Create a plugins directory and clone the dependencies:
    mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
    git clone https://github.com/joao-paulo-santos/dsh-event-relay.git
    git clone https://github.com/joao-paulo-santos/dsh-granular-settings.git
    git clone https://github.com/joao-paulo-santos/dsh-bouncing-squares-example.git
  1. Add the plugins in the Harness checkout:
    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-event-relay
    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-settings
    pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-bouncing-squares-example
  1. Verify the configuration:
    pnpm dsh --profile web --dump-config

After restarting Harness, a Granular Settings option appears in the control panel, where you can adjust attributes such as the squares’ color, speed, and size in real time.

Typical Usage

You can observe the behavior of different scopes by performing the following operations:

  1. Open two sessions in the same workspace and assign them different Session colors. At this point, each session’s square color is independent, while the workspace square color remains consistent.
  2. Switch to another workspace and observe the Session and Workspace squares change with the context, while the Global square remains unchanged.
  3. Close all sessions. At this point, only the Global square continues to bounce on the screen, demonstrating that global settings still exist when there is no session context.

Notes

  • Dependencies: This plugin depends on dsh-granular-settings and dsh-event-relay.
  • Runtime environment: This is an example plugin, not a core platform component.
  • Permissions and security: The plugin runs with the permissions of the current DSH process. It is recommended to review the source code and license before installation.

Summary

This plugin serves as a best-practice reference for understanding DeepSeek Harness’s setting scope mechanisms. Through the visual bouncing-squares effect, developers can intuitively verify the lifecycle and behavior of settings at different levels, enabling them to make appropriate architectural choices when developing their own plugins.