TQSY114514/dsh-ui-appearance
31Last commit Aug 15, 2026
dsh-ui-appearance DSH plugin
dsh-ui-appearance is a plugin for DeepSeek Harness that lets you freely customize the WebUI appearance. It provides a theme color palette with 6 color roles, wallpaper and video background support, frosted glass and semi-transparency effects, and a backdrop ambiance system. All changes are previewed in real-time and automatically persisted to localStorage.
How to install the dsh-ui-appearance DSH plugin
dsh plugin --profile <name> add dsh-ui-appearanceThis source command needs manual review. Copying does not run it.
dsh-ui-appearance DSH plugin data source
dsh-ui-appearance DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-ui-appearance DSH plugin can do
- Customize 6 color roles (primary, background, panel, input, text, border) with color picker and HEX input, with automatic focus ring and message bubble following primary color.
- Upload or drag-and-drop images (JPG/PNG/WebP) or paste image/video URLs for wallpaper; supports video backgrounds (MP4/WebM) stored in IndexedDB.
- Adjust panel opacity, frosted glass intensity, and backdrop ambiance (opacity, blur, mask) with independent sliders, all affecting sidebar, settings panel, chat area, task panel, cards, and buttons.
- Apply 6 preset themes (Default, Midnight, Ocean, Forest, Rose, Monochrome) and freely tweak after applying without being locked.
- Export and import color schemes as JSON text for sharing with others.
- Automatic brightness sampling on uploaded wallpaper: dark wallpapers trigger coordinated surface brightening and text lightening to maintain readability.
Where the dsh-ui-appearance DSH plugin fits
- Customize the DeepSeek Harness WebUI to match your personal aesthetic or brand colors.
- Use a favorite image or video as a live wallpaper behind the chat interface.
- Create a frosted glass effect for a modern, translucent UI look.
- Quickly switch between preset themes for different moods or working environments.
- Share your color scheme with friends or colleagues by exporting and importing JSON.
Who the dsh-ui-appearance DSH plugin is for
- DeepSeek Harness users who want to personalize the appearance of their WebUI.
- Developers or designers using DeepSeek Harness who need a consistent visual theme for their workflow.
dsh-ui-appearance DSH plugin limitations
- Settings are stored in browser localStorage; they are tied to the specific browser and will be lost if site data is cleared or if you switch browsers.
- Image compression budget is 2 MB with an input limit of 5 MB; wallpaper is stored as a compressed data URL, subject to localStorage quota.
- Video background supports only H.264 (MP4) and VP8/VP9 (WebM) encodings; unsupported codecs like HEVC will fall back to wallpaper.
- Syntax highlighting text colors (shiki tokens) are independent and not affected by the primary color, consistent with IDE conventions.
dsh-ui-appearance DSH plugin: from the repository README
Quoted from the TQSY114514/dsh-ui-appearance README, the upstream source of the dsh-ui-appearance DSH plugin. Copyright remains with the original authors.
DeepSeek Harness 外观自定义插件 —— 自由调色的主题色板、壁纸/视频背景、毛玻璃与背景氛围,全部实时预览、自动持久化。 [](https://www.npmjs.com/package/dsh-ui-appearance) [](https://github.com/TQSY114514/dsh-ui-appearance/actions) [](https://github.com/TQSY114514/dsh-ui-appearance/releases) > 零核心代码改动:完全通过官方插件机制(`ctx.theme.overrideTokens()` 主题扩展点与 `settings.general.item` 插槽)实现;卸载后界面完整恢复默认。 <!-- 演示:将录屏放入 docs/demo.gif 并替换此行  --> ## 界面 | 设置面板 | 壁纸 + 毛玻璃效果 | |---|---| |  |  | > 效果图中的壁纸素材 © MadYY([原图](docs/wallpaper-madYY.png)),仅作演示;用户上传自己的图片即可。 ## 功能 **主题颜色** —— 6 个颜色角色:主色、背景色、面板色、输入框色、文字色、边框色。每个角色都支持取色器与 HEX 输入;文字选区与键盘焦点环自动跟随主色;消息气泡跟随主色(半透明时保留主色相)。 **壁纸背景** —— 点击上传或拖拽图片(JPG / PNG / WebP),或**粘贴图片/视频 URL 一键加载**(按扩展名自动分流,支持 CORS 友好的图床/视频直链),自动压缩后作为全界面壁纸;上传时自动采样亮度,深色壁纸会协调抬亮表面、翻亮文字、按钮跟随变暗,保证可读性。也支持**视频背景**(MP4 / WebM,静音循环,与图片互斥),视频存入 IndexedDB,不占用 localStorage 配额。 **毛玻璃与半透明** —— 面板不透明度与毛玻璃强度两个滑块,让侧边栏、设置面板、聊天区、任
Read the full READMERepository license: MIT
dsh-ui-appearance DSH plugin questions
How do I install dsh-ui-appearance?
Run the command `dsh plugin --profile <name> add dsh-ui-appearance` in your terminal. You can also install from source by cloning the repo and using `dsh plugin --profile <name> add file:<path>`. To update, simply re-run the `add` command.
Will my settings be lost after I uninstall the plugin?
No, the plugin automatically cleans up all overrides, style sheets, and background layers when removed. Your settings are stored in localStorage under the key `dsh-ui-appearance.settings`, but they are not automatically restored if you reinstall. However, if you uninstall, the interface returns to default immediately.
Can I use a video as a background?
Yes, you can upload or paste a URL for a video in MP4 or WebM format. The video will play in a loop without sound. It is stored in IndexedDB, not localStorage, to avoid quota issues. Unsupported codecs like HEVC will fall back to the wallpaper.
Why does the syntax highlighting color not change with the primary color?
Syntax highlighting colors (shiki tokens) are intentionally independent of the theme color to maintain readability and consistency with IDE conventions. The plugin does not override them.
How do I share my color scheme with someone else?
Open the settings panel, go to the 'Color Scheme' section, click 'Export', and the JSON text will be copied to your clipboard. The other person can click 'Import' and paste the JSON to apply the same scheme.