dsh-m3-monet · 莫奈美化

Monet wallpaper theming for the DeepSeek Harness desktop app, built on Material Design 3 dynamic color. The wallpaper seed goes through the official Material color pipeline (HCT → quantize → Score → tonal palettes) and maps the M3 roles onto the Harness design tokens per color scheme.

• 壁纸取色：本地图片/图片链接/内置渐变 → 莫奈种子提取（Quantizer-style 采样 + Score 评分）
• 换图即自动重取色：壁纸以内容哈希标记，选择新壁纸后立即重新提取种子并应用（无需手动切色源）
• MD3 Token 映射：--dsw-alias-* 全套别名令牌（100+ 项，亮暗各自取值）由 theme.overrideTokens 注入
• 毛玻璃：侧边栏与主体分别配置（各自开关 / 模糊 / 饱和度 / 不透明度），backdrop-filter 直接作用于壁纸
• Material You 视觉与动效：MD3 运动/形状令牌 + m3ui 控件样式（开关/滑块/芯片/卡片）+ 壳层配色交叉淡入 + 设置页入场动画，可一键关闭并尊重系统「减少动态效果」
• 壁纸背景：整窗口背景（带亮/暗各自的暗化层），并把顶层表面改为半透明使其透出
• 顶部标题栏固定为主题纯色，不参与壁纸与毛玻璃
• 侧边栏底部原「阴影式」软边界替换为主题色 1px 横线
• 设置对话框背景透视：全屏遮罩恢复为半透明 scrim、面板改为半透明 + 毛玻璃，壁纸从设置页背后透出
• 设置页操作逻辑：壁纸来源四选一（无 / 渐变 / 上传 / 图片链接）、毛玻璃参数滑杆在所属功能关闭时置灰但保持可见、分区带副标题说明
• 调色控制：风格（标准/鲜艳/柔和/表现/单色）、色彩强度、明度微调，实时预览
• 内置 8 组 Material palette 预设 + 8 组渐变壁纸（随当前调色联动）
• 设置全部持久化在 localStorage（dsh.m3monet.v1），跟随系统亮暗自动切换

适配 DSH 版本（Shell 选择器表）

2026-11 的 Harness 更新（client 0.2.2-rc.1-c59d10a）把全部 CSS module 类名换了一轮 （.BynINW_* → .mP3x-q_*、._2H3hWW_* → .wtg9ga_*、wCInkW_* → .AnXs9G_*），壁纸 / 半透明 / 毛玻璃因此全部失配。插件现在把所有依赖宿主类名的选择器集中在 src/client-template.js 顶部的 SHELL 表（并暴露为 window.__M3_SHELL__，冒烟测试的断言也从这张表拼接）：

用途	当前值
frame（壁纸承载层）	.mP3x-q_frame
主体列	.mP3x-q_centerCol
侧边栏列	.mP3x-q_sidebarCol
侧边栏内部根	.wtg9ga_root
侧边栏底部区 / 区域区	.wtg9ga_footArea / .wtg9ga_regionArea
设置页遮罩 / 面板	.AnXs9G_mask / .AnXs9G_panel

DSH 今后再换类名时，只需从新版 app.asar 包里重新派生这几个值（用 read 读 node_modules/@deepseek-ai/dsh-client-ui-layout|dsh-client-ui-sidebar|dsh-client-ui-settings-general/lib/client.js 里的 CSS module 规则即可），改动面被限制在这一张表内。主题令牌（--dsw-alias-* / --dsw-specific-*） 与 theme.overrideTokens 机制在本次更新中未变，无需适配（已用 Theme.listTokens 实测确认）。

壁纸图层处理

壁纸画在 .mP3x-q_frame 的背景上，而布局的子列会在其上再铺自己的底色，导致壁纸被完全遮住 （源码见 @deepseek-ai/dsh-client-ui-layout/lib/client.js）：

