前言¶

DeepSeek Harness（DSH）的桌面端界面默认走一套跨平台的 Web 皮肤，背景和窗口质感与 Windows 11 原生「云母（Mica）」并不一致。若你长期在 Windows 上把 DSH 当作日常工作台，窗口背后仍是扁平色块或简单模糊，和系统其它应用放在一起会显得割裂。

dsh-mica 是社区维护的 DSH 插件，面向 desktop profile，在 Web / 桌面壳层上复刻接近 Win11 的两区云母：外侧薄、对话区更实，壁纸随窗口在桌面上滑动，而不是固定渐变底图。下面介绍它做什么、怎么装、以及使用时需要注意的平台与权限边界。

这是什么¶

dsh-mica（GitHub：208c/dsh-mica，当前包版本 1.3.5，MIT）由维护者 208c 发布。插件通过 DSH 的 bundle patch 注入客户端逻辑，并在宿主侧配合采样 Windows 桌面壁纸，把材质参数交给浏览器合成。

一句话定位：给 DSH 桌面界面加一层 Windows 11 风 Mica，包含真实壁纸采样、随窗口移动的纹理、云母着色与噪点、以及和 DSH 原版布局对齐的双区圆角与发丝线。

核心功能¶

以下能力均来自插件 README 与 package.json 描述，按实现要点归纳。

壁纸与底片¶

• 真实壁纸背景（二维采样）：宿主从注册表 HKCU\Control Panel\Desktop\WallPaper 读取当前壁纸（取不到时退回 TranscodedWallpaper），缩成 14×14 的 RGB 色块阵列交给前端；浏览器侧保留横、竖两个方向，合成与视口比例匹配的底片，而不是只取一列像素或固定假渐变。
• 同次采样还会产出 128 宽 的桌面缩略图及壁纸铺放方式（填充 / 适应 / 拉伸 / 居中 / 平铺 / 跨屏），供主渲染路径使用。

随窗口移动的 Mica¶

• 浏览器将缩略图 预模糊 成桌面纹理，再按 window.screenX / screenY 与显示器原点把纹理摆到壁纸真实位置；拖动时主要更新 translate3d，由合成器搬运，避免每帧重绘整张模糊图。README 给出对比：约 800 px/s 拖动下逐帧色差约 0.25 ΔE（旧实现约 2.1，峰值 5.2）。
• 云母着色 + 噪点：按 Win11 材质定义叠加着色层（Mica 基础为比例透明度，Mica Alt 为上重下轻的纱罩）与 2×2 有序抖动噪点。
• 桌面起伏（relief）：在高不透明度着色之上，用同一张壁纸纹理以 mix-blend-mode: soft-light 只还原明暗、不还原壁纸颜色，避免「实心云母」把桌面形状抹平。

双区布局与表面¶

• 两个区、一块材质：标题栏 + 左侧边栏 + 底栏为更透的云母面；对话区在同材质上再叠更实的板，保留 DSH 原版 16px 圆角（CSS 变量 --dsh-windows-content-radius）与 Windows 风格发丝线。右侧边栏停靠时与对话区共用同一块板；最大化时仍以半透明板覆盖对话区。
• 输入框与菜单：输入框 [data-composer-card] 用 ::before 单独做模糊背板，避免直接给卡片加 filter 导致斜杠 / @ 菜单失效；菜单沿用 DSH 自带的 MenuSurface（.material + blur(40px)），插件不再叠第二层 filter。
• 实心度与可读性：着色强度同时影响底色不透明度、纱罩、壁纸中性化等；并按壁纸亮度做 对比度保护，减轻浅色面 + 深色壁纸或深色面 + 浅色壁纸时的文字可读性问题。
• 完全可逆：效果由 ctx.effect 持有；关闭开关或卸载插件后界面恢复原生状态，无需刷新。

设置界面¶

安装并在 设置 → 通用 中可见 「云母材质」 一行，可开关、切换 Mica / Mica Alt、调整着色强度、模糊、噪点，并查看背景来源（跟随桌面 / 本地生成）与桌面纹理缩略图。

安装与启用¶

插件面向 desktop profile。官方安装方式如下（路径改为你本机 clone 或解压后的目录绝对路径）：

dsh plugin --profile desktop add <本目录绝对路径>
# 例如 dsh plugin --profile desktop add C:\path\to\dsh-mica

安装后 必须重启 DSH：宿主启动时会缓存包元数据与 bundles 层。重启后在 设置 → 通用 中确认「云母材质」是否出现。

若没有 dsh 命令，README 说明等价于在 %USERPROFILE%\.dsh\profiles\desktop 下执行 pnpm add link:<本目录绝对路径>，并把 dsh-mica 追加到该目录 package.json 的 dsh.profile.bundles 数组末尾。

卸载：

dsh plugin --profile desktop remove dsh-mica

运行环境要求：package.json 中 engines.node 为 >=22。

典型用法与配置¶

界面调节¶

在 设置 → 通用 → 云母材质 中调整即可；选项持久化在浏览器 localStorage，键前缀为 dsh.mica.：

对比度保护由壁纸亮度自动计算，不在上表中单列开关；逻辑与预览脚本 scripts/preview.mjs 共用同一套公式。

渲染路径说明（便于排查）¶

• 主路径：有桌面采样且跟随窗口时，模糊烘进纹理，位移靠 transform。
• 回退路径：无桌面采样、铺满整张或使用自定义图时，走底片 + 定时重绘，材质不随窗口滑动。

宿主采样管线在 README 中有示意：14×14 色块与 128×72 缩略图同一次 PowerShell + System.Drawing 采样，再在前端做盒式平均、高斯预模糊与材质层叠。

适用场景与注意¶

适合谁

• 在 Windows 上使用 DSH desktop 配置，希望界面质感接近 Win11 Mica、且壁纸与窗口位置一致的用户。
• 需要在 DSH 内微调云母模式、实心度、模糊与噪点，并保留一键关闭恢复原生 UI 的场景。

务必注意

1. 平台与 profile：壁纸注册表读取、PowerShell 采样等能力针对 Windows 桌面环境；安装命令固定为 --profile desktop，与纯 Web profile 不同。
2. 插件权限：DSH 插件在 当前 dsh 进程权限 下运行；安装前应自行阅读 GitHub 仓库 源码与 MIT 许可证，确认可接受其行为（含读取桌面壁纸路径与生成纹理数据）。
3. 生态归属：DSH 社区插件目录（如 SkillHub 目录页）为独立站点，与 DeepSeek / 幻方无官方从属关系；本文介绍的是社区插件，非官方内置主题。
4. 技术依赖：客户端注入依赖 @deepseek-ai/dsh-client-runtime；若 DSH 大版本变更 DOM 或令牌命名，插件可能需要跟随更新。

结尾¶

dsh-mica 把 Win11 云母的两区结构、壁纸采样与随窗滑动合成落到 DSH 桌面壳上，并在设置里提供可逆开关与强度调节。若你要在 Windows 工作台上统一 DSH 与系统视觉语言，可按上文命令以本地路径安装、重启后在「云母材质」中试调参数。

• 目录页：https://www.skillhub.cn/plugins/208c/dsh-mica
• 源码与完整说明：https://github.com/208c/dsh-mica