dsh-theme-palette 1.13.3 → 1.13.4

package/CHANGELOG.md

@@ -8,6 +8,24 @@
 > 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`、标题近白，而旁边的侧栏与画布都是染过色的。

package/assets/screenshots.meta.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-10-29T11:29:25.163Z",
-  "pluginVersion": "1.13.3",
+  "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": "8952278cd4d7eb94840604c8ffddba4c51670dd565bf80ead6f8820a84eff661",
+      "htmlSha256": "54916add6cedff817044eaf0eee2297265f8ff5b2fb336d3e201dad504bf2b35",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
-      "bytes": 47480,
-      "sha256": "2504df2500e798c458dcb3014882b880c96ca09a057702a2845fd0252a2b736b"
+      "bytes": 47498,
+      "sha256": "d5fc7fe7a3a5012fc0e3947038e6faf69e3df23b5897d346fc3381da655b0fa0"
     },
     {
       "file": "assets/screenshot-settings-dark.png",
@@ -31,13 +31,13 @@
         "--adv",
         "0"
       ],
-      "htmlSha256": "c8c71e00b0e2518beea8f4b58e64c57b70e7903f69829a9652fb27f11e3ffd6d",
+      "htmlSha256": "0348f7373871e7d430cf07615cfcd481476bc62478c0a57ba7918e6611b6dd98",
       "cssWidth": 620,
       "cssHeight": 888,
       "width": 620,
       "height": 888,
-      "bytes": 47789,
-      "sha256": "4133eaf99848b36dd4df90b5604155878df9f5b47d09e6cdccdce1e8b9fb3ca5"
+      "bytes": 47810,
+      "sha256": "ba07e44099f33978f5f7d62563b96e999f240aed4971e0657a145aa5188a452b"
     },
     {
       "file": "assets/screenshot-settings-custom.png",
@@ -50,13 +50,13 @@
         "--out",
         "customadv"
       ],
-      "htmlSha256": "199f061201c88c70c0228dc2d9066f83d333f7b7f3c20627a3fe947b81e36084",
+      "htmlSha256": "5929bc3227c1c53bd6264bb9f3be23557b481a77271e204e77676ac526edc530",
       "cssWidth": 620,
       "cssHeight": 1753,
       "width": 620,
       "height": 1753,
-      "bytes": 116545,
-      "sha256": "c2b6d3d6e0a11b2da64c16b9729b0aa12b8cd9ea47b9627cd2d95881008306ab"
+      "bytes": 116566,
+      "sha256": "b7853a193d0be58f3284c363f379cc66fa9f490b83a49fd5abd6780cc70fa728"
     },
     {
       "file": "assets/screenshot-settings-hc.png",
@@ -69,13 +69,13 @@
         "--out",
         "hcadv"
       ],
-      "htmlSha256": "56ea7c65091e98ff5a25149cd39933b14035da47ebc986ec4afb423ef0f475f6",
+      "htmlSha256": "5b68173af9cf81d3586c1ed4a206475427a7f266174420da1df22f1f1d84277d",
       "cssWidth": 620,
       "cssHeight": 1463,
       "width": 620,
       "height": 1463,
-      "bytes": 94765,
-      "sha256": "db1ff1416e5d6b0a0202f5a435a64137f4bf13a35fce6d43ad53497358b279cb"
+      "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.3'
+    const PLUGIN_VERSION = '1.13.4'
     const STORE_KEY = 'dsh-theme-palette.v1'
     const OVERRIDE_SOURCE = 'dsh-theme-palette'
 
@@ -1936,6 +1936,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 +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}
@@ -2127,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) {
@@ -2146,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 照收，样式不生效）。
@@ -2455,7 +2497,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: '由主色派生',
         deriveHint: '用当前强调色的色相与色度推导底色与文字（明暗跟随当前模式）',
         deriveNote: '「由主色派生」以强调色为唯一输入，自动算出底色与文字 —— 会覆盖你手动设置的底色与文字；派生之后仍可逐项手改。',
-        notice: '1.13.3：修复左侧会话行悬停卡的底色不跟随主题色——宿主把表面别名写成色阶引用，浮层里这条链不生效；现在 47 个表面别名直接写入覆盖层。',
+        notice: '1.13.4：悬停卡底色不再被宿主写死成中性深灰 —— 接到配色的暗面，白字与对比度不变。',
         dismiss: '知道了',
         explainClamp: '强调色已归一化：{from} → {to}（保证按钮与勾选可读）',
         explainLink: '链接已为可读性压暗：{ratio}:1（目标 {target}:1）',
@@ -2528,7 +2570,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: '由主色派生',
         deriveHint: '用目前強調色的色相與彩度推導底色與文字（明暗跟隨目前模式）',
         deriveNote: '「由主色派生」以強調色為唯一輸入，自動算出底色與文字 —— 會覆蓋你手動設置的底色與文字；派生之後仍可逐項手改。',
-        notice: '1.13.3：修正左側會話列懸停卡的底色不跟隨主題色——宿主把表面別名寫成色階引用，浮層裡這條鏈不生效；現在 47 個表面別名直接寫入覆蓋層。',
+        notice: '1.13.4：懸停卡底色不再被宿主寫死成中性深灰 —— 接到配色的暗面，白字與對比度不變。',
         dismiss: '知道了',
         explainClamp: '強調色已正規化：{from} → {to}（確保按鈕與勾選可讀）',
         explainLink: '連結已為可讀性壓暗：{ratio}:1（目標 {target}:1）',
@@ -2601,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.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.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)',
@@ -2674,7 +2716,7 @@ body[data-ds-dark-theme] .dsh-tp{color-scheme:dark}
         derive: 'メイン色から生成',
         deriveHint: '現在のアクセント色の色相と彩度から背景色と文字色を生成します（明暗は現在のモードに従います）',
         deriveNote: '「メイン色から生成」はアクセント色だけを入力として背景色と文字色を自動計算します。手動で設定した背景色と文字色は上書きされます（生成後に個別に変更できます）。',
-        notice: '1.13.3：セッション行のホバーカードが配色に追随しない問題を修正——ホストは表面別名を色階の参照で宣言しており、ポップオーバー内ではその連鎖が効きません。47 個の表面別名をオーバーライド層へ直接書き込むようにしました。',
+        notice: '1.13.4：ホバーカードの背景がホスト固定の中立ダークから配色の暗面に切り替わりました（白文字とコントラストはそのまま）。',
         dismiss: '了解',
         explainClamp: 'アクセント色を正規化しました：{from} → {to}（ボタンとチェックの可読性のため）',
         explainLink: 'リンクを可読性のため暗くしました：{ratio}:1（目標 {target}:1）',
@@ -3325,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, 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 +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.3",
+  "version": "1.13.4",
   "description": "DSH 主题配色：4 套配色 × 明暗两模式，OKLCH 色域安全重建 + 真实承载面对比度求解，可调强度与面板表面。",
   "type": "module",
   "main": "index.js",