dsh-theme-palette 1.13.3 → 1.13.5

package/CHANGELOG.md

@@ -8,6 +8,83 @@
 > 1.13.2 起逐节标注 —— 此前 27 个版本节看起来都能装，用户按 CHANGELOG 钉版本会撞 404
 > （2026-10-29 审计 P2-9）。
 
+### 1.13.5
+用户回执：「自定义色派生好像有问题？并未覆盖所有啊，好多颜色仍然是默认色」。
+这次不是猜：把宿主 `app.asar` 里的 token 表（`ui-theme` 的 `design-platform.css` + 应用 CSS）整份解出来，
+和插件实际声明的 token 逐条对表，得到确切口径 ——
+
+- 宿主定义 **412** 个 token 名，插件声明 151 个颜色 token（无一拼写失效、无一被宿主丢弃）；
+- 应用 CSS 真正 `var()` 消费的只有 **66** 个颜色 token；
+- 差集里 **58** 个颜色 token 插件从未声明：其中 19 个靠 `var()` 链落到已重建的色阶上（**会跟随**，
+  例如 `state-business-primary` → deepseek-500、`menu-icon` → bluish-800），
+  **39 个落在宿主字面色值上 —— 那是真正的"还是默认色"**。
+
+根因：插件只重建四族色阶（bluish / neutral / deepseek / blue），
+而宿主 `design-platform.css` 里还并列着**三族语义色阶 red / green / amber**，从来没有被碰过。
+于是「步骤点（done/error/warning）、`data-tone` 标签、终端错误行、无效输入边框、
+危险菜单项悬停、**文件 diff 的 +/− 行**」在自定义配色下永远是宿主的纯红/纯绿/纯琥珀。
+
+- **修法一（色阶）**：`SEMANTIC_BASE` 补 red / green / amber 三族（含宿主给的两个带 alpha 的 diff 浅底），
+  `buildRamps` 用新增的 `harmonizeSemantic` 做**温度调和**：色相往配色色相拉、**旋转封顶 8°**、
+  色度压到 88–92%，**明度一律沿用宿主**。封顶是关键 —— 苔绿配色（hue 162）的"短路径"
+  本来会把红（OKLCH h≈28°）往橙推 16°，报错就和警告撞色；封到 8° 后只是"同一件语义色换冷暖"。
+  无彩（纯黑/纯白/正灰）的自定义配色**不做调和**，语义色一个像素都不动。
+- **修法二（别名）**：`aliasOverrides` 显式落地 `state-{error,success,warn}-{primary,secondary,tertiary,label}`、
+  `code-diff-added/deleted`、`interactive-bg-hover-danger`（用语义红重合成宿主那两个 alpha 字面量）。
+  顺带补上宿主**没定义、但构建 CSS 在用**的两个洞：`--dsw-alias-label-error`（设置页"保存失败"那行，
+  缺失时 `color` 整条失效、文字回落继承色）与 `--dsw-alias-bg-layer-4`（帮助按钮 hover 底）。
+- **修法三（契约守卫，防复发）**：`tools/check-host-contract.mjs` 新增颜色覆盖守卫 ——
+  从宿主构建 CSS 里解出所有被 `var()` 消费的颜色 token，逐条要求"被插件声明"或"`var()` 链
+  落到插件声明的 token 上"。拿 1.13.4 的 `client.js` 跑同一条断言会挂 **30 处**（这就是这次漏检的形态），
+  1.13.5 为 0。黑白档的 19 个 token、遮罩/透明分隔线/首次引导页等字面色值走显式白名单。
+- **断言**：`check-audit` 第 29 组 —— 三族真的产出 / 色相偏移 ≤ 8° / 红绿琥珀两两可辨（≥ 25° 与 ≥ 40°）/
+  别名映射与宿主明暗档位一致 / 补回的两个缺口 / diff 行对比度与宿主同量级 /
+  黑白档不重建 / 无彩自定义不调和。
+- **已知边界（不修）**：语义色沿用宿主明度，因此宿主本身的两个问题照旧 ——
+  浅色下成功绿当文字只有 ~2.1:1（diff `+` 行、`data-tone=success` 标签），以及宿主为这一族
+  设计了**明暗同值**的单一档位，任何"靠调明度补对比度"的做法都会在另一侧反噬。
+  插件不替宿主改语义色的明暗节奏；这一条写进 README 的覆盖口径里。
+- 复核：`check-audit` 29 组全过；`check-host-contract` 全过（含新增守卫）；两档报表 exit 0。
+- **截图未重出**：设置页不渲染语义色，`screenshots.meta.json` 只同步了版本号。
+
+#### 1.13.5 补丁 · 自定义配色的「底色」与「线条色」（同日第二次回执）
+
+用户回执 #2：截图里 `v1.13.5` 已生效，但「很多地方底色、线条色都是按默认的」。核查确认两条：
+
+- **底色只被当色相来源**。`customScheme` 只取色相与色度，深色画布固定 L≈0.226；
+  用户把「底色」设成 `#070b11`（L≈0.148）时，屏幕上是 `#191c21` 一档的蓝灰 —— 他读成"底色没变"，
+  而且这个读法是对的。
+  **修法**：底色偏暗（L ≤ 0.35）→ 它就是**深色模式的画布明度**（夹到 0.14–0.30）；
+  偏亮（L ≥ 0.75）→ **浅色模式的画布明度**（夹到 0.90–0.985）；中间灰（0.35–0.75）不表达明暗意图，
+  两侧都沿用引擎值。只锚画布这一档，其余三层面按同一 delta 平移（层次间距不变），
+  文字对比度由求解器在新承载面上重算 —— 该配色实测正文对画布 **11.33:1**、对 875 面 **10.16:1**。
+  下限 0.14 是层次余量：再往下左栏「更深」档会掉进近纯黑。
+- **线条色取的是文字色 alpha**。文字一旦近中性（`#e1eced`，C≈0.012），发丝线就是一片中性灰。
+  **修法**：自定义配色下线条改用**配色色相 + 色度下限 0.02**（明度与 alpha 不变，对比关系不变）；
+  预置仍是墨/纸原色，不受影响。
+- UI 提示（四语）同步改成"底色偏暗/偏亮会当作对应模式的画布"。
+- **断言**：`check-audit` 第 30 组（13 条）—— 深/浅/中间灰三类输入、四层面阶梯、左栏与画布 ΔE、
+  正文对比度、线条色相与最小色度、预置不受影响、纯黑底色的层次余量。
+- 复核：工具链回归 8/8、两档报表 exit 0；设置页截图按新文案重拍。
+
+### 1.13.4
+用户第二次回执：同一张悬停卡「还是深灰底色」。这次**明暗两套截图对比**把 1.13.3 的方向证伪了 ——
+浅色模式下（画布 `#f8fcf6`）卡片仍是 `#2c2c2e` + 白字，颜色一个像素都没变：
+它根本不读调色板，所以改多少条 token 都碰不到。
+
+逐文件扫宿主 asar 后定位到根因：**`dsh-web-frontend` 把悬停卡底色写死在卡片元素上** ——
+`._card_38jqx_9{--dsw-hovercard-bg:#2C2C2E;background:var(--dsw-hovercard-bg)}`。
+这是全站唯一的大写手写 hex：既不读色阶、也不读别名，与主题完全无关（连浅色模式也是深灰）。
+
+- **修法**：`buildTokens` 新增专用 token `--dsh-tp-hovercard-bg`（明暗两档都取色阶 **850 的暗面**），
+  并注入第三条样式 `dsh-theme-palette/host-patch.css`：
+  `*{--dsw-hovercard-bg:var(--dsh-tp-hovercard-bg,#2c2c2e)!important}`。
+  宿主的声明在卡片元素**自身**，普通声明压不过它，必须 `!important`；只改这一个自定义属性，
+  其它元素即使命中也没有副作用。卡片保持**暗底白字**（对比度不变），但从此带上配色色相。
+  黑白档没有色阶可接，回落到宿主原色（行为不变）。
+- **断言**：`check-audit` 第 28 组 —— 明暗同值 / = 850 暗面 / 补丁样式的形态 / 黑白档不产出。
+- 复核：`npm run check` 8/8；两档报表 exit 0。
+
 ### 1.13.3
 用户实测反馈：**左侧会话行的悬停卡（会话标题 / 时间 / 状态）底色不跟随主题色** —— 卡片背景停在
 `#2c2c2e`、标题近白，而旁边的侧栏与画布都是染过色的。

package/README-es.md

@@ -28,9 +28,9 @@ El plugin solo apila tokens de color mediante `ctx.theme.overrideTokens`; no reg
 
 - **4 preajustadas + personalizada** — Mono, Arena cálida, Índigo, Musgo (cada una adaptada de forma independiente a claro y oscuro), más una paleta personalizada derivada de tres colores;
 - la escala se **recalcula** completa: reconstrucción OKLCH → croma por rol → **ajuste al gamut sRGB** → contraste resuelto sobre superficies reales;
