dsh-plugin-background-image
DeepSeek Harness 界面背景图片插件：网络/本地图片与预设渐变背景，支持图片不透明度、沉浸式全屏/仅对话区域、毛玻璃模糊与分区不透明度调节。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-background-image@1.2.2Plugin Background Image 以 dsh-plugin-background-image 发布，当前版本为 1.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 简体中文
A background image plugin for DeepSeek Harness (DSH): set a web image, local image, or preset gradient as the interface background, with image opacity, display scope, frosted-glass blur, per-region opacity, and chat-content offset for a more immersive interface.
http(s)://), local images (absolute paths), and data:image/ data URLssettings.yaml and are restored automatically after a page refresh or a DSH restartDSH background image plugin demo DSH background image plugin demo DSH background image plugin demo
npx @deepseek-ai/dsh plugin --profile <profile> add \
dsh-plugin-background-image@file:/path/to/background-image-plugin
For example:
npx @deepseek-ai/dsh plugin --profile web add \
dsh-plugin-background-image@file:/Users/your-name/projects/background-image-plugin
npx @deepseek-ai/dsh plugin --profile <profile> add dsh-plugin-background-image
Start DSH with the same profile after installation and the plugin will load.
The background toggle, display scope, image opacity, frosted glass, per-region opacity, and chat content offset are persisted by the DSH settings system into the config directory (default ~/.dsh/settings.yaml), like this:
background-image:
enabled: true
mode: fullscreen
opacity: 0.9
image: https://example.com/background.webp
blur: 12 # frosted-glass blur strength (px, sidebar & composer card, 0 = off)
conversationBlur: 0 # independent conversation blur (0–48 px)
conversationOpacity: 0 # conversation opacity (0–1, both display modes)
saturation: 1.4 # glass color saturation (1 = as-is, >1 = more vivid)
sidebarOpacity: 0.5 # sidebar opacity (fullscreen mode only, via the pseudo-element glass)
composerOpacity: 0.72 # composer opacity
contentOffset: 120 # chat content horizontal offset (px, positive = right, negative = left, 0 = centered)
background-image:
enabled: true
mode: fullscreen
opacity: 0.9
image: /Users/you/Pictures/background.png
blur: 0
conversationBlur: 0 # independent conversation blur (0–48 px)
conversationOpacity: 0 # conversation opacity (0–1, both display modes)
saturation: 1
sidebarOpacity: 0.5
composerOpacity: 0.72
contentOffset: 0
Browsers cannot load
file://resources directly due to security policies, so the plugin registers a read-only file-serving route on the host (GET /plugins/background-image/file?path=<absolute-path>) that serves the local image referenced by the configuration to the page over same-origin http. The route only accepts loopback origins and only serves the exact path currently referenced by theimagefield in settings.yaml ("reference-as-authorization", the same model as the officialsession.attachment). If the image file is moved or deleted, the background stops working and the path must be set again.
@deepseek-ai/schemastery: host-side settings schema definition and validation.react (peer, optional): client-side settings panel UI.node:child_process, node:fs/promises, node:path."Choose Local Image" invokes the native system file dialog, which depends on the following commands per platform:
| Platform | Required command |
|---|---|
| macOS | osascript (bundled with the system) |
| Linux | zenity or kdialog (either one is enough) |
| Windows | powershell |
When none of these is available, you can still type the local absolute path manually.
This plugin works by overriding DSH theme tokens and injecting CSS, which changes the global interface appearance. Keep the following in mind:
--dsw-alias-bg-base: every interface region referencing this token will show the background image. The plugin forces known panels/buttons back to surface colors (--dsw-alias-bg-layer-2) via CSS, but elements added by future DSH updates that reference the token may need follow-up rules..pI_x6G_frame, .wSkVaW_root, .ydkMvW_root, .hHd-Xa_root, .pI_x6G_sidebarCol, .uV2eYG_card, .wSkVaW_composerSeat, .wSkVaW_viewArea, and .wSkVaW_composerHero. If a DSH update renames them, the corresponding effects break or misalign..pI_x6G_sidebarCol::before pseudo-element (an absolutely positioned overlay carrying the translucent fill and backdrop-filter). This way backdrop-filter lands on a pseudo-element without fixed descendants, so the sidebar ancestor never becomes the containing block for fixed descendants — the position: fixed settings overlay (.VOzbGW_overlay) is not trapped inside the sidebar. The approach still depends on internal class names such as .pI_x6G_sidebarCol and .hHd-Xa_root; if a DSH update renames them, the sidebar glass breaks or misaligns.!important overrides.Update to the latest version:
npx @deepseek-ai/dsh plugin --profile <profile> add dsh-plugin-background-image@latest
Uninstall the plugin:
npx @deepseek-ai/dsh plugin --profile <profile> remove dsh-plugin-background-image
