壁纸自适应字色 jiangking22/dsh-text-color-adaptive

dsh-text-color-adaptive

按壁纸的实际亮度给 DSH 的文字重新取色，解决「深色主题白字压在亮壁纸上就糊」。

同一段话压在壁纸的亮部与暗部：左边是固定白字，右边是自适应后的字色

为半透明玻璃风格而做（壁纸 + 半透明面板）：DSH 深色主题的字色是固定的近白色，而动态壁纸一直在往文字后面送亮帧。这个插件不假设字该是白的，而是先量背景，再决定用浅字还是深字。

它做什么

每 0.9 秒取一次壁纸层（.we-layer，由 dsh-plugin-wallpaper-engine 生成）——、、，或场景 iframe（走它自己的 __wp.capture()）。

画面缩到 64×36，只统计正文那一列，得到背景平均色；再混入当前主题的玻璃表面色，估算字实际压在什么上面。然后在浅字/深字里挑对比度更高的一侧，并把这侧颜色推到刚好 ≥ 4.6:1。

写入五个 token：--dsw-alias-label-primary / -secondary / -tertiary / -caption / -dimmed，外加一层与字色反向的文字阴影（浅字配暗影，深字配亮影）作为兜底。

换边有迟滞：新一侧要在连续两次采样里都明显更优（1.15 倍）才会切，动态壁纸不会来回闪。

取不到壁纸时

没有壁纸层、帧还没解码完、或者场景 iframe 拿不到 __wp.capture()（跨源）时，插件会把自己整个关掉（移除 html[data-at-adaptive]），DSH 保持原生配色，不会留半套覆盖。

没装壁纸插件时没有可采集的画面，而 DSH 的纯色背景本来也不需要帮忙，插件保持沉默。

调参

都在 client.js 顶部：

| 常量 | 默认 | 作用 |
| FLOOR | 4.6 | 主文字目标对比度（WCAG AA 正文线 4.5:1） |
| SURFACE_MIX | 0.45 | 估计玻璃盖住壁纸的比例；玻璃越厚这个值越该调大 |
| TICK_MS | 900 | 采样间隔 |
| SWITCH_MARGIN / SWITCH_STABLE | 1.15 / 2 | 换边阈值与稳定次数 |

调试

浏览器控制台：

__dshAdaptiveText.state
// { active: true, side: 'light', primary: '#fbfcfe', wallpaperLuminance: 0.31 }
__dshAdaptiveText.refresh() // 立刻重新采样
__dshAdaptiveText.dispose() // 恢复 DSH 原生配色

安装

dsh plugin --profile web add dsh-text-color-adaptive

卸载

dsh plugin --profile web remove dsh-text-color-adaptive

只想临时关掉、不卸载：控制台执行 __dshAdaptiveText.dispose()。

许可

MIT