dsh-workspace

Unofficial — an independent community project, not affiliated with or endorsed by DeepSeek.

English · 中文

A drop-in UI enhancement for DeepSeek Harness (DSH): keep an eye on your balance and today's cost, browse and edit-worthy project files, review Git changes & history, open a terminal, and update Harness in one click — all from the sidebar, no extra config.

Features · Screenshots · Install · Configuration · FAQ · Known limitations · License

Screenshots

Features

Usage at a glance

• Live balance, today's cost, and idle/peak status in the bottom-left of Harness
• Balance is green normally and turns red at 10 CNY or below; idle shows green, peak shows red
• Auto-refreshes every 30s and re-fetches the moment you switch back to the tab
• Today's cost uses the official DeepSeek bill first, falling back to a local token estimate when the platform API is unavailable

Harness updates, one click away

• Shows the installed Harness version, and turns red with a prominent "new version" notice when an upgrade is available
• Hit Update to install the latest version; Harness restarts automatically with a breathing-logo transition screen and the page recovers on its own — no white screen, no manual steps

Project workspace panel

• A right-side panel previews the current session's project: file tree with type-aware icons, Git working-tree changes, per-file diff, and commit history
• Read-only and strictly confined to projectRoot; path traversal and out-of-root symlinks are rejected
• Skips .git, node_modules, dist, lib, coverage, .next, .cache
• Built-in terminal for quick command execution in the project

Privacy by default

• All endpoints are loopback-only unless you opt in with allowRemote: true
• API keys are resolved through Harness ctx.credentials and never exposed to the browser

Install

Requirements

• DeepSeek Harness installed and dsh web running
• Node.js >= 22 when installing from the repository

One-line install

dsh plugin --profile web add "github:deepseek-dsh/dsh-workspace#dev"

Restart dsh web after installation.

Verify & remove

dsh web --dump-config | grep dsh-workspace    # confirm the plugin layer is mounted
dsh plugin --profile web remove dsh-workspace # remove, then restart dsh web

Configuration

The plugin works with zero configuration. The following options can be set in the profile's config file when needed:

Option	Default	Description
baseUrl	https://api.deepseek.com	DeepSeek API base URL
apiKeyEnv	DEEPSEEK_API_KEY	Env name of the API key resolved via ctx.credentials
projectRoot	—	Absolute project root to preview; defaults to the session working directory
peakWindows	[[540, 720], [840, 1080]]	Peak billing windows in minutes (Beijing time)
allowRemote	false	Allow non-loopback access to the plugin endpoints

Troubleshooting

…