dsh-mpkg-wallpaper 3.14.0 → 3.15.1

package/README.en.md

@@ -265,24 +265,24 @@ Contains the *Show wallpaper* sub-section.
 |---|---|---|---|---|
 | Unify blur | `unifyTint` | on | One slider drives the whole-screen blur; takes over sidebar/title-bar/right-sidebar frost | off |
 | Full-screen blur degree | `unifyAmount` | 30px | 0–40 (drives the wallpaper-layer blur) | — |
-| Left sidebar / title-bar opacity | `sidebarAlpha` | 35% | Frost thickness 0–100% | — |
+| UI transparency | `sidebarAlpha` | 65% | **0% = fully opaque (normal UI), 100% = fully transparent (wallpaper visible)**; drives left sidebar / title bar / right sidebar · dock alike; independent of the blur | — |
 | Chat follows full-screen blur | `chatFollow` | on | off = the chat area is driven by the *Frosted blur* slider | off |
 | New-chat button follows panel opacity | `sessionFollow` | on | off = back to the host's original colour | off |
 | Unified fog (full-screen mask) | `aquaMask` | off | All surfaces share one fog colour (moved here from the Aqua section) | off |
 | Unified fog strength | `aquaMaskAlpha` | 82% | 0–100% | — |
 
 > **What the two sliders mean (fixed since 2026-10-02; judged by `tools/fog-model-test.mjs`)**:
