From 80314f4830ae51bf863a96d8ec4a4e62797e17b8 Mon Sep 17 00:00:00 2001 From: AskaEth Date: Mon, 2 Nov 2026 09:36:49 +0800 Subject: [PATCH] =?UTF-8?q?docs(design):=20hint=5Fkey=20=E7=9A=84=E6=96=87?= =?UTF-8?q?=E6=A1=88=E6=98=A0=E5=B0=84=E8=A1=A8=E6=90=AC=E8=BF=9B=20proven?= =?UTF-8?q?ance.rs=20=E7=9A=84=E6=96=87=E6=A1=A3=E6=B3=A8=E9=87=8A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit DevDocs/ 是 gitignore 的本地文档，契约里的「键 → 文案」表review 时看不到， 所以在 hint_key 的 rustdoc 里放同样一张表（差异只有措辞建议，结构一致）。 --- .../design/src/palette/resolve/provenance.rs | 20 ++++++++++++++++--- 1 file changed, 17 insertions(+), 3 deletions(-) diff --git a/crates/design/src/palette/resolve/provenance.rs b/crates/design/src/palette/resolve/provenance.rs index ee8c63b..c7734f9 100644 --- a/crates/design/src/palette/resolve/provenance.rs +++ b/crates/design/src/palette/resolve/provenance.rs @@ -175,9 +175,23 @@ impl Provenance { /// UI 提示键（`None` = 无需提示）。 /// - /// 形如 `palette.hint.background.low-chroma`，文案映射表见 - /// `DevDocs/SubAgentsTalk/palette-source-contract.md`。`key` 稳定、可持久化进日志； - /// 本 crate 不产出人话文案（文案属于 UI 层，D40 的分层纪律）。 + /// 形如 `palette.hint.background.low-chroma`，`key` 稳定、可持久化进日志； + /// 本 crate 不产出人话文案（文案属于 UI 层，D40 的分层纪律），UI 只做查表： + /// + /// | 键 | 建议文案（`{card}` = `provenance.card.name()`） | + /// |---|---| + /// | `palette.hint.background.undecodable` | 背景图读取失败，已改用{card}配色 | + /// | `palette.hint.background.too-small` | 背景图太小，无法取色，已改用{card}配色 | + /// | `palette.hint.background.bad-dimensions` | 背景图数据异常，已改用{card}配色 | + /// | `palette.hint.background.no-opaque-pixels` | 背景图几乎全透明，无法取色，已改用{card}配色 | + /// | `palette.hint.background.low-chroma` | 背景图颜色太淡，取不出主题色，已改用{card}配色 | + /// | `palette.hint.background.contrast` | 背景图配色达不到可读性要求，已改用{card}配色 | + /// | `palette.hint.wallpaper.*` | 同上，把「背景图」换成「桌面壁纸」 | + /// | `palette.hint.preset.contrast` | 当前配色可读性不足，已自动微调 | + /// | `palette.hint.adjusted` | 为可读性微调了少量颜色（`adjustments` 非空但无失败） | + /// + /// 完整契约（含可选补充提示、持久化纪律、性能账）见 + /// `DevDocs/SubAgentsTalk/palette-source-contract.md`（该目录是本地文档，不入库）。 /// /// 优先级：① 先解释「为什么回落」（第一个失败的层级）→ ② 再说「微调过对比度」。 /// 前者对用户更重要：用户看到的是「我的壁纸怎么没生效」，而不是「颜色被调了 2%」。