-- se cubren todos los tokens de color del host (158 tokens en paletas con tinte, 19 en mono; 1080 combinaciones de ajuste escaneadas): texto, secundario, terciario, notas, enlaces, barras laterales, tarjetas, burbuja del usuario, botón primario, barras de desplazamiento, interruptores, títulos/negritas de Markdown, bloques de código;
+- tokens de color del host: 179 en las paletas con tinte (+13 propios del plugin), 19 en mono (1080 combinaciones de ajuste escaneadas); **los 66 tokens de color que el CSS compilado consume de verdad resuelven todos al plugin**: texto, secundario, terciario, notas, enlaces, barras laterales, tarjetas, burbuja del usuario, botón primario, barras de desplazamiento, interruptores, títulos/negritas de Markdown, bloques de código y ahora **los estados de error/éxito/aviso y las líneas +/− del diff** (las escalas roja/verde/ámbar entran por primera vez en la reconstrucción: solo temperatura, giro de tono limitado a 8°);
 - ajustable: intensidad del texto (3), profundidad de la barra lateral (3), énfasis de Markdown, barras de desplazamiento, color de interruptores;
-- **paleta personalizada** (elige superficie / texto / acento — el motor mantiene sus garantías de contraste), **exportación/importación de configuración** con un código `dshs1.`, **modo de alto contraste** y **4 idiomas de interfaz**;
+- **paleta personalizada** (elige superficie / texto / acento: el matiz del texto entra en la derivación y una superficie claramente oscura o clara pasa a ser la luminosidad del lienzo de ese modo — el motor mantiene sus garantías de contraste), **exportación/importación de configuración** con un código `dshs1.`, **modo de alto contraste** y **4 idiomas de interfaz**;
 - **autorreparable**: si el host descarta la capa de override, la paleta se vuelve a aplicar; tras fallos repetidos la autorreparación se pausa y la página de ajustes ofrece un botón para reactivarla;
 - **promesas de contraste**: el cuerpo tiene la promesa de 12:1 en claro y 10:1 en oscuro (15:1 en alto contraste), el secundario ≥ 6.2 en claro y 8.0 en oscuro (HC 9 / 9.6), el terciario ≥ 4.85 en claro y 6.4 en oscuro (HC 7 / 7.6), los enlaces ≥ 4.95 en claro y 4.62 en oscuro (HC 7; los mínimos claros llevan un margen para déficits de visión cromática; los enlaces oscuros además pasan una puerta APCA Lc ≥ 60, 75 en HC), medidos sobre las superficies donde el texto realmente cae (el lado oscuro necesita más: un cociente WCAG sobreestima la legibilidad sobre fondo oscuro);
 - las superficies prometidas son 00/60 en claro y 950/875 en oscuro; las oscuras 800 (superficie de módulo) y 850 (sub-superficie) **no** respaldan el texto del cuerpo: el informe las cuenta aparte como «fuera de política» (ni cuentan como aprobado ni como fallo);

package/README-hi.md

@@ -28,9 +28,9 @@ DeepSeek Harness (वेब और डेस्कटॉप) के लिए
 
 - **4 प्रीसेट + कस्टम** — मोनो, वार्म सैंड, इंडिगो, मॉस (हर एक लाइट और डार्क दोनों के लिए अलग से अनुकूलित), साथ ही तीन रंगों से निकली कस्टम पैलेट;
 - पूरी रैंप **दोबारा गणना** होती है, बदली नहीं जाती: OKLCH पुनर्निर्माण → भूमिका-आधारित क्रोमा → **sRGB गैमट क्लैंप** → वास्तविक सतहों पर कंट्रास्ट हल;
-- होस्ट के सभी रंग टोकन शामिल (रंगीन पैलेट में 158 टोकन, मोनो में 19; 1080 सेटिंग संयोजन पूरी तरह स्कैन किए गए): मुख्य टेक्स्ट, द्वितीयक, तृतीयक, कैप्शन, लिंक, साइडबार, कार्ड, उपयोगकर्ता बबल, प्राइमरी बटन, स्क्रॉलबार, स्विच, Markdown शीर्षक/बोल्ड, कोड ब्लॉक;
+- होस्ट के रंग टोकन: रंगीन पैलेट में 179 (+ प्लगइन के अपने 13), मोनो में 19 (1080 सेटिंग संयोजन पूरी तरह स्कैन किए गए); **बिल्ट CSS जो 66 रंग टोकन वास्तव में उपभोग करता है, वे सभी प्लगइन पर ही हल होते हैं**: मुख्य टेक्स्ट, द्वितीयक, तृतीयक, कैप्शन, लिंक, साइडबार, कार्ड, उपयोगकर्ता बबल, प्राइमरी बटन, स्क्रॉलबार, स्विच, Markdown शीर्षक/बोल्ड, कोड ब्लॉक, और अब **त्रुटि/सफलता/चेतावनी की स्थितियाँ तथा फ़ाइल diff की +/− पंक्तियाँ** (लाल/हरा/एम्बर तीनों स्केल पहली बार पुनर्निर्माण में शामिल; केवल तापमान, रंग-कोण घुमाव अधिकतम 8°);
 - समायोज्य: टेक्स्ट की तीव्रता (3), साइडबार की गहराई (3), Markdown ज़ोर, स्क्रॉलबार, स्विच का रंग;
-- **कस्टम पैलेट** (सतह / टेक्स्ट / एक्सेंट चुनें — इंजन अपने कंट्रास्ट वादे बनाए रखता है), `dshs1.` कोड से **कॉन्फ़िगरेशन निर्यात/आयात**, **हाई-कॉन्ट्रास्ट** मोड, और **4 UI भाषाएँ**;
+- **कस्टम पैलेट** (सतह / टेक्स्ट / एक्सेंट चुनें: टेक्स्ट का रंग-कोण भी व्युत्पन्न में शामिल होता है, और स्पष्ट रूप से गहरी/हल्की सतह उस मोड के कैनवास की चमक बन जाती है — इंजन अपने कंट्रास्ट वादे बनाए रखता है), `dshs1.` कोड से **कॉन्फ़िगरेशन निर्यात/आयात**, **हाई-कॉन्ट्रास्ट** मोड, और **4 UI भाषाएँ**;
 - **स्व-उपचार**: यदि होस्ट ओवरराइड परत हटा दे, पैलेट फिर से लगा दी जाती है; बार-बार विफलता पर स्व-उपचार रुक जाता है और सेटिंग्स पेज पर इसे दोबारा चालू करने का बटन मिलता है;
 - **कंट्रास्ट के वादे**: मुख्य टेक्स्ट के लिए लाइट में 12:1 और डार्क में 10:1 (उच्च-कंट्रास्ट में 15:1), द्वितीयक ≥ 6.2 (लाइट) / 8.0 (डार्क) (HC 9 / 9.6), तृतीयक ≥ 4.85 (लाइट) / 6.4 (डार्क) (HC 7 / 7.6), लिंक ≥ 4.95 (लाइट) / 4.62 (डार्क) (HC 7) — लाइट की सीमाओं में रंग-दृष्टि दोष के लिए गुंजाइश रखी गई है; डार्क लिंक अतिरिक्त APCA Lc ≥ 60 (HC 75) — उन्हीं सतहों पर मापे गए जहाँ टेक्स्ट वास्तव में बैठता है (डार्क में ज़्यादा चाहिए: गहरे बैकग्राउंड पर WCAG अनुपात पढ़ने की सुविधा को बढ़ा-चढ़ा कर दिखाता है);
 - वादे की गई सतहें लाइट में 00/60 और डार्क में 950/875 हैं; डार्क 800 (मॉड्यूल सतह) और 850 (उप-सतह) मुख्य टेक्स्ट को नहीं सहनाते — रिपोर्ट उन्हें अलग «नीति से बाहर» के रूप में गिनती है (न तो पास, न ही फेल);

package/README-ja.md

@@ -28,9 +28,9 @@ package.json の `engines` は `^22.19.0 || >=24.0.0` —— 上の表と同じ
 
 - **4 プリセット + カスタム** —— モノクロ / ウォームサンド / インディゴ / モスグリーンがライトとダークをそれぞれ独立に適応し、さらに 3 色から派生するカスタム配色；
 - 色階は置き換えではなく**全体を再計算**：OKLCH 再構築 → 役割ごとの彩度 → **sRGB ガマット・クランプ** → 実際の面でコントラストを解く；
-- ホストの全色トークンを網羅（着色パレットで 158、モノクロで 19。1080 通りの設定を全走査）：本文、二次、三次、注記、リンク、サイドバー、カード、ユーザー吹き出し、プライマリボタン、スクロールバー、スイッチ、Markdown 見出し/太字、コードブロック；
+- ホストの色トークン：着色パレットで 179（+ プラグイン自前 13）、モノクロで 19（1080 通りの設定を全走査）。**ビルド済み CSS が実際に消費する色トークン 66 個はすべてプラグインに解決されます**：本文、二次、三次、注記、リンク、サイドバー、カード、ユーザー吹き出し、プライマリボタン、スクロールバー、スイッチ、Markdown 見出し/太字、コードブロック、そして**エラー/成功/警告の状態色とファイル diff の +/− 行**（赤/緑/アンバーの三色階が初めて再構築に参加。色相の回転は 8° まで、温度だけを合わせるので意味は変わりません）；
 - 調整可：テキストの着色 3 段、サイドバー 3 段、Markdown 強調、スクロールバー、スイッチの配色；
