前言¶
DeepSeek Harness（DSH）Desktop 在 macOS 上会以原生 vibrancy 和透明窗口（vibrancy: "sidebar"、backgroundColor: "#00000000"）向系统要一层材质。Web GUI 却把各面板涂成不透明，材质被盖住，窗口看起来仍是普通实底。
下面介绍社区插件 dsh-frosted-glass（维护者 ViccRondo，目录分类「趣味换装」）：通过客户端样式把面板改成半透明着色，让系统自带的模糊露出来，而不是在 CSS 里逐帧重算模糊。
这是什么¶
dsh-frosted-glass 是面向 DeepSeek Harness Desktop 窗口的客户端插件，一句话定位是：Native macOS frosted glass for the DeepSeek Harness Desktop window——让 UI 面板显示窗口真实的 vibrancy 材质，而不是再盖一层不透明色。
实现方式不改动应用二进制，仅在浏览器侧注入样式；宿主侧通过 cordis.patch.yml 增加 Loader 行。插件以当前 DSH 进程权限运行，安装前宜自行查看 GitHub 仓库 源码与 MIT 许可证。
核心功能¶
启用后大致会带来这些变化（均以 README 描述为准）：
- 整窗读作一块毛玻璃：模糊由 macOS 合成，不在 CSS 里按帧二次模糊。
- 深度一致：对话页、日程页、插件页等主表面共用同一层着色，避免每层各自叠不透明底。
- 页面样式表面：半透明后，原先比正文深一级的 sticky 页眉条表现会随设计变化。
系统行为也会被尊重：降低透明度（Reduce transparency）与 macOS 全屏模式下，会退回实底表面，与原生应用一致。
不支持：浏览器里打开的 Web GUI（没有窗口材质可透出）；Windows Desktop 无视觉效果（选择器限定 html[data-platform="darwin"]）。
环境与要求¶
| 项目 | 说明 |
|---|---|
| 宿主 | DSH Desktop，且运行在 macOS |
| DSH 版本 | dsh >= 0.2.0-rc.1（见 package.json 的 engines.dsh） |
| 不适用 | 浏览器标签页中的 Web GUI |
安装与启用¶
在 DSH 中打开 插件 → 添加插件，按 spec 安装（命令须与官方 README 一致，勿自行拼接 github:owner/repo）：
- npm：
dsh-frosted-glass - 本地目录：
file:/absolute/path/to/dsh-frosted-glass
安装后在插件页将 frosted-glass 开关打开。页面会重新加载模块，无需重启应用。
关闭：在插件页关闭该 bundle，或从插件列表移除。
调色与微调¶
可调参数写在 lib/client.js 文件顶部的样式里。百分比表示不透明度，数值越低越透：
--dsh-frosted-glass-pane: color-mix(in srgb, #fdfdff 56%, transparent); /* light theme */
--dsh-frosted-glass-pane: color-mix(in srgb, #151517 44%, transparent); /* dark theme */
侧栏单独一层 alpha（macOS 侧栏填充本身已带约 50% 透明混合）：
--dsw-specific-sidebar-fill: color-mix(in srgb, #f9fafb 50%, transparent);
修改文件后，将插件关再开一次以重新加载。
工作原理（简述）¶
包内同时提供 host 与 browser 两半：dsh.bundle 指向 cordis.patch.yml，dsh.client 指向浏览器 bundle；模块装载时浏览器侧追加一个 <style>。
样式完全靠选择器驱动：
- 统一改
--dsw-alias-bg-base，各面板即共用一层玻璃色； html[data-platform="darwin"]使非 macOS 平台不生效；- 对话根、页面根、Tab 宿主等会重复涂抹同一 token 的层被设为透明，保证主表面只有一层 tint。
局限与维护注意¶
- 仅 macOS Desktop；Windows 与浏览器无视觉变化。
- 选择器依赖 CSS Module 的 local 名（如
pageBar、pageBody、TabHost等），一般能扛过重编译 hash 变化，但若 DSH 做一次较大布局重构，选择器仍可能失效。 - 系统「降低透明度」与全屏优先于插件效果，属设计行为。
当前 npm 包版本为 0.1.0（见 package.json）。
目录与源码¶
- 社区目录页：skillhub.cn — ViccRondo/dsh-frosted-glass
- 源码与中文说明：GitHub — ViccRondo/dsh-frosted-glass（含
README.zh.md）
DSH 生态强调「一切皆插件」；SkillHub 等目录为社区站点，与 DeepSeek / 幻方无官方从属关系。若你长期在 macOS 上使用 DSH Desktop，又希望窗口材质与系统磨砂一致，可先按上文 spec 安装 dsh-frosted-glass，再按需微调 lib/client.js 中的透明度变量。
