dsh-theme-palette 1.13.2 → 1.13.4

package/CHANGELOG.md

@@ -8,6 +8,43 @@
 > 1.13.2 起逐节标注 —— 此前 27 个版本节看起来都能装，用户按 CHANGELOG 钉版本会撞 404
 > （2026-10-29 审计 P2-9）。
 
+### 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`、标题近白，而旁边的侧栏与画布都是染过色的。
+
+核实（像素取样 + 宿主构建对账）：卡片背景正好是宿主 **原始**色阶 `--dsw-static-neutral-bluish-850`
+（`#2c2c2e`）、标题是原始 `50`（`#f9fafb`）；而宿主把这些表面别名声明成
+`var(--dsw-static-neutral-bluish-NN)` 的**引用**，插件过去只覆盖色阶、指望浏览器在 `body` 上完成替换 ——
+这条链在浮层里没有生效，于是卡片拿到了宿主原色。
+
+- **修法**：把宿主里**全部 47 个**「纯粹是色阶引用」的别名（`bg-base` / `bg-layer-1..3` / `tooltip-bg` /
+  `label-primary` / `toast-bg` / `switch-thumb` / `specific-tip` / `specific-input-major` …）在覆盖层里
+  **直接写成色阶值**，不再依赖任何中间引用。已经由求解器给值的键（`label-secondary` / `label-tertiary` /
+  `link` / `brand` / `bubble` / `sidebar-fill` / `markdown-code-block` 等）一律跳过，保持求解结果。
+  能正常替换的地方结果完全一致（同一档），链不生效的地方就是修复。
+- **防回退**：`check-audit` 新增第 27 组 —— 每个别名都必须在覆盖表里、且值等于它声明的色阶档；
+  `check-host-contract` 改为从**宿主真实构建**里解出这 47 条映射并与插件对表（宿主改映射会红，不会静默错色）。
+- 覆盖的 token 数从 122 增至 **158**（黑白档 17 → 19），六语 README 同步。
+- 复核：`npm run check` 8/8；两档报表 exit 0；`npm pack` 28 文件。
+
 ### 1.13.2
 对 2026-10-29 全量审计（**34 条**，报告与反哺回执在仓库根目录的 `AUDIT-2026-10-29.md` /
 `AUDIT-2026-10-29-FEEDBACK.md`）的修订。审计的核心判断成立：**引擎正确，缺的是"防回归"的工程能力** ——

package/README-es.md

