dsh-mpkg-wallpaper 3.13.11 → 3.14.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)
 
@@ -273,15 +271,24 @@ Contains the *Show wallpaper* sub-section.
 | 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.
+> 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 | — |
 | 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

@@ -21,6 +21,21 @@
 | 三 GitHub 克隆 | 开发者 / 离线 / 要改代码 | `git pull` | 完整 |
 | 四 单文件 bundle | 离线应急；给非 DSH 宿主复用路由 | 重新生成并替换那个 `.mjs` | **只有宿主端** |
 
+### ⚠ 桌面版（DSH Desktop）怎么装（2026-10-02 补）
+
+DSH 桌面包目前只有 **macOS / Windows**。官方 README 写明：**`desktop` 这个 profile 名由 Electron 壳独占，
+CLI 会拒绝它的 `boot` / `config-dump` / 插件管理请求** ⇒ 桌面上**不能**照抄 `dsh plugin --profile desktop add …`。
+桌面档请按下面两条之一走（按你手上那个桌面版本的界面为准）：
+
+1. **桌面 App 自带的插件入口**（若有）：在设置/插件页添加 npm 包名 `dsh-mpkg-wallpaper`；
+2. **手动装进桌面 profile 的依赖树**：把包放进该 profile 的 `node_modules/`（或在其 `package.json` 里加依赖后装），
+   并在该 profile 的 `cordis.patch.yml` 里保留本包的挂载行（与「方式三」同形，只是 profile 换成一个由桌面壳管理的目录）。
+
+桌面档还有一条与网页档不同的前提：**宿主页面源可能不是回环 HTTP**（Electron 用 `file://` + IPC）。
+3.11.0 起客户端已按 DSH 第一方口径兜底（`location.origin` 缺失或为 `"null"` ⇒ `http://dsh.internal`），
+所以宿主路由在桌面档也能解析；若仍然连不上宿主，请跑 `window.__mpwCompat()` 与 `GET /api/mpkg-wallpaper/compat`
+把两段 JSON 发给我们（见 `docs/TRANSLUCENT-THEME.md` 同级的排查说明）。
+
 ### 方式一：`dsh plugin add`（推荐，市场可识别）
 
 ```bash
@@ -258,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）
 
@@ -273,15 +286,24 @@ node tools/build-bundle.mjs
 | 统一雾（全屏遮罩） | `aquaMask` | 关 | 所有表面共享一种雾色（原 Aqua 实验项） | 关 |
 | 统一雾强度 | `aquaMaskAlpha` | 82% | 0–100% | — |
 
+> **两个条的语义（2026-10-02 起口径固定，判据 `tools/fog-model-test.mjs`）**：
+> 「整屏虚化程度」= 模糊半径（**0 = 完全不虚化**：标题栏/侧边栏/右栏/dock 也回到**实心**，
+> 不会把未模糊的原始壁纸透出来）；
+> 「左侧边栏/标题栏透明度」= 各表面白雾厚度（**0 = 完全透明**：只看到**模糊**壁纸，不留雾、不留面板取色）——
+> 它只在「整屏虚化程度 > 0」时决定观感。
+> 两者对**整个界面外壳**生效（左栏/标题栏/右栏/dock 共用同一套表面 token）。
+
 ### 5. 界面虚化（blur）
 
 | 面板文案 | 内部键 | 默认 | 程度键 / 默认 | 关 |
 |---|---|---|---|---|
+| 界面虚化跟随统一虚化 | `blurFollowUnify` | **开** | 开 = 本页被接管的项交给「整屏虚化程度 + 左侧边栏/标题栏透明度」统一驱动；关 = 各自独立可调 | — |
 | 虚化对话框 | `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）
 

package/cordis.patch.yml

@@ -3,6 +3,9 @@
 # 这是 `dsh.bundle.patch` 层：通过官方 CLI 安装时——
 #
 #   dsh plugin --profile <name> add dsh-mpkg-wallpaper
+#   ⚠ 桌面版（DSH Desktop / macOS / Windows）：`desktop` profile 由 Electron 壳独占，官方 CLI **拒绝**它的
+#   插件管理请求 ⇒ 桌面上不要用上面这条命令；请按 README「桌面版怎么装」两条之一（桌面 App 的插件入口，或
+#   手动放进桌面 profile 的依赖树 + 保留本文件的挂载行）。
 #
 # ——CLI 会读取本声明把插件行追加到 bundle 栈，profile 启动时合并本 patch。
 # 若 profile 里还留着旧的手动挂载行（@local/dsh-mpkg-wallpaper），