Introduction

dsh-custom-workspace is a plugin for DeepSeek Harness (DSH) Web. It enables each workspace to be configured individually with background, chat font size, Markdown line height, Markdown block spacing, and Retina font rendering, saving these settings to local configuration per workspace. Below is an introduction to its features, installation methods, and typical usage.

What is it

The repository owner for dsh-custom-workspace is JeremyGuo, and the license is MIT. It solves the problem: in DSH Web, different workspaces may require different reading density and appearance, and the plugin can preserve these appearance settings per workspace.

Core Features

  • Main workspace background color or image URL.
  • Independent Markdown body font size and line height.
  • Markdown block spacing for paragraphs, lists, headings, blockquotes, and code blocks.
  • Retina display grayscale anti-aliasing toggle.
  • Persisted to $DSH_HOME/settings.yaml per workspace.

Installation and Enablement

It is recommended to check the source code and MIT license before installing; the plugin runs with the permissions of the current dsh process.

Environment Requirements:

  • DeepSeek Harness 0.1.0-rc.6.
  • Node.js ^22.19.0 or >=24.0.0.
  • loopback DSH Web session; the settings RPC will reject non-loopback browsers.

Installation Command:

dsh plugin --profile web add dsh-custom-workspace

After installation, open Settings → General Settings → Workspace Appearance to configure the selected workspace. Changes are saved immediately.

Typical Usage

The following two configurations can be selected based on reading habits:

  • Compact Reading: 13px font size, 20px line height, 4px block spacing, #eef4ff background.
  • Relaxed Reading: 20px font size, 38px line height, 28px block spacing, #fff3e8 background.

The background can be configured with a color or an image URL. The image URL is used directly, and the loading result depends on the browser’s network and Content Security Policy.

Local Development Workflow:

pnpm install
pnpm run verify
dsh plugin --profile web add link:$PWD
pnpm run watch

First install dependencies and run verification, then load the plugin using the local path, and finally start the watch process.

Persistence and Security

Settings are saved in $DSH_HOME/settings.yaml. The Host side owns the custom-workspace settings namespace and registers a dedicated /custom-workspace Connection RPC channel. This channel only accepts loopback requests and does not expose other settings namespaces.

The browser side verifies the response; it reloads the Host value if writing fails; browsers that are disconnected or non-loopback mark the scope as unavailable. Settings are unavailable for browsers accessed via LAN hostname, even if the DSH Web server trusts that hostname.

Applicable Scenarios and Notes

Suitable for users who need to adjust reading density, background, font size, line height, block spacing, and Retina font rendering within a loopback DSH Web session. Workspace appearance only affects browser rendering and does not enter model requests or session logs.

Usage Notes:

  • Only supports loopback DSH Web sessions.
  • Background images are used directly from the configured URL, relying on the browser’s network and Content Security Policy.
  • This version targets DSH 0.1.0-rc.6; pre-release DSH APIs may change and no compatibility shims are provided.
  • Source code and license should be checked before installation.

Links

The value of dsh-custom-workspace is to provide DSH Web appearance settings preserved per workspace without changing the model experience.

  • GitHub: https://github.com/JeremyGuo/dsh-custom-workspace
  • Directory Page: URL not provided