@@ -28,7 +28,7 @@ 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 (122 tokens en paletas con tinte, 17 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;
+- 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;
 - 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**;
 - **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;

package/README-hi.md

@@ -28,7 +28,7 @@ DeepSeek Harness (वेब और डेस्कटॉप) के लिए
 
 - **4 प्रीसेट + कस्टम** — मोनो, वार्म सैंड, इंडिगो, मॉस (हर एक लाइट और डार्क दोनों के लिए अलग से अनुकूलित), साथ ही तीन रंगों से निकली कस्टम पैलेट;
 - पूरी रैंप **दोबारा गणना** होती है, बदली नहीं जाती: OKLCH पुनर्निर्माण → भूमिका-आधारित क्रोमा → **sRGB गैमट क्लैंप** → वास्तविक सतहों पर कंट्रास्ट हल;
-- होस्ट के सभी रंग टोकन शामिल (रंगीन पैलेट में 122 टोकन, मोनो में 17; 1080 सेटिंग संयोजन पूरी तरह स्कैन किए गए): मुख्य टेक्स्ट, द्वितीयक, तृतीयक, कैप्शन, लिंक, साइडबार, कार्ड, उपयोगकर्ता बबल, प्राइमरी बटन, स्क्रॉलबार, स्विच, Markdown शीर्षक/बोल्ड, कोड ब्लॉक;
+- होस्ट के सभी रंग टोकन शामिल (रंगीन पैलेट में 158 टोकन, मोनो में 19; 1080 सेटिंग संयोजन पूरी तरह स्कैन किए गए): मुख्य टेक्स्ट, द्वितीयक, तृतीयक, कैप्शन, लिंक, साइडबार, कार्ड, उपयोगकर्ता बबल, प्राइमरी बटन, स्क्रॉलबार, स्विच, Markdown शीर्षक/बोल्ड, कोड ब्लॉक;
 - समायोज्य: टेक्स्ट की तीव्रता (3), साइडबार की गहराई (3), Markdown ज़ोर, स्क्रॉलबार, स्विच का रंग;
 - **कस्टम पैलेट** (सतह / टेक्स्ट / एक्सेंट चुनें — इंजन अपने कंट्रास्ट वादे बनाए रखता है), `dshs1.` कोड से **कॉन्फ़िगरेशन निर्यात/आयात**, **हाई-कॉन्ट्रास्ट** मोड, और **4 UI भाषाएँ**;
 - **स्व-उपचार**: यदि होस्ट ओवरराइड परत हटा दे, पैलेट फिर से लगा दी जाती है; बार-बार विफलता पर स्व-उपचार रुक जाता है और सेटिंग्स पेज पर इसे दोबारा चालू करने का बटन मिलता है;

package/README-ja.md

@@ -28,7 +28,7 @@ package.json の `engines` は `^22.19.0 || >=24.0.0` —— 上の表と同じ
 
 - **4 プリセット + カスタム** —— モノクロ / ウォームサンド / インディゴ / モスグリーンがライトとダークをそれぞれ独立に適応し、さらに 3 色から派生するカスタム配色；
 - 色階は置き換えではなく**全体を再計算**：OKLCH 再構築 → 役割ごとの彩度 → **sRGB ガマット・クランプ** → 実際の面でコントラストを解く；
-- ホストの全色トークンを網羅（着色パレットで 122、モノクロで 17。1080 通りの設定を全走査）：本文、二次、三次、注記、リンク、サイドバー、カード、ユーザー吹き出し、プライマリボタン、スクロールバー、スイッチ、Markdown 見出し/太字、コードブロック；
+- ホストの全色トークンを網羅（着色パレットで 158、モノクロで 19。1080 通りの設定を全走査）：本文、二次、三次、注記、リンク、サイドバー、カード、ユーザー吹き出し、プライマリボタン、スクロールバー、スイッチ、Markdown 見出し/太字、コードブロック；
 - 調整可：テキストの着色 3 段、サイドバー 3 段、Markdown 強調、スクロールバー、スイッチの配色；
 - **カスタム配色**（背景 / テキスト / アクセントの 3 色。極端に明るい・暗いアクセントは正規化されます）、**設定のエクスポート/インポート**（`dshs1.` ショートコードに 3 色を含む）、**ハイコントラスト**、UI 4 言語；
 - **自己修復**：ホストがオーバーライド層を破棄すると自動で再適用。連続失敗すると自動再適用を停止し、設定ページに「再有効化」の入口を出します；

package/README-pt.md

@@ -28,7 +28,7 @@ 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 (122 tokens nas paletas com tinta, 17 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;
+- 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;
 - 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**;
 - **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;

package/README-zh.md

@@ -28,7 +28,7 @@ package.json 的 `engines` 字段写的是 `^22.19.0 || >=24.0.0`——与上表
 
 - **4 套预设 + 自定义** —— 黑白 / 暖砂 / 靛蓝 / 苔绿各自独立适配明暗两侧，另加由三色派生的自定义配色；
 - 色阶**整体重算**而不是替换：OKLCH 重建 → 角色化色度 → **sRGB 色域钳位** → 在真实承载面上求解对比度；
-- 覆盖宿主全部颜色 token（自定义/染色档 122 个、黑白档 17 个；1080 组设置全扫描）：正文、次级、三级、注释、链接、侧栏、卡片、主人气泡、主按钮、滚动条、开关、Markdown 标题/加粗、代码块；
+- 覆盖宿主全部颜色 token（自定义/染色档 158 个、黑白档 19 个；1080 组设置全扫描）：正文、次级、三级、注释、链接、侧栏、卡片、主人气泡、主按钮、滚动条、开关、Markdown 标题/加粗、代码块；
 - 可调：文字着色三档、侧栏三档、Markdown 强调、滚动条、开关配色；
 - **自定义配色**（给 底色/文字/强调 三色，文字色相也参与派生；过亮/过暗的强调色会归一化）、**配置导入导出**（`dshs1.` 短码含三色）、**高对比**档、4 种界面语言；
 - **自愈**：宿主丢弃 override 层时自动重放；自动重放连续失败后会停用，并在设置页给出「重新启用」入口；

package/README.md

@@ -28,7 +28,7 @@ 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 (122 tokens for tinted palettes, 17 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;
+- 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;
 - 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;
 - **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;

package/assets/screenshots.meta.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-10-29T08:38:25.942Z",
-  "pluginVersion": "1.13.2",
+  "generatedAt": "2026-10-29T11:56:54.301Z",
+  "pluginVersion": "1.13.4",
   "chrome": "Chrome/156.0.8078.49",
   "width": 620,
   "scale": 1,
@@ -14,13 +14,13 @@
         "--adv",
         "0"
       ],
-      "htmlSha256": "41c23ed56875a8ba0fe08d8a94a927a60bde92a9c9a5d8f49d434f81180322a3",
+      "htmlSha256": "54916add6cedff817044eaf0eee2297265f8ff5b2fb336d3e201dad504bf2b35",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
-      "bytes": 47493,
-      "sha256": "ec6a7fb41bd433e853d1ae856a2729aefd5c579295603642f1b78fa7148d9dfd"
+      "bytes": 47498,
+      "sha256": "d5fc7fe7a3a5012fc0e3947038e6faf69e3df23b5897d346fc3381da655b0fa0"
     },
     {
       "file": "assets/screenshot-settings-dark.png",
@@ -31,13 +31,13 @@
         "--adv",
         "0"
       ],
-      "htmlSha256": "4a3b259c2acad16f9e2ef0fff8d19b734fd93f3304ddd448b1422e18741e0d56",
+      "htmlSha256": "0348f7373871e7d430cf07615cfcd481476bc62478c0a57ba7918e6611b6dd98",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
       "bytes": 47810,
-      "sha256": "8385f5668da31a5f39dceba34420545bd8afccc895e3bd16e0744c417a083e5d"
+      "sha256": "ba07e44099f33978f5f7d62563b96e999f240aed4971e0657a145aa5188a452b"
     },
     {
       "file": "assets/screenshot-settings-custom.png",
@@ -50,13 +50,13 @@
         "--out",
         "customadv"
       ],
