前言¶
如果你在用 DeepSeek Harness（dsh）的 Web GUI，会发现界面样式基本是默认的。想加一点视觉标识，通常只有两条路：直接改 dsh 前端源码，或者自己维护一套构建流程——两者都要跟 dsh 的版本升级做斗争。
下面介绍的 dsh-logo-silhouette 走的是另一条路：利用 dsh 的插件机制，把一层纯视觉的背景水印挂进 Web GUI，不改宿主逻辑，装上就能用。
这是什么¶
dsh-logo-silhouette 是 kami-mura 维护的 dsh 插件，把 DeepSeek 鲸鱼 logo 剪影作为全屏背景水印铺在 Web GUI 上。当前版本 0.2.0，MIT 许可。
它是纯视觉插件，没有任何宿主逻辑：鲸鱼图形、颜色、透明度全在一个手写的 client bundle 里，与 dsh 的功能代码互不干扰。
核心功能¶
背景层与交互
- 固定铺满视口的背景层，
z-index: 0，不挡点击、不挡滚动 - 整层设置
pointer-events: none，完全不挡交互 - 大号鲸鱼剪影固定在左下角，高度
min(56vh, 600px)，带aria-hidden
明暗主题适配
- 亮色模式使用 DeepSeek 品牌蓝（设计令牌
--dsw-static-deepseek-500），opacity: .15 - 夜间模式使用柔和浅蓝（
--dsw-static-deepseek-300），opacity: .12 - 颜色和透明度随主题 300ms 平滑过渡，切换不跳变
夜间模式细节
- 鲸鱼顶部有 mask 渐隐，上缘融入背景，去掉「贴纸感」
- 暗色下进一步降低不透明度，减少深色底上的眩光
- 窄屏自动缩小并修正定位（
left/bottom） - 尊重
prefers-reduced-motion，并有系统暗色prefers-color-scheme兜底
安装与启用¶
安装命令只有一行：
dsh plugin --profile web add dsh-logo-silhouette
安装后需重启 dsh web 服务生效。
这个包是标准的 dsh bundle（dsh.bundle.patch），dsh plugin add 会自动把它加入 profile 的层栈（dsh.profile.bundles），不需要手改任何配置文件。
也可以直接从 GitHub 安装：
dsh plugin --profile web add github:kami-mura/dsh-logo-silhouette
卸载同样一行：
dsh plugin --profile web remove dsh-logo-silhouette
想改样式怎么办¶
所有视觉和 CSS 都在 lib/client.js 里。它是一个手写的 client bundle（window.__ModuleLoader__ 格式），没有构建依赖，直接改就能生效。
先打开 lib/client.js，找到里面的 CSS 常量：
- 颜色走 DSH 设计令牌
--dsw-static-deepseek-*，带兜底色 - 位置、尺寸、透明度直接改数值
如果需要改鲸鱼图形本身，走构建脚本：
npm run build
scripts/build.js 会从 assets/favicon.svg（从 deepseek-harness 仓库 vendored 的 logo 源文件，MIT 许可）提取鲸鱼路径，并写回 lib/client.js。
仓库里另一个文件 lib/index.js 是 host 半体，因为纯视觉插件没有宿主逻辑，它基本是空的。插件的结构就这两部分，看完不需要更多上下文。
适用场景与注意¶
适合自托管 dsh web、想给界面加一点视觉标识或个人风格的人。因为不挡交互、不碰宿主逻辑，装上之后界面行为不会有任何变化，只是多了一层背景。
两点注意：
1、插件以当前 dsh 进程的权限运行，安装前应先阅读源码、确认许可证。这个仓库 MIT 许可，代码量不大，lib/client.js 加 lib/index.js 很快能过一遍。
2、DeepSeek 鲸鱼 logo 是 DeepSeek 的品牌资产。本插件只是把它作为装饰性水印展示，不代表与 DeepSeek 官方有关联，介意这点的可以不装。
结尾¶
dsh-logo-silhouette 是一个典型的「小而纯」的 dsh 插件：单一层视觉补丁、零宿主逻辑、MIT 许可。经过上面的步骤，重启后的 Web GUI 左下角就会多出一只低调的鲸鱼剪影，明暗主题自动跟随。
- 目录页：https://www.skillhub.cn/plugins/kami-mura/dsh-logo-silhouette
- GitHub：https://github.com/kami-mura/dsh-logo-silhouette