-- **カスタム配色**（背景 / テキスト / アクセントの 3 色。極端に明るい・暗いアクセントは正規化されます）、**設定のエクスポート/インポート**（`dshs1.` ショートコードに 3 色を含む）、**ハイコントラスト**、UI 4 言語；
+- **カスタム配色**（背景 / テキスト / アクセントの 3 色。テキストの色相も派生に参加し、背景が明確に暗い／明るい場合はそのモードのキャンバス明度になります。極端なアクセントは正規化されます）、**設定のエクスポート/インポート**（`dshs1.` ショートコードに 3 色を含む）、**ハイコントラスト**、UI 4 言語；
 - **自己修復**：ホストがオーバーライド層を破棄すると自動で再適用。連続失敗すると自動再適用を停止し、設定ページに「再有効化」の入口を出します；
 - **コントラストの約束**：本文はライト 12:1 / ダーク 10:1（ハイコントラスト 15:1）、二次 ≥ 6.2（ライト）/ 8.0（ダーク）、三次 ≥ 4.85（ライト）/ 6.4（ダーク）（HC 7 / 7.6）、リンク ≥ 4.95（ライト）/ 4.62（ダーク）（HC 7。ライト側は色覚特性の余裕を含む）。ダークのリンクはさらに APCA Lc ≥ 60（HC 75）—— いずれもテキストが実際に載る面で実測（ダーク側の要求が厳しいのは、暗い背景では WCAG の比が読みやすさを過大評価するため）；
 - 約束する面はライト 00/60 とダーク 950/875。ダークの 800（モジュール面）と 850（サブ面）は**本文を保証しません** —— レポートでは「ポリシー外」として別枠（達成にも未達にも数えない）；

package/README-pt.md

@@ -28,9 +28,9 @@ O plugin apenas empilha tokens de cor via `ctx.theme.overrideTokens`; não regis
 
 - **4 predefinidas + personalizada** — Mono, Areia quente, Índigo, Musgo (cada uma adaptada de forma independente ao claro e ao escuro), mais uma paleta personalizada derivada de três cores;
 - a escala é **recalculada** por completo: reconstrução OKLCH → croma por papel → **limite de gamut sRGB** → contraste resolvido sobre superfícies reais;
-- todos os tokens de cor do host são cobertos (158 tokens nas paletas com tinta, 19 na mono; 1080 combinações de ajuste escaneadas): texto, secundário, terciário, legendas, links, barras laterais, cartões, balão do usuário, botão primário, barras de rolagem, interruptores, títulos/negrito de Markdown, blocos de código;
+- tokens de cor do host: 179 nas paletas com tinta (+13 do próprio plugin), 19 na mono (1080 combinações de ajuste escaneadas); **os 66 tokens de cor que o CSS compilado realmente consome resolvem todos no plugin**: texto, secundário, terciário, legendas, links, barras laterais, cartões, balão do usuário, botão primário, barras de rolagem, interruptores, títulos/negrito de Markdown, blocos de código e agora **os estados de erro/sucesso/aviso e as linhas +/− do diff** (as escalas vermelho/verde/âmbar entram pela primeira vez na reconstrução: só temperatura, rotação de matiz limitada a 8°);
 - ajustável: intensidade do texto (3), profundidade da barra lateral (3), ênfase de Markdown, barras de rolagem, cor dos interruptores;
-- **paleta personalizada** (escolha superfície / texto / acento — o motor mantém as garantias de contraste), **exportação/importação de configuração** por um código `dshs1.`, **modo de alto contraste** e **4 idiomas de interface**;
+- **paleta personalizada** (escolha superfície / texto / acento: a matiz do texto entra na derivação e uma superfície claramente escura ou clara vira a luminosidade do canvas daquele modo — o motor mantém as garantias de contraste), **exportação/importação de configuração** por um código `dshs1.`, **modo de alto contraste** e **4 idiomas de interface**;
 - **autorrecuperação**: se o host descartar a camada de override, a paleta é reaplicada; após falhas repetidas a autorrecuperação pausa e a página de ajustes oferece um botão para reativá-la;
 - **promessas de contraste**: o corpo tem a promessa de 12:1 no claro e 10:1 no escuro (15:1 em alto contraste), o secundário ≥ 6.2 no claro e 8.0 no escuro (HC 9 / 9.6), o terciário ≥ 4.85 no claro e 6.4 no escuro (HC 7 / 7.6), os links ≥ 4.95 no claro e 4.62 no escuro (HC 7; os pisos do lado claro têm margem para deficiências de visão cromática; os links escuros ainda passam por um portão APCA Lc ≥ 60, 75 em HC), medidos nas superfícies onde o texto realmente cai (o lado escuro precisa de mais: uma razão WCAG superestima a legibilidade sobre fundo escuro);
 - as superfícies prometidas são 00/60 no claro e 950/875 no escuro; as escuras 800 (superfície de módulo) e 850 (sub-superfície) **não** sustentam o texto do corpo: o relatório as conta à parte como «fora de política» (nem contam como aprovado nem como falha);

package/README-zh.md

@@ -28,9 +28,9 @@ package.json 的 `engines` 字段写的是 `^22.19.0 || >=24.0.0`——与上表
 
 - **4 套预设 + 自定义** —— 黑白 / 暖砂 / 靛蓝 / 苔绿各自独立适配明暗两侧，另加由三色派生的自定义配色；
 - 色阶**整体重算**而不是替换：OKLCH 重建 → 角色化色度 → **sRGB 色域钳位** → 在真实承载面上求解对比度；
-- 覆盖宿主全部颜色 token（自定义/染色档 158 个、黑白档 19 个；1080 组设置全扫描）：正文、次级、三级、注释、链接、侧栏、卡片、主人气泡、主按钮、滚动条、开关、Markdown 标题/加粗、代码块；
+- 覆盖宿主颜色 token：染色档 179 个宿主 token + 13 个插件自有 token，黑白档 19 个（1080 组设置全扫描）；**构建 CSS 实际消费的 66 个颜色 token 全部覆盖或跟随**—— 正文、次级、三级、注释、链接、侧栏、卡片、主人气泡、主按钮、滚动条、开关、Markdown 标题/加粗、代码块，以及**错误/成功/警告状态与文件 diff 的 +/− 行**（红/绿/琥珀三族第一次参与重建：只调温度、色相旋转封顶 8°，语义不漂）；
 - 可调：文字着色三档、侧栏三档、Markdown 强调、滚动条、开关配色；
-- **自定义配色**（给 底色/文字/强调 三色，文字色相也参与派生；过亮/过暗的强调色会归一化）、**配置导入导出**（`dshs1.` 短码含三色）、**高对比**档、4 种界面语言；
+- **自定义配色**（给 底色/文字/强调 三色：文字的色相参与派生，**底色偏暗/偏亮会成为对应模式的画布明度**；过亮/过暗的强调色会归一化）、**配置导入导出**（`dshs1.` 短码含三色）、**高对比**档、4 种界面语言；
 - **自愈**：宿主丢弃 override 层时自动重放；自动重放连续失败后会停用，并在设置页给出「重新启用」入口；
 - **对比度承诺**：正文浅色 12:1、深色 10:1（高对比 15:1），次级 ≥ 6.2 浅 / 8.0 深，三级 ≥ 4.85 浅 / 6.4 深（高对比 7 / 7.6），链接 ≥ 4.95 浅 / 4.62 深（高对比 7；浅色留了色觉缺陷余量），链接深色另过 APCA Lc ≥ 60（高对比 75）—— 都在文字真实落到的承载面上实测（深色要高一些：WCAG 比值在暗底上会高估可读性）；
 - 承诺面是浅色 00/60 与深色 950/875；深色 800（模块面）与 850（次级深面）**不为正文兜底**，报表单列为「政策外」（既不算达标也不算失败）；
@@ -70,6 +70,8 @@ OKLCH(L, C, hue) ──► 色域钳位（对 C 二分） ──► sRGB hex
 
 - 语义别名保留 `var(--dsw-static-neutral-bluish-NN)` 引用链，跟 token 的元素就跟着配色走；
 - 浅色面用色阶 00–300，深色面用 800–950；
+- **语义色（1.13.5）**：宿主自带的红/绿/琥珀三族不重排明度，只按配色色相做**温度调和**（`harmonizeSemantic`：色相旋转封顶 8°、色度压到 88–92%），所以「错误仍是红、成功仍是绿、警告仍是琥珀」，只是换了一套冷暖；无彩（纯黑/纯白/正灰）的自定义配色不做调和，一个像素都不动；
+- **覆盖口径可验证**：`tools/check-host-contract.mjs` 从宿主构建里解出「应用 CSS 真正 `var()` 消费的颜色 token」，逐条要求它要么被插件声明、要么 `var()` 链落到插件声明的 token 上 —— 1.13.4 及以前这条会挂 30 处（红/绿/琥珀三族 + 危险悬停 + diff 行），1.13.5 起为 0；
 - 文字下限在构建期强制：正文浅色 ≥ 12:1、深色 ≥ 10:1（高对比 15:1），次级 ≥ 6.2 浅 / 8.0 深（HC 9 / 9.6），三级 ≥ 4.85 浅 / 6.4 深（HC 7 / 7.6），链接 ≥ 4.95 浅 / 4.62 深（HC 7），链接另过 APCA Lc ≥ 60 深 / 75 HC；侧栏与气泡文字随色阶派生，实测均 ≥ 7（不设独立对比度门）；
 - 承诺面是浅色 00/60 与深色 950/875；深色 800（模块面）与 850（次级深面）**不为正文兜底**，报表单列为「政策外」（既不算达标也不算失败），且每一档承载面仍须过 AA 底线 4.5；
 - 报表把三件事分开：声明目标、物理上限（该承载面上黑或白前景能达到的对比度）、政策豁免；0.93 只是求解余量，仅用于判断目标是否高于上限；

