Soft Glass UI for DSH

An unofficial, installable visual layer for the DeepSeek Harness web interface.

This community project is not affiliated with, sponsored by, or endorsed by DeepSeek or the Kelivo project. DeepSeek Harness and Kelivo remain the property of their respective owners and contributors.

Scope

• Home, conversations, trajectory, settings, menus, dialogs, and related web UI states.
• Light and dark themes.
• Visual styling and presentation behavior only.
• The composer keeps long drafts inside its capped internal scroll area, preserves rounded clipping, and leaves a compact bottom safe area for the statistics line.
• No changes to Harness Agent, Session, Tools, Permissions, storage, credentials, or model runtime behavior.

Current candidate

0.1.0-rc4 fixes long-draft overflow and lowers the home/conversation composer slightly. The frozen 0.1.0-rc3 archive remains unchanged.

Compatibility

Component	Verified version
DeepSeek Harness	0.1.0-rc.5
Node.js	^22.19.0 or >=24
Platform	Web profile
Tested viewport baseline	1440 x 900, DPR 1

Compatibility with later Harness versions is not guaranteed until re-tested.

One-click Windows use

For the normal Windows workflow, use the command wrappers in the repository root:

File	Action
install.cmd	Stop a verified Harness process, remove the legacy/current theme, install the bundled tgz, start Harness, and open the browser.
uninstall.cmd	Stop Harness, remove Soft Glass and the legacy theme if present, restart the original Harness UI, and open the browser.
start.cmd	Start Harness on port 3081, or open it if the verified Harness process is already running.
stop.cmd	Stop only a process positively identified as this Harness checkout.
status.cmd	Show the detected Harness directory, pnpm path, profile, installed themes, archive hash, port owner, and command line.

The scripts automatically locate the nearby Harness checkout and a usable pnpm.cmd, including the bundled Codex runtime. They add pnpm to the child process PATH so Harness plugin installation does not fail with pnpm is not recognized.

If Harness is stored elsewhere, pass its path explicitly:

install.cmd -HarnessRoot "C:\path\to\harness-run"

Optional parameters include -Port, -DshHome, -Pnpm, and -NoOpen. Runtime logs are written under %LOCALAPPDATA%\SoftGlassUI\logs.

Unknown processes occupying the selected port are never stopped automatically.

Architecture

The package uses the supported DSH client-plugin injection path. It decorates existing Harness DOM nodes with plugin-owned data-softglass-* attributes and applies a scoped CSS module. Unloading the plugin removes its decorations and injected style, restoring the original Harness UI.

No Harness core source file is replaced or patched.

Install from a release archive

dsh plugin --profile web add <path-to-dsh-soft-glass-ui.tgz>

Restart the web process after installation.

Remove and roll back

dsh plugin --profile web remove dsh-soft-glass-ui

Restart the web process. The original Harness interface should return without residual plugin roles or style tags.

Build from source inside a compatible Harness checkout

Place this directory under plugins/soft-glass-ui in the compatible Harness checkout, then run:

pnpm run build

The build uses the Harness client-bundle preset and then applies a fail-closed release sanitizer to remove build-machine paths from generated region comments.

Licensing and provenance

The plugin's own source is licensed under MIT. Harness-derived compatibility material retains the DeepSeek MIT notice in THIRD_PARTY_NOTICES.md. See PROVENANCE.md for the design and asset boundary.