dsh-studio

Studio for DeepSeek Harness

Themes and personalisation for DeepSeek Harness (DSH): 18 themes, a theme editor that builds themes from a mood, one colour, any word or any picture, a theme per workspace, a community gallery of themes and prompt packs, liquid-glass panels, wallpapers (Bing daily, slideshows and video), fonts, saved looks on a schedule that can follow sunrise and sunset, your Windows accent colour, layout controls and a focus mode, AI modes, task-finished alerts, a usage and cost dashboard with spending alerts, chat export to Markdown and PDF, accessibility options, smarter saved prompts, settings sync, a Ctrl+K quick switcher, and 19 languages.

Zero npm dependencies. Your settings stay on your machine unless you turn on sync.

Install

From the app: open DSH → sidebar Plugins → Add plugin → enter

github:IRdotAI/dsh-studio

From a terminal:

npx @deepseek-ai/dsh plugin --profile web add github:IRdotAI/dsh-studio

Then restart dsh web. A Studio entry appears in the sidebar. Requires DSH 0.2 (tested with 0.2.0-rc.2), the web profile, and Node 22.5+. pnpm must be on your PATH for plugin installs (npm install -g pnpm).

Already on 1.3 or later? Studio offers the update itself (Studio → Updates).

To remove it, use Uninstall on its Plugins page entry.

Using it

