前言¶
DeepSeek Harness (DSH) 采用插件化架构，允许开发者通过不同插件扩展功能。wallpaper-engine-dsh 是一个 DSH 插件包，旨在解决在 DSH Web 界面 (dsh web) 中直接使用 Wallpaper Engine 本地壁纸库的需求。
该插件由维护者 Weilv-D 开发，通过将本地 Wallpaper Engine 的项目（视频和网页壁纸）渲染为 Web 界面的背景，替代原本静态或单一的资源。
核心功能¶
壁纸库与搜索
插件启动时会扫描本地 Wallpaper Engine 库，网格列表会展示所有浏览器可渲染的壁纸（视频和网页）。搜索框支持通过标题或 Workshop ID 快速筛选。场景和应用程序壁纸（.pkg）因属于私有格式且无法被浏览器渲染，不会被列出。
智能遮罩
为了确保文字可读性，插件内置了智能遮罩。遮罩颜色会根据 DSH 的深色或浅色主题自动切换（黑色或白色），且会定期采样壁纸亮度。如果壁纸过于明亮或昏暗，遮罩会自动增强，同时增强边框对比度和玻璃磨砂效果。
手动裁剪与调整
提供多种布局选项：封面、包含、拉伸、原始、自由和镜像。
- Fit 行：用于设置基础布局。
- Adjust：进入全屏编辑模式，支持滚轮缩放和拖拽平移。在固定布局下裁剪会被限制以防止露边。
实时调节滑块
提供四项实时调节功能，即时生效并持久保存：
- Blur：模糊程度
- Scrim：遮罩强度
- Borders：边框
- Glass：玻璃磨砂效果
旋转列表
支持创建轮播列表。可以自定义间隔（1-120 分钟）、播放顺序（顺序或随机）。当列表中有至少两个可用壁纸且开启自动旋转时，状态栏会显示运行状态。
资源监控
界面顶部显示实时的 FPS，并在帧率过低时给出提示。支持在标签页隐藏或电量低时自动暂停壁纸播放。prefers-reduced-motion 优先级也会控制视频的初始播放状态。
容错播放
切换壁纸时支持平滑的淡入淡出。如果媒体解码失败，系统会重试一次，随后回退到预览静态图，并在状态栏提示。刷新按钮会重新解析 URL 并恢复播放位置。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add wallpaper-engine-dsh
安装完成后，重启 dsh web，进入 Settings → General → Wallpaper Engine 即可启用。
典型用法¶
- 选择壁纸：在缩略图网格或搜索框中选择壁纸，背景会实时淡入。
- 控制播放：使用暂停/播放控制视频播放，使用关闭按钮淡出背景，使用刷新按钮重新扫描库（新订阅的 Workshop 内容无需刷新页面）。
- 调节混合效果：通过滑块调整模糊、遮罩、边框和玻璃效果，使背景与文字融合更舒适。
- 调整构图：先使用 Fit 行设置布局，再使用 Adjust 功能进行精细的缩放和平移。
- 设置轮播：点击 New 创建列表，从网格或导入 WE 播放列表填充，最后开启 Auto-rotate。
- 查看资源：资源行显示当前 FPS 及自动暂停的开关状态。
注意事项¶
- 不支持的格式：场景和应用程序壁纸（.pkg）由于是私有格式且只能在 Wallpaper Engine 桌面端运行，当前版本无法显示或渲染。
- 权限与来源：插件以 DSH 进程权限运行，安装前建议检查源码与许可证。
总结¶
wallpaper-engine-dsh 通过将 Wallpaper Engine 的视频和网页壁纸引入 DSH Web 界面，为开发者提供了可视化的个性化背景方案。其智能遮罩、手动裁剪、轮播列表以及资源监控功能，使其在兼顾美观的同时也保证了界面的稳定性与可读性。
- 项目地址：https://github.com/Weilv-D/wallpaper-engine-dsh
- 目录页：https://www.skillhub.cn/plugins/Weilv-D/wallpaper-engine-dsh
