跨端: 修「深色下玻璃变灰纸板」+「主题选了不生效」（两个真 bug）

用户问「你的玻璃效果呢？」。我上手先取像素，结果是**两个一直存在的真 bug**，
不是观感偏好问题。两个都有实测数据。

## ① 深色下玻璃 alpha 没跟着翻 →「像深色卡片浮在灰纸板上」

### 实测

深色主题 + aurora 壁纸，同一行交替采样（`/tmp/g1.raw`，1008×2232）：

    y=670   卡片缝隙 rgb(199,199,199)   卡片内 rgb(27,37,50)
    y=880   卡片缝隙 rgb(201,203,201)   卡片内 rgb(27,36,53)

缝隙是**浅灰 199**、比卡片还亮。而 199 恰好 = `0.78 × 255`
（壁纸层实测 x=4..24 为 rgb(0,1,3)，近黑）—— 就是 `glassCardWall` 那层白纱。

### 根因：我把 WebUI 的一句话读漏了后半句

`Theme.glassCard` / `glassCardWall` 是**单一值、不分深浅**。我当初写的理由是
「基色恒为白，主题之间只差 alpha」——但 WebUI 原话是
「**基材恒为白**，主题之间**只差 alpha**」（`index.css:406`、`:1546`）。
我只抄了前半句，把「只差 alpha」误读成「alpha 也不用变」。

WebUI `.dark` 的实际取值：

    --glass-card-a:      0.06     ← 浅色 0.92
    --glass-card-wall-a: 0.04     ← 浅色 0.78

**深浅差 15 倍**：深色下白纱要几乎撤掉让深壁纸透上来，浅色下才用厚白纱盖亮壁纸。
我用同一个 0.92 配两套主题 ⇒ 深色下壁纸被糊成浅灰，**玻璃感与深色同时消失**。

### 修法

`Theme.glassCardFor(wall, dark?)` —— 与 `accentFor`/`textSubtleFor` 同一范式，
深浅从 `Theme.isDarkNow()`（`AppStorage` 那个发布键）读，不靠调用方自觉传。
新增 `glassCardDark #0FFFFFFF` / `glassCardWallDark #0AFFFFFF`。

改后同处实测：缝隙 rgb(3..16)，壁纸透上来了；浅色档回归检查未变（244/239，厚白纱仍在）。

## ② 用户选的主题被无条件覆盖 →「选了深色但界面还是浅的」

### 实测

「我的」页选「深色」后：
· 按钮显示选中、服务端也记下 `theme:'dark'`（`GET /me/appearance` 确认）；
· 但界面仍浅色，且文字浅色压浅底 —— 实测背景 `rgb(243,243,243)` /
  文字 `rgb(243,243,243)`，**对比度 ≈1.0:1，完全不可读**。

### 根因（两处叠加）

① `EntryAbility.onCreate` 有一句**无条件**的
   `setColorMode(COLOR_MODE_NOT_SET)`（= 跟随系统）—— 每次冷启都把用户的选择重置掉。
   它是目录迁移时抄进来的（`git log -S` 指向 `f9d757b chore: directory migration`），
   **没有注释说明为什么，也没有谁在用**。已删除（连带上游 import）。

② `MainPage.applyAppearance()` 算出了 `isDarkNow`、发布了 `AppStorage`，
   但**从来没调用过 `store.applyTheme(...)`** ⇒ 系统色彩模式根本没被设过。

### 修法

· 删掉 EntryAbility 那句无条件覆盖（附长注释说明为什么由页面负责）；
· `applyAppearance()` 补上 `store.applyTheme(ctx, snap.theme)`。

★ **顺序**：`KEY_IS_DARK` 发布必须在 `applyTheme` **之前** ——
  因为 `glassCardFor()` 是从那个键读深浅的，反过来会让卡片用上一轮的深浅画一帧。
  `applyThemeNow()` 里同一处顺序也一并修正。

## 判据

