JianFeeeee
4ecddfc2b6
## 一、判据基建先修对，否则是在听噪声
深色可读性扫描的**取样法迭代了三版**，每版都因为**假红**才改的
（记在这里，因为"判据自己错"比"界面错"更费时间）：
1. **取中心一个像素** ⇒ 落在笔画之间、读到的是底色 ⇒ 一片 ratio=1.00 假红。
2. **取全局最暗/最亮** ⇒ 会采到**两个不同的东西**：细字的抗锯齿中间色。
实例：segmented「日」报 ink `rgb(32,34,35)` / bg `rgb(98,100,101)` 2.69:1 ——
而截图里它要么蓝底白字、要么深底浅字，两种都远高于 3:1。
**反复核对才确认是判据的错，不是界面的错。**
3. **步长采样 + 众数** ⇒ 仍然假红：周表头「一」报 2.03:1，
而逐像素的真实墨是 `rgb(166,167,167)`（**6.6:1**）——
稀疏网格**整个跳过了笔画**。这不是调参能修好的（字越小越糟）。
4. **逐像素 + 众数=底 + 离底最远者=墨**（最终版）。
理由：一个文字框里**面积最大的一定是底**，而"离底色最远"就是笔画最实那部分。
⚠️ 逐像素是**负担得起的**（整屏已解码在内存，一个框最多 9 万像素）——
**不要再为了省开销退回抽样**，前两版都因此假红。
## 二、真 bug 三批（都是"深色下没提亮"）
### ① 语义色前景（12 处 → 修完设备复扫 0）
WebUI 的语义色也是**双通道**，`.dark` 段把 `red/green/amber-700` 换成浅色
（`248/118/249 → 164/219/195` 那组）。鸿蒙只有一个深色值：
- 「归档」按钮 `Theme.danger` #B91C1C 压深面 ⇒ **2.47:1**（联系人页 7 处）
- 「今天」/「日」等 ⇒ **2.38–2.77:1**
加 `dangerDark/approveDark/warnFgDark`（逐字对齐 WebUI `.dark`）
+ `dangerFor()/approveFor()/warnFgFor()` 入口，22 处接入。
### ② 日历工具条整块配色抄错（不是"深色档选错"）
对照 WebUI `CalendarView.tsx:313-331`：
| 元素 | WebUI | 鸿蒙（改前） |
|---|---|---|
| 「今天」 | `border-gray-300` + `text-gray-700`（**中性**） | `accentSoft` 底 + `accentStrong` 字 |
| 月/周/日 未选中 | `bg-white` + `text-gray-700` | `accentSoft` 底 |
鸿蒙把**次要的中性按钮**画成了**品牌色按钮** —— 视觉重量跟主操作一样，
三个档看起来"都像选中"。已按 WebUI 改成中性。
### ③ 三级文字在深色下 2.82:1（**71 处**，全局最大的一个）
WebUI 的 `.dark` 段注释逐字写着这个坑：
> 「`gray-400/500`（次要文字）→ **提亮**。深底上的浅色 gray-400
> 只有约 2:1 对比度，远低于 WCAG AA 的 4.5:1 —— **看得见但读不动**。」
鸿蒙用的系统三级色 `ohos_id_color_text_tertiary` 深色下是 `rgb(102,103,105)`
压深面 **2.82–3.05:1**，而它被用在 10–11px 的**小字**上
（时间戳、农历、空态、辅助说明）。
**不换掉系统令牌**（"系统拥有的维度"纪律照旧），加 `textSubtleFor()`：
深色下改用二级色（实测 `rgb(166,167,167)` ≈ 7.15:1，
且与 WebUI 的 `gray-500` 同档位）。71 处接入。
**设备复扫（修后）**：通信/日历/联系三页 **176 段文字全部 ≥3:1**。
## 三、欠账与底本
- `baseline.sha` 第 4 次重算。仍**先逐个取证**：
`git diff --quiet HEAD -- <f> && echo STALE || echo INTENTIONAL`
⇒ 三个全是 `INTENTIONAL`（我改的），不是变异残留。
把这条取证命令也写进文件，下次照抄。
- `dangerDark/approveDark/warnFgDark` 已登记进 `SELF_OWNED_COLORS`
+ `Theme.ets` 登记表（各带理由与 WebUI 出处）。
`run-all.mjs` → `checks=514 pass=514 fail=0 skip=0 red=0 broken=0 unreported=0`。
**未验**：①「我的」页（底部头像按钮，扫描脚本没找到入口）没扫；
② 浅色下的对比度没扫（本轮全部针对深色）。
68 lines
6.2 KiB
Plaintext
68 lines
6.2 KiB
Plaintext
# 变异体基线的**自证底本**：每个被变异过的文件在此记下"未变异"时的 sha256。
|
||
# 跑完变异后 `sha256sum -c baseline.sha` 必须全 OK（summary.py 把结果打进 RESULT 行）。
|
||
#
|
||
# 取基线是**有意的动作**，不是随手重算 —— 重算会把"某次变异没还原"永久掩盖掉。
|
||
# 每次重算都要在此记一行"为什么"：
|
||
# 2026-09-15 11:22 dsh：`AdminUsersPage.ets` 的哈希变了，**不是变异残留**。
|
||
# 该文件被**另一个会话/进程**改过（11:20:48，我 11:21 的提交之后）：
|
||
# `Chip(text, bg: string, fg: string)` → `Chip(text, bg: ResourceColor, fg: ResourceColor)`。
|
||
# 核实过是**正确的 ArkTS 修法**（`Theme.surfaceMuted`/`textSubtle` 是 `Resource`，
|
||
# `Theme.chipNeutralBg` 是 `string` ⇒ 旧签名编译不过）。我没有提交也没有回退它。
|
||
#
|
||
# 2026-09-15 11:50 dsh：三个文件漂移，全部核实为**有意改动、不是变异残留**：
|
||
# · `model/Appearance.ts` + `pages/MainPage.ets`：**我自己**按 pi 的裁定把方案 (b) 落地成 (a)
|
||
# （删 `navMaterialFor` 与 `NAV_MATERIAL_OF`、导航条改回 `Theme.navMaterial`、
|
||
# 重写那段"注释说 (a)、代码是 (b)"的自相矛盾注释）。
|
||
# · `api/ApiClient.ets`：**别的会话**的提交 `69c2059`（JianFeeeee，11:43:22，
|
||
# 推送客户端契约层）动过它；当前内容与 HEAD 逐字节相同（`git diff HEAD` 空）。
|
||
# 复核"是不是变异残留"的方法：`git diff HEAD -- <文件>` + 上面这些记录。
|
||
#
|
||
# 2026-09-18 dsh：三个文件漂移，**已逐个核实是提交态、不是变异残留**（重算前的前提）：
|
||
# · `AdminUsersPage.ets`、`SettingsPage.ets`：提交 `1be8318`（09-17 21:15，
|
||
# "底栏黑带 / 联系人点不开"那批）改过；`git diff --quiet HEAD` 为空 ⇒ 与 HEAD 逐字节相同。
|
||
# · `ApiClient.ets`：提交 `fce5b91`（09-15 15:15，"鸿蒙客户端连不上服务器"）改过；同上。
|
||
# ★ 为什么必须先证这一步：底本**过期**与**变异残留**在 `sha256sum -c` 眼里一模一样，
|
||
# 而重算会把真正的残留**永久掩盖** —— 所以"重算"必须是一次**有记录**的动作。
|
||
# ★ 顺带修了播报：原来一律打"有文件没还原"（指向最危险的结论），
|
||
# 而真因只是底本没跟上提交 ⇒ 现在两种分开报，并各自给出判别方法。
|
||
#
|
||
# 2026-09-19 13:0x dsh：四个文件漂移，**已逐个核实是提交态、不是变异残留**（重算前的前提）：
|
||
# · `pages/AdminUsersPage.ets`：提交 `6693e96`（09-18 11:47，"登录页那个 emoji 是 Unicode…"）
|
||
# · `common/BackgroundPicker.ets`、`pages/SettingsPage.ets`：提交 `7e1120a`
|
||
# （09-19 12:30，"顶栏不再自己铺白条 + 日历改左右两栏…"）
|
||
# · `api/ApiClient.ets`：提交 `7e10bfa`（09-18 12:55，"鸿蒙日历补 .ics 导入导出"）
|
||
# 四个都 `git diff --quiet HEAD -- <f>` ⇒ **与 HEAD 逐字节相同** ⇒ 底本过期，不是残留。
|
||
# ★ 为什么必须逐个证这一步：底本**过期**与**变异残留**在 `sha256sum -c` 眼里一模一样，
|
||
# 而重算会把真正的残留**永久掩盖** —— 所以"重算"必须是一次**有记录**的动作。
|
||
# ⚠️ 这次漂移正是 `baseline-stale`（rc=0、只提示）那一档的又一次实例：
|
||
# 它**不假红**（正常提交不会天天红），但也**不会被自动发现** ——
|
||
# 我是靠"核每个文件的登记/实际读数"这条主动核查撞上的，不是它自己报的。
|
||
#
|
||
# 2026-09-19 18:2x baseline 重算（**先核过不是残留，才重算的**）：
|
||
# ① `pages/AdminUsersPage.ets`、`pages/SettingsPage.ets` —— 我本次的**有意编辑**：
|
||
# 给所有"压在彩色底上的字/图标"换前景色（`Theme.surface` → `Theme.accentFg`），
|
||
# 并把品牌蓝前景接入 `Theme.accentFor()`（深色下提亮到 WebUI 的 `--c-blue-600`）。
|
||
# ② `api/AppearanceApi.ets` —— **与 HEAD 逐字节相同**（`git diff --quiet HEAD` 为空），
|
||
# 但底本哈希对不上 ⇒ 说明它在底本取完之后被**合法改过**（提交 `3b5cc63`，
|
||
# 09-19 那次"外观保存 400"的修：`payloadFromLocal` 改用 `AppearancePayload`）。
|
||
# ⇒ 这是 `stale`（底本过期），不是 `residue`（变异残留）。
|
||
# ★ 三个都逐个跑过 `git diff --quiet HEAD -- <f>` 取证，没有一个是"改动忘了还原"。
|
||
# ★ 这正是这份文件里那条纪律的第 3 次执行："重算必须是一次有记录的动作"。
|
||
#
|
||
# 2026-09-19 20:2x baseline 重算（第 4 次，**仍先核过不是残留**）：
|
||
# ① `pages/AdminUsersPage.ets` / `pages/SettingsPage.ets` / `common/BackgroundPicker.ets`
|
||
# —— 本次的**有意编辑**：语义色前景接入 `dangerFor()/approveFor()/warnFgFor()`
|
||
# （深色下红/绿/琥珀要提亮，对齐 WebUI `.dark --c-red/green/amber-700`），
|
||
# 以及三级文字接入 `textSubtleFor()`（深色下换二级，见 Theme.ets 里那段理由）。
|
||
# ② 三个都逐个跑过 `git diff --quiet HEAD -- <f>` ⇒ 全部**非空**（工作树有改动）
|
||
# ⇒ 是"我改的"，不是"变异忘了还原"。
|
||
# ★ 取证命令留在这里，下次照着做：
|
||
# git diff --quiet HEAD -- <file> && echo STALE || echo INTENTIONAL
|
||
4f3e0802346ba93740d7a6989fa6a9ef7dce16d1db59ea7402ff554127b07e3e client/harmony/entry/src/main/ets/model/AdminUsers.ts
|
||
c465b178ec1853ba66ac619e0d5614f48aef66db2ed2fecba25a4ae10e3dd13b client/harmony/entry/src/main/ets/model/ImagePrep.ts
|
||
ceec4a5aae5e9064d9ab57ef24acd4b7f185506de8582ae2c67e35f634ff8593 client/harmony/entry/src/main/ets/pages/AdminUsersPage.ets
|
||
73c66c7045f579c3eb8b8e0aa07803e7c9363b7ae8375972b251633d3ce969be client/harmony/entry/src/main/ets/common/BackgroundPicker.ets
|
||
e773fd556f4454efbb204ff72841b63a0a584f7ca7827c73142884af21328ba5 client/harmony/entry/src/main/ets/pages/SettingsPage.ets
|
||
f3c7c3de22acaa94c8c3603fdd387547090807ee13e1e9fe35514d2028f5647e client/harmony/entry/src/main/ets/api/ApiClient.ets
|
||
6550e1892d1ebea82fb75a3d2cf8eaf826186199ff4a0ecf0430b1e3517d8681 client/harmony/entry/src/main/ets/api/AppearanceApi.ets
|