dsh-mpkg-wallpaper 3.2.0 → 3.3.0

package/README.en.md

@@ -33,10 +33,13 @@ A plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harn
 **🎨 Theme color & glass appearance (Aqua experiment, off by default)**
 - **Theme color (accent)**: color picker + 6 presets driving brand buttons/sliders/selected items/links/send button (`--dsw-alias-brand-*` tokens)
 - **Unified fog** (full-screen mask with one fog color, strength slider), **panel wallpaper-matching color** (auto sample + strength slider + custom picker), **adaptive text + blue cleanup** (brand unified, custom picker), **dark-background text readability**, **todo-list frost**
-- Appearance tab also has: **wallpaper flip** (flipX/flipY), floating cards, clock, etc.
+- Appearance tab also has: floating cards, clock, etc.
 
 **🎬 Lens & picture**
-- Lens zoom (10–2000%) & pan, brightness (50–150%), light sharpen, wallpaper flip, Deep diving background box
+- Lens zoom (10–2000%) & pan, brightness (50–150%), light sharpen, Deep diving background box
+
+**🎛️ Wallpaper settings (tab)**
+- Everything directly tied to the **current wallpaper** lives here: mute (web wallpapers), mirror flip (horizontal/vertical), video playback speed (0.5–2x), adjustable options (mpkg read-only / web wallpapers editable), **decode fps cap** (24/30/48/60, ffmpeg frame-sampling), **resolution cap** (720p/1080p/2K, ffmpeg downscale to cut load), ffmpeg status with download/uninstall
 
 **🚀 Hybrid large-file mode (default on)**
 - mpkg streams to the DSH host → disk storage → HTTP Range streaming, **>600MB files supported**, low memory usage
@@ -64,21 +67,21 @@ A plugin for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harn
 | **mpkg (scene)** | 🟡 Partial | static-frame / layer composite / preview animation (below); slots with video textures auto-switch |
 | **Time-variation wallpaper** | ✅ Full | multi-slot auto-switch + manual lock, lazy loading to avoid OOM |
 | **Video (mp4/webm)** | ✅ Full | plays directly |
-| **Web (HTML)** | 🟡 Experimental | sandboxed iframe; **web wallpapers with settings are wired into the plugin (below)** |
+| **Web (HTML)** | 🟡 Experimental | sandboxed iframe; **web wallpapers with settings are wired into the plugin (below)**; **interactive-feature wallpapers not adapted yet** |
 | **Scene raw folder (scene.pkg)** | 🟡 Partial | same as mpkg scene |
 | **Application (.exe)** | ❌ Excluded | safety: never read/executed |
 
 ## Adjustable options & web-wallpaper settings wiring
 
 - **mpkg wallpapers**: the project's own **adjustable options** are shown **read-only** in the collapsible "Adjustable options" area (the browser shows pre-rendered assets; apply changes in the WE app).
-- **Web wallpapers (some wired in — Live2D portraits)**: some web wallpapers (e.g. Blue Archive / Honkai Star Rail Live2D portraits, usually with a `loadJson.json` `SettingModel`) have built-in options — now **wired into the plugin settings page**, editable in the **same collapsible "Adjustable options" area**:
+- **Web wallpapers (some wired in — Live2D portraits)**: some web wallpapers (Live2D portraits, usually with a `loadJson.json` `SettingModel`) have built-in options — now **wired into the plugin settings page**, editable in the **same collapsible "Adjustable options" area**:
   - **Resolution 2k / 4k / 8k** (reloads the wallpaper)
   - **Language** (per wallpaper: 中文 / 日本語 / English / Tiếng Việt / Русский …)
   - **BGM & voice volume** (live, no reload)
   - **Show touch-area boxes / show text box** toggles
   - Changes are written to the wallpaper iframe's same-origin localStorage (key = skeleton name), then the wallpaper reloads
 - **Hide the wallpaper's own settings panel**: these web wallpapers show a "Settings" button + panel in the top-right of the wallpaper surface, which can't be interacted with — the plugin **auto-hides it** on iframe load, and you operate the options via the plugin page.
-- **A few web wallpapers are still in progress**: web wallpapers relying on external SDKs / special interaction logic (e.g. some miHoYo event pages) haven't had their built-in options wired in yet; they load as-is.
+- **Wallpapers with interactive features are not adapted yet**: web wallpapers relying on external SDKs / special interaction logic (e.g. some miHoYo event pages, or wallpapers that need login or click interaction) haven't had their built-in options wired in yet — they display fine, but **the in-plugin adjustable options are unavailable for them**.
 
 > These editable web-wallpaper controls only appear after the plugin detects the wallpaper's `loadJson.json`; plain image/video web wallpapers or those without settings show nothing extra.
 
