dsh-skin

🖼 使用

打开 设置 → 背景壁纸：

分区	你可以做什么
图片来源	在「图床链接 / 本地图片 / Wallpaper Engine」之间切换；三选一，切换后立即重新加载。
图床链接	粘贴直链、开关本地缓存、指定缓存目录。
本地图片	添加文件或目录、点「选择文件夹」批量导入、在缩略图里点选或删除单张。
Wallpaper Engine	填创意工坊目录并「重新扫描」。
外观	背景图透明度、界面不透明度、模糊程度。
播放	轮播间隔、随机播放、淡入淡出时长、视频播完自动切换、视频默认静音。
控制	上一张 / 下一张 / 暂停轮播，以及当前播放进度。

小提示：

• 「界面不透明度」调到 100 时界面完全不透明，壁纸只在边缘透出来；调到 40~70 最好看。设置弹窗始终保持不透明，不影响阅读。
• 图床地址每次请求可能返回不同的图片，所以图床来源按顺序轮播，随机播放只对本地图片和 Wallpaper Engine 库生效。
• 视频不循环、播完切下一张时，轮播间隔对视频不生效，由视频时长决定。

⚙️ 配置项

设置保存在 $DSH_HOME/data/dsh-skin/config.json，也可以直接改这个文件（改完重启 DSH 或打开设置页保存一次）。

字段	默认值	范围 / 取值	说明
enabled	true	布尔	关闭后立即移除壁纸层。
source	"urls"	urls / local / wallpaper	当前使用的来源。
urls	[]	最多 100 条	图床直链。
folders	[]	最多 50 条	本地图片 / 视频目录。
files	[]	最多 200 条	本地单个媒体文件。
hidden	[]	最多 1000 条	已隐藏（删除）的条目。
cacheUrls	true	布尔	是否把图床图片缓存到本地。
cacheDir	""	路径	缓存目录，留空用 $DSH_HOME/data/dsh-skin/library。
wallpaperDir	""	路径	Wallpaper Engine 创意工坊目录。
opacity	100	0–100	壁纸本身的透明度。
surfaceOpacity	62	0–100	主界面面板的不透明度，越低壁纸越明显。
blur	0	0–80	壁纸的高斯模糊（像素）。
intervalSec	30	3–86400	轮播间隔（秒）。
random	false	布尔	随机播放。
advanceOnEnd	true	布尔	视频播完自动切下一张。
videoMuted	true	布尔	视频默认静音（被浏览器拦截自动播放时会自动回退静音）。
fadeSec	1.2	0–5	两张壁纸交叉淡入淡出时长（秒）。

支持的格式：图片 png jpg jpeg jfif webp gif avif bmp svg，视频 mp4 webm ogv mov m4v。