`cross-client-theme` 的两条原本把 `Theme.glassCard`/`glassCardWall` 两个**字面量**钉死，
被我这次正确的改动撞红 —— 我没有放宽它们，而是改成钉**行为**：
· 卡片必须经 `glassCardFor(...)` 取色（入口存在）；
· 四个令牌都要在 Theme 里存在；
· **深色档不得与浅色档同值**（同值 = 主题感知是假的）。

变异验证：① 深色档改回与浅色同值 → 3 条红；② 卡片改回不分深浅 → 5 条红；还原 → 21/21 绿。

## 验证状态

✓ 两个修复都在设备上取**像素**验证（不是看截图说"像了"）
✓ `cross-client-theme` 21/21、全量套件 545 pass（3 红均为改动前既有：
  `harmony-admin` 两处 = 我上一轮 `SecuritySection` 拆分遗留、`build-stamp` = 产物戳过期）
✓ 编译通过、进程存活、无新 jscrash

client/harmony/entry/src/main/ets/entryability/EntryAbility.ets

@@ -13,7 +13,12 @@
  * limitations under the License.
  */
 
-import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
+/*
+ * `ConfigurationConstant` 本轮**不再需要**：原来为 `setColorMode(COLOR_MODE_NOT_SET)`
+ * 引的，那句已删（见 `onCreate` 里的说明）。应用色彩模式现在统一由
+ * `MainPage.applyAppearance()` 按用户存下来的 `snap.theme` 决定。
+ */
+import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
 import { hilog } from '@kit.PerformanceAnalysisKit';
 /*
  * ★ `KeyboardAvoidMode` 必须从 `@kit.ArkUI` 引（= `@ohos.arkui.UIContext` 那个）。
@@ -37,11 +42,37 @@ export default class EntryAbility extends UIAbility {
   private ledger: NotificationLedger = new NotificationLedger(50);
 
   onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
-    try {
-      this.context.getApplicationContext().setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
-    } catch (err) {
-      hilog.error(DOMAIN, 'testTag', 'Failed to set colorMode. Cause: %{public}s', JSON.stringify(err));
-    }
+    /*
+     * ★★ 2026-09-21 **删掉了这里的一句 `setColorMode(COLOR_MODE_NOT_SET)`**。
+     *
+     * 原来这里是：
+     *     this.context.getApplicationContext()
+     *       .setColorMode(ConfigurationConstant.ColorMode.COLOR_MODE_NOT_SET);
+     *
+     * 它的语义是"跟随系统"，而它是**无条件**执行的 ⇒ 每次冷启都把应用色彩模式
+     * 重置回跟系统走，**用户在「我的」页选的浅色/深色被丢掉**。
+     *
+     * 实测症状：选「深色」后按钮显示选中、服务端也存了 dark，但界面仍是浅色
+     * （背景 rgb(243,243,243) / 文字 rgb(243,243,243)，对比度 ≈1:1，不可读）。
+     *
+     * 为什么会这样：它是目录迁移时抄过来的（`git log -S` 指向
+     * `f9d757b chore: directory migration`），**没有任何注释说明为什么**。
+     *
+     * ── 现在由谁负责 ──
+     *
+     * `MainPage.applyAppearance()`：它读本机缓存 + 服务端合并出 `snap.theme`，
+     * 然后调用 `store.applyTheme(ctx, snap.theme)` 真正应用。
+     * 那里才是"用户偏好的权威"所在。
+     *
+     * ★ 为什么不在 ability 里也读一次 preferences：
+     *   主题是**按账号**存的（键 `appearance.<accountId>`，见 `AppearanceStore`），
+     *   而 `onCreate` 时活跃账号可能还没加载出来 ⇒ 会读到错的账号、
+     *   或者读到空值又退回默认。**一个事实一个权威来源**，这里不重复。
+     *
+     * ★ 会不会因此丢掉"跟随系统"这条语义：不会 ——
+     *   `theme === 'system'` 时 `colorModeValue()` 返回的正是 `COLOR_MODE_NOT_SET`，
+     *   由 `MainPage` 按用户**实际选中的档位**决定，而不是无条件。
+     */
     hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onCreate');
     /*
      * ★ 2026-09-15：冷启点通知也要跳转。