跨端: 壁纸遮盖色改用页面底色系（mask 两套主题都深，浅色下方向与 WebUI 相反）；模态遮罩保持 mask

pi 提了一个**方向性**疑问，让我先把值读出来再定 —— 读完确认**他是对的**，而且这是"机制上确定不同"。

## 实测（两张 SDK 表交叉验证，不靠记忆）

`ets/build-tools/ets-loader/sysResource.js` 给名字→id，`previewer/.../resources.txt` 给 id→值：

| 令牌 | 浅色主题 | 深色主题 |
|---|---|---|
| `ohos_id_color_mask_regular`（原 `Theme.overlay`） | `#99182431` **深蓝灰** | `#b2000000` 黑 |
| `ohos_id_color_background` | `#ffffffff` **白** | `#ff18181a` 近黑 |

⇒ mask 的 light/regular/thick 是**浓度档**（同一深色的三个 alpha），不是深浅两套值：
它在**两套主题下都是深色**（模态遮罩语义）。而 WebUI 的 `--bg-scrim` 浅色是**白**
（原话「浅色下用白把花哨的图案洗淡」）—— 壁纸遮盖用 mask 就是**反方向**：
浅色主题下把预设压暗，而 WebUI 是把它洗淡。

## 改法

- 新增 `Theme.wallpaperScrim = $r('sys.color.ohos_id_color_background')`（页面底色系：
  浅色白、深色近黑，**自动换向**，与"朝底色淡化"同一意图）；预设档与图片档的遮盖层都用它。
- `Theme.overlay`（mask）**只留给模态弹层**（那里语义确实是压暗背后）。
- 不复用 `pageBg` 的原因写进注释：页面底在背景开启时会被换成**透明**
  （`bgActive ? Color.Transparent : Theme.pageBg`），而遮盖层**永远要一个真实颜色** ——
  两个用途生命周期不同，共用一个名字迟早坏一头（这个仓库撞过四次的模式）。

## 判据（从 SDK 读真值再判，不写死结论）

断言「mask 两套主题都深」「页面底色系浅白深黑」「WebUI 的 `--bg-scrim` 浅色是白」，
再落到代码：两处遮盖层必须用 `wallpaperScrim`、弹层仍用 `overlay`、两个令牌不许混用。
**这样"令牌选错方向"以后不能靠记性避免。**

变异：遮盖退回 mask → 红 1 条；只改一层 → 红 2 条。

## 文档

§7.17b-2 记这次读数（表格 + 两张表怎么读 + 为什么不复用 pageBg + 变异结果）；
§7.12 有意差异表加一行（遮盖色令牌：两个语义两个令牌，"不允许混用"）。

## 验证

`hvigorw assembleHap` BUILD SUCCESSFUL；`npm test` 退出码 0
（12 个判据文件全绿 + vitest 258/258；harmony-appearance 23 → 24 条）。

client/harmony/entry/src/main/ets/common/Theme.ets

@@ -62,6 +62,34 @@ export class Theme {
    */
   static readonly overlay: Resource = $r('sys.color.ohos_id_color_mask_regular');
 
+  /**
+   * 壁纸遮盖层的颜色 —— **不是** `overlay`（那是模态遮罩），两者语义不同。
+   *
+   * pi 2026-09-14 提出的方向性疑问，我按他说的去 SDK 里把值读出来了
+   * （`ets/build-tools/ets-loader/sysResource.js` 给 名字→id，
+   *  `previewer/common/resources/entry/resources.txt` 给 id→值，两张表交叉验证）：
+   *
+   *   | 令牌 | 浅色主题 | 深色主题 |
+   *   |---|---|---|
+   *   | `ohos_id_color_mask_regular`（= `overlay`） | `#99182431` **深蓝灰** | `#b2000000` 黑 |
+   *   | `ohos_id_color_background` | `#ffffffff` **白** | `#ff18181a` 近黑 |
+   *
+   * 也就是说 **`mask_*` 在两套主题下都是深色**（它的 light/regular/thick 是**浓度档**，
+   * 不是深浅两套值），用途是**模态遮罩**（弹层背后压暗）。
+   * 而 WebUI 的 `--bg-scrim` 在 `:root` 是**白**、`.dark` 才是黑，注释原话是
+   * 「浅色下用白把花哨的图案洗淡，深色下用黑压暗」—— 它做的是"**朝页面底色淡化**"。
+   *
+   * 所以壁纸遮盖若用 `mask`：**浅色主题下会把预设压暗，而 WebUI 是把它洗淡 —— 方向相反**。
+   * 这是"机制上确定不同"，不是观感。改用**页面底色系**：那才是"朝底色淡化"的系统对应物，
+   * 浅色=白底方向、深色=深底方向，自动换向，与 WebUI 是同一个意图。
+   *
+   * ⚠️ 为什么不干脆复用 `pageBg`（值一样是 `ohos_id_color_background`）：
+   * 页面底在背景开启时会被换成语义上的**透明**（`bgActive ? Color.Transparent : Theme.pageBg`），
+   * 而遮盖层**永远需要一个真实颜色**。两个用途的生命周期不同，共用一个名字迟早坏一头
+   * —— 这正是这个仓库撞过四次的模式（`text-white` vs `bg-white`、`--c-*` vs `--s-*`）。
+   */
+  static readonly wallpaperScrim: Resource = $r('sys.color.ohos_id_color_background');
+
   /**
    * 导航/浮层的材质档次。**不再有 `#B8FFFFFF` / `#B80F172A` 这种手写玻璃 alpha** ——
    * 那两个值等于"我们替系统猜了深色该怎么做"，与"用系统方案"直接冲突；

client/harmony/entry/src/main/ets/pages/MainPage.ets

@@ -1652,7 +1652,8 @@ struct MainPage {
          */
         Column()
           .width('100%').height('100%')
-          .backgroundColor(Theme.overlay)
+          // 遮盖色 = **页面底色系**（朝底色淡化），不是模态遮罩 mask（浅色下那会压暗，方向相反）
+          .backgroundColor(Theme.wallpaperScrim)
           .opacity(this.bgPlan.scrim)
       }
       .width('100%').height('100%')
@@ -1664,7 +1665,8 @@ struct MainPage {
         // 压暗用**系统遮罩色** + 服务端给的浓度：换向（浅色洗白/深色压黑）由系统负责
         Column()
           .width('100%').height('100%')
-          .backgroundColor(Theme.overlay)
+          // 遮盖色 = **页面底色系**（朝底色淡化），不是模态遮罩 mask（浅色下那会压暗，方向相反）
+          .backgroundColor(Theme.wallpaperScrim)
           .opacity(this.bgPlan.scrim)
       }
       .width('100%').height('100%')