Skip to content

dsh-sidebar-wallpaper

Verified

dsh-sidebar-wallpaper · v0.1.5 · MIT · Web UI

Play a local Wallpaper Engine wallpaper inside a tile pinned to the DSH left sidebar; the tile is as wide as the sidebar and follows its width while you drag. Self-contained: scans Wallpaper Engine by itself and renders Video, Scene (.pkg) and Web wallpap

Install

dsh plugin add dsh-sidebar-wallpaper

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

侧栏壁纸

npm version license DSH platform

English

在 DeepSeek Harness 左侧边栏的底部,开一格会动的壁纸。

它直接读取你电脑上 Wallpaper Engine 里已经订阅、已经下好的壁纸 —— 视频、场景、网页都行。旁边还能放你自己下载的视频和图片。

装好就能用:不需要 Wallpaper Engine 开着,也不需要装别的壁纸插件。


预览

侧栏底部的一格 —— 宽度跟着侧栏走,高度默认 9/16:

壁纸方格在侧栏底部

也可以放到侧栏顶部:

壁纸方格在侧栏顶部

单独看这一格(示例是 Wallpaper Engine 里的车模场景):

壁纸方格特写


为什么做它

其他联动 Wallpaper Engine 的插件,壁纸常挂在显眼的地方,有时会被周围的人看见;可壁纸又想欣赏 —— 有些确实不便大屏展示。

所以做了这个插件:把壁纸缩进侧栏一格,安静地放在自己视野里。功能不算多,说它鸡肋也不算冤。


安装

方式一:npm(推荐)

在 DSH 的设置 → 插件里点「安装」,把包名填进去:

dsh-sidebar-wallpaper

也可以指定版本:[email protected]。

方式二:GitHub

同样在「设置 → 插件 → 安装」里填:

github:kandsome1/dsh-sidebar-wallpaper

想固定在某个发布版本:github:kandsome1/dsh-sidebar-wallpaper#v0.1.0。

方式三:命令行

在 DSH 内置终端里执行(侧栏的终端面板,打开时会显示 DSH Desktop … terminal):

dsh plugin --profile desktop add dsh-sidebar-wallpaper

卸载同理:

dsh plugin --profile desktop remove dsh-sidebar-wallpaper

装完要重启 DSH Desktop(终端欢迎信息里的原话:Restart DSH Desktop after plugin changes.)。

如果你用 npm 装的 dsh CLI 管理其他 profile(例如 web):

npx @deepseek-ai/dsh plugin --profile web add dsh-sidebar-wallpaper

注意:npm 版的 dsh 会拒绝管理 desktop profile —— 那是 DSH Desktop 独占的,只能用它自己内置终端里的 dsh。

装完

按 Ctrl + Shift + R 硬刷新浏览器。侧栏底部出现壁纸小窗就算好了;插件列表里也能看到「侧栏壁纸」。

更新

插件列表里点更新即可;想指定版本就重新填一次安装源(例如 [email protected])。

卸载

在插件列表里移除,或把它停用。

兼容性

DSH ^0.2.0-rc.1(Desktop 与 Desktop NEXT 都可用)
系统 Windows(通过 Steam 注册表定位 Wallpaper Engine)
没有 Wallpaper Engine 也能用 —— 「我的上传」库可以放自己的视频和图片
面板位置 装在右侧栏标签页里(用 dsh-better-sidebar);没装时会回落到内置的停靠面板

三步开始

1. 点开面板

鼠标移到侧栏底部的小窗上,工具条会出现;点最左边的图片图标(或者侧栏右侧的「侧栏壁纸」标签页)。

2. 挑一张

在「壁纸」页里点任意缩略图,方格立刻换成那张。

3. 调成你喜欢的

圆角、暗化、滤镜、音量、自动轮播都在「设置」页;场景类壁纸还能在「属性」页调作者开放的颜色、开关等。


界面怎么用

那个小窗

  • 宽度跟随侧栏,你拖动侧栏宽度时它会一起变;
  • 高度默认是宽度的 9/16,想换比例去「设置 → 方格」;
  • 侧栏收起来(变成窄条)时,它会自动隐藏,展开后回来;
  • 鼠标移上去才会出现工具条,不碰它的时候是一块干净的壁纸;
  • 鼠标在壁纸里划动时,支持互动的壁纸(场景 / 网页类)会跟着动 —— 视差、跟随光效、点击触发都能用。

工具条从左到右:

按钮 作用
图片 打开「壁纸」页
喇叭 静音 / 取消静音
暂停 / 播放 停一下 / 继续
循环箭头 打开自动轮播(立刻换一张示意)
⚙ 打开「设置」页

面板有四个页面

壁纸 —— 挑壁纸的地方。上面有两个库:

  • 壁纸引擎:你 Wallpaper Engine 里的全部壁纸,可以按 视频 / 场景 / 网页 筛选;
  • 我的上传:你自己传进来的视频和图片,可以按 视频 / 图片 筛选,右边有「+ 上传」。

两个库的筛选各管各的,互不影响。缩略图上:

  • 左上角 + / ✓:把这面壁纸加入(或移出)轮播列表;
  • 右上角 ☆ / ★:收藏,收藏后会变成金色;
  • 上传的壁纸还多一个红色 ×:删除这个文件(磁盘上的文件也会删掉)。

