code-newbie-1/dsh-wallpaper

把本机 Wallpaper Engine 下载的壁纸设为 DSH Web GUI 的页面背景：图片 / 视频 / 网页壁纸按原样渲染，场景壁纸自动柔化为静态预览。侧边栏「壁纸设计」入口 + 右侧面板实时调节。

截图

主内容区（视频壁纸）	壁纸设计面板	整页模式

功能

• 壁纸库：扫描 Steam 创意工坊 431960 与本地 projects，解析 project.json（无则按扩展名识别），标记 WE 当前壁纸
• 渲染：图片原图填充；视频自动静音循环（支持 Range 拖动）；网页壁纸 iframe 加载并透传 ws/fps/resolution；场景壁纸柔化静态预览（优化开关：模糊 + 降不透明度 + 暗角）
• 壁纸设计面板：不透明度、作用范围（整页 / 主内容区）、填充模式、高斯模糊、暗角遮罩、帧率限制、失焦暂停、鼠标视差、点击穿透、多壁纸轮播、主题联动；设置存 localStorage 自动恢复
• Agent 工具：wallpaper_scan / wallpaper_list / wallpaper_set / wallpaper_config

安装

dsh plugin --profile web add dsh-wallpaper

重启 dsh web 后，侧边栏出现「壁纸设计」入口；点击选择壁纸即应用，面板内可实时调节全部效果。自定义 WE 安装路径：面板「壁纸来源路径…」或 wallpaper_config（持久化到 ~/.dsh/dsh-wallpaper.json）。

Agent 工具

工具	说明
wallpaper_scan	重新扫描壁纸库
wallpaper_list [query]	列出壁纸（id / 标题 / 类型 / 来源 / 当前 / 分辨率）
wallpaper_set <id> [opacity] [scope]	设置 GUI 期望壁纸（浏览器下次加载应用）
wallpaper_config	指定 Steam 根目录 / WE 安装目录

限制

• 壁纸只作用于本机 GUI 页面（API 均为 loopback-only），不改变 Windows 桌面壁纸
• 场景壁纸的粒子 / 特效无法移植到网页，降级为预览图
• 视频壁纸播放原始文件，帧率限制作用于视差 / 轮播等效果循环

English

dsh-wallpaper lets the DSH web GUI use your local Wallpaper Engine library as a page background. Image / video / web wallpapers render natively; scene wallpapers degrade to a softened static preview. A sidebar 壁纸设计 panel tunes opacity, scope (whole page vs main column), blur, vignette, fps, parallax, carousel and theme linkage; agent tools wallpaper_scan/list/set/config are included. Install: dsh plugin --profile web add dsh-wallpaper.

License

Apache-2.0