dsh-thirteen-bg

Animated and video live wallpaper for the DeepSeek Harness Web GUI — GIF, animated WebP/APNG and static PNG/JPEG images, plus MP4/WebM video backgrounds, with auto format detection, a dim slider, and UI chrome tone matching.

latest

Source

npm

Version: 0.5.2

Version published: last week

Maintainers: 1

Created: last week

Source

dsh-thirteen-bg

DeepSeek Harness Web GUI 动态背景插件（live wallpaper），by 十三 / thirteen。

支持 GIF / 动图 WebP / APNG / 静态 PNG / JPG 图片，以及 MP4 / WebM / MOV 视频背景—— 格式自动识别：上传或填 URL 时按扩展名/MIME 判断，视频走 <video> 层（静音循环、硬件加速、切后台自动暂停），图片走 CSS background-image。纯客户端插件，设置存于浏览器 localStorage，上传文件存 IndexedDB（不限大小）。

Demo

15 秒实拍：DeepSeek Harness Web 界面 + 动态背景效果。

📹 无法播放？点此直接打开 demo.mp4

安装

dsh plugin --profile web add <本目录的绝对路径>
# 例如（本地路径安装）
dsh plugin --profile web add C:\Users\fhd19\deepseek_harness\dsh-thirteen-bg
# 发布到 npm 后
dsh plugin --profile web add dsh-thirteen-bg

装完后重启 dsh web 生效（或直接刷新浏览器——客户端代码改动刷新即生效）。重启后：

浏览器硬刷新（Ctrl+F5）
「设置」→ 通用 → 找到 动态背景 卡片
上传本地动图/视频（不限大小，存 IndexedDB），或粘贴 http(s) 媒体 URL，调节压暗程度

⚠️ 本地文件路径（如 C:\... 或 file:///...）不能作为 URL 使用——浏览器会拦截。本地媒体请用「上传」按钮；远程媒体才填 URL。

媒体标准

类型	建议
图片（动图）	GIF / 动图 WebP（推荐）/ APNG；长边 ≤ 1920px；8–20 秒无缝循环
图片（静态）	PNG / JPG 均可作高清静态壁纸；长边 ≤ 1920px
视频	MP4（H.264）或 WebM（VP9）；1080p 足够；10–60 秒（`loop` 自动循环，无需首尾无缝）
通用	深色/低饱和为主（背景后有文字，插件自带「压暗」滑块）；体积建议 ≤ 几十 MB 保证流畅

压缩工具

动图：ffmpeg ffmpeg -i in.mp4 -vf "scale=1920:-1,fps=15,format=rgba" -loop 0 out.webp；Squoosh
视频：ffmpeg ffmpeg -i in.mov -vf "scale=1920:-1" -c:v libx264 -crf 23 -an out.mp4

与其它皮肤插件共存

背景层是真实元素（position:fixed; z-index:-1 的 div / video），挂在 <html> 下，不占用 html::before/::after 伪元素，因此与 dsh-client-ui-skins、dsh-dream-skin 等用伪元素做背景的皮肤零冲突：本插件层按 DOM 顺序绘制在皮肤层之上，动态背景始终可见；关闭本插件即恢复静态皮肤。