图层	覆盖色	处理方式
[data-windows-titlebar] .mP3x-q_centerCol	--dsw-alias-bg-base	开启壁纸时按「主体毛玻璃不透明度」或「界面不透明度」改为 color-mix(... transparent)
.mP3x-q_sidebarCol	--dsw-specific-sidebar-fill	开启壁纸时按「侧边栏毛玻璃不透明度」或「界面不透明度」改为半透明
.mP3x-q_sidebarCol .wtg9ga_root	同上（第二层）	壁纸开启时置为 background: transparent，避免两层叠加
[data-windows-titlebar] .mP3x-q_frame:before	--dsw-specific-sidebar-fill	改为主题纯色（surfaceContainer），并清掉 backdrop-filter
--dsw-alias-bg-layer-1/2/3	卡片/面板底色	取「界面不透明度 + 14%」，保持正文可读性
.AnXs9G_mask（设置页全屏遮罩）	--dsw-alias-bg-mask-1	遮罩 token 恢复为半透明 scrim（stock #0000003d 语义），并加 backdrop-filter 毛玻璃
.AnXs9G_panel（设置页 800px 面板）	--dsw-alias-bg-layer-2	开启壁纸时改为按「主体毛玻璃不透明度 / 界面不透明度」的 color-mix(... transparent) + 毛玻璃

--dsw-alias-bg-mask-1/2/3、bg-mask-photo/drop、bg-skeleton、border-inverted(2) 在 stock 主题里都是半透明叠加层； 早期版本把它们错误地映射成了不透明 scrim，会让设置页遮罩变成纯黑（壁纸完全看不见），现已按语义修正。

毛玻璃 backdrop-filter 按分组分别作用于侧边栏（.mP3x-q_sidebarCol）与主体（.mP3x-q_centerCol）， 二者直接坐在 frame 背景上，因此模糊的正是壁纸本身；标题栏条不参与模糊。

该模糊不能直接写在列元素上：backdrop-filter（与 filter、transform 一样）会让元素成为其 position:fixed 后代的包含块，而侧边栏的折叠按钮 .wtg9ga_toggle 恰好是 position:fixed; left:12px; top:calc((var(--dsh-windows-titlebar-height) - 28px) / 2)——靠它落在 Windows 标题栏那一行。模糊一旦写在列上，按钮就以「侧边栏列」为基准定位，整体下移一个标题栏高度， 压到 deepseek HARNESS 品牌行上（因为列本身已经被 frame 的 padding-top 推低了一个标题栏高度）。 因此改为在列内绘制 ::before 毛玻璃层： position:relative;z-index:0 + ::before{inset:0;z-index:-1;pointer-events:none;backdrop-filter:…}。 该层位于列内容之下（z-index:-1，不会把侧边栏自己的文字糊掉），且自身没有任何后代， 不会再改变任何元素的定位基准。主体列同理。

侧边栏底部（.wtg9ga_footArea，账号行上方）原有软性阴影边界，现替换为 border-top: 1px solid var(--dsw-alias-border-l2) 的主题色横线。

Material 3 视觉与动效

设置页与主题表面按 Google Material 3（Material You）规范重构：

• 静态样式表：MD3 运动令牌（--m3-ease-standard/emphasized、--m3-dur-short…medium4）、形状令牌 （--m3-radius-xs…xl）与全套 m3ui-* 控件样式，经 data-m3-monet-base 样式表注入一次、永不重写—— 重写样式表会重启 CSS 动画；随设置变化的规则仍在独立的动态样式表（data-m3-monet）里。
• 控件：开关（MD3 轨道 40×22、拇指 14→18、悬停状态层光晕）、滑块（4px 轨道 + 主色拇指 + 按压光晕）、 分段选择与按钮（药丸形芯片，选中用 secondary-container / primary 填充）、色板与预设圆点、 卡片（MD3 elevation level 1——阴影色取自当前方案的 shadow 角色而非硬编码灰色）。 颜色全部走 --m3-* 令牌并回退到 --dsw-alias-*，插件禁用时控件自动退回主题令牌样式。
• 壳层交叉淡入：壁纸/毛玻璃/调色变化时，frame、侧边栏、主体列与内部侧边栏根的背景/边框/文字色以 250ms ease-standard 过渡（列 ::before 毛玻璃层同步过渡）。只过渡颜色属性，不对宿主元素使用 transform/will-change（避免再次触碰 fixed 定位包含块问题）。
• 入场动画：设置页行级 4px 上滑淡入；壁纸预览图更换时 200ms 淡入（key 重挂载触发）。
• 运动开关：设置页「过渡动画」可整体关闭（立即生效）；系统 prefers-reduced-motion: reduce 时自动全部禁用。

