前言¶
DeepSeek Harness（DSH）的 Web 界面默认是功能导向的开发者 UI。若你希望在不改 DSH 源码的前提下，给聊天与设置页换一套玻璃拟态视觉、可调背景与装饰，社区里有「客户端 UI 主题」类插件可走。下面介绍维护者 zmm863-commits 发布的 dsh-client-ui-paopaocat（社区分类：趣味换装）：基于 Seaglass 架构，为 DSH Web 端提供可开关、可细调的泡泡猫主题。
这是什么¶
dsh-client-ui-paopaocat 是纯客户端 Web 主题插件：Host 侧为空实现，样式与交互通过客户端 bundle 注入。关闭总开关即可完全还原原生界面，不修改 DSH 一行源码。
README 标明适配 DSH 0.2.0-rc.2（peerDependencies 覆盖 ^0.1.2-rc.1 与 ^0.2.0-rc.1）。当前 npm 包版本为 0.3.4。0.3.3 起对 settingsScope 改为可选探测，避免在较旧 DSH 上主题永久 pending；0.3.4 起已移除背景音乐（播放器、上传与内置曲目入口均下线），下文功能以当前版本为准。
- 目录页：https://www.skillhub.cn/plugins/zmm863-commits/dsh-client-ui-paopaocat
- 源码：https://github.com/zmm863-commits/dsh-client-ui-paopaocat
- 许可证：MIT
核心功能¶
双风格与双模式¶
设置面板顶部 风格 分段控件可在 淡雅 / 蓝色 间实时切换：
- 淡雅：极淡冰蓝白底（
#F5F9FC → #FFFFFF），玻璃近乎透明，装饰克制，强调留白与高字体反差。 - 蓝色：饱和蓝白流体（
#87CEEB → #F0F8FF → #E0F7FA），猫爪、泡泡、小鱼、星光等装饰更明显。
模式 二选一：云母效果 将布局改为悬浮玻璃卡片；兼容模式 保持原版排版，仅替换材质。
背景与材质¶
- WebGL2 流体背景：三色渐变、噪声、漩涡与鼠标交互，色调（0–360°）与深浅（0–100%）可调。
- 壁纸背景：内置默认壁纸，也可自定义图片或视频；支持模糊、磨砂、亮度调节。默认壁纸
assets/default-wallpaper.jpg由 Agnes 图像 API（agnes-image-2.1-flash）生成后经尺寸压缩；猫角色、猫爪、小鱼、泡泡、星光等为插件内联 SVG，随主题色变化。 - 玻璃材质：模糊度 0–40px，磨砂度与代码块磨砂度均为 0–100%。
装饰、交互与字体¶
- 环境装饰 可单独开关：猫角色、小鱼、星光。
- 悬停效果：鼠标辉光、悬停下压。
- 中/英文字体 可在设置中分别指定。
全部样式经 [data-ppc] 属性 gating，卸载或关闭主题即可还原，不污染全局 DOM 语义。
安装与启用¶
在已安装 DSH CLI 且使用 web profile 的环境下，执行官方 README 中的安装命令：
dsh plugin --profile web add dsh-client-ui-paopaocat
安装完成后刷新 DSH Web 界面。在设置中找到该主题相关分组，打开 总开关 即可生效；关闭总开关即回到原生界面。
若需从源码本地调试（维护者文档中的流程），可在克隆仓库后构建并以本地路径安装：
cd dsh-client-ui-paopaocat
npm install
npm run build
dsh plugin --profile web add "$(pwd)"
npm run build 会执行 tsdown、ModuleLoader 包装与 headless smoke test，任一环节失败则构建失败。
典型用法：设置项一览¶
安装并刷新后，在 DSH Web 设置 中按需求调整。README 归纳的分组如下：
| 分组 | 控件 |
|---|---|
| 总开关 | 开启 / 关闭 |
| 风格 | 淡雅 / 蓝色 |
| 模式 | 云母效果 / 兼容模式 |
| 玻璃材质 | 模糊度 0–40px · 磨砂度 0–100% · 代码块磨砂度 0–100% |
| 背景 | 流体 / 壁纸；流体含色调与深浅；壁纸支持图片与视频 |
| 环境装饰 | 猫角色 · 小鱼 · 星光 |
| 悬停效果 | 鼠标辉光 · 悬停下压 |
| 字体 | 英文字体 · 中文字体 |
建议先选 风格 与 模式，再调 背景 与 玻璃材质，最后按需开关装饰与悬停，避免一次改过多参数难以对比效果。
适用场景与注意¶
适合谁：长期在 DSH Web 端调试智能体、希望界面更柔和或更有主题感，且接受 WebGL 流体与玻璃效果带来的额外客户端开销的开发者。
版本与生态：
- 安装前确认本机 DSH 版本与 README 中的 peer 范围匹配；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，插件质量与兼容性以仓库说明与源码为准。
- 插件在 当前 dsh 进程权限 下运行，安装前应阅读源码与 MIT 许可证，自行评估是否满足环境策略。
- 目录页简介若仍提到背景音乐，以 GitHub 0.3.4 说明为准：当前版本已无播放器与上传能力。
实现要点（便于排查问题）：客户端 bundle 为单文件 CJS，由构建脚本包装为 window.__ModuleLoader__.load；React 经 factory 的 require 获取。主题逻辑集中在 client/ppc-layer.ts（生命周期、CSS 变量、流体、场景、辉光）与 ppc-preset.ts（双风格参数）等模块，便于对照行为与样式。
结尾¶
dsh-client-ui-paopaocat 把 Seaglass 式客户端主题架构落到「泡泡猫」视觉：淡雅/蓝色一键切换、流体或壁纸背景、可关可开的装饰与悬停，并通过总开关与属性 gating 保证可逆。若你要为 DSH Web 换肤且不想 fork 主仓库，可按上文命令安装后在设置里逐项微调。