package/README.md

@@ -28,9 +28,9 @@ The plugin only stacks colour tokens through `ctx.theme.overrideTokens`; it does
 
 - **4 presets + custom** — Mono, Warm sand, Indigo, Moss (each adapting to light *and* dark independently), plus a custom palette derived from three colours;
 - the whole ramp is **recomputed**, not swapped: OKLCH rebuild → role-based chroma → **sRGB gamut clamp** → contrast solved on real surfaces;
-- every host colour token is covered (158 tokens for tinted palettes, 19 for mono; 1080 setting combinations fully scanned): body, secondary, tertiary, captions, links, sidebars, cards, user bubble, primary button, scrollbars, switches, Markdown headings/bold, code blocks;
+- host colour tokens: 179 for tinted palettes plus 13 plugin-owned tokens, 19 for mono (1080 setting combinations fully scanned); **all 66 colour tokens the built CSS actually consumes resolve to the plugin** — body, secondary, tertiary, captions, links, sidebars, cards, user bubble, primary button, scrollbars, switches, Markdown headings/bold, code blocks, and now **error/success/warning states and the +/− rows of the file diff** (the red/green/amber scales join the rebuild for the first time: temperature only, hue rotation capped at 8°, so the semantics never drift);
 - adjustable: text tint (3), sidebar depth (3), Markdown emphasis, scrollbars, switch colour;
-- **custom palette** (pick surface / text / accent — the engine keeps its contrast guarantees), **config export/import** via a `dshs1.` code, **high-contrast** mode, and 4 UI languages;
+- **custom palette** (pick surface / text / accent — the text hue joins the derivation, and a clearly dark or light surface becomes that mode's canvas lightness; the engine keeps its contrast guarantees), **config export/import** via a `dshs1.` code, **high-contrast** mode, and 4 UI languages;
 - **self-healing**: if the host drops the override layer, the palette is re-applied; after repeated failures auto-restore pauses and the settings page offers a re-enable button;
 - **contrast promises**: body text is promised 12:1 in light and 10:1 in dark (15:1 in high contrast), secondary ≥ 6.2 in light / 8.0 in dark (HC 9 / 9.6), tertiary ≥ 4.85 in light / 6.4 in dark (HC 7 / 7.6), links ≥ 4.95 in light / 4.62 in dark (HC 7; the light floors carry a colour-vision headroom; dark links also clear an APCA Lc ≥ 60 gate, 75 in HC) — measured on the surfaces the text actually lands on (the dark side needs more, because a WCAG ratio overstates readability on a dark background);
 - the promised surfaces are light 00/60 and dark 950/875; dark 800 (module surface) and 850 (sub-surface) do **not** back body text — the report counts them apart as "out of policy" (neither pass nor fail);
@@ -70,6 +70,8 @@ OKLCH(L, C, hue) ──► gamut clamp (binary search on C) ──► sRGB hex
 
 - semantic aliases keep `var(--dsw-static-neutral-bluish-NN)` chains, so anything following a token follows the palette;
 - light surfaces use steps 00–300, dark surfaces 800–950;
+- **semantic colours (1.13.5)**: the host's red/green/amber scales keep their host lightness and only get a **temperature harmonisation** toward the palette hue (`harmonizeSemantic`: hue rotation capped at 8°, chroma scaled to 88–92%) — error stays red, success stays green, warning stays amber, just in the palette's warm/cool key; an achromatic custom palette (pure black/white/grey) is left untouched;
+- **the coverage claim is testable**: `tools/check-host-contract.mjs` extracts every colour token the built CSS actually consumes and requires each one to be either declared by the plugin or to end its `var()` chain in a declared token — 1.13.4 and earlier fail this with 30 leaks (red/green/amber, danger hover, diff rows), 1.13.5 reports zero;
 - text floors are enforced at build time: body ≥ 12:1 in light and ≥ 10:1 in dark (high contrast: 15:1), secondary ≥ 6.2 in light / 8.0 in dark (HC 9 / 9.6), tertiary ≥ 4.85 in light / 6.4 in dark (HC 7 / 7.6), link ≥ 4.95 in light / 4.62 in dark (HC 7), link APCA Lc ≥ 60 in dark (HC 75); sidebar and bubble text follow the ramp and measure ≥ 7 (no separate contrast gate);
 - the promised surfaces are light 00/60 and dark 950/875; dark 800 (module surface) and 850 (sub-surface) do **not** back body text — the report counts them apart as "out of policy" (neither pass nor fail), and every surface still has to clear the AA floor of 4.5;
 - the report separates three things: the declared target, the physical ceiling (what black or white can reach on that surface) and the policy exemption; 0.93 is only a solver margin, used to decide whether a target sits above the ceiling;

package/assets/screenshots.meta.json

@@ -1,7 +1,7 @@
 {
-  "generatedAt": "2026-10-29T11:29:25.163Z",
-  "pluginVersion": "1.13.3",
-  "chrome": "Chrome/156.0.8078.49",
+  "generatedAt": "2026-10-30T15:33:51.493Z",
+  "pluginVersion": "1.13.5",
+  "chrome": "Chrome/155.0.8059.85",
   "width": 620,
   "scale": 1,
   "images": [
@@ -14,13 +14,13 @@
         "--adv",
         "0"
       ],
-      "htmlSha256": "8952278cd4d7eb94840604c8ffddba4c51670dd565bf80ead6f8820a84eff661",
+      "htmlSha256": "72e549c29634c57766d6c158c44abac17540a69846b40959e8703e367cb70342",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
-      "bytes": 47480,
-      "sha256": "2504df2500e798c458dcb3014882b880c96ca09a057702a2845fd0252a2b736b"
+      "bytes": 47280,
+      "sha256": "9cfc50ae62a47151c4f91227aac492d0f75e71f49ead95bf7eb94cfb36582cb1"
     },
     {
       "file": "assets/screenshot-settings-dark.png",
@@ -31,13 +31,13 @@
         "--adv",
         "0"
       ],
-      "htmlSha256": "c8c71e00b0e2518beea8f4b58e64c57b70e7903f69829a9652fb27f11e3ffd6d",
+      "htmlSha256": "fba6044a9742347944f900f75961d81f99df53ea44b9e40924b4286e0f46abb3",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
-      "bytes": 47789,
-      "sha256": "4133eaf99848b36dd4df90b5604155878df9f5b47d09e6cdccdce1e8b9fb3ca5"
+      "bytes": 47814,
+      "sha256": "4aa499cf86eae625e7648aafc692263dfde7f6eddf2d36bf3bf3e5005a1345dc"
     },
     {
       "file": "assets/screenshot-settings-custom.png",
@@ -50,13 +50,13 @@
         "--out",
         "customadv"
       ],
-      "htmlSha256": "199f061201c88c70c0228dc2d9066f83d333f7b7f3c20627a3fe947b81e36084",
+      "htmlSha256": "147f41c51dd2373d76eb16d07fd175630f0d8e75f7ca93f3209b66ec7d15d018",
       "cssWidth": 620,
-      "cssHeight": 1753,
+      "cssHeight": 1771,
       "width": 620,
-      "height": 1753,
-      "bytes": 116545,
-      "sha256": "c2b6d3d6e0a11b2da64c16b9729b0aa12b8cd9ea47b9627cd2d95881008306ab"
+      "height": 1771,
+      "bytes": 118730,
+      "sha256": "123909ebbbf6827a7d2f1b8d06976bffc6e64883cb1a8f624c398410d8af2805"
     },
     {
       "file": "assets/screenshot-settings-hc.png",
@@ -69,13 +69,13 @@
         "--out",
         "hcadv"
       ],
-      "htmlSha256": "56ea7c65091e98ff5a25149cd39933b14035da47ebc986ec4afb423ef0f475f6",
+      "htmlSha256": "62c56df0d28276506415c4d53ec22509c14ad4cff1c2ad8be2aca1242dd63f81",
       "cssWidth": 620,
       "cssHeight": 1463,
       "width": 620,
       "height": 1463,
-      "bytes": 94765,
-      "sha256": "db1ff1416e5d6b0a0202f5a435a64137f4bf13a35fce6d43ad53497358b279cb"
+      "bytes": 94312,
+      "sha256": "37e5795563143fff26b4c72af62a9db82f113db7dac609eb7feab539a6d9cee2"
     }
   ]
 }

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.13.3'
+    const PLUGIN_VERSION = '1.13.5'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -58,6 +58,48 @@ window.__ModuleLoader__.load({
       },
     }
 
