dsh-scenery
适用于 DeepSeek Harness 工作区的 Capy 风格环境背景：选择一张图片，然后插件将其与底部超大的黑色渐变及编辑器周围柔和的径向“光晕”组合，使界面看起来像是置于场景之中。仅添加视觉效果——现有界面、布局和行为保持不变。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wbaws/dsh-scenery#b927ca5d703a066e6a835f5ac57b0b2f2ba52eb7Scenery 以 dsh-scenery 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Capy-style ambient background for the DeepSeek Harness (DSH) workspace — an image, a very large bottom black gradient, and a soft radial “aura” around the composer, so the UI looks like it is sitting inside the scene instead of floating on a flat colour.
Additive only. This plugin adds one click-through layer behind the conversation column. It does not redesign anything, does not touch the layout of existing components, and — unless you flip the switch — changes absolutely nothing about the way DSH looks or behaves.
| Scenery on — semi-full scene | Scenery on — barely there |
|---|---|
| scenery on | scenery barely there |
Screenshots above show the effect live in DSH. Crank the opacity up and the image, bottom gradient and composer aura sit clearly behind the conversation; dial it right down and you get just a whisper of atmosphere — enough to make the workspace feel alive without stealing focus while you work. Every setting is live-previewable: the bundled standalone page (
preview/index.html) renders the exact same compositing math in any browser, so you can tune a look here before it goes anywhere near your real setup.
Layering (bottom → top):
① your image (fit / pan / zoom / blur / opacity)
② large bottom black gradient (soft, no bands; grows gradually, the last
~20–30% approaches black)
③ radial “aura” around the composer (very soft ellipse, black centre fading
to nothing — no visible edge)
④ existing DSH UI (completely untouched)
The aura tracks the real composer seat inside the conversation column (sticky bottom bar), so it stays glued to the input area as you resize the window or drag columns.
| Setting | Meaning |
|---|---|
| Enable | master switch — off by default |
| Image | upload a local picture (PUT to the host, stored under your DSH home) or paste an http(s) image URL |
| Fit | cover (crop-to-fill) / contain / fill |
| Position X/Y | object-position pan, % |
| Zoom | extra scale, 0.5×–3× |
| Overall opacity | dims image + overlays together toward the app surface |
| Bottom gradient strength | peak blackness of the big bottom gradient |
| Bottom gradient height | how much of the stage the gradient spans (from the bottom) |
| Aura strength | blackness of the composer aura |
| Aura size | ellipse radii multiplier |
| Aura offset X/Y | fine-tune aura centre relative to the auto-tracked composer |
| Image blur | gaussian blur of the image only — UI text stays crisp |
Every control previews live; Save persists to the host. There is also a Reset (restores defaults and clears the current image) — it asks once before it commits.
Persistence: ~/.dsh/dsh-scenery/config.json (+ uploaded wallpaper.* file,
or $DSH_HOME/dsh-scenery/ when DSH_HOME is set). A localStorage mirror
makes the background apply instantly on page load before the config round
trip.
Published on npm as dsh-scenery (this repo).
# official CLI (any profile)
dsh plugin --profile desktop add dsh-scenery
# or from the in-app plugin market (dshmarket → search "scenery")
# or straight from this repo:
dsh plugin --profile desktop add dsh-scenery@github:wbaws/dsh-scenery
Restart / reload DSH, open Settings → Scenery background, pick an image, flip Enable. Done. (No code from Capy is used — only the general visual technique, re-implemented in plain CSS.)
Client half (lib/client.js, served at /plugins/dsh-scenery/client.js):
[data-slot="conversation"] (no hard-coded class names).z-index:-1, pointer-events:none,
aria-hidden stage as the first child of the conversation host. The host is
made its own stacking context (isolation:isolate), so the stage paints
above the host's flat background colour but under every message and
panel. Nothing else in the app is modified.<img> (fit/pan/zoom/blur) plus a scrim div whose
background stacks the aura radial-gradient over the bottom
linear-gradient. Both gradients are generated from the settings with many
interpolation stops → smooth falloff, no banding.ResizeObserver + window resize keep geometry fresh; the composer seat is
found by scanning for the sticky-bottom element inside the conversation
host (cached, cheap).Host half (lib/index.js, Cordis plugin scenery): a small fenced route
prefix /dsh-scenery-bg that persists config and wallpaper bytes
(GET/PUT/DELETE config, PUT/GET wallpaper). Zero platform peer deps — plain
Node builtins only, path-traversal-safe.
Settings UI: registers one section into the official
settings.section slot (id scenery-config), styled with the DSH alias
tokens so it follows the active theme.
npm run build # concatenates src/client/* -> lib/client.js + syntax checks
npm run check
# interactive visual tuning:
# open preview/index.html in a browser (uses window.SceneryCore from lib/client.js)
Layout:
lib/index.js host half (Cordis plugin: persistence routes)
lib/client.js built client bundle (do not edit)
src/client/00-defs.js defaults / sanitizers / i18n
src/client/01-composite.js pure gradient + aura math (shared with preview)
src/client/02-runtime.js DOM engine (stage, tracking, modes)
src/client/03-settings-ui.js settings section
src/client/04-entry.js module-loader entry + window.SceneryCore
preview/index.html standalone preview / tuning page
Targets the official DSH web client (works in the DSH Desktop app window and
the web GUI). Requires a DSH profile with the client plugin system (same base
as dsh-pet, dsh-better-sidebar, etc.). If you find an incompatibility,
please open an issue with your DSH version.
MIT. “Capy” styling is used purely as a visual reference; this is an independent, from-scratch implementation of the general gradient technique.