壁纸取色

壁纸每次变化都会重新走一遍取色流程，用「壁纸标记」（wallpaperTag）判断是否需要重算：

function hashString(str) {            // FNV-1a
  let hash = 0x811c9dc5;
  for (let i = 0; i < str.length; i += 1) {
    hash ^= str.charCodeAt(i);
    hash = Math.imul(hash, 0x01000193) >>> 0;
  }
  return hash.toString(16) + '-' + str.length;
}
wallpaperTag = kind + ':' + hashString(value);

早期版本用 kind + value.slice(0, 64) 当标记，而所有 JPEG data URL 的前 64 个字符都是同一段 data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQABAAD…，于是换壁纸后标记不变、被判定为「已提取过」而跳过重算， 主题就一直停留在上一张壁纸的颜色。改为内容哈希（并附上长度）后，任何换图都会触发重新提取。

• 图像一变即提取，不再要求 palette.source === 'wallpaper'；若当前色源为「预设色板」，会自动切到「壁纸自动」。
• 提取结果以内存中的最新设置为基座合并后落盘（避免存储回读把它覆盖回旧值）。
• 提取失败时落盘 seeds: [] + extractError: true，设置页给出提示而不是静默沿用旧色。
• 插件激活时若存储里的标记与当前壁纸不符（例如升级前留下的旧标记），也会重新提取一次。
• 提取是异步的，因此结果以「立即应用」写回并取消仍在排队中的防抖应用：否则那次延迟 120ms 的防抖回调 会在提取完成后拿着更新前的快照再跑一遍，把刚取到的新颜色覆盖回上一张壁纸的颜色（表现就是「换壁纸后颜色不变， 手动把色源切走再切回来才刷新」）。同时用自增序号丢弃过期的提取结果，连续换图时只有最后一次生效。

入口

• 仅插件设置页：设置 > 插件 > 莫奈美化 > 配置（settings.section 槽位，页面内容可上下滚动）
• 不在主页面显示，也不占用主页面左侧栏——只作为插件自身设置存在

说明与限制

• 主题覆盖随会话临时生效：关闭插件或卸载后恢复默认界面；设置项保留在本地。
• 仅使用 Harness 主题令牌与 --dsw-* CSS 变量绘制 UI，不引入任何客户端 UI 包。
• 远端图片链接受页面 CSP 限制时可能无法作为壁纸显示；本地图片（data URL）不受影响。
• 引擎为离线打包的 @material/material-color-utilities（Apache-2.0，见 THIRD_PARTY_NOTICES.md）。

开发

node scripts/build.mjs      # 由 src/engine-core.js + src/engine-ext.js 生成 lib/engine.js 并内联进 client.js
node scripts/test.mjs       # 引擎单元测试（HCT 已知值、Scheme 角色、Monet 取色、Token 映射）
node scripts/smoke-client.mjs  # 浏览器端冒烟：模块装载、槽位注册、Token 注入、壁纸取色

包体结构：index.js（Host 空实现）、client.js（浏览器端全量逻辑）、cordis.patch.yml（一行插件行）。

验证记录

