前言¶
DeepSeek Harness (DSH) 的插件化系统允许开发者通过插件扩展功能。除了常规的功能增强，视觉层面的定制也是插件生态的一部分。现有的界面定制方案多基于 CSS，形式较为单一。dsh-video-skin 插件引入了视频背景与开机动画的概念，在不改变 DSH 核心逻辑的前提下，为桌面端和浏览器端提供了更丰富的视觉表现。
插件简介¶
该插件由 Something11235 维护，采用 MIT 许可证。其核心价值在于“零依赖”设计，将一段无声视频循环作为聊天背景，另一段有声视频作为开机动画。通过配置，用户可以调节透明度与对比度，使视频背景与界面文字保持可读性。
核心功能¶
插件主要提供以下能力：
- 聊天背景：一段短片循环铺满整个界面，默认静音。界面层的透明度可在 UI 中实时调节，无需重启。
- 有声开机动画：开机时播放有声动画，动画结束后自动交叉溶解进主界面。用户在播放期间点击画面即可跳过。
- 透明度控制：右下角提供半透明小圆钮，打开后包含两个滑块（面板透明度与视频遮罩），并支持三种预设。调完刷新即可生效，无需重启。
- 实时对比度读出：面板显示当前视频帧的文本对比度数据，辅助调节。
- 主题适配：支持暗黑与明亮主题的自动切换与配置。
安装与启用¶
安装插件需要通过 DSH 的插件管理界面进行。
- 进入 设置 → 插件 → 添加插件。
- 在输入框中粘贴以下命令并确认安装：
github:Something11235/dsh-video-skin#main
- 必须完全退出并重新打开 DSH 才会生效。在桌面版（Electron）中，由于索引注入表是在宿主启动时收集的快照，刷新页面不足以完成注入。
使用方法¶
安装完成后，可以通过以下方式使用：
- 调节透明度：右下角会出现一个半透明小圆钮，点击打开面板。拖动滑块调节遮罩透明度，按
Alt+B快捷键亦可切换面板。 - 跳过开机动画：启动时若不想等待开机动画，直接点击画面即可跳过。
- 关闭面板：点击面板外部区域，或按
Esc键关闭。 - 浏览器端音量：浏览器（dsh web）默认阻止未静音自动播放，会回退到静音播放并显示独立的音量按钮。点击音量按钮即可开启声音。
注意事项¶
- 配置文件路径：配置文件保存在
<plugin>/video-skin.config.或%USERPROFILE%\.dsh\dsh-video-skin.。修改文件后刷新页面即可生效，桌面版安装除外。 - 层级限制：透明度控制面板的 z-index 为 900，低于内核的 Modal overlay (1000)，确保模态框能正常覆盖控制面板。
- 依赖情况：插件完全零依赖，构建产物不包含外部
import，通过github:安装路径可直接使用。
总结¶
dsh-video-skin 提供了一种无需编写代码即可为 DeepSeek Harness 添加视频背景与开机动画的方案。通过精细调节透明度与对比度，可以在保证视觉美观的同时维持界面的可读性。更多细节与源码可查阅 GitHub 仓库。