@@ -107,7 +110,8 @@ The plugin offers these partial solutions (chosen automatically by scene content
 ## Settings Tabs
 
 - **Source**: master switch, hybrid, mpkg file, image/video files, custom folder (can point at the workshop root), local library (Steam scan), switching/rotation, **time-variation slot lock**
-- **Appearance**: theme color, flip, floating, frosted blur, lens zoom/position, brightness
+- **Wallpaper**: mute, mirror flip (horizontal/vertical), video playback speed, adjustable options (mpkg read-only / web wallpapers editable), decode fps cap, resolution cap, ffmpeg status
+- **Appearance**: theme color, floating, frosted blur, lens zoom/position, brightness
 - **Unified blur**: full-screen blur + sidebar/title-bar fog, chat follow, new-chat follow
 - **UI blur**: dialog/settings/popup/popover/mask/sidebar frost each independent
 - **Wallpaper reveal**: sidebar/title-bar visibility, title-bar frost amount, sharpen
@@ -150,7 +154,7 @@ Uninstall: `dsh plugin --profile web remove dsh-mpkg-wallpaper`.
 ## Limitations
 
 - **Scene wallpapers cannot be fully dynamic on the web** (see [Scene wallpaper adaptation](#scene-wallpaper-adaptation)); mpkg adjustable options are read-only (apply changes in the WE app)
-- **Web wallpapers are experimental**: heavy animation / external dependencies may freeze or fail (preflight tags + refresh recovery); **web wallpapers with built-in options are partly wired in — a few are still in progress**
+- **Web wallpapers are experimental**: heavy animation / external dependencies may freeze or fail (preflight tags + refresh recovery); **web wallpapers with built-in options are partly wired in — wallpapers with interactive features are not adapted yet**
 - **Huge assets** (pure-browser mode): standalone video >600MB, video textures >250MB, images >200MB unsupported; **hybrid mode** has no such limit
 - Scene static-frame / layer-composite **first extraction takes a few seconds** (longer for 8K textures); afterwards served from cache
 
@@ -171,10 +175,6 @@ Uninstall: `dsh plugin --profile web remove dsh-mpkg-wallpaper`.
 <!-- Wallpapers in the screenshots are by Bilibili UP【-夜莺Night】: [author page](https://b23.tv/86CyaFw) -->
 
 -->
-## Official Docs
-
-Wallpaper Engine official help site: [help.wallpaperengine.io](https://help.wallpaperengine.io). mpkg/tex/mdl are proprietary formats without official docs (format knowledge in this plugin comes from RePKG / lwe public reverse-engineering).
-
 ## Bug Reports
 
 Please include:

package/README.md

@@ -33,10 +33,13 @@
 **🎨 主题色与玻璃外观（Aqua 实验模式，默认全关）**
 - **主题颜色（accent）**：取色盘 + 6 预置，驱动按钮/滑条/选中项/链接/发送键等品牌色（`--dsw-alias-brand-*` 系列 token）
 - **统一雾**（全屏遮罩统一雾色，强度独立滑条）、**面板匹配壁纸色**（自动取色 + 强度滑条 + 自定义取色盘）、**自适应文字色 + 蓝色清理**（品牌色统一，带自定义取色盘）、**深底文字可读增强**、**任务列表磨砂**
-- 外观 tab 里还有：壁纸镜像翻转（flipX/flipY）、悬浮卡片、时钟等
+- 外观 tab 里还有：悬浮卡片、时钟等
 
 **🎬 镜头与画面**
-- 镜头缩放（10–2000%）与平移、画面亮度（50–150%）、轻度锐化、壁纸镜像翻转、Deep diving 背景框
+- 镜头缩放（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 大文件也支持**，内存占用极低
@@ -64,21 +67,21 @@
 | **mpkg（场景类）** | 🟡 折中 | 静态帧提取 / 图层合成 / 预览动图（见下）；**含视频纹理时段的可自动切换** |
 | **时间变化壁纸** | ✅ 完整 | 多时段自动切换 + 手动锁定，懒加载防 OOM |
 | **视频（mp4/webm）** | ✅ 完整 | 直接播放 |
-| **网页（HTML）** | 🟡 实验性 | iframe 沙箱加载；**带设置项的部分网页壁纸已接入插件可改（下）** |
+| **网页（HTML）** | 🟡 实验性 | iframe 沙箱加载；**带设置项的部分网页壁纸已接入插件可改（下）**；**带可交互功能的暂未适配** |
 | **场景原始目录（scene.pkg）** | 🟡 折中 | 同 mpkg 场景类 |
 | **Application（exe）** | ❌ 排除 | 安全考虑，绝不读取/执行 |
 
 ## 可调参数与网页壁纸的设置接入
 
 - **mpkg 壁纸**：项目自带的**可调参数**在「可调参数」折叠区**只读展示**（浏览器显示的是预渲染素材，修改需在壁纸引擎 App 中生效），供对照。
-- **网页壁纸（部分已接入，Live2D 立绘类）**：部分网页壁纸（如碧蓝档案 / 星穹铁道的 Live2D 立绘，通常含 `loadJson.json` 的 `SettingModel`）自带设置项，现在**已经接入插件设置页**——在**同一个「可调参数」折叠区**里可直接修改：
+- **网页壁纸（部分已接入，Live2D 立绘类）**：部分网页壁纸（Live2D 立绘，通常含 `loadJson.json` 的 `SettingModel`）自带设置项，现在**已经接入插件设置页**——在**同一个「可调参数」折叠区**里可直接修改：
   - **分辨率 2k / 4k / 8k**（重载生效）
   - **语言**（按壁纸实际提供：中文 / 日本語 / English / Tiếng Việt / Русский 等）
   - **背景音乐与语音音量**（实时生效，不重载）
   - **显示触摸区域框 / 文本框**等开关
   - 修改写入壁纸 iframe 的同源 localStorage（key = 骨架名），改完重载该壁纸生效
 - **隐藏壁纸自带设置面板**：这类网页壁纸在壁纸表面右上角自带「设置」按钮 + 面板，且无法交互——插件在 iframe 加载后**自动隐藏**它（防挡住画面），设置通过插件页操作。
-- **少部分网页壁纸仍在处理**：依赖外网 SDK / 特殊交互逻辑的网页壁纸（如部分米哈游事件页），其内置设置项尚未接入，仍按原样加载。
+- **部分带可交互功能的壁纸暂未适配**：依赖外网 SDK / 特殊交互逻辑的网页壁纸（如部分米哈游事件页、需要登录或点击交互的壁纸），其内置设置项尚未接入，仍按原样加载——这类壁纸可正常显示，但**插件内的可调参数不可用**。
 
 > 这类可改网页壁纸的按钮（分辨率/语言/音量等）只在识别到对应壁纸的 `loadJson.json` 后出现；普通图片/视频/无设置项的网页壁纸不显示。
 
@@ -107,7 +110,8 @@
 ## 设置分组（顶部 Tab）
 
 - **来源**：总开关、hybrid、mpkg 文件、图片/视频文件、自定义目录（可指 workshop 主目录）、本地壁纸库（Steam 扫描）、壁纸切换/轮换、**时间变化壁纸的时段锁定**
-- **外观**：主题颜色、翻转、悬浮、磨砂模糊、镜头缩放/位置、亮度
+- **壁纸设置**：静音、镜像翻转（水平/垂直）、视频倍速、可调参数（mpkg 只读 / 网页壁纸可改）、解码帧率上限、分辨率上限、ffmpeg 状态
+- **外观**：主题颜色、悬浮、磨砂模糊、镜头缩放/位置、亮度
 - **统一虚化**：整屏虚化 + 侧边栏/标题栏白雾、聊天区跟随、新会话跟随
 - **界面虚化**：对话框/设置面板/弹窗/弹层/遮罩/侧边栏磨砂各自独立
 - **透出壁纸**：侧边栏/标题栏透出、标题栏磨砂程度、锐化
@@ -150,7 +154,7 @@ git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/no
 ## 限制
 
 - **场景壁纸无法完整动态还原**（见[场景壁纸适配现状](#场景壁纸scene适配现状)）；mpkg 可调参数为只读展示，修改需在壁纸引擎 App 中生效
-- **网页壁纸为实验性**：重动画/外网依赖可能卡顿或加载失败（有预检标注与刷新恢复机制）；**自带设置项的部分网页壁纸已接入插件可改，少部分仍在处理**
+- **网页壁纸为实验性**：重动画/外网依赖可能卡顿或加载失败（有预检标注与刷新恢复机制）；**自带设置项的部分网页壁纸已接入插件可改，带可交互功能的壁纸暂未适配**
 - **超大素材**（纯浏览器模式）：独立视频 >600MB、视频纹理 >250MB、图片 >200MB 无法处理；**hybrid 模式**无此限制
 - 场景静态帧/图层合成的**首次提取耗时**（几秒，8K 纹理更久）；之后走缓存秒开
 
@@ -171,10 +175,6 @@ git clone https://github.com/XHR666/dsh-mpkg-wallpaper.git $DSH_HOME/profiles/no
 <!-- 截图中的壁纸来自 B 站 UP 主【-夜莺Night】的壁纸作品：[作者主页](https://b23.tv/86CyaFw) -->
 
 -->
-## 官方文档
-
-Wallpaper Engine 官方帮助站 [help.wallpaperengine.io](https://help.wallpaperengine.io)；mpkg/tex/mdl 为专有格式，官方未公开文档（本插件格式知识来自 RePKG / lwe 公开逆向）。
-
 ## 反馈 Bug
 
 反馈问题时请附带：