• Studio in the sidebar has everything, in tabs. Pick your language in the top-right corner (Automatic follows your browser, or DSH itself when it's set to Chinese).
• Ctrl+K (Cmd+K on macOS) opens the quick switcher anywhere: themes (arrow through them to preview live; Esc puts yours back), your looks, AI modes, light/dark, text size, chat width, focus mode, ambience, saved prompts, alerts, chat export, backup, updates and every Studio page.
• In the composer, type /theme, /ai, /transcript, /prompts, /focus or /studio, or click the ✦ button beside the input for saved prompts.

Features

Updates

Studio updates itself from this repo's releases:

• When a new version is out, a banner at the top of Studio (and a dot on its sidebar icon) offers Update now, Turn on auto-updates and What's new.
• Studio → Updates lists every release. Update to a newer one, Reinstall the current one, or Downgrade to an older one if a new version gives you trouble.
• With auto-updates on, Studio checks GitHub every 6 hours and installs new versions by itself.
• Installs go through DeepSeek Harness's own plugin manager (the same as Plugins → Add plugin). A new version only runs in a fresh harness, so Studio then restarts DeepSeek Harness by itself: straight away for an update you start, and once no task is running for an automatic one. Open windows pick up the new version on their own. The restart reuses the exact command the harness was started with, on the same terminal or log, so Ctrl+C (or the app that started it) still stops it. Turn it off under Studio → Updates → Restart DeepSeek Harness by itself after an update; a harness started some other way than the dsh command needs a manual restart, and the Updates page says so.
• Your settings are backed up before every install (~/.dsh/studio/studio.backup-*.json, newest five kept).
• Downgrading switches auto-updates off, so Studio doesn't jump straight back.
• Versions before 1.3.0 don't have the Updates page; to come back from one, use Plugins → Add plugin → github:IRdotAI/dsh-studio again.

One-click updates need Studio to have been installed from GitHub. A copy linked from a local folder (a developer install) says so on the Updates page and updates from that folder instead.

Privacy

• Settings live in ~/.dsh/studio/studio.json (or $DSH_HOME/studio/studio.json), uploaded images included. Usage records live next to them in usage.json and never leave your machine.
• Sync is off until you add a GitHub token. The token is kept in ~/.dsh/studio/github-token (readable only by you), is never sent to the browser, and is only used to talk to GitHub. Backups go to a private gist on your account.
• Check balance sends your existing DeepSeek API key to DeepSeek's own balance endpoint, and only when you press it.
• The Gallery tab downloads the theme and prompt-pack list from this repository on GitHub.
• AI preferences (and modes) are only added to the model's system prompt while you have them switched on.
• A wallpaper set by URL is fetched by your browser from that URL. Uploads, slideshow folders, video files and the desktop wallpaper never leave your machine.
• Bing daily downloads the picture of the day from bing.com once a day and keeps the last three in ~/.dsh/studio/bing/.
• Sunrise and sunset use a location you type or allow once; it is rounded to about 10 km and stored only in your settings. The times are worked out on your machine.
• Chat export happens in your browser; nothing is uploaded.

How it works

DSH plugins have a host half (Node) and a browser half (React). Studio's host half stores settings, serves them over authenticated /api/studio/* routes, injects the stylesheet into every page load (so your theme is there from the very first frame), serves the desktop wallpaper and font files, reads the Windows accent colour, records token usage from the llm/stream waterfall, runs the gist sync, and contributes the optional system-prompt section. The browser half renders the UI and updates the stylesheet live.

Theming works by re-deriving DSH's three static colour scales (--dsw-static-neutral-bluish-*, --dsw-static-neutral-*, --dsw-static-deepseek-*). Every alias token points at them, so the whole interface follows while keeping the original contrast ladder.

API

All routes are behind DSH's own browser authentication.

• GET /api/studio/state: settings plus what this machine offers (desktop wallpaper, served fonts, Windows accent)
• POST /api/studio/patch: partial update (objects merge, arrays replace)
• POST /api/studio/replace: whole-settings import
• POST /api/studio/reset with {"confirm":"reset-studio"}
• GET /api/studio/desktop-wallpaper: the current Windows wallpaper
• GET /api/studio/bing-wallpaper: today's Bing picture (downloaded once a day)
• GET /api/studio/wallpaper-file?i=<n>: one image from the slideshow folder
• GET /api/studio/video-wallpaper: the video wallpaper file (supports Range)
• GET /api/studio/export?session=<id>: one chat's messages, for export
• GET /api/studio/font?f=<file>: a file from the configured font folder (only files in that folder are served)
• GET /api/studio/updates: version, releases and update status; POST it {"action":"check"}, {"action":"install","version":"x.y.z"} or {"action":"restart"}
• GET /api/studio/usage: usage totals and recent calls; POST it {"action":"clear"} or {"action":"balance"}
• GET /api/studio/sync: sync status; POST it {"action":"set-token","token":"…"}, clear-token, push or pull
• GET /api/studio/gallery: the community gallery (cached for an hour); POST to refresh
• GET /api/studio/locale?lang=<code>: one language's interface text

Development

git clone https://github.com/IRdotAI/dsh-studio
cd dsh-studio
node scripts/build.mjs           # rebuild lib/client.js
node test/selftest.mjs           # 41 checks
node scripts/check-locales.mjs   # every language has every string
node scripts/build-gallery.mjs   # validate gallery themes and prompt packs, rebuild gallery/index.json
npx @deepseek-ai/dsh plugin --profile web add "$PWD"   # install your local copy

Restart dsh web after changing anything under lib/ (host modules are cached).

Adding a language: add it to LANGUAGES in lib/shared.js, copy locales/en.json to locales/<code>.json, translate the values (keep every {placeholder}), and run node scripts/check-locales.mjs.

DSH plugin pitfalls worth knowing:

• connection.fetch.register paths must be the full path starting with /api/; anything else throws "invalid exact Fetch route".
• Exact routes are keyed by path alone, so GET and POST on one path must be one route with methods: ["GET", "POST"].
• A requestBody: "streaming" route cannot serve GET (the bridge always attaches a body). Keep reads buffered.
• A host-injected <style> using html:root body selectors outranks DSH's token sheets and also covers the first paint.
• DSH portals its menus to <body> and positions them from on-screen rectangles, so scale the app with zoom on #root, never on <html>.
• A plugin slash command with the same name as a host command (/export, /plan, /goal, …) makes the whole / menu fail. Host rows also rank first, so a name that is the start of a host command (/mode vs /model) can never be picked with Enter. Studio checks the host's commands before offering each of its own.

Credits

Made by RdotA. Theme palettes adapted from Dracula, Nord, Catppuccin, Gruvbox, Solarized, Tokyo Night and Rosé Pine. Full credits, with links, are in CREDITS.md and in the app under Studio → Credits.

Licence

MIT