-> *Full-screen blur degree* = blur radius (**0 = no blur at all**: the title bar / sidebar / right sidebar / dock
-> return to a **solid** surface, so the un-blurred raw wallpaper is never shown through);
-> *Left sidebar / title-bar opacity* = fog thickness on every surface (**0 = fully transparent**: the *blurred*
-> wallpaper only, no fog and no wallpaper-sampled tint) — it only matters while the blur degree is > 0.
+> *Full-screen blur degree* = blur radius (**0 = no blur at all**);
+> *UI transparency* = how transparent the whole UI shell is (**0% = fully opaque — the normal UI, painted with the
+> host's own surface colour; 100% = fully transparent, wallpaper visible**) — it is independent of the blur, and
+> with transparency at 0 the plugin does not override the host at all (no background, no blur, no token changes).
 > Both apply to the **whole UI shell** (left sidebar, title bar, right sidebar and dock share one set of tokens).
 
 ### 5. UI blur (blur)
 
 | Label | Key | Default | Amount key / default | Off |
 |---|---|---|---|---|
-| UI blur follows Unified blur | `blurFollowUnify` | **on** | on = the taken-over rows on this page follow the *Full-screen blur degree* + *Left sidebar / title-bar opacity*; off = they become independently adjustable | — |
+| Follow Unified blur | `blurFollowUnify` | **on** | on = the taken-over rows on this page follow the *Full-screen blur degree* + *Left sidebar / title-bar opacity*; off = they become independently adjustable | — |
 | Blur dialogs | `dialogBlur` | on | `dialogAmount` 14px | off |
 | Blur settings panel | `settingsBlur` | on | `settingsAmount` 14px | off |
 | Blur download/confirm popups | `confirmBlur` | on | `confirmAmount` 12px | off |

package/README.md

@@ -280,24 +280,24 @@ node tools/build-bundle.mjs
 |---|---|---|---|---|
 | 统一虚化 | `unifyTint` | 开 | 整屏模糊感由一个条控制；开启后接管侧边栏/标题栏/右栏磨砂 | 关 |
 | 整屏虚化程度 | `unifyAmount` | 30px | 0–40（控制壁纸层 blur） | — |
-| 左侧边栏/标题栏透明度 | `sidebarAlpha` | 35% | 白雾厚度 0–100% | — |
+| 界面透明度 | `sidebarAlpha` | 65% | **0% = 完全不透明（正常界面）、100% = 完全透明（看到壁纸）**；同时驱动左栏/标题栏/右栏·dock；与模糊互不影响 | — |
 | 聊天区跟随整屏虚化 | `chatFollow` | 开 | 关 = 聊天区由「磨砂模糊」条控制 | 关 |
 | 新会话按钮跟随面板不透明度 | `sessionFollow` | 开 | 关 = 回到宿主原色 | 关 |
 | 统一雾（全屏遮罩） | `aquaMask` | 关 | 所有表面共享一种雾色（原 Aqua 实验项） | 关 |
 | 统一雾强度 | `aquaMaskAlpha` | 82% | 0–100% | — |
 
 > **两个条的语义（2026-10-02 起口径固定，判据 `tools/fog-model-test.mjs`）**：
-> 「整屏虚化程度」= 模糊半径（**0 = 完全不虚化**：标题栏/侧边栏/右栏/dock 也回到**实心**，
-> 不会把未模糊的原始壁纸透出来）；
-> 「左侧边栏/标题栏透明度」= 各表面白雾厚度（**0 = 完全透明**：只看到**模糊**壁纸，不留雾、不留面板取色）——
-> 它只在「整屏虚化程度 > 0」时决定观感。
+> 「整屏虚化程度」= 模糊半径（**0 = 完全不虚化**）；
+> 「界面透明度」= 整个界面外壳的透明程度（**0% = 完全不透明（正常界面，用宿主自己的表面色）、100% = 完全透明（看到壁纸）**）——
+> 它与模糊**互不影响**：模糊 0 时照样按它透出，只是背后壁纸是清晰的。
+> 另外：**透明度 = 0 时插件完全不覆盖宿主**（不写背景/不写模糊/不动宿主 token）。
 > 两者对**整个界面外壳**生效（左栏/标题栏/右栏/dock 共用同一套表面 token）。
 
 ### 5. 界面虚化（blur）
 
 | 面板文案 | 内部键 | 默认 | 程度键 / 默认 | 关 |
 |---|---|---|---|---|
-| 界面虚化跟随统一虚化 | `blurFollowUnify` | **开** | 开 = 本页被接管的项交给「整屏虚化程度 + 左侧边栏/标题栏透明度」统一驱动；关 = 各自独立可调 | — |
+| 跟随统一虚化 | `blurFollowUnify` | **开** | 开 = 被接管的项（左栏磨砂/标题栏磨砂/右侧边栏·dock）与统一值一致；**其中任一项你自己调过之后就独立**；关 = 全部独立；重新打开 = 清空独立标记 | — |
 | 虚化对话框 | `dialogBlur` | 开 | `dialogAmount` 14px | 关 |
 | 虚化设置面板 | `settingsBlur` | 开 | `settingsAmount` 14px | 关 |
 | 虚化下载/确认弹窗 | `confirmBlur` | 开 | `confirmAmount` 12px | 关 |
@@ -315,6 +315,7 @@ node tools/build-bundle.mjs
 | 第三方 UI 圆角兼容 | `roundCompat` | 关 | 兼容第三方插件圆角 | 关 |
 | 自适应文字色 + 蓝色清理 | `aquaInk` | 关 | 文字色随遮罩亮度自适应 + 品牌色统一（配 `aquaInkColor`） | 关 |
 | 深底文字可读增强 | `aquaTextEnhance` | 关 | 文字双色描边（近似方案） | 关 |
+| ≥4K 源自动降 1080p | `resMax`（自动写 1920） | 自动 | 检测到 ≥4K 且宿主转码可用、且你没设过「分辨率上限」时，自动把该壁纸降到 1080p（每张壁纸一次；`?autocap=off` 关闭；设置里可改回） | `?autocap=off` |
 | 纯 Scene 壁纸渲染方式 | `sceneRender` | — | ⚠ 有按钮、有写入，**无读取点**（未接线） | — |
 | 场景渲染上报（排障） | `sceneReport` | 开 | 壁纸每 10s 把渲染器现场写到 `reports/` | 关 |
 | 场景首帧看门狗 | `sceneWatchdog` | 开 | 超时未出画自动回退静态帧；等待时长 `sceneWatchdogSecs` 8s（3–30） | 关 |