-      "htmlSha256": "3b3643539b513b916816b110ed7ff6eddf00ed903fba77c37c75202fd195dd0b",
+      "htmlSha256": "5929bc3227c1c53bd6264bb9f3be23557b481a77271e204e77676ac526edc530",
       "cssWidth": 620,
       "cssHeight": 1753,
       "width": 620,
       "height": 1753,
-      "bytes": 116563,
-      "sha256": "4e59831c236d3c3660cd40c652872c1ae521410b99cce720246171302d3cf329"
+      "bytes": 116566,
+      "sha256": "b7853a193d0be58f3284c363f379cc66fa9f490b83a49fd5abd6780cc70fa728"
     },
     {
       "file": "assets/screenshot-settings-hc.png",
@@ -69,13 +69,13 @@
         "--out",
         "hcadv"
       ],
-      "htmlSha256": "b855508855018b1e8c21a4502673dbca3266e68227cf2ee8b790f2a59706da23",
+      "htmlSha256": "5b68173af9cf81d3586c1ed4a206475427a7f266174420da1df22f1f1d84277d",
       "cssWidth": 620,
       "cssHeight": 1463,
       "width": 620,
       "height": 1463,
-      "bytes": 94783,
-      "sha256": "d58e614eac2f08265421e1579f0f6699e370560e4d81c75b51680bc4dfc4dfd7"
+      "bytes": 94792,
+      "sha256": "e021a907dd32378591b0e5198027bd4ba2d19da112ccf3e4bf6fbb1929796c0e"
     }
   ]
 }

