前言¶

DeepSeek Harness（DSH）通过客户端主题插件可以改配色、注入 UI，但多数主题只动 CSS 变量，聊天区背景仍是默认空白。若你希望在不改侧栏布局的前提下，给中心对话列加上静态或视频壁纸、开屏、环境音和轻量粒子，需要自己处理媒体存储、轮播和控制条交互。下面介绍社区维护者 morningluu 发布的 dsh-theme-scaramouche（仓库名，SkillHub 分类为「趣味换装」）：一套围绕《原神》角色散兵 / 流浪者视觉风格设计的非官方粉丝主题，媒体已嵌入本地 bundle，安装后可在 DSH 0.2.x 桌面端或 dsh web 上直接使用。

这是什么¶

dsh-theme-scaramouche 是 DeepSeek Harness 的客户端 UI 主题插件，当前 package.json 版本为 0.2.0，声明 engines.dsh >= 0.2.0。仓库 README 标题为「散兵 · 浮世雷音」，定位是完整的 Scaramouche 风格暗色主题：墨黑底、深海蓝 × 青蓝 × 雾紫蓝配色、暗金细线，并附带开屏视频、预设壁纸、环境音乐与右下角可拖动玻璃控制条。

主题不修改 DSH 侧栏布局，不做 fixed 覆盖 frame 轨道；预设与自定义壁纸只在聊天中心列显示，侧栏保持纯黑。仓库为「完整本地媒体版」：开屏、最后一帧预设壁纸、环境音乐已写入 lib/client.js，开箱可见完整效果；同时支持导入自有图片/视频、粒子与遮罩透明度调节。代码与原创 SVG 为 MIT；README 明确开屏视频、最后一帧与 HOYO-MiX 音乐仅用于非商业粉丝演示，不在 MIT 授权范围内，项目与米哈游 / HoYoverse、DeepSeek 均无关联。

核心功能¶

视觉与设计令牌¶

• 91 个 --dsw-* 设计令牌，colorScheme: dark。
• 原生 DSH 侧栏，壁纸层与预设/自定义共用同一套显示逻辑。

壁纸¶

• 静态 / 视频壁纸：多张导入、缩略图库、任意勾选、轮切或循环；遮罩透明度 0–100%（默认 70%），只调黑色遮罩层，不改变素材本身亮度。
• 图片与视频存入本机 IndexedDB；视频以 Blob 保存并自动抽帧做 poster，静音循环、点击穿透。
• 轮切播完所选后停下；循环则回到第一张。

开屏、音乐与粒子¶

• 完整开屏视频（含音频），带声音开关与跳过；无视频时开屏直接关闭。
• 环境音乐为内置 96k MP3，<audio loop>；浏览器自动播放策略可能要求先点击页面一次。
• 粒子三种：青蓝光点、雷光、雪；渲染在聊天内容下方，不影响阅读。

控制条¶

右下角可拖动玻璃控制条；小屏自动收紧/横排；位置按距右下角的相对距离保存，窗口缩放或全屏后跟随边缘。

安装与启用¶

从 GitHub 安装（README 推荐方式）。desktop 为官方桌面端 profile；若使用 dsh web，将 desktop 换成 web，自定义 profile 换成实际名称。

dsh plugin --profile desktop add github:morningluu/dsh-theme-scaramouche

从源码安装时，README 给出本地 link 方式（需已有源码目录，本文不展开 clone 步骤）：

dsh plugin --profile desktop add link:"$PWD"

安装后完全退出 DSH 再重开，以便客户端 bundle 重新加载。客户端主题依赖宿主支持 dsh.client 与 @deepseek-ai/dsh-client-ui-theme。

典型用法¶

安装并重开 DSH 后，界面右侧有四个入口，对应 README 中的控制项：

壁纸缩略图右上角勾选圈决定哪些进入轮播。若需替换为自有媒体或生成不含官方素材的干净版，仓库提供 scripts/intro-video.cjs，例如：

node scripts/intro-video.cjs \
  --video "/path/to/your-opening.mp4" \
  --fallback "/path/to/your-fallback.mp4" \
  --music "/path/to/your-music.mp3"

查看媒体标记状态：

node scripts/intro-video.cjs --check

生成不含官方素材的干净版：

node scripts/intro-video.cjs --clean

脚本将压缩后的视频/音频以 base64 嵌入 lib/client.js；替换后的素材版权仍归其权利人，请勿超额分发。

适用场景与注意¶

适合谁：已在 DSH 0.2.x 上使用桌面端或 Web，希望聊天区有壁纸/视频背景、开屏与氛围音，且接受暗色粉丝向视觉的用户。SkillHub 目录页分类为「趣味换装」。

运行与信任边界：插件随当前 DSH 进程加载，安装前应阅读仓库源码、LICENSE 与 NOTICE.md，确认许可证与官方媒体使用边界。公开版仓库内含《原神》相关官方演示媒体，不用于商业用途；若需对外发布无官方素材版本，应使用 --clean 构建流程。

兼容性（来自 README）：DeepSeek Harness 0.2.x；桌面端与 dsh web 均可。

结尾¶

dsh-theme-scaramouche 把散兵向暗色令牌、聊天区壁纸（含视频与轮播）、开屏、环境音乐、粒子与可拖动控制条收进一个 DSH 客户端主题，并在 README 中写清 MIT 代码与官方粉丝演示媒体的版权分界。目录与收录信息可在 SkillHub 查看：morningluu/dsh-theme-scaramouche；源码与完整说明见 GitHub 仓库。