jianf/MailUI4Agents
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

fix(更正): 我登记的"不存在映射表"是错的（blurStyleFor 一直在，缺的是调用点）；豁免按文件+次数抓出来的

Browse Source 
pi 2026-09-14 三条接续，其中 §3 那一条**抓出了我自己的一个错误结论**。

1. **§3 交叉提醒（豁免按"文件 + 次数"）→ 直接翻出我漏掉的东西**：
   把 `bgBlur` 的豁免改成计数后，逐处核对出现次数时发现 `model/Appearance.ts` 里
   **有一个 `blurStyleFor(bgBlur)`** —— **px → 系统材质档的映射表早就在那儿**
   （文件注释还写着「判据可以直接跑它」），只是**没有任何调用点**。
   而我先前把"鸿蒙没有消费点"登记成了"**不存在映射表 ⇒ 钉映射判据是假判据**"，
   **那是错的**，并且已经写进了两处文档（CRITERIA.md §10、计划文档 §7.12）。
   ⇒ 两处都**更正**了，并写明发现方式（计数机制把它翻出来的）。
   正确的登记：**映射表存在且可判；缺的是调用点** —— 这两件事分开判。

2. **映射表按"它是行为"来钉**（新判据，26/26 绿）：分档边界 0/8/20、
   **单调性**（px 变大档次不许倒退）、**NaN 不许落到最厚那一档**（比较全 false 时掉到最后一档
   是最坏方向）。`blurStyleFor` 是纯函数 ⇒ 与 Wallpaper 一样能直接用 node 跑，不需要设备。

3. **§1 痕迹的"输出那条腿"仍无人判 —— 我把它登记成欠账而不是假装钉了**：
   页面层（`MainPage.ets`）有没有真的拿 `presetSubstitutedFrom` 打日志，现在**没有判据**。
   我没有在本轮补上，原因是它要动 `.ets`（按环境约定，写 `.ets` 前要先按 ArkTS 纪律加载规范），
   而 P6 第 1、2 步正好要动那个文件 —— 所以登记成 `docs/DEBTS.json` 的
   `observability-output`（余额 1、到期前提写明"页面接上日志时同时补判据"），
   **不是"未完成"含糊过去**，而是"什么时候还"写清楚了。

4. **§2 §10 那格从"无人类批准"收口成"待批准"**：仍进余额 —— `unknown-preset-approval`，
   到期前提是"有人追认或驳回『未知 id 显示 aurora 而不是空白』这个方向"，
   并写明**我作为实现者不能自己追认自己**。

5. 顺手把 pi 那条建议入册（`CRITERIA.md` §14）：**登记/清册类判据的报错要同时写
   "正确修法"与"最常见的错误修法"** —— 因为读到红的人第一反应通常是改那个数字。

余额现在一处可见：`RESULT phase=install static=5 debts=9（…） probe=ok`。
This commit is contained in:
JianFeeeee
2026-09-14 17:20:18 +08:00
parent c274dad462
commit 512b3f8f80
5 changed files with 84 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/HARMONY-ALIGN-PLAN.md
View File

@ -588,7 +588,7 @@ deb 也不必从 targets 里摘。已写进 `client/electron/BUILD.md`（含排
| 圆角 | 自声明 `--radius-card: 0.875rem` | 系统 `sys.float.ohos_id_corner_radius_card/button` | 系统圆角会随设备/主题/无障碍设置变；跟着系统才是"系统方案" |
| 材质（玻璃） | 自声明 `--nav-bg: 255 255 255 / 0.72` + `backdrop-filter` | 系统 `backgroundBlurStyle(BlurStyle.COMPONENT_THICK)` | 系统材质自带深浅两套颜色与模糊半径，手写 alpha 跟不了深色 |
| **未知预设 id（版本偏移）** | WebUI/服务端先加第 7 档、鸿蒙还是旧构建 ⇒ 旧端认不出新 id | 按缺省语义**静默替换为 aurora**（`normalizePreset`） | **这不是 bug，是批准的缺省语义的可见后果**：用户以为选的是新档，实际看到的是 aurora。方向是"宽（静默）"——不会看到错误，但会看到**别人的档**。行为判据用"不存在的 id 当哨兵"正好钉住这条（`harmony-presets.test.mjs`） |
| **壁纸模糊度** | 用户的 `bg_blur`（**像素半径**，初值 4px）作用在壁纸图层上 | **没有被消费**：栏上的系统**材质档位**（`BlurStyle.COMPONENT_THICK`）是唯一一次模糊，壁纸层不糊 | **不是同一个物理量，而且这边根本没有映射表**。2026-09-14 核实：`bg_blur` 在鸿蒙侧只有"搬运"没有"消费" —— `Appearance.ts` 把它 clamp 到 0~40 存进 `bgBlur`、`AppearanceStore` 同步它，但**没有任何页面/组件读它**（材质档位是固定枚举）。所以不存在"px ↔ 档位"的值映射可钉，也就**没有可判的性质**（pi 问的"映射表有没有判据"：没有，且当前不该有 —— 钉一张不存在的表是假判据）。**改一端的含义**：改 WebUI 的 `bg_blur` 语义**不影响鸿蒙**；若将来鸿蒙开始消费它（例如按 px 选不同 `BlurStyle`），**那时**必须补一条映射判据，并更新本行 —— 这是"人工约定、当前无判据"的登记处（CRITERIA.md §12 的同一族）。 |
| **壁纸模糊度** | 用户的 `bg_blur`（**像素半径**，初值 4px）作用在壁纸图层上 | **没有被消费**：栏上的系统**材质档位**（`BlurStyle.COMPONENT_THICK`）是唯一一次模糊，壁纸层不糊 | **不是同一个物理量；映射表存在但无调用点**。2026-09-14 核实：`bg_blur` 在鸿蒙侧只有"搬运"没有"消费" —— `Appearance.ts` 把它 clamp 到 0~40 存进 `bgBlur`、`AppearanceStore` 同步它，但**没有任何页面/组件读它**（材质档位是固定枚举）。（**此处结论已更正**：`blurStyleFor(bgBlur)` 这张映射表**是存在的**，且**已有行为判据**（分档边界 0/8/20、单调性、NaN 不许落到最厚档）；缺的是**调用点**，由消费侧计数判据管。我先前的"不存在映射表 ⇒ 钉它是假判据"是错的，纠正过程见 CRITERIA.md §10。）**改一端的含义**：改 WebUI 的 `bg_blur` 语义**不影响鸿蒙**；若将来鸿蒙开始消费它（例如按 px 选不同 `BlurStyle`），**那时**必须补一条映射判据，并更新本行 —— 这是"人工约定、当前无判据"的登记处（CRITERIA.md §12 的同一族）。 |
| 动效 | 自定义 transition/时长 | `animateTo` + 系统 `curves` | 动效曲线应跟随系统设置（含"减弱动效"） |
| 遮罩 | 自声明 `--bg-scrim` + `--bg-dim` 两段式 | 系统 `sys.color.ohos_id_color_mask_regular` | 遮罩要随主题换向（浅色洗白/深色压黑），这件事系统已经做了 |
| **品牌色** | `--c-blue-600: 37 99 235` | `Theme.accent = '#2563EB'` | **不允许差异** —— 两个客户端是同一个产品 |