Skip to content
  • Home
  • Plugin manual
  • dsh-bg-beautify

halosb/dsh-bg-beautify

30Last commit Aug 15, 2026

dsh-bg-beautify DSH plugin

dsh-bg-beautify adds a background image and makes panels translucent in the DeepSeek Harness Web UI. It includes a settings page for real-time adjustments and persists configuration via its own config.json. The plugin requires no source code modifications or frontend rebuilds.

ui-productivity

How to install the dsh-bg-beautify DSH plugin

dsh plugin --profile web add github:halosb/dsh-bg-beautify

Copying does not run this command. Review the repository and version before installing the dsh-bg-beautify DSH plugin.

dsh-bg-beautify DSH plugin data source

dsh-bg-beautify DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-bg-beautify DSH plugin can do

  • Set background image via URL, upload, or plugin-served assets
  • Adjust opacity of main area, sidebar, card overlays, and input area with four sliders
  • Enable input glow effect with customizable color, speed, cross-color, and intensity
  • Persist all settings to plugin's own config.json, survive restarts
  • Override text color (white/black/auto) and add a scrim for better contrast
  • Replace favicon, welcome text, and browser title suffix

Where the dsh-bg-beautify DSH plugin fits

  • Personalize the DeepSeek Harness Web UI appearance with a custom background image
  • Reduce visual clutter by making panels more transparent to see the background
  • Apply a branded look by setting a company logo as favicon and custom welcome text
  • Enhance input field visibility with a subtle breathing glow effect
  • Quickly switch between light and dark themes while maintaining consistent transparency

Who the dsh-bg-beautify DSH plugin is for

  • DeepSeek Harness users who want to customize the web UI's look and feel
  • Developers or operators deploying DeepSeek Harness who want a branded, polished interface

dsh-bg-beautify DSH plugin limitations

  • Only works with DeepSeek Harness Web UI (not CLI or other interfaces)
  • Requires restart of dsh web after installation for client bundle to load
  • Background image upload only supports common image formats (jpg, png, gif, webp, avif, svg)
  • Cannot modify the loading screen text (handled by the shell)

dsh-bg-beautify DSH plugin: from the repository README

Quoted from the halosb/dsh-bg-beautify README, the upstream source of the dsh-bg-beautify DSH plugin. Copyright remains with the original authors.

> 给 DeepSeek Harness Web UI 加背景图 + 面板半透明的美化插件，带设置页实时调节。 > A background-image & translucent-panels beautifier for the DeepSeek Harness Web UI, with a live settings page. 以官方插件机制安装，**不修改任何 DSH 源码**（`apps/web`、`packages/client` 一概不动），也**不需要重新构建前端**。 ## 特性 - 🖼️ **背景图**：支持 `/bg/文件名`（插件内置伺服）、`https://` 外链、`data:` URI - 📤 **本地图片上传**：设置页直接选文件，自动存入插件 `assets/` 并填入 `/bg/文件名` - 🎚️ **四个透明度滑块**：主区 / 侧边栏 / 卡片浮层 / 输入区（0 全透 ～ 1 不透），即时生效 - 💫 **输入框呼吸光晕**（v0.2.1）：输入框外圈**均匀弥散软光匀速呼吸**，光晕背后一层**超大模糊的旋转色晕**——两个颜色按 abab… 环绕分布、柔和流转（无任何灯带/环/线条），并随光晕一起变色；**颜色 / 速度 / 交叉色 / 强度(0~2)**可调；尊重系统"减少动态效果" - 📐 尺寸 / 位置 / 背景固定选项；亮色、暗色主题各一套 - 💾 **持久化**：设置写入插件自己的 `config.json`，重启不丢；不依赖宿主设置服务的白名单 - 🎨 设置分区 UI 完全对齐 DSH 内置设置页的设计语言（胶囊按钮、h32 字段、主题 token） - 🔒 仅监听回环地址（127.0.0.1）；上传文件名白名单 + 路径穿越防护 ## 效果预览 ![示例图 1](docs/screenshots/demo-1.png) ![示例图 2](docs/screenshots/demo-2.png) ## 工作原理（30 秒） 1. 本插件是一个 DSH **组合包（bundle）**：`package.json` 声明 `dsh.bundle`（贡献一行组合配置）+ `dsh.client`（声明浏览器端 bundle）。 2. 安装进 profile 后，loader 挂载 `bg-beautify` 行；`dsh-client-modules` 把 `/plugins/dsh-bg-beautify/client.js` 编入 `window.__DSH_BOOT__` 引导图，浏览器端运行时加载——**无需构建前端**。 3. 浏览器端 `apply()`：注入 `<style>` 设背景图 + 用官方主题接口 `ctx.theme.overrideTokens(

Read the full READMERepository license: MIT

dsh-bg-beautify DSH plugin questions

How do I install dsh-bg-beautify?

You can install it via the DSH CLI command: `dsh plugin --profile web add github:halosb/dsh-bg-beautify`. After installation, you must restart `dsh web` for the plugin to load. You can also install from a local directory or using pnpm in a source environment.

Why is the background image not showing?

First, ensure you have restarted `dsh web` after installing the plugin. Then try a hard refresh (Ctrl+F5) in your browser. If using a local file via `/bg/filename`, check that the filename casing matches exactly and the file is placed in the `assets/` directory. Only supported formats (jpg, png, gif, webp, avif, svg) work.

Can I use an external URL as background?

Yes, you can enter any `https://` URL in the background image field. The plugin also supports `data:` URIs. For local images, you can upload them via the settings page, which automatically copies them to the plugin's `assets/` folder and sets the path to `/bg/filename`.

How do I reset the opacity settings without losing my background image?

Click the 'Restore Default' button in the settings page. This resets only the four opacity sliders to their factory values (0.25, 0.5, 0.7, 0.75) and leaves the background image and display options unchanged.

Why does the input glow effect not appear?

The input glow effect was introduced in v0.2.1. Make sure you have the latest version installed. If options are missing, restart `dsh web` to reload the client bundle. Also check that the 'Reduce motion' system setting is not enabled, as the plugin respects that.