• plugin_manager install_bundle：application: applied，无警告；包以 link: 形式装入 profiles/desktop。
• Client 槽位实时注册（cordis_inspect_query）：仅 settings.section 出现 monet-theme（order 120，active: true）；main 与 sidebar.panellist 均不注册（按需求：不在主页面/左侧栏显示）。
• 主题注册表 Theme.listTokens 中已出现本插件注册的 --m3-* 自定义令牌，证明 theme.overrideTokens 在页面端生效；覆盖值为 {light, dark} 双方案，符合 requiresLightAndDark: true 约束。
• 引擎对照官方实现验证：#4285f4 → HCT (265.98, 62.27, 56.55)；Scheme.light(blue).primary = #005ac1、dark = #adc6ff（Material You 蓝的规范值）。
• 本会话无浏览器控制，未截屏验证毛玻璃/壁纸的最终像素效果；需要重载应用加载最新 client.js 生成物后肉眼确认。
• 图层修复（壁纸被覆盖）由 scripts/smoke-client.mjs 覆盖：断言壁纸开启时 --dsw-alias-bg-base/--dsw-specific-sidebar-fill 变为 color-mix 半透明、内部侧边栏根（SHELL.sidebarRoot）置透明；并断言无壁纸图源时表面保持不透明、总开关关闭时不注入覆盖。
• 后续四项修复同样由冒烟测试覆盖：①设置页重新进入时读取已存值（断言读回 #b90063 / blur 20 / opacity 55，旧代码会退回默认值）；②侧边栏与主体毛玻璃独立（断言两个 veil 分别用 80% 与 60%、两条 backdrop-filter 各自参数）；③顶部标题栏为纯色且 backdrop-filter:none；④侧边栏底部为 border-top: 1px solid var(--dsw-alias-border-l2) 横线。另含旧版扁平 glass 配置的迁移断言。
• 设置页背景透视由冒烟测试覆盖：断言 --dsw-alias-bg-mask-1 为 24% 半透明 scrim（非不透明）、bg-skeleton 半透明、border-inverted 亮色为 transparent；壁纸开启时 SHELL.settingsMask 与 SHELL.settingsPanel 均带 backdrop-filter，面板背景为 60%（主体毛玻璃不透明度）的 color-mix；无壁纸时不下发设置面板规则。
• 壁纸自动取色由冒烟测试场景 5/6 覆盖：场景 5 用「旧版前缀标记 + 已存紫色种子」模拟升级前状态，断言重新提取出的标记与旧标记不同、种子来自新壁纸（纯绿 64×64，greenFromArgb > blueFromArgb）、最终 --dsw-alias-brand-primary 亮色不再是 #6750a4（实测 #006e21，种子 #48a850）且主题被重复应用；场景 6 断言开启壁纸后色源自动从 preset 切到 wallpaper。
• 「换壁纸后颜色不刷新」的竞态由场景 5 守住：测试等待 settle(260ms) 越过 120ms 防抖窗口后才断言，要求最终生效的主题既不是旧种子 #6750a4、也不等于旧种子推出的 brand-primary。把修复临时还原（applySoon 用旧快照 + applyFresh 不取消防抖）后该断言确实失败（实测回落到 #6750a4），证明断言不是空转。
• 「侧边栏折叠按钮下移到品牌行」由冒烟测试守住：断言毛玻璃只出现在 .mP3x-q_sidebarCol::before / .mP3x-q_centerCol::before 上，列元素本身不带 backdrop-filter（断言正则由 SHELL 表拼接， 侧边栏列与主体列各一条都必须不命中）——一旦把模糊写回列元素，这两条断言立即失败。
• Material 3 视觉与动效由冒烟测试守住：断言恰好两张样式表（静态 base + 动态）、base 含 MD3 运动令牌与 prefers-reduced-motion、壳层过渡被 html.m3-monet-on:not(.m3-motion-off) 门控、base 不含 backdrop-filter； 遍历设置页渲染树（含函数组件调用与 children 拍平）断言控件使用 m3ui-switch/chip/card/slider/dot 类、 行带 m3ui-row-in 入场类；motion:false 时断言 m3-motion-off 根标记出现（默认不出现）。
• DSH 0.2.2-rc.1 适配由冒烟测试守住：所有宿主类名断言从 window.__M3_SHELL__ 读取（类名再变时只需更新 SHELL 表与断言表各一处）；运行时验证 Theme.listTokens 仍含全部 --m3-* 令牌、Slots.listSubTree 中 settings.section 仍挂在 sidebar.settings 下。
• 设置页操作逻辑重构由冒烟测试守住：毛玻璃两组共 6 个参数滑杆在所属功能关闭时渲染为 disabled （默认场景 6 个全禁用）、开启毛玻璃的场景全部可用。

安装

git clone https://github.com/Regex520/dsh-m3-monet.git

克隆后把该目录作为本地 bundle 装入 Harness profile（以 link: 方式登记，因此改工作区文件即改已装包内容）， 重载应用后生效：设置 → 插件 → 莫奈美化 → 配置。

许可证

• 本插件：MIT（见 LICENSE）。
• 离线打包的引擎代码来自 @material/material-color-utilities（Apache-2.0），出处与许可全文见 THIRD_PARTY_NOTICES.md。