@jonahwu/dsh-bg-carousel

使用说明

打开面板

侧边栏底部有「背景」入口，点击后打开控制面板。面板打开时会自动加载当前目录的媒体清单。

配置媒体目录

面板顶部输入框填写本地目录，支持绝对路径与工作区相对路径；点击「选择」调起宿主原生目录选择器（Windows 为系统文件夹对话框），选中即填入并自动保存生效。「保存」立即重新扫描，「默认」恢复自动探测（工作区 backgrounds 目录）。目录不存在、无法读取或没有受支持的文件时，面板显示原因；配置目录不可用时回退默认目录，轮播照常。「打开文件夹」由宿主在系统文件管理器中打开当前目录。

轮换与排序

自动轮播按设定间隔切换到下一个媒体。间隔短于视频时长时，插件截断当前视频并切换下一个；间隔长于时长时，视频自然播完后立即切换；视频卡死时由定时器兜底推进。拖拽缩略图可调整顺序，顺序立即生效并持久化，新增文件按字母序排在末尾。

视频播放

视频静音、自动播放，以 cover 方式铺满视口，表面叠一层随主题取色的压暗渐变。环境限制自动播放时停在首帧，定时器照常推进。无法解码的文件自动跳过，浏览器控制台记录原因；全部媒体失败时暂停轮播并在面板提示。

格式兼容性

HLS 由 Safari 原生支持；FLV 需要 MSE 类扩展（如 flv.js）。Chromium 环境下这两类文件自动跳过，轮播继续。MOV 能否播放取决于容器内编码，H.264 编码通常可以播放。

配置媒体目录

面板顶部输入框填写本地目录，支持绝对路径与工作区相对路径；点击「选择」调起宿主原生目录选择器（Windows 为系统文件夹对话框），选中即填入并自动保存生效。「保存」立即重新扫描，「默认」恢复自动探测（工作区 backgrounds 目录）。目录不存在、无法读取或没有受支持的文件时，面板显示原因；配置目录不可用时回退默认目录，轮播照常。「打开文件夹」由宿主在系统文件管理器中打开当前目录。

使用

1. 把图片和视频复制到媒体目录（默认工作区 backgrounds，可在面板里修改）
2. 点击侧边栏底部「背景」打开面板
3. 点击缩略图切换背景，拖拽缩略图排序，勾选「自动轮播」按设定间隔循环，「面板不透明」滑杆调整界面透明度