轮播 —— 自动换壁纸的名单。

  • 按顺序列出要轮流播放的壁纸,按住拖动可以换顺序;
  • 「加入当前分类」一次把当前筛选下的壁纸全加进来;「清空列表」清空;
  • 最上面选轮播池用哪一档:列表(就按这个名单轮)、收藏(只轮你收藏的)、全部(所有壁纸随机轮)。

属性 —— 调整当前壁纸自己的可调项。

场景类壁纸通常带一堆作者开放给用户的设置:颜色、亮度、开关、下拉选项、文本。这里会按壁纸原本的样子列出来,改一下画面立刻变,不用重新加载。每张壁纸的设置分别记住。

设置 —— 外观与播放:

分组 能改什么
界面 语言:跟随 DSH(默认)/ 中文 / English
方格 放底部还是顶部、高度比例(16:9 / 16:10 / 4:3 / 方形)、画面怎么填(铺满裁切 / 完整显示 / 拉伸)
外观 圆角、暗化程度、画面滤镜(黑白、复古、暖色、冷色……)
播放 音量、帧率上限、自动轮播间隔(20 秒到 24 小时)、侧栏收起时是否隐藏
配置 导出 / 导入设置(换电脑、备份、误改后恢复)

几件常用的事

只是喜欢某几张,让它一直播

点壁纸右上角 ☆ 收藏 → 去「轮播」页把轮播池切到「收藏」→ 设置里把轮播间隔调成你想要的(比如 5 分钟)。

想按固定顺序播一组

在缩略图左上角点 + 把它们加入轮播列表 → 到「轮播」页拖动排好顺序 → 打开轮播。

想放自己下载的视频或图片

「我的上传」库里点「+ 上传」,选文件即可(支持 mp4 / webm / mov / mkv / png / jpg / webp / gif / avif,单个不超过 512 MB)。传完自动出现在列表里,直接点就能播。

想让声音小一点 / 关掉

工具条上的喇叭,或者「设置 → 播放 → 音量」。

想让它安静点、省点电

「设置 → 播放 → 帧率上限」调到 24 或 15;切到别的标签页或最小化窗口时,插件的渲染会自动停。

换电脑 / 备份设置

「设置 → 配置 → 导出 JSON」存一个文件;到新机器上「导入 JSON」就恢复了(壁纸选择、轮播列表、每张壁纸的属性值都在里面)。


几个常见疑问

换壁纸要等一下? 场景类壁纸要把整包资源装配一遍,通常 1–2 秒。这期间方块会保持上一帧,新的场景出画后才显示,所以不会闪白。

上传的视频放不出画面? 浏览器支持的编码比较挑。mp4(H.264)和 webm 最稳;mov / mkv 里如果是 HEVC 之类,可能只有声音或者干脆报错。遇到这种情况换一个 mp4 版本就行。

方块怎么不见了? 多半是侧栏被收窄了(插件在窄条状态下会自动隐藏),或者你把它拖到了侧栏顶部之外的位置。展开侧栏就会回来。

鼠标在壁纸上划动没反应? 只有「场景」和「网页」类壁纸能接收鼠标 —— 视频和图片本身没有指针这个概念。另外,依赖 Wallpaper Engine 客户端私有功能(比如读取桌面真实鼠标坐标)的壁纸也不会响应,这是引擎能力边界,不是坏掉了。


出问题时

方块左上角会显示状态:正常加载时闪一下就淡出;出错时会留下红字。

更详细的记录在 ~/.dsh-sidebar-wallpaper/diag.log(超过 512 KB 自动轮转成 .1)。

你看到的 原因
video 加载失败(4) 这个视频的编码浏览器不支持(常见于 HEVC),会自动退到壁纸自带的预览图
卡在「加载中」很久然后重载 场景装配失败或太久,插件会自动重试一次;再看一眼日志里最后几行
上传提示 415 文件格式不在白名单里
上传提示 413 文件超过 512 MB
面板里一直是空的 点一下壁纸页的「刷新」,或者确认 Wallpaper Engine 里确实订阅了壁纸
方块跑到了奇怪的位置 / 不见了 先看日志里的 locate ok (geometry); column=256×807 —— 这行说明它把哪一块当成了侧栏。via scroll-container 表示按几何没认出来、退到了可滚动容器的兜底;出现 column not found 则是完全没找到,方块会暂时隐藏,展开侧栏即可恢复

设置存在哪

  • 设置:~/.dsh-sidebar-wallpaper/config.json
  • 你上传的视频和图片:~/.dsh-sidebar-wallpaper/uploads/
  • 运行日志:~/.dsh-sidebar-wallpaper/diag.log

卸载插件不会删这些,想清干净就直接删掉这个文件夹(连同里面的壁纸副本)。


小限制

  • 界面语言默认跟随 DSH 的语言设置(设置 → 通用),也可以在插件「设置 → 界面」里固定成中文或英文;只内置这两种,其他语言回落英文;
  • 自动扫描 Wallpaper Engine 仅 Windows 支持;macOS / Linux 能正常跑,但素材要自己从「我的上传」放进去;
  • 右侧栏标签页依赖可选的 dsh-better-sidebar,没装时用内置的停靠面板,样式会朴素一些。

第三方

  • renderer/engine/webwallgl.global.min.js — WebWallGL(MIT),版权见 renderer/engine/LICENSE-webwallgl.txt。
  • renderer/default-wallpaper/index.html — 渲染失败时的兜底页,取自 dsh-plugin-wallpaper-engine(MIT,elysia395)。
  • Steam 探测思路参考 dsh-plugin-wallpaper-engine(MIT)。

本包同样以 MIT 发布。