package/client.js

@@ -27,7 +27,7 @@ window.__ModuleLoader__.load({
     const React = require('react')
     const h = React.createElement
 
-    const PLUGIN_VERSION = '1.13.2'
+    const PLUGIN_VERSION = '1.13.4'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -1492,6 +1492,68 @@ window.__ModuleLoader__.load({
     // （低于自己声明的 0.006），而上面的注释还宣称"整条色阶单调"。
     const RAMP_ORDER = ['00', '50', '60', '75', '100', '150', '200', '300', '400', '500', '600', '700', '750', '800', '850', '875', '900', '950', '1000']
 
+    /**
+     * 宿主里所有「只是 `var(--dsw-static-neutral-bluish-NN)` 引用」的别名 → 色阶档位。
+     *
+     * 为什么要在插件侧再落一遍（2026-10-29，用户实测：左侧会话行的悬停卡不跟随主题色）：
+     * 插件过去只覆盖色阶，指望浏览器在 `body` 上把这些引用替换掉。实测那张卡拿到的仍是
+     * **宿主原始色阶**（背景 #2c2c2e = 宿主 850，标题近白 = 宿主 50），说明这条链在浮层里不生效。
+     * 这里把 47 个别名**直接写成色阶值**，不再依赖中间引用 —— 链正常时结果完全一致（同一档），
+     * 链不生效时就是修复。表由宿主构建逐条导出，`tools/check-host-contract.mjs` 会核对映射没漂。
+     *
+     * 只补**插件没有专门求解过**的键：label-secondary / tertiary / link / brand / bubble /
+     * markdown-code-block / sidebar-fill 等由求解器给值，循环里遇到已存在的一律跳过。
+     */
+    const SURFACE_ALIAS_STEPS = {
+      '--dsw-alias-bg-base': { light: '00', dark: '950' },
+      '--dsw-alias-bg-document-preview': { light: '100', dark: '950' },
+      '--dsw-alias-bg-layer-1': { light: '00', dark: '875' },
+      '--dsw-alias-bg-layer-2': { light: '00', dark: '850' },
+      '--dsw-alias-bg-layer-3': { light: '00', dark: '800' },
+      '--dsw-alias-bg-module-platform': { light: '60', dark: '800' },
+      '--dsw-alias-bg-overlay': { light: '150', dark: '700' },
+      '--dsw-alias-brand-primary': { light: '1000', dark: '50' },
+      '--dsw-alias-brand-primary-invert': { light: '1000', dark: '50' },
+      '--dsw-alias-brand-text': { light: '1000', dark: '50' },
+      '--dsw-alias-button-contrast-fill': { light: '700', dark: '50' },
+      '--dsw-alias-button-elevated-fill': { light: '00', dark: '750' },
+      '--dsw-alias-button-floating-fill': { light: '00', dark: '850' },
+      '--dsw-alias-button-floating-hover': { light: '75', dark: '800' },
+      '--dsw-alias-button-ghost-active-border': { light: '500', dark: '600' },
+      '--dsw-alias-button-ghost-active-fill': { light: '100', dark: '750' },
+      '--dsw-alias-button-ghost-active-hover': { light: '150', dark: '700' },
+      '--dsw-alias-button-primary-dimmed': { light: '100', dark: '750' },
+      '--dsw-alias-button-primary-hover': { light: '750', dark: '100' },
+      '--dsw-alias-interactive-bg-hover-solid': { light: '75', dark: '800' },
+      '--dsw-alias-label-caption': { light: '400', dark: '600' },
+      '--dsw-alias-label-dimmed': { light: '200', dark: '750' },
+      '--dsw-alias-label-document-preview': { light: '700', dark: '300' },
+      '--dsw-alias-label-primary': { light: '1000', dark: '50' },
+      '--dsw-alias-label-primary-dimmed': { light: '950', dark: '100' },
+      '--dsw-alias-label-primary-foreground': { light: '00', dark: '1000' },
+      '--dsw-alias-label-primary-inverted': { light: '00', dark: '800' },
+      '--dsw-alias-label-secondary': { light: '700', dark: '300' },
+      '--dsw-alias-label-tertiary': { light: '600', dark: '400' },
+      '--dsw-alias-markdown-citation': { light: '100', dark: '800' },
+      '--dsw-alias-markdown-code-block': { light: '50', dark: '900' },
+      '--dsw-alias-markdown-code-block-banner': { light: '50', dark: '850' },
+      '--dsw-alias-markdown-code-segment-selected': { light: '00', dark: '800' },
+      '--dsw-alias-markdown-code-segment-unselected': { light: '75', dark: '900' },
+      '--dsw-alias-markdown-placeholder': { light: '60', dark: '850' },
+      '--dsw-alias-markdown-tag': { light: '75', dark: '850' },
+      '--dsw-alias-switch-thumb': { light: '00', dark: '400' },
+      '--dsw-alias-toast-bg': { light: '800', dark: '750' },
+      '--dsw-alias-toast-label': { light: '00', dark: '00' },
+      '--dsw-alias-tooltip-bg': { light: '850', dark: '750' },
+      '--dsw-specific-input-major': { light: '00', dark: '850' },
+      '--dsw-specific-login-input': { light: '50', dark: '900' },
+      '--dsw-specific-selector': { light: '60', dark: '800' },
+      '--dsw-specific-sidebar-fill': { light: '50', dark: '900' },
+      '--dsw-specific-sidebar-nav-item-active': { light: '100', dark: '750' },
+      '--dsw-specific-sidebar-nav-item-hover': { light: '75', dark: '850' },
+      '--dsw-specific-tip': { light: '60', dark: '800' },
+    }
+
     /**
      * 把色阶压回「序号越大越深」。**没有返回值**（审计 2026-10-29 P3-6）：
      * 原来返回一个 `changed` 布尔，但唯一调用点丢弃它 —— 看起来像是打算用来触发重解或提示，
@@ -1860,6 +1922,26 @@ window.__ModuleLoader__.load({
       // 色阶排序归一化（审计 3.2）：放在最后 —— 前面的求解与参考墨色对齐都可能把某一档
       // 推出反序，收尾统一压一次，保证「序号越大越深」在整条色阶上成立。
       if (params.tinted) enforceRampOrder(pairs)
+      // 表面别名**显式落地**（2026-10-29 用户实测：左侧会话行的悬停卡没跟随主题色）。
+      //
+      // 宿主在 `body` / `body[data-ds-dark-theme]` 上把这一批别名写成
+      // `var(--dsw-static-neutral-bluish-NN)` 的**引用**；插件过去只覆盖色阶，指望浏览器
+      // 在 body 上完成 var 替换。实测那张悬停卡拿到的仍是宿主原始色阶值（#2c2c2e =
+      // 宿主 850），说明这条链在某些浮层里不生效。这里把别名**直接写成色阶值**，
+      // 不再依赖任何中间引用 —— 对能正常替换的地方结果完全一致（同一档），对不生效的地方是修复。
+      // 已由求解器给值的键（label-secondary / link / brand / bubble / sidebar-fill …）一律保留，不覆盖。
+      for (const [name, steps] of Object.entries(SURFACE_ALIAS_STEPS)) {
+        if (pairs[name]) continue
+        const light = pairs['--dsw-static-neutral-bluish-' + steps.light]
+        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
@@ -1920,7 +2002,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}
@@ -2051,8 +2151,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) {
@@ -2070,6 +2169,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 照收，样式不生效）。
@@ -2379,7 +2497,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: '由主色派生',
         deriveHint: '用当前强调色的色相与色度推导底色与文字（明暗跟随当前模式）',
         deriveNote: '「由主色派生」以强调色为唯一输入，自动算出底色与文字 —— 会覆盖你手动设置的底色与文字；派生之后仍可逐项手改。',
-        notice: '1.13.2：无障碍与文案修正——面板的 lang 跟随实际界面语言、「色觉缺陷」提示改称 OKLab ΔE、对比度矩阵的承载面名跟随语言；配色数值不变。',
+        notice: '1.13.4：悬停卡底色不再被宿主写死成中性深灰 —— 接到配色的暗面，白字与对比度不变。',
         dismiss: '知道了',
         explainClamp: '强调色已归一化：{from} → {to}（保证按钮与勾选可读）',
         explainLink: '链接已为可读性压暗：{ratio}:1（目标 {target}:1）',
@@ -2452,7 +2570,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: '由主色派生',
         deriveHint: '用目前強調色的色相與彩度推導底色與文字（明暗跟隨目前模式）',
         deriveNote: '「由主色派生」以強調色為唯一輸入，自動算出底色與文字 —— 會覆蓋你手動設置的底色與文字；派生之後仍可逐項手改。',
-        notice: '1.13.2：無障礙與文案修正——面板的 lang 跟隨實際介面語言、「色覺缺陷」提示改稱 OKLab ΔE、對比度矩陣的承載面名跟隨語言；配色數值不變。',
+        notice: '1.13.4：懸停卡底色不再被宿主寫死成中性深灰 —— 接到配色的暗面，白字與對比度不變。',
         dismiss: '知道了',
         explainClamp: '強調色已正規化：{from} → {to}（確保按鈕與勾選可讀）',
         explainLink: '連結已為可讀性壓暗：{ratio}:1（目標 {target}:1）',
@@ -2525,7 +2643,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         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.2: accessibility and wording fixes — the panel lang now matches the rendered UI language, the colour-vision note says OKLab ΔE, and contrast-matrix surface names follow the UI language. Palette values are unchanged.',
+        notice: '1.13.4: the hover card background is no longer the hardcoded neutral dark from the host — it now follows the palette dark surface, keeping white text and contrast.',
         dismiss: 'Got it',
         explainClamp: 'Accent normalised: {from} → {to} (keeps buttons and checks readable)',
         explainLink: 'Link darkened for readability: {ratio}:1 (target {target}:1)',
@@ -2598,7 +2716,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: 'メイン色から生成',
         deriveHint: '現在のアクセント色の色相と彩度から背景色と文字色を生成します（明暗は現在のモードに従います）',
         deriveNote: '「メイン色から生成」はアクセント色だけを入力として背景色と文字色を自動計算します。手動で設定した背景色と文字色は上書きされます（生成後に個別に変更できます）。',
-        notice: '1.13.2：アクセシビリティと文言の修正 — パネルの lang を実際の表示言語に合わせ、「OKLab ΔE」表記に訂正、コントラスト表の面名も表示言語に追従。配色の数値は変わりません。',
+        notice: '1.13.4：ホバーカードの背景がホスト固定の中立ダークから配色の暗面に切り替わりました（白文字とコントラストはそのまま）。',
         dismiss: '了解',
         explainClamp: 'アクセント色を正規化しました：{from} → {to}（ボタンとチェックの可読性のため）',
         explainLink: 'リンクを可読性のため暗くしました：{ratio}:1（目標 {target}:1）',
@@ -3249,7 +3367,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, 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 {
@@ -3865,10 +3983,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/package.json

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