前言¶

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，改动立即生效

环境要求¶

1. macOS，且 DSH 窗口材质为透明（NEXT 默认符合；官方客户端同样符合）
2. 兼容版本（资料原文）：NEXT 自 2.0.20-next 起（实测 2.0.22-next）；官方客户端自 0.2.2-rc.1 起
3. 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。

典型用法¶

装好后进入 设置 → 磨砂玻璃（导航中紧挨「桌面」页）。主要控件如下：

临时关闭用总开关即可；彻底卸载可走市场卸载，或按开发文档 §4 手动移除。

适用场景与注意¶

适合谁

• 在 macOS 上长期使用 DSH NEXT 或官方 Desktop 客户端，希望主窗格与侧边栏呈现统一磨砂质感，又不愿改布局或 fork 上游样式

运行与信任

• 插件以当前 DSH 进程权限运行，仅做客户端 CSS 注入；安装前可在 GitHub 查看 index.js、client.js 与 MIT 许可证
• 不声明 peerDependencies（原因见开发文档 §6），以降低内核升级时兼容性校验拒载的风险；与 dsh-better-sidebar 等插件共存且不修改对方文件

常见问题（来自 README）

1. 装完没反应：确认 macOS、总开关已开、必要时重启 DSH
2. 找不到设置页：检查是否已正确挂载到 profile / bundles
3. 对话框仍实心：属设计如此，非失效
4. 性能：无轮询与监听循环；背景装饰层 pointer-events: none，不参与布局

社区插件目录页与上游仓库相互独立，与 DeepSeek / 幻方无官方从属关系；星标与收录状态以各站点当时显示为准。

结尾¶

dsh-vibrancy-skin 把 DSH 在 macOS 上已有的 Vibrancy 从被 CSS 挡住的状态里释放出来：材质可调、可关、可卸载，布局零改动。需要效果图与开发验收清单时，可直接查阅仓库 README 与 docs/DEVELOPMENT.md。

• 社区目录：https://www.skillhub.cn/plugins/Natasha123-bit/dsh-vibrancy-skin
• GitHub：https://github.com/Natasha123-bit/dsh-vibrancy-skin