前言¶
DeepSeek Harness（DSH）在 macOS 上可以利用 NSVisualEffectView 做窗口级 Vibrancy，但上游界面 CSS 往往在会话区、侧边栏、气泡和输入框上叠了不透明底色，玻璃效果被挡住。换主题或改布局能一定程度上缓解，成本却更高，且容易和第三方侧边栏插件冲突。
下面介绍的 dsh-vibrancy-skin 只做材质层：把相关区域的实心底色换成同族半透明，让窗口里原有的毛玻璃透出来；不重建 UI、不改布局尺寸与间距，也不动第三方插件文件。
这是什么¶
dsh-vibrancy-skin 由维护者 Natasha123-bit 发布，在 SkillHub 社区分类为「趣味换装」。插件通过纯 CSS 注入调整背景与自定义属性，不发网络请求；关闭总开关即可回到原生像素表现。
适用宿主：
- DSH NEXT 2.0.x 或 官方 DeepSeek Harness 客户端 0.2.x（两者共用
~/.dsh/profiles/desktop，装一次两边都生效） - 仅 macOS（Windows / Linux 无此窗口材质，安装后为空操作）
核心功能¶
README 中列出的效果如下，均可在「设置 → 磨砂玻璃」中即时调节，无需重启（装好后若 loader 未加载，见下文常见问题）。
会话与底栏
- 主区域整片磨砂；输入框、消息气泡、文件卡片、cost 侧栏面板为半透明
第三方侧边栏
- 例如与 dsh-better-sidebar 共存：面板、标签栏、底部工作台同款磨砂
- 可选「深层玻璃」，将内部卡片、列表也玻璃化（对比度会下降）
强度与背景
- 三层强度：磨砂 24% / 均衡 40%（默认）/ 实心 62%
- 微调 0–100，在预设不够时精确指定
- 背景图：透到桌面 或 透到壁纸（本地图片压缩后存 IndexedDB，不上传）；壁纸模式可调磨砂度 0–100
其它约定
- 对话框、命令面板等弹层保持不透明，保证可读性
- 偏好存在本机 localStorage，改动立即生效
环境要求¶
- macOS，且 DSH 窗口材质为透明（NEXT 默认符合；官方客户端同样符合）
- 兼容版本（资料原文）：NEXT 自 2.0.20-next 起（实测 2.0.22-next）；官方客户端自 0.2.2-rc.1 起
- npm 包当前版本：dsh-vibrancy-skin@1.6.1，许可证 MIT
安装与启用¶
从插件市场（推荐）¶
收录后，在 DSH 中打开 设置 → 插件市场，搜索「磨砂玻璃」或 dsh-vibrancy-skin 安装，然后重启 DSH。
资料说明：市场收录尚在准备中；收录前可先手动安装。
手动安装（npm 包）¶
包已发布到 npm，安装与 profile、bundle 列表、备份回滚的完整步骤见仓库 docs/DEVELOPMENT.md 的「安装」一节。勿仅凭插件名拼接未在文档中出现的 CLI 命令。
装完后用 Cmd+Q 退出再打开 DSH，确保插件进入 loader。手动安装需确认 profile 的 dependencies 与 dsh.profile.bundles 两处均包含 dsh-vibrancy-skin。
典型用法¶
装好后进入 设置 → 磨砂玻璃（导航中紧挨「桌面」页）。主要控件如下：
| 控件 | 默认 | 说明 |
|---|---|---|
| 启用磨砂玻璃 | 开 | 总开关；关 = 摘除全部样式表 |
| 背景图 | 透到桌面 | 「透到壁纸」可选本地图片 |
| 侧边栏面板磨砂 | 开 | 第三方侧边栏面板随主界面磨砂 |
| 深层玻璃（卡片 / 列表） | 关 | 侧边栏内部也玻璃化 |
| 强度 | 均衡 | 磨砂 / 均衡 / 实心三档 |
| 磨砂度 | 36 | 仅壁纸模式；「透到桌面」时置灰 |
| 微调 | — | 0–100 精确强度 |
临时关闭用总开关即可；彻底卸载可走市场卸载，或按开发文档 §4 手动移除。
适用场景与注意¶
适合谁
- 在 macOS 上长期使用 DSH NEXT 或官方 Desktop 客户端，希望主窗格与侧边栏呈现统一磨砂质感，又不愿改布局或 fork 上游样式
运行与信任
- 插件以当前 DSH 进程权限运行，仅做客户端 CSS 注入；安装前可在 GitHub 查看
index.js、client.js与 MIT 许可证 - 不声明
peerDependencies（原因见开发文档 §6），以降低内核升级时兼容性校验拒载的风险；与 dsh-better-sidebar 等插件共存且不修改对方文件
常见问题（来自 README）
- 装完没反应：确认 macOS、总开关已开、必要时重启 DSH
- 找不到设置页：检查是否已正确挂载到 profile / bundles
- 对话框仍实心：属设计如此，非失效
- 性能：无轮询与监听循环；背景装饰层
pointer-events: none，不参与布局
社区插件目录页与上游仓库相互独立，与 DeepSeek / 幻方无官方从属关系；星标与收录状态以各站点当时显示为准。
结尾¶
dsh-vibrancy-skin 把 DSH 在 macOS 上已有的 Vibrancy 从被 CSS 挡住的状态里释放出来：材质可调、可关、可卸载，布局零改动。需要效果图与开发验收清单时，可直接查阅仓库 README 与 docs/DEVELOPMENT.md。
