前言¶
DeepSeek Harness（dsh）是 DeepSeek AI 开源的智能体运行时，架构口号是「一切皆插件」：模型、工具、会话、UI 都可以用插件替换或叠加，而不必改 Harness 源码。官方仓库当前仍标为 developer preview，默认用下面这条命令就能拉起网页界面，地址一般是 http://127.0.0.1:3080：
npx @deepseek-ai/dsh web
界面能用之后，下一层需求往往是外观。顶栏、侧边栏、输入框、统计行、轨迹视图都是工作区里停留最久的几块区域，原生样式偏「能干活」，想做成磨砂玻璃，通常要么去改前端源码，要么装一套会动布局的皮肤。前者升级时容易冲突，后者可能把其他插件的面板挤乱。
DSH-Transparent-UI-Plugin 走的是第三条路：在网页端外面再套一层玻璃材质。模糊度、磨砂度、背景都可以在设置里调；关掉总开关，界面回到原生样子。社区插件目录把它归在「主题与外观」。需要说明的是，DeepSeek Harness 插件库 是独立的社区站点，和 DeepSeek / 幻方没有官方从属关系，不要把它当成官方应用商店。
这是什么¶
一句话定位：DSH-Transparent-UI-Plugin 是套在 DeepSeek Harness 网页端上的玻璃质感主题。维护者是 GitHub 用户 WYH66666666，仓库采用 MIT 许可证，版权页署名为 John Wu。目录页与 package.json 都标明主要语言是 JavaScript。
仓库内部的 npm 包名是 @deepseek-ai/dsh-client-ui-aqua，README 里简称 Aqua，设置页总开关的文案是「玻璃主题」。这个 @deepseek-ai/ 作用域只是包名，插件本身由社区维护，不是 DeepSeek 官方主题。package.json 里 dsh.client.platform 写的是 web，对等依赖指向 @deepseek-ai/dsh-client-* 的 ^0.1.0-rc.5，也就是说它挂在 Web UI 这一侧，不覆盖终端 TUI。
截至 2026 年 8 月 17 日，GitHub API 显示该仓库 177 星、最新正式版 v1.3.0（2026-08-16 发布）。社区目录页同期仍显示 19 星，和仓库实时数据不一致，星标以 GitHub 为准。
它要解决的问题很具体：在不改 DSH 任何一行源码的前提下，把顶栏、侧边栏、输入框、统计行、轨迹视图变成可调的磨砂玻璃，并允许用流体、图片或视频当背景。
核心功能与亮点¶
下面能力来自仓库 README / README.zh.md 和 CHANGELOG，以当前最新版 v1.3.0 为准。README 对 v1.2 之后的几项（悬停下压、鼠标辉光、视频壁纸等）更新较慢，这些以 CHANGELOG 为准。
1、云母效果和兼容模式¶
主题提供两种模式：
- 云母效果（早期版本叫「漂浮玻璃」）：把布局改成悬浮玻璃卡片，模糊度、磨砂度可调。顶栏、侧边栏、发送框、统计行、轨迹视图各自成片，聊天区在背景上滑动。
- 兼容模式：原版排版保持一字不动，只把材质换成通用玻璃。README 写明它按角色和类名子串命中菜单、卡片、气泡、下拉、提示等表面，其他插件的界面也会自动玻璃化。
v1.2.0 的 CHANGELOG 还记过一次兼容模式修复：注入层不再顶歪顶栏、新建会话按钮和发送栏。如果装了侧边栏、看板一类会往页面里塞控件的插件，优先用兼容模式更稳妥。
2、流体、图片和视频三种背景¶
背景有三条路：
- 流体板：一块会动的背景，颜色可调。v1.2.0 起拆成「色调」「颜色深浅」两条滑杆：0°/360° 锚定蓝色，默认色调 320°（青蓝）；深浅从浓到粉彩无极调节。
- 图片壁纸：铺满页面、保持比例，可单独调模糊度和磨砂度。图片会压缩后存在本地。README 建议浅色壁纸配浅色模式、深色壁纸配深色模式。
- 视频壁纸（v1.3.0）：用浏览器原生解码，循环播放、铺满裁剪，窗口缩放会跟着适配。Chromium 内核下可用 File System Access「记住文件授权」，刷新后自动读回原文件；非 Chromium 会退回数据库存储。CHANGELOG 写明视频上会加自动柔光罩，聊天气泡改实底，避免字看不清。
背景亮度跟当前深浅色走：深色模式只能在 0–50 压暗，浅色模式只能在 50–100 提亮，50 表示不改。选「跟随系统」时，旋钮范围会按实际解析出的模式翻转。
3、玻璃旋钮和出厂默认值¶
云母模式下，玻璃本身有模糊度、磨砂度两条旋钮。v1.2.0 给出的出厂默认是：
- 模糊 20
- 磨砂 7
- 色调 320
- 深浅 25
- 亮度 50
- 相关开关默认开启
v1.3.0 还把发送栏和数据栏收成一块玻璃：同一套背景、模糊、边框和投影，分界线落在左右圆角弯曲处，避免两片玻璃模糊度对不齐。数据栏文字和发送栏占位符改成中性色（深色近白、浅色深灰），去掉原来的蓝色调。
4、装饰层：粒子鲸鱼、小鱼、边缘模糊、铭牌¶
这些都可以在设置里关掉，不是主题本体：
- 粒子鲸鱼：README 写的是 deepseek.com/harness 同款粒子鱼的 2D 移植，放在聊天主区域正中央（不含侧边栏）。深色模式白粒子，浅色模式灰粒子。
- 小鱼（v1.1.2）：背景里游动的小鱼/气泡，开关在粒子鲸鱼旁边。
- Harness 光泽铭牌：仅深色模式生效，侧边栏铭牌换成官网同款药丸（135° 渐变描边 + 柔光）；浅色模式保持原版。
- 边缘渐变模糊：页面顶部和底部各 5px 渐变模糊带，浮在聊天内容上层，滚到边缘会融进去。浅色微泛白，深色微泛黑。
v1.2.0 另外加了两组悬停效果，设置里单独分组：
- 鼠标辉光：光标附近一层荧光光晕，画在玻璃下面从磨砂里透出来，不挡内容。v1.2.1 起颜色跟随「色调」滑杆。
- 悬停下压：官网卡片同款 3D 倾斜（哪边有鼠标哪边下压，透视 800px，微放大 1.01，0.1s 过渡）。顶栏、侧边栏、发送框+数据栏、轨迹窗用同一配方，轨迹窗幅度减半。
5、一键开关，关掉就回到原生界面¶
总开关打开后主题默认生效；关掉之后，README 的表述是「完全还原原生界面」，效果随插件卸载一起消失。总开关在「设置 → 插件 → 玻璃主题」，形状和其他插件卡片一样。其余旋钮都在「设置 → 通用设置 → 外观」正下方，没有单独标题。总开关关闭时，外观下面那一整块调节会隐藏。
安装与启用¶
目录页给出的安装命令如下，在已经装好 dsh CLI 的终端里执行即可。命令以目录页原文为准，不要自己拼接仓库名：
dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin
需要可复现安装时，按目录页说明把 commit 哈希钉死：
dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin#<commit>
把 <commit> 换成仓库里实际的提交哈希。dsh 官方文档里，GitHub 源安装走的是 pnpm；若第一次 add 被 pnpm ≥10 拦住 prepare 脚本，按终端提示把对应包名写进当前 profile 的 pnpm-workspace.yaml 的 allowBuilds，再执行一次 add。
Windows 用户如果更想用仓库自带的安装器，README 提供了一条 PowerShell 命令，默认装最新 Release，不强制本机有 git（会退回到 zip 下载）。脚本会把插件链到 profile 的 node_modules，并在 cordis.patch.yml 里登记 ui-aqua，重复执行不会重复登记：
powershell -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://github.com/WYH66666666/DSH-Transparent-UI-Plugin/raw/main/install.ps1' -OutFile install.ps1; .\install.ps1"
指定版本或跟踪开发分支：
.\install.ps1 -Version 'v1.3.0'
.\install.ps1 -Version 'main'
README 里 macOS / Linux 的示例仍写着 --branch v1.1.0，而当前最新正式版已经是 v1.3.0。跨平台更稳妥的做法是优先用上面的 dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin。装好后刷新 Web 界面即可。
典型用法¶
刷新网页后，Aqua 默认是开着的。按 README 的路径操作：
- 打开 设置 → 插件 → 玻璃主题，确认总开关为开启。关掉它，外观页那一组旋钮会一起消失，界面回到原生。
- 打开 设置 → 通用设置 → 外观，在外观区块正下方调节：
- 模式：云母效果 / 兼容模式
- 模糊度、磨砂度（云母模式）
- 流体色调、颜色深浅
- 背景亮度
- 背景类型：流体 / 壁纸（含图片、以及 v1.3.0 的视频）
- 壁纸自己的模糊、磨砂、删除按钮
- 粒子鲸鱼、小鱼
- 鼠标辉光、悬停下压 - 先在默认值附近试：模糊 20、磨砂 7、色调 320、深浅 25、亮度 50。背景太抢眼就先把亮度往 50 收，或把壁纸模糊拉高。
- 如果同时装了会改 DOM 的界面插件，先切到兼容模式，确认其他插件的按钮、面板还在原位，再决定要不要用云母效果改布局。
- 用视频壁纸时，CHANGELOG 建议在 Chromium 内核浏览器里授权一次本地文件，这样刷新后不用重新选；气泡在视频上是实底，这是有意为之，不是显示故障。
设置页本身在 v1.2.0 之后也会玻璃化（约 50px 磨砂，区分深浅色，兼容模式生效）。装饰和悬停效果在设置里分成两组，可以整组关掉，只留玻璃材质。
适用场景与注意事项¶
适合这几类用法：
- 日常用 DSH 网页端写代码、看轨迹，希望界面接近磨砂玻璃，但不想 fork 前端。
- 已经装了侧边栏、看板、皮肤类插件，只想换材质、尽量不动排版——用兼容模式。
- 想用自己的壁纸或循环视频当工作区背景，并且能单独调模糊和亮度。
使用前注意下面几条：
- 只覆盖 Web UI。
package.json声明platform: "web"。终端 TUI、桌面套壳如果没用这份网页界面，装了也不会出现玻璃主题。 - 对等依赖是
^0.1.0-rc.5。 DSH 仍在 developer preview，官方 README 写明会有破坏性变更。升级 Harness 之后如果主题错位或开关消失，先核对插件版本和 Web UI 版本是否还匹配。 - 包名里的
@deepseek-ai/不代表官方出品。 维护者是 WYH66666666，许可证 MIT。安装前应自己打开仓库看源码和 LICENSE。 - 插件以当前 dsh 进程的权限运行，安装时可能执行代码。目录页也写了同一句警告。社区目录只是索引，不代替你做安全审查。需要可复现环境时，用
#<commit>钉死版本，避免后续 push 悄悄改掉正在跑的代码。 - README 的 macOS 示例仍钉在 v1.1.0，缺粒子鲸鱼之后的多项能力。不要照抄过期分支号；以 GitHub Release 的 v1.3.0 或
dsh plugin add解析到的当前默认版本为准。 - 粒子鲸鱼、小鱼、悬停下压、视频壁纸在设置里都有独立开关。不需要这些装饰时可以关掉，只留玻璃材质；仓库没有提供性能基准，是否卡顿以本机 Web UI 实测为准。
小结¶
DSH-Transparent-UI-Plugin 做的事情很收束：给 DSH 网页端加一层可开关的玻璃主题，布局可以改成云母卡片，也可以只换材质。背景支持流体、图片和视频，旋钮都在「外观」下面，关掉总开关就回到原生界面，不改 Harness 源码。
它是社区 MIT 项目，不是官方皮肤。装之前看一眼源码和许可证，安装命令用目录页这一条即可：
dsh plugin add github:WYH66666666/DSH-Transparent-UI-Plugin
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-transparent-ui-plugin/
GitHub：https://github.com/WYH66666666/DSH-Transparent-UI-Plugin
