From 15309394ac62cd126d8927d0f16b3cda9ef9b636 Mon Sep 17 00:00:00 2001
From: AskaEth <i@yeij.top>
Date: Tue, 10 Nov 2026 22:31:20 +0800
Subject: [PATCH] =?UTF-8?q?docs(design):=20M228=20=E5=A4=8D=E5=AE=A1=20r2?=
 =?UTF-8?q?=20=E4=B8=A4=E5=A4=84=E6=96=87=E6=A1=A3=E5=8F=A3=E5=BE=84?=
 =?UTF-8?q?=EF=BC=88Ink=20=E7=9F=A9=E9=98=B5=E4=B8=8A=E9=99=90=E3=80=81?=
 =?UTF-8?q?=E6=B5=8B=E8=AF=95=E6=8C=87=E9=92=88=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

P2-1 统一全矩阵口径：palette/visibility.rs 实测表 Ink 行第二列「1.54 ~ 12.13」是旧的「对
surface-container-highest 单一层」量法，改成 4×5 全矩阵（4 个状态容器 × 5 个容器层）的上限
**16.47**（primary-container 压 surface-container-lowest），下限 1.54（secondary-container 压
highest）不变——Silver 行本来就是全矩阵（1.02 ~ 1.80），现在两行同口径。表头补「4×5 全矩阵」
说明，避免下次又被按单层读。

P2-2 修正失效指针：visibility.rs 模块文档的「实测」小节把测试指向
`tests/ink_cat_boards.rs`，但容器层可视性那几条在 r1 返工时已搬到
`tests/ink_cat_visibility.rs` —— 改指后者。boards/mod.rs:42 的「26 组文字/图标对
（tests/ink_cat_boards.rs）」仍正确，未动。

纯文档两行，无数值/代码变更。fmt --all --check=0；test -p unlucky-design --all-targets=0
（267 passed = 186 lib + 81 集成；ink_cat_boards 7 / ink_cat_visibility 4 / ink_cat_geometry 3）。
---
 crates/design/src/palette/visibility.rs | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/crates/design/src/palette/visibility.rs b/crates/design/src/palette/visibility.rs
index 94ec6ad..d0ebfe3 100644
--- a/crates/design/src/palette/visibility.rs
+++ b/crates/design/src/palette/visibility.rs
@@ -24,11 +24,11 @@
 //! 第 3 条为什么不是「把阈值降到 1.02 就完事」：那样等于承认「选中态可以看不见」，
 //! 而用户抱怨的正是这个。把不可测的那一半转成**构成要求**，才是能落地的那一半。
 //!
-//! ## 实测（`tests/ink_cat_boards.rs` 守住第 2 条与阶梯）
+//! ## 实测（`tests/ink_cat_visibility.rs` 守住第 2 条与阶梯）
 //!
-//! | 板 | 最弱状态容器 / `surface` | 状态容器 / 容器层（最低 ~ 最高） | 阶梯 L\\* 步长 |
+//! | 板 | 最弱状态容器 / `surface` | 状态容器 / 容器层（4×5 全矩阵，最低 ~ 最高） | 阶梯 L\\* 步长 |
 //! |---|---|---|---|
-//! | Ink | **1.97**（secondary-container） | 1.54 ~ 12.13 | +1.4 ~ +4.4 |
+//! | Ink | **1.97**（secondary-container） | 1.54 ~ **16.47** | +1.4 ~ +4.4 |
 //! | Silver | **1.23**（tertiary/error-container） | **1.02** ~ 1.80 | −1.7 ~ −4.1 |
 //! | 旧 baseline（债务现场） | 1.23 | **1.057**（对卡片，m223 实测） | — |
 //!