dsh-mpkg-wallpaper 3.13.12 → 3.15.0

package/README.en.md

@@ -258,8 +258,6 @@ Contains the *Show wallpaper* sub-section.
 | Title bar frost amount | `headerBlurAmount` | 0% | Frost thickness 0–100% (default 0 = transparent) | 0 |
 | Set title bar frost separately | `headerFrostOwn` | off | on = `headerFrostAmount` overrides the frost radius | off |
 | Title bar frost strength | `headerFrostAmount` | 30px | 0–60 | 0 |
-| Right sidebar / dock blur | `rightSidebarBlur` | on | The DSH right sidebar and bottom dock | off |
-| Blur amount / surface opacity | `rightSidebarBlurAmount` / `rightSidebarAlpha` | 14px / 45% | 0–40 / 0–100% | — |
 
 ### 4. Surface unify (unify)
 
@@ -267,21 +265,30 @@ 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**);
+> *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 |
 |---|---|---|---|---|
+| 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 |
 | Blur popovers | `popoverBlur` | on | `popoverAmount` 10px; plus `popoverAlpha` 94% surface opacity | off |
 | Blur mask (full-screen backdrop) | `maskBlur` | on | `maskAmount` 8px | off |
+| Right sidebar / dock blur | `rightSidebarBlur` | on | `rightSidebarBlurAmount` 14px + `rightSidebarAlpha` 45%; both are taken over while following Unified blur | off |
 
 ### 6. Other (other)
 

package/README.md

@@ -273,8 +273,6 @@ node tools/build-bundle.mjs
 | 标题栏磨砂程度 | `headerBlurAmount` | 0% | 白雾厚度 0–100%（默认 0 = 透明） | 0 |
 | 单独调节标题栏磨砂 | `headerFrostOwn` | 关 | 开 = 用 `headerFrostAmount` 覆盖磨砂半径 | 关 |
 | 标题栏磨砂强度 | `headerFrostAmount` | 30px | 0–60 | 0 |
-| 右侧边栏/dock 虚化 | `rightSidebarBlur` | 开 | DSH 自带右侧边栏与底部 dock | 关 |
-| 虚化程度 / 表面透明度 | `rightSidebarBlurAmount` / `rightSidebarAlpha` | 14px / 45% | 0–40 / 0–100% | — |
 
 ### 4. 界面统一（unify）
 
@@ -282,21 +280,30 @@ 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 = 完全不虚化**）；
+> 「界面透明度」= 整个界面外壳的透明程度（**0% = 完全不透明（正常界面，用宿主自己的表面色）、100% = 完全透明（看到壁纸）**）——
+> 它与模糊**互不影响**：模糊 0 时照样按它透出，只是背后壁纸是清晰的。
+> 另外：**透明度 = 0 时插件完全不覆盖宿主**（不写背景/不写模糊/不动宿主 token）。
+> 两者对**整个界面外壳**生效（左栏/标题栏/右栏/dock 共用同一套表面 token）。
+
 ### 5. 界面虚化（blur）
 
 | 面板文案 | 内部键 | 默认 | 程度键 / 默认 | 关 |
 |---|---|---|---|---|
+| 跟随统一虚化 | `blurFollowUnify` | **开** | 开 = 被接管的项（左栏磨砂/标题栏磨砂/右侧边栏·dock）与统一值一致；**其中任一项你自己调过之后就独立**；关 = 全部独立；重新打开 = 清空独立标记 | — |
 | 虚化对话框 | `dialogBlur` | 开 | `dialogAmount` 14px | 关 |
 | 虚化设置面板 | `settingsBlur` | 开 | `settingsAmount` 14px | 关 |
 | 虚化下载/确认弹窗 | `confirmBlur` | 开 | `confirmAmount` 12px | 关 |
 | 虚化弹层 | `popoverBlur` | 开 | `popoverAmount` 10px；另有 `popoverAlpha` 94% 表面不透明度 | 关 |
 | 虚化遮罩（全屏背景） | `maskBlur` | 开 | `maskAmount` 8px | 关 |
+| 右侧边栏/dock 虚化 | `rightSidebarBlur` | 开 | `rightSidebarBlurAmount` 14px + `rightSidebarAlpha` 45%；跟随统一虚化时两项都被接管 | 关 |
 
 ### 6. 其他（other）
 
@@ -308,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） | 关 |