dsh-mpkg-wallpaper — DSH 壁纸引擎背景插件

中文 | English

给 DeepSeek Harness Web 界面（dsh web）添加背景壁纸的插件：Wallpaper Engine .mpkg 解析、Steam 创意工坊原始目录、视频/网页/图片壁纸、时间变化壁纸的多时段切换、整屏虚化体系、主题色与玻璃外观、本地壁纸库、定时轮换、一键更新。几乎每一个外观细节都可以调节。

一句话版本：视频/图片/网页壁纸直接播放；时间变化壁纸（Time Variation）支持多时段自动切换 + 手动锁定时段；带设置项的部分网页壁纸（如 Live2D 立绘类，含分辨率/语言/音量）已接入插件设置页，可在「可调参数」折叠区直接修改；场景（Scene）壁纸提供静态帧提取 + 图层合成两个折中方案。

核心能力

📦 壁纸来源（全部支持）

• Wallpaper Engine .mpkg：浏览器内直接解析容器（不上传第三方）；视频类自动播放内嵌 mp4 / 视频纹理；场景类解析容器提取素材；多时段自动切换（按系统时间选时段素材）
• Steam 创意工坊原始目录：自动发现 WE 安装（读注册表 + libraryfolders.vdf，支持非默认盘），列出 video / web / scene 三种类型；也可直接把 workshop 主目录（steamapps/workshop/content/431960）设为自定义目录——每个子文件夹自动识别为一张壁纸
• 视频壁纸：.mp4 直接播放（自定义目录 / Steam 库 / 本地文件均可）
• 网页壁纸：HTML 壁纸在沙箱 iframe 中加载（实验性，带风险预检：自动标注「⚠重动画」「🌐外网」，见网页壁纸）
• 图片 / GIF / URL：本地图片（png/jpg/webp/gif）或图片链接（含 data:image）直接作背景

⏰ 时间变化壁纸（Time Variation）

• 支持 WE 的时间变化壁纸（项目里带 morningtime / daytime / dusktime / nighttime / timevarying 属性，含多个时段视频纹理）：
  • 自动切换：按系统时间每 60 秒检查，跨时段自动换到对应素材
  • 手动锁定 / 时段覆盖：设置页提供「自动 + 清晨 / 白天 / 黄昏 / 夜晚」按钮——点击某个时段即固定为该素材，点击「自动」恢复随时间切换
  • 按需懒加载：只在当前时段提取视频纹理（单槽峰值约几十 MB），其余时段切换时才读取，避免一次导入全部时段导致移动端 OOM 崩溃
  • 不串台：切换不同时间变化壁纸时清空上一张的时段缓存，避免「点清晨/白天/黄昏却显示上一张壁纸画面」的串台问题
• 适配方式：视频类 mpkg、场景类（scene.pkg 用「mpkg 方式」解析——scene.pkg 与 mpkg 是同一 PKG 容器，含内嵌视频纹理的时段可自动切换）

🌊 整屏虚化（磨砂）体系

• 统一虚化：一个条控制整屏壁纸模糊度；侧边栏白雾厚度、聊天区跟随、新会话按钮跟随独立可调
• 界面虚化（各自独立开关+程度）：对话框（通用居中窗口 + 聊天输入框）、设置面板、下载/确认弹窗、弹层（菜单/下拉/提示）、遮罩（全屏背景）、侧边栏磨砂（弹窗打开时自动摘除）
• 标题栏磨砂 / 侧边栏透出壁纸：独立控制

🎨 主题色与玻璃外观（Aqua 实验模式，默认全关）

• 主题颜色（accent）：取色盘 + 6 预置，驱动按钮/滑条/选中项/链接/发送键等品牌色（--dsw-alias-brand-* 系列 token）
• 统一雾（全屏遮罩统一雾色，强度独立滑条）、面板匹配壁纸色（自动取色 + 强度滑条 + 自定义取色盘）、自适应文字色 + 蓝色清理（品牌色统一，带自定义取色盘）、深底文字可读增强、任务列表磨砂
• 外观 tab 里还有：悬浮卡片、时钟等

🧩 dsh-better-sidebar 适配（检测到该插件后显示）

• 已安装 dsh-better-sidebar 时，「外观 / 其他」tab 自动出现适配分类：总开关 + 子开关：
  • 悬浮双层修复（bsFloat）：让悬浮侧边栏的 _panel 内层 pane/tabBar 背景透明，避免悬浮时出现双重实色矩形
  • 透出程度（bsReveal + bsRevealAlpha 滑条）：better-sidebar 表面透出壁纸的浓度可调（越高越透）
  • 跟随主题 / Aqua（bsAlpha / bsAqua）：better-sidebar 面板跟随主题底色 / 跟随统一雾取色
  • 底部面板避让（bsBottomAvoid）：底部面板实时对齐 DSH 中心列（better-sidebar 自身 ResizeObserver 负责，无需手动偏移）
  • 字体跟随（bsFont）等其余子开关
• 主机端 /ping 自动探测 better-sidebar 是否安装；未安装时该分类隐藏

🎬 镜头与画面

• 镜头缩放（10–2000%）与平移、画面亮度（50–150%）、轻度锐化、Deep diving 背景框

🎛️ 壁纸设置（tab）

• 当前壁纸直接相关的都集中在这里：静音（网页壁纸）、镜像翻转（水平/垂直）、视频倍速（0.5–2x）、可调参数（mpkg 只读 / 网页壁纸可改）、解码帧率上限（24/30/48/60，ffmpeg 抽帧）、分辨率上限（720p/1080p/2K，ffmpeg 缩放降占用）、ffmpeg 状态与下载/卸载

🚀 大文件混合模式（hybrid，默认开）

• mpkg 流式上传到 DSH 宿主 → 磁盘存储 → HTTP Range 流式播放，>600MB 大文件也支持，内存占用极低

🖼️ 本地壁纸库

• Steam 自动发现 + 自定义目录（任意文件夹 + 跨平台目录选择器；mpkg 文件与 workshop 文件夹混合放置都能识别）
• 壁纸切换与轮换：上一个/下一个一键切换、定时自动轮换（间隔可调）；轮换列表勾选后滚动保持不跳顶，未命名列表自动加序号（未命名列表 N）不重名

🛡️ 安全与共存

• 冲突检测：检测到其他壁纸/主题插件自动关闭本功能
• 安全边界：.exe/application 壁纸完全排除（防病毒注入）；自定义目录只读媒体文件；宿主路由有路径穿越校验；网页壁纸 iframe 沙箱隔离

🔄 更新

• 「检查更新」按版本号对比（semver），本地未推送改动不误报；推荐先到插件市场更新（semver 检测与市场一致）；「一键更新」从 GitHub 拉最新代码写回，重启生效

💾 备份与恢复 / 设置持久化

• 「其他」tab 提供备份与恢复：导出外观类设置（外观 / 统一虚化 / 界面虚化 / Aqua / 其他）为可分享的 JSON 文件，导入即还原——不含当前壁纸与扫描目录
• 设置持久化到宿主端文件：设置除浏览器 localStorage 外加存 ~/.dsh-mpkg-wallpaper/settings.json，换端口 / 清浏览器数据不丢失（参考 elysia395 v0.4.0 的做法）

⚡ 性能与稳定性

…