+    /* ================= 语义色阶（宿主原生红 / 绿 / 琥珀）=================
+     * 2026-10-30：宿主 `design-platform.css` 里除了四个中性/品牌色阶（bluish / neutral /
+     * deepseek / blue），还并列着三族**语义色阶**：red / green / amber。插件此前只重建前四族，
+     * 于是自定义配色下「步骤点、`data-tone` 标签、文件 diff 的 +/− 行、危险菜单项悬停、
+     * 无效输入边框」永远停在宿主的纯红 / 纯绿 / 纯琥珀（逐条核过：58 个颜色 token 里
+     * 39 个最终落在字面色值上，红绿琥珀占了绝大多数）。
+     *
+     * 重建方式与 file-diff 同一手法 —— **只换温度，不动语义**：
+     * 色相往配色色相拉一小段（封顶 ±8°，见 harmonizeSemantic）、色度压到 0.88–0.92，
+     * 明度一律沿用宿主。明度不动是关键：宿主的语义色明暗节奏（浅色 600/500 当字、100 当底；
+     * 深色反过来用 400/900）是它自己的对比度策略，改明度会把宿主的层次算坏。
+     *
+     * 黑白档（mono）不重建：它按设计只动 19 个 token，语义色保持宿主原样。
+     */
+    const SEMANTIC_BASE = {
+      red: { '50': '#fef2f2', '100': '#fee2e2', '400': '#f25a5a', '500': '#ef4444', '600': '#ec1313', '900': '#570c0c' },
+      green: { '100': '#e6faed', '400': '#4ed17e', '500': '#22c55e', '900': '#233c2c' },
+      amber: { '100': '#fef5e7', '400': '#f7ad31', '500': '#f59e0b', '600': '#dd8629', '900': '#27241f' },
+    }
+    /* 宿主在同一条色阶上另给了四个**带 alpha 的底色档**（diff 行底），单列在这里：
+     * 它们不是独立色相，而是 base + alpha，调和时只能先调 base 再补 alpha，
+     * 否则 8 位 hex 进 harmonize 会被当非法输入。 */
+    const SEMANTIC_ALPHA = {
+      green: { '500-a08': ['500', 0.078], '500-a12': ['500', 0.121] },
+      red: { '600-a08': ['600', 0.078], '400-a12': ['400', 0.121] },
+    }
+    /* 语义色色相旋转上限（度）与拉近系数。一个都不能多：苔绿配色（hue 162）的
+     * "短路径"会把红（OKLCH h≈28°）往黄绿推，推多了红就滑成琥珀、和警告撞色；
+     * 封到 8° 后观感只是"同一件语义色换了冷暖"（暖砂→朱红、靛蓝→绯红），语义不丢。 */
+    const SEMANTIC_TURN = 8
+    const SEMANTIC_PULL = 0.12
+
+    /**
+     * 语义色温度调和：与 harmonize 的差别只有一条 —— **色相旋转按 SEMANTIC_TURN 封顶**。
+     * 明度与色相的"主"部分保持宿主原样，所以红仍是红、绿仍是绿、琥珀仍是琥珀。
+     */
+    function harmonizeSemantic(hex, targetHue, chromaScale) {
+      const [L, C, h] = toOklch(hex)
+      const dh = ((targetHue - h + 540) % 360) - 180
+      return fromOklch(L, C * chromaScale, h + clamp(dh * SEMANTIC_PULL, -SEMANTIC_TURN, SEMANTIC_TURN))
+    }
+
     /**
      * 每一步在 UI 里的角色 → 色度权重来源。
      * light = 浅色模式的底/卡片/悬浮层；mid = 中间灰（边框、次级 UI）；
@@ -238,6 +280,29 @@ window.__ModuleLoader__.load({
       }
       const lightC = achromatic ? 0 : clampN(bg[1] * 0.9, 0.008, 0.045)
       const darkC = achromatic ? 0 : clampN(bg[1] * 0.75, 0.006, 0.035)
+      /* ---------- 底色明度（2026-10-30 用户回执 #2：选 #070b11 当底色，界面还是"默认深灰"）----------
+       * 1.13.5 以前只取底色的**色相与色度**，明度完全由引擎按模式给：
+       * 深色画布固定 L≈0.235（#191c21 一档的蓝灰）。用户把「底色」设成 #070b11（L≈0.15）时，
+       * 屏幕上看不到自己选的那个底色 —— 读起来就是"很多地方底色还是默认的"，而且说得对。
+       *
+       * 现在把「底色」当真的底色用：
+       *   底色偏暗（L ≤ 0.45）→ 它就是**深色模式**的画布明度（钳到 0.10–0.24，别把卡层挤没）；
+       *   底色偏亮（L ≥ 0.55）→ 它就是**浅色模式**的画布明度（钳到 0.90–0.985）。
+       * 中间灰（0.45–0.55）视为"没有偏好"，两侧都沿用引擎值 —— 那种输入表达不出明暗意图。
+       * 只锚**画布这一档**：其余层按原间距整体平移（见 buildRamps），文字对比度照旧由求解器
+       * 在新承载面上重算，承诺下限不变。 */
+      /* 下限 0.14 是**层次余量**，不是审美：深色侧还有三个更亮的面（875/850/800，各 +0.03 L）
+       * 和左栏「更深」一档（再 -0.042）——画布压到 0.10 时左栏会掉到 #020407（近纯黑，
+       * 和画布只差 ΔE 2 但整体塌成一块）。0.14 让整条阶梯仍有 ~0.09 L 的可用空间，
+       * 用户选 #070b11 这种近黑底色时观感仍是"近黑"，但层次还在。
+       *
+       * 阈值 0.35 / 0.75：只有"明显偏暗"或"明显偏亮"才算表达了明暗意图；
+       * 中间灰（L 0.35–0.75）两侧都不锚 —— 那既不表达深色也不表达浅色，硬锚会把浅色画布
+       * 压成 0.90 的中灰，等于凭空换了套配色。 */
+      const CANVAS_L_DARK = [0.14, 0.30]
+      const CANVAS_L_LIGHT = [0.90, 0.985]
+      const canvasDarkL = bg[0] <= 0.35 ? clampN(bg[0], CANVAS_L_DARK[0], CANVAS_L_DARK[1]) : undefined
+      const canvasLightL = bg[0] >= 0.75 ? clampN(bg[0], CANVAS_L_LIGHT[0], CANVAS_L_LIGHT[1]) : undefined
       return {
         id: 'custom', label: '自定义', desc: '三色派生', tinted: true, custom: true,
         hue, darkHue: hue, achromatic,
@@ -247,6 +312,7 @@ window.__ModuleLoader__.load({
         textC: achromatic ? 0 : clampN(tx[1], 0.002, 0.030), textHue: achromatic ? hue : tx[2],
         darkC, darkLift: 0.030,
         paperC: achromatic ? 0 : clampN(tx[1], 0.004, 0.030), paperHue: achromatic ? hue : tx[2],
+        canvasDarkL, canvasLightL,
         // accentL 必须钳位：500 档同时是 --dsw-alias-link、button-info-fill 与勾选支点的来源。
         // 纯白/荧光黄会让填充与白字同色；只在极端输入时归一化，预设色不受影响。
         accentHue: ac[2], accentC: clampN(ac[1], 0.04, 0.18), accentL: clampN(ac[0], 0.30, 0.64), accentScale: 1.0,
@@ -944,6 +1010,21 @@ window.__ModuleLoader__.load({
         const hue = L <= 0.45 && scheme.darkHue !== undefined ? scheme.darkHue : scheme.hue
         neutral[step] = fromOklch(compressL(L), c, hue)
       }
+      /* 语义色阶：只换温度（见 harmonizeSemantic），明度与宿主一致。
+       * 面（50/100/900）压到 0.88 的色度、字（400–600）留 0.92 —— 大面积色块要读成
+       * 「同一张纸」，而标签/步骤点的字色一旦发灰，「操作成功/失败」就不再一眼可辨。 */
+      const semantic = {}
+      for (const [family, table] of Object.entries(SEMANTIC_BASE)) {
+        const out = {}
+        for (const [step, hex] of Object.entries(table)) {
+          const surface = step === '50' || step === '100' || step === '900'
+          out[step] = scheme.achromatic === true ? hex : harmonizeSemantic(hex, scheme.hue, surface ? 0.88 : 0.92)
+        }
+        for (const [suffix, [base, alpha]] of Object.entries(SEMANTIC_ALPHA[family] || {})) {
+          out[suffix] = withAlpha(out[base], alpha)
+        }
+        semantic[family] = out
+      }
       const accent = (ramp) => {
         const out = {}
         for (const [step, hex] of Object.entries(ramp)) {
@@ -1003,7 +1084,24 @@ window.__ModuleLoader__.load({
         bluish['100'] = lerp(0.55)
         bluish['200'] = lerp(1.25)
       }
-      return { bluish, neutral, deepseek: accent(BASE.deepseek), blue: accent(BASE.blue) }
+      /* 自定义配色：把画布锚到用户「底色」的明度（见 customScheme 的 canvasDarkL / canvasLightL）。
+       * 在整条色阶**建好之后**按同一 delta 平移那一组面，层与层的间距不变；
+       * 只动面档（深色 800–950 / 浅色 00–200），文字档留给 tuneRamps 在新面上重解。
+       * 预置不参与：它们的明度是设计稿钉死的（SURFACE_TARGETS）。 */
+      if (scheme.custom === true) {
+        const shiftSurfaces = (steps, target, canvasStep) => {
+          if (target === undefined) return
+          const delta = target - toOklch(bluish[canvasStep])[0]
+          if (Math.abs(delta) < 0.002) return
+          for (const step of steps) {
+            const [L, C, h] = toOklch(bluish[step])
+            bluish[step] = fromOklch(clamp(L + delta, 0.02, 0.995), C, h)
+          }
+        }
+        shiftSurfaces(['800', '850', '875', '900', '950'], scheme.canvasDarkL, '950')
+        shiftSurfaces(['00', '60', '75', '100', '150', '200'], scheme.canvasLightL, '00')
+      }
+      return { bluish, neutral, deepseek: accent(BASE.deepseek), blue: accent(BASE.blue), ...semantic }
     }
 
     /**
@@ -1219,7 +1317,7 @@ window.__ModuleLoader__.load({
      * 不跟着色阶走，必须单独覆盖，否则暖底上会出现冷灰发丝线。
      * 值按「浅色 / 深色」给一对（overrideTokens 的硬性要求）。
      */
-    function aliasOverrides(r, hc) {
+    function aliasOverrides(r, hc, params) {
       const ink = r.bluish['1000'] // 浅色模式的墨色
       const paper = r.bluish['50'] // 深色模式的纸白
       const grey = r.bluish['700'] // 悬浮在媒体上的工具条用中性灰
@@ -1228,9 +1326,19 @@ window.__ModuleLoader__.load({
        * （参考实现也是这个量级，界面不会变成表格）。但高对比模式继续用 alpha 就说不过去了：
        * 1.9.8 的 HC 只改了文字，边框 alpha 没动，实测数值完全一样，HC 名不副实。
        * 现在 HC 下按 SC 1.4.11 对承载面反解到 3:1 / 3.4:1 / 4:1，三档保留层级。
-       */
+       *
+       * 2026-10-30（用户回执 #2「线条色还是默认的」）：发丝线一直取**文字色**的 alpha。
+       * 文字色一旦近中性（例如自定义的 #e1eced，C≈0.012），线条就等于中性白 α —— 屏幕上
+       * 确实没有任何主题色。自定义配色下改成：明度与 alpha 仍取墨/纸（对比关系不变），
+       * 但**色相取配色色相、色度给下限 0.02**，让线条带上主题色而不是一块灰。 */
+      const borderInk = (mode) => {
+        const base = mode === 'light' ? ink : paper
+        if (!params || params.custom !== true) return base
+        const [L, C, h] = toOklch(base)
+        return fromOklch(L, Math.max(C, 0.02), params.hue)
+      }
       const inkOf = (mode) => (mode === 'light' ? ink : paper)
-      const alphaBorder = (mode, alpha) => withAlpha(inkOf(mode), alpha)
+      const alphaBorder = (mode, alpha) => withAlpha(borderInk(mode), alpha)
       /**
        * HC 的边框要的是**定量**：3.0 / 3.4 / 4.0。之前用 solveForeground 求解，
        * 从墨色起步时它一步都不用挪就「已达标」→ 直接返回墨色，实测 16.9:1 ——
@@ -1246,7 +1354,7 @@ window.__ModuleLoader__.load({
        */
       const solidBorder = (mode, target) => mixToContrast(
         mode === 'light' ? [r.bluish['00'], r.bluish['60']] : [r.bluish['875'], r.bluish['850']],
-        inkOf(mode),
+        borderInk(mode),
         target,
       )
       const border = (mode, alpha, target) => (hc ? solidBorder(mode, target) : alphaBorder(mode, alpha))
@@ -1339,6 +1447,39 @@ window.__ModuleLoader__.load({
           light: mixHex(r.deepseek['500'], r.bluish['00'], 0.11),
           dark: mixHex(r.deepseek['400'], r.bluish['950'], 0.13),
         },
+
+        /* ---- 语义色（2026-10-30）----
+         * 宿主把这一族写成 `var(--dsw-static-red/green/amber-NN)`，而这三族此前根本没被重建，
+         * 于是一整套「错误 / 成功 / 警告 / diff / 危险悬停」在自定义配色下保持宿主原色。
+         * 现在色阶跟着配色调温度（SEMANTIC_BASE），别名这里**显式落地**对应档位 ——
+         * 明暗两侧档位不同（错误浅色 600 / 深色 400，成功与警告两侧同档），
+         * 与宿主 design-platform.css 逐条对齐，`tools/check-host-contract.mjs` 会核这张表。
+         */
+        '--dsw-alias-state-error-primary': { light: r.red['600'], dark: r.red['400'] },
+        '--dsw-alias-state-error-secondary': { light: r.red['400'], dark: r.red['400'] },
+        '--dsw-alias-state-success-primary': { light: r.green['500'], dark: r.green['500'] },
+        '--dsw-alias-state-success-secondary': { light: r.green['400'], dark: r.green['400'] },
+        // 成功/警告的「浅底」在深色模式换成深底（宿主用的是 green-900 / amber-900）
+        '--dsw-alias-state-success-tertiary': { light: r.green['100'], dark: r.green['900'] },
+        '--dsw-alias-state-warn-primary': { light: r.amber['500'], dark: r.amber['500'] },
+        '--dsw-alias-state-warn-secondary': { light: r.amber['400'], dark: r.amber['400'] },
+        '--dsw-alias-state-warn-tertiary': { light: r.amber['100'], dark: r.amber['900'] },
+        '--dsw-alias-state-warn-label': { light: r.amber['600'], dark: r.amber['600'] },
+        // 宿主**没有定义**、但构建 CSS 在用的错误文字色（设置页「保存失败」那一行）。
+        // 缺失时那条 color 声明整条失效 → 文字回落到继承色，看着像没报错。
+        '--dsw-alias-label-error': { light: r.red['600'], dark: r.red['400'] },
+        // 文件 diff 的 +/− 行底：宿主现在用的是 code-diff-*（不是 file-diff-*，后者仍保留给旧构建）
+        '--dsw-alias-code-diff-added': { light: r.green['500-a08'], dark: r.green['500-a12'] },
+        '--dsw-alias-code-diff-deleted': { light: r.red['600-a08'], dark: r.red['400-a12'] },
+        // 危险菜单项 hover/focus 底：宿主给的是 `#ec13130d`（浅，5%）/`#f25a5a26`（深，15%）两个字面量，
+        // 这里用同一档密度（13/255 与 38/255）从语义红重新合成，色相才跟得上配色
+        '--dsw-alias-interactive-bg-hover-danger': {
+          light: withAlpha(r.red['600'], 13 / 255),
+          dark: withAlpha(r.red['400'], 38 / 255),
+        },
+        // 宿主同样没有定义、但构建 CSS 在用的第四层面（帮助按钮 hover）：给一档与
+        // --dsw-alias-button-floating-hover 同档的面，正好是「比 layer-3 再抬一层」的语义
+        '--dsw-alias-bg-layer-4': { light: r.bluish['75'], dark: r.bluish['800'] },
       }
     }
 
@@ -1652,7 +1793,7 @@ window.__ModuleLoader__.load({
             }
           }
         }
-        const aliases = aliasOverrides(ramps, hc)
+        const aliases = aliasOverrides(ramps, hc, params)
         for (const [name, pair] of Object.entries(aliases)) pairs[name] = pair
       }
       const sidebar = sidebarTokens(ramps, sidebarMode, params.tinted, params)
@@ -1936,6 +2077,12 @@ window.__ModuleLoader__.load({
         const dark = pairs['--dsw-static-neutral-bluish-' + steps.dark]
         if (light && dark) pairs[name] = { light: light.light, dark: dark.dark }
       }
+      // 宿主悬停卡的专用底色（配合 HOST_PATCH_CSS）：宿主把卡片底色写死成 #2C2C2E，
+      // 这里给一个**两档都取暗面**的 token —— 卡片始终是暗底白字（对比度不变），但带上配色色相。
+      if (pairs['--dsw-static-neutral-bluish-850']) {
+        const hoverBg = pairs['--dsw-static-neutral-bluish-850'].dark
+        pairs['--dsh-tp-hovercard-bg'] = { light: hoverBg, dark: hoverBg }
+      }
       // 覆盖层标记（自愈判据用）：宿主撤销这一层时它会一起消失。
       pairs[LAYER_MARK] = { light: '1', dark: '1' }
 return pairs
@@ -1996,7 +2143,25 @@ return pairs
       '[class*="_markdown_"] :not(pre) > code{background:var(--dshtp-code-inline,inherit)}',
     ].join('')
 
-    /* ================= 设置页样式（head 里第二条 CSS） ================= */
+    /* ================= 宿主补丁样式（head 里第三条 CSS） =================
+     *
+     * 为什么需要它（2026-10-29 用户实测，第二轮回执）：
+     *   宿主的「悬停卡」（hover card，会话行悬停时弹出的小卡）把底色**写死在卡片元素上**：
+     *   dsh-web-frontend 的 `._card_38jqx_9{--dsw-hovercard-bg:#2C2C2E;background:var(--dsw-hovercard-bg)}`。
+     *   这是一个**手写字面量**（全站唯一的大写 hex），既不读色阶也不读别名 ——
+     *   所以浅色模式下它也是深灰、明暗两套主题下颜色一模一样。改多少条 token 都碰不到它。
+     *
+     * 修法：给一个**专用 token**（`--dsh-tp-hovercard-bg`，见 buildTokens：两档都取色阶 850 的暗色值），
+     * 再用 `*` + `!important` 把它接到宿主的 `--dsw-hovercard-bg` 上 —— 宿主的声明在卡片元素自身，
+     * 普通声明压不过它，必须 important。白字保持不变（暗底白字，对比度不受影响），
+     * 卡片从此带上配色的色相，而不是一块中性的深灰。
+     */
+    const HOST_PATCH_STYLE_ID = 'dsh-theme-palette/host-patch.css'
+    const HOST_PATCH_CSS = `
+/* 宿主悬停卡：--dsw-hovercard-bg 是宿主写死的 #2C2C2E；这里接回配色的暗面（见 buildTokens 的 --dsh-tp-hovercard-bg） */
+*{--dsw-hovercard-bg:var(--dsh-tp-hovercard-bg,#2c2c2e)!important}
+`
+    /* ================= 设置页样式（head 里第四条 CSS） ================= */
     const SETTINGS_STYLE_ID = 'dsh-theme-palette/settings.css'
     const SETTINGS_CSS = `
 .dsh-tp{display:flex;flex-direction:column;gap:14px;width:100%;color:var(--dsw-alias-label-primary);box-sizing:border-box}
@@ -2127,8 +2292,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
       }
     }
 
-    function installSettingsStyle() {
-      try {
+    function installSettingsStyle() {      try {
         if (typeof document === 'undefined' || !document.head) return () => {}
         let tag = document.querySelector('style[data-plugin-css="' + SETTINGS_STYLE_ID + '"]')
         if (!tag) {
@@ -2146,6 +2310,25 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
       }
     }
 
+    /** 宿主补丁（悬停卡写死的底色）——与另外两条样式同构：覆盖写 + 卸载移除。 */
+    function installHostPatchStyle() {
+      try {
+        if (typeof document === 'undefined' || !document.head) return () => {}
+        let tag = document.querySelector('style[data-plugin-css="' + HOST_PATCH_STYLE_ID + '"]')
+        if (!tag) {
+          tag = document.createElement('style')
+          tag.dataset.plugin = 'dsh-theme-palette'
+          tag.dataset.pluginCss = HOST_PATCH_STYLE_ID
+          document.head.appendChild(tag)
+        }
+        tag.textContent = HOST_PATCH_CSS
+        return () => { if (tag.parentNode) tag.remove() }
+      } catch (err) {
+        console.warn('[dsh-theme-palette] 宿主补丁样式注入失败：', err)
+        return () => {}
+      }
+    }
+
     /* ================= 运行时自检 ================= */
     /**
      * 宿主若改了 token 名，插件会**静默失效**（overrideTokens 照收，样式不生效）。
@@ -2451,11 +2634,11 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         lang: '语言',
         hc: '高对比',
         custom: '自定义配色',
-        customHint: '取三个色的色相与色度；过亮/过暗的强调色会归一化以保证可读，明度由引擎按模式计算。',
+        customHint: '取三个色的色相与色度；底色偏暗会当作深色模式的画布、偏亮会当作浅色模式的画布（过暗/过亮的会被夹回可用区间）；过亮/过暗的强调色会归一化以保证可读。',
         derive: '由主色派生',
         deriveHint: '用当前强调色的色相与色度推导底色与文字（明暗跟随当前模式）',
         deriveNote: '「由主色派生」以强调色为唯一输入，自动算出底色与文字 —— 会覆盖你手动设置的底色与文字；派生之后仍可逐项手改。',
-        notice: '1.13.3：修复左侧会话行悬停卡的底色不跟随主题色——宿主把表面别名写成色阶引用，浮层里这条链不生效；现在 47 个表面别名直接写入覆盖层。',
+        notice: '1.13.5：错误/成功/警告与文件 diff 的 +/− 行也跟着配色了 —— 红/绿/琥珀三族第一次参与重建，只调温度、色相旋转封顶 8°。',
         dismiss: '知道了',
         explainClamp: '强调色已归一化：{from} → {to}（保证按钮与勾选可读）',
         explainLink: '链接已为可读性压暗：{ratio}:1（目标 {target}:1）',
@@ -2524,11 +2707,11 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         lang: '語言',
         hc: '高對比',
         custom: '自訂配色',
-        customHint: '取三個色的色相與色度；過亮/過暗的強調色會正規化以確保可讀性，明度由引擎依模式計算。',
+        customHint: '取三個色的色相與色度；底色偏暗會當作深色模式的畫布、偏亮會當作淺色模式的畫布（過暗/過亮的會被夾回可用區間）；過亮/過暗的強調色會正規化以確保可讀性。',
         derive: '由主色派生',
         deriveHint: '用目前強調色的色相與彩度推導底色與文字（明暗跟隨目前模式）',
         deriveNote: '「由主色派生」以強調色為唯一輸入，自動算出底色與文字 —— 會覆蓋你手動設置的底色與文字；派生之後仍可逐項手改。',
-        notice: '1.13.3：修正左側會話列懸停卡的底色不跟隨主題色——宿主把表面別名寫成色階引用，浮層裡這條鏈不生效；現在 47 個表面別名直接寫入覆蓋層。',
+        notice: '1.13.5：錯誤/成功/警告與檔案 diff 的 +/− 行也跟著配色了 —— 紅/綠/琥珀三族第一次參與重建，只調溫度、色相旋轉上限 8°。',
         dismiss: '知道了',
         explainClamp: '強調色已正規化：{from} → {to}（確保按鈕與勾選可讀）',
         explainLink: '連結已為可讀性壓暗：{ratio}:1（目標 {target}:1）',
@@ -2597,11 +2780,11 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         lang: 'Language',
         hc: 'High contrast',
         custom: 'Custom palette',
-        customHint: 'Takes hue and chroma from three colours; extreme accents are normalised for readability; lightness comes from the engine per mode.',
+        customHint: 'Takes hue and chroma from three colours plus the surface lightness: a dark surface becomes the canvas in dark mode, a light one in light mode (out-of-range values are clamped); extreme accents are normalised for readability.',
         derive: 'Derive from accent',
         deriveHint: 'Derive background and text from the current accent hue and chroma (follows the current light/dark mode)',
         deriveNote: '"Derive from accent" takes the accent as its only input and computes background and text from it — this overwrites the background and text you set by hand; you can still edit each of them afterwards.',
-        notice: '1.13.3: fixes the session-row hover card not following the palette — the host declares surface aliases as ramp references and that chain does not resolve inside popovers; all 47 surface aliases now go straight into the override layer.',
+        notice: '1.13.5: error/success/warning states and the +/− diff rows now follow the palette too — the semantic red/green/amber scales join the rebuild, temperature only, hue rotation capped at 8°.',
         dismiss: 'Got it',
         explainClamp: 'Accent normalised: {from} → {to} (keeps buttons and checks readable)',
         explainLink: 'Link darkened for readability: {ratio}:1 (target {target}:1)',
@@ -2670,11 +2853,11 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         lang: '言語',
         hc: 'ハイコントラスト',
         custom: 'カスタム配色',
-        customHint: '3 色の色相と彩度を使用。極端なアクセント色は可読性のため正規化され、明度はモードごとにエンジンが決めます。',
+        customHint: '3 色の色相と彩度に加えて、背景色の明度も使います（暗い背景ならダークモードのキャンバス、明るい背景ならライトモードのキャンバス。範囲外はクランプ）。極端なアクセント色は可読性のため正規化されます。',
         derive: 'メイン色から生成',
         deriveHint: '現在のアクセント色の色相と彩度から背景色と文字色を生成します（明暗は現在のモードに従います）',
         deriveNote: '「メイン色から生成」はアクセント色だけを入力として背景色と文字色を自動計算します。手動で設定した背景色と文字色は上書きされます（生成後に個別に変更できます）。',
-        notice: '1.13.3：セッション行のホバーカードが配色に追随しない問題を修正——ホストは表面別名を色階の参照で宣言しており、ポップオーバー内ではその連鎖が効きません。47 個の表面別名をオーバーライド層へ直接書き込むようにしました。',
+        notice: '1.13.5：エラー/成功/警告とファイル diff の +/− 行も配色に追従するようになりました（赤/緑/アンバーの三色階が再構築に参加、色相の回転は 8° まで）。',
         dismiss: '了解',
         explainClamp: 'アクセント色を正規化しました：{from} → {to}（ボタンとチェックの可読性のため）',
         explainLink: 'リンクを可読性のため暗くしました：{ratio}:1（目標 {target}:1）',
@@ -3325,7 +3508,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
     // 必须能在测试里读到"实现里的那个数"。此前测试拿 floors() 的返回值当期望值 ——
     // 常量一改、期望值跟着改，那道门就是空转的（变异实测：CONTRAST_FLOOR 4.5→1.0 全绿）。
     if (DEV_OPT_IN && typeof window !== 'undefined' && typeof window.__DSH_THEME_PALETTE_DEV__ === 'function') {
-      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, fromOklch, flatten, luminance, withAlpha, mixHex, harmonize, deltaE, simulateCvd, rampsFor, floors, floorsDark, apcaContrast, raiseToLc, solveForeground, pickLocale, hostLocale, encodeConfig, decodeConfig, customScheme, deriveCustomFromAccent, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, buildContrastReport, devContrastReport, CONTRAST_TARGETS, CONTRAST_EXEMPT, CONTRAST_FLOOR, CONTRAST_SOLVER_MARGIN, MIN_MAIN, MIN_SECONDARY, MIN_TERTIARY, MIN_LINK, MIN_LINK_DARK, MIN_SECONDARY_DARK, MIN_TERTIARY_DARK, FLOORS_HC, FLOORS_HC_DARK, RAMP_MIN_GAP, RAMP_ORDER, SURFACE_ALIAS_STEPS, hexToRgb, LAYER_MARK, settingsCss: SETTINGS_CSS, markdownCss: MARKDOWN_CSS, cardColors })
+      window.__DSH_THEME_PALETTE_DEV__({ buildTokens, SCHEMES, SIDEBAR_MODES, TEXT_MODES, SCROLL_MODES, CONTROL_MODES, MD_MODES, HC_MODES, contrast, toOklch, fromOklch, flatten, luminance, withAlpha, mixHex, harmonize, deltaE, simulateCvd, rampsFor, floors, floorsDark, apcaContrast, raiseToLc, solveForeground, pickLocale, hostLocale, encodeConfig, decodeConfig, customScheme, deriveCustomFromAccent, readCustom, writeCustom, CONTRAST_SURFACES, CONTRAST_ROLES, buildContrastReport, devContrastReport, CONTRAST_TARGETS, CONTRAST_EXEMPT, CONTRAST_FLOOR, CONTRAST_SOLVER_MARGIN, MIN_MAIN, MIN_SECONDARY, MIN_TERTIARY, MIN_LINK, MIN_LINK_DARK, MIN_SECONDARY_DARK, MIN_TERTIARY_DARK, FLOORS_HC, FLOORS_HC_DARK, RAMP_MIN_GAP, RAMP_ORDER, SURFACE_ALIAS_STEPS, hexToRgb, LAYER_MARK, hostPatchCss: HOST_PATCH_CSS, settingsCss: SETTINGS_CSS, markdownCss: MARKDOWN_CSS, cardColors })
     }
 
     return {
@@ -3941,10 +4124,12 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
           applyAll('boot')
           const removeStyle = installMarkdownStyle()
           const removeSettings = installSettingsStyle()
+          const removeHostPatch = installHostPatchStyle()
           return () => {
             disposeLayer()
             removeStyle()
             removeSettings()
+            removeHostPatch()
             try {
               document.removeEventListener('visibilitychange', healOnVisible)
               window.removeEventListener('focus', healOnFocus)

package/docs/DESIGN.md

@@ -258,8 +258,10 @@ WCAG 2.x 的相对亮度比在暗底上**系统性高估**可读性。同一个
 
 - **暖砂与苔绿在 deutan 下几乎同色**（深色画布 ΔE **0.84**）。也就是说红绿色盲用户在深色侧几乎分不出这两套 ——
   好在它只是审美选择，不承载信息。
-- **红/绿语义色在 protan 下只剩 ΔE 5.7**。语义色由宿主提供（`--dsw-alias-state-*`），插件**有意不染色**：
-  把「成功 / 失败」也染成用户主色会让语义丢信息。所以这一层需要靠**图标或文字**区分，不能只靠颜色。
+- **红/绿语义色在 protan 下只剩 ΔE 5.7**。语义色由宿主提供（`--dsw-alias-state-*`），
+  1.13.5 起插件会给它们**做温度调和**（`harmonizeSemantic`：色相旋转封顶 8°、色度压到 88–92%，
+  明度一律沿用宿主）—— 但"只是换冷暖"，不是把「成功 / 失败」染成用户主色：
+  色觉缺陷下这一层仍然需要靠**图标或文字**区分，不能只靠颜色。
 
 三套预置在 achromat（全色盲）下的层间明度差仍保留（ΔE 3.7–5.9），层级不依赖色度。
 
@@ -293,12 +295,40 @@ WCAG 2.x 的相对亮度比在暗底上**系统性高估**可读性。同一个
 三级 5.3–5.4、链接 5.4–5.5）。主色无彩（C < 0.004）时派生中性纸面，
 避免「黑底 + 白字 + 黄强调派生出一套淡粉」那类老问题。
 
+### 底色明度也参与（1.13.5 补丁）
+
+1.13.5 之前，三色里的「底色」只贡献**色相与色度**，画布明度由引擎按模式写死（深色 ≈ 0.226）。
+用户把底色设成 `#070b11`（L≈0.148）时屏幕上是 `#191c21` 一档的蓝灰 —— 用户读成"底色没变"，
+而且这个读法是对的：**控件叫「底色」，那它就该是底色**。
+
+现在的规则只有三条：
+
+| 底色明度 | 行为 |
+|---|---|
+| L ≤ 0.35（明显偏暗） | 它成为**深色模式的画布明度**，夹到 0.14–0.30 |
+| L ≥ 0.75（明显偏亮） | 它成为**浅色模式的画布明度**，夹到 0.90–0.985 |
+| 0.35 < L < 0.75（中间灰） | 不表达明暗意图，两侧都沿用引擎值 |
+
+只锚**画布这一档**：800–950 四层面按同一 delta 平移（层间距 0.03 L 不变），浅色侧同理平移
+00–200。文字色不在这次平移里，它们随后由 `tuneRamps` 在新承载面上重解对比度 ——
+所以承诺下限一条没松（该用户配色实测正文对画布 11.33:1、对 875 面 10.16:1）。
+
+下限 0.14 是**层次余量**，不是审美：深色侧还有三层更亮的面，左栏「更深」档再往下 -0.042 L；
+画布压到 0.10 时左栏会掉进 `#020407` 一档的近纯黑，整体塌成一块。
+
+同一次回执里还有一条：**线条色**过去取的是文字色的 alpha。文字一旦近中性
+（`#e1eced`，C≈0.012），发丝线就是一片中性灰，用户读作"线条还是默认的"。
+自定义配色下线条改成**配色色相 + 色度下限 0.02**（明度与 alpha 不变，对比关系不变）；
+预置仍走墨/纸原色，不受影响。
+
+
 ### 运行时覆盖报告（`getCoverageReport`）
 
 诊断导出（设置页「复制诊断信息」）多一份 `coverage`：遍历宿主样式表里所有 `--dsw-*` 自定义属性，
 按四类分账 —— `ours`（本插件覆盖层接管）、`derived`（值是 `var(--dsw-…)` 引用，跟着基础 token 走）、
-`literalChromatic`（字面带彩色值，宿主语义色等，有意不染）、`literalGray`（字面灰值，是「跟配色」
-的候选）。它回答的是「宿主还有多少 token 没跟上配色」，只读、尽力而为：
+`literalChromatic`（字面带彩色值）、`literalGray`（字面灰值，是「跟配色」的候选）。
+1.13.5 起语义色（red / green / amber）进入 `ours`，剩下的 `literalChromatic` 只有首次引导页强调色这类
+真正够不到的字面量。它回答的是「宿主还有多少 token 没跟上配色」，只读、尽力而为：
 拿不到 `styleSheets`（沙箱、跨域）就返回 `{ ok: false }`，不影响其它诊断。
 
 ## 宽色域（display-P3）：本期不做（1.10.0）
@@ -435,7 +465,10 @@ MIN_MAIN 从 15.5 放宽到 12，1.9.7 起深色正文再降到 10：给“带
 
 **本来就跟随配色的中性组件**：边框（用色阶两端的墨/纸做 alpha）、分隔线、骨架屏、菜单表面、
 `interactive-bg-*` 悬停层、`bg-document-selection`（选择高亮）、`markdown-code-segment-*`。
-**故意不跟**：遮罩 `bg-mask-*`（保持中性黑）、代码 diff 的红绿、`state-error/warn` 语义色。
+**故意不跟**：遮罩 `bg-mask-*`（保持中性黑）、首次引导页那几条字面包彩/渐变（只在 onboarding 出现）。
+**1.13.5 起改为「跟温度、不跟语义」**：代码 diff 的红绿（`code-diff-*`）、`state-{error,success,warn}-*`
+—— 它们此前完全不跟，是"好多颜色还是默认色"的主因；现在色相往配色色相拉但**封顶 8°**，
+红仍是红、绿仍是绿、琥珀仍是琥珀，`check-audit` 第 29 组守着这个上限与三者之间的可辨距离。
 
 ## 开关 / 勾选 / 单选
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-theme-palette",
-  "version": "1.13.3",
+  "version": "1.13.5",
   "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
   "type": "module",
   "main": "index.js",