前言¶
DeepSeek Harness（DSH）的 Web 界面默认是常规主题与静态背景。若你同时关心「每次打开页面时的仪式感」和「会话期间背景仍保持动效」，通常需要分别安装 boot-animation、wallpaper 等插件，层叠关系也要自己留意。dsh-cinematic-wallpaper 由社区维护者 zus12873 发布，在 SkillHub 分类为「趣味换装」，把约 7 秒的电影感开场、0.9 秒过渡到 DSH UI、以及会话壁纸合并为同一套 Web 插件；并在半透明界面上根据壁纸实际像素重算文字与图标颜色，避免背景变亮后正文发灰、对比度不够。
这是什么¶
dsh-cinematic-wallpaper 是面向 DSH Web profile 的客户端插件（package 版本 0.2.0，MIT 许可证）。每次加载页面时，默认会先播放 DeepSeek 角色苏醒的开场动画，随后场景留在 UI 后方作为会话壁纸；Composer 等表面在浅色主题约 28%、深色主题约 30% 不透明度，壁纸不被雾面遮罩盖住。插件以当前 dsh 进程权限运行，安装前建议在 GitHub 阅读源码与许可证。
- 目录页：https://www.skillhub.cn/plugins/zus12873/dsh-cinematic-wallpaper
- 仓库：https://github.com/zus12873/dsh-cinematic-wallpaper
核心功能¶
开场（约 7 秒）¶
前 2.7 秒播放线稿段落（光带、线框、面部扫描），来自已逐帧去掉内嵌 HUD 的片段；之后由代码驱动睁眼、虹膜泛绿、镜头推进。Logo、字标、状态列表、终端、角标等 HUD 由代码绘制。点击或按任意键（含 IME 输入）可跳过；开场期间按键不会进入 Composer。
交接（约 0.9 秒）¶
左侧 HUD 淡出，DSH 界面淡入。
会话壁纸¶
角色留在 UI 后方，保留右侧角标。默认在静态底图上叠加 AI 生成的 idle 循环：头发以半速正放再倒放，约 24 秒一周期。有循环时 canvas 最高约 30 fps，无循环时约 10 fps。
半透明 UI 与自适应文字色¶
两种主题下壁纸均无额外雾层。可见文字、图标、占位符会根据其下方「壁纸 + 半透明 UI 合成结果」选取对比更好的浅/深字色，并加轻微光晕；不透明区域上的文字仍用 DSH 原色，彩色文字保留色相仅加光晕。窗口缩放、主题切换、UI 变化、滚动时会重算；循环播放期间约每秒重算一次。
降级与兼容¶
系统开启「减少动态效果」时跳过开场，壁纸为静帧。隐藏标签页会暂停动画。DeepSeek 资源加载等待 4 秒；超时则 DeepSeek 开场与 DeepSeek 壁纸层自行移除，DSH 按原样工作；自定义开场/背景不依赖这些资源仍可显示。片段缺失则去掉线稿段；循环缺失则壁纸为静帧。
与 boot-animation、wallpaper 类插件职责重叠，同时安装会叠层；使用本插件时建议卸掉同类插件。
安装与启用¶
要求 DSH >= 0.1.5-rc.1 且使用 web profile。官方推荐从 release 包安装（含预构建与两段视频）：
dsh plugin --profile web add https://github.com/zus12873/dsh-cinematic-wallpaper/releases/latest/download/dsh-cinematic-wallpaper.tgz
dsh web
安装或更新后需重启 dsh web。确认 host 半部已挂载：
curl http://127.0.0.1:3080/dsh-cinematic-wallpaper/health
卸载：
dsh plugin --profile web remove dsh-cinematic-wallpaper
典型用法：更换开场与背景¶
DeepSeek 开场与壁纸为默认。可将二者替换为自有媒体，或关闭自定义开场。
- 将文件放入
~/.dsh/dsh-cinematic-wallpaper/media/（首次在设置页读取时创建）。支持视频.mp4、.m4v、.webm（可作开场或背景）；图片.jpg、.jpeg、.png、.webp（仅背景）。只识别该目录下的普通文件，不含符号链接与子目录。 - 若改用其他目录，在 host 插件选项中设置
mediaDir为绝对路径或~/…；相对路径会被忽略并告警，仍用默认目录。 - 打开 Settings → Plugins → Intro & background，在 Intro 与 Background 下各选一张卡片；添加文件后点 Refresh。
背景切换立即生效并 crossfade；新开场在下次打开 DSH 时生效。自选媒体静音播放，cover-fit 居中，宽高比不一致时边缘裁剪。所选文件丢失或无法播放时，开场跳过、背景回退 DeepSeek 默认，标签页会标 File missing。
DSH 版本注意： 需 settings 服务允许插件注册自有 namespace（README 写明在 DSH 0.1.5-rc.2 验证）。DSH 0.1.7 及更高版本可能不支持，此时设置页无法保存并锁定卡片，插件保持 DeepSeek 默认；其他原因保存失败会显示 “Couldn’t save” 并恢复已存选项。
适用场景与注意¶
适合希望在 DSH Web 端统一开场与会话背景、并愿意接受半透明 Composer 与动态取色行为的开发者。不适合需要完全 opaque 传统界面、或依赖旧版 settings 命名空间且已升级到 0.1.7+ 却无法改设置的环境。
插件与 DSH 同属「一切皆插件」的社区生态；SkillHub 目录为独立站点，与 DeepSeek / 幻方无官方从属关系。星标与版本以仓库与 release 为准，本文不列举未在资料中出现的用户案例或反馈。
结尾¶
dsh-cinematic-wallpaper 把电影感开场、会话循环壁纸和自适应字色收进一个 Web 插件，安装命令以 release .tgz 为准。进一步说明见仓库 README（含 HUD 布局表 src/client/layout.ts、本地 npm run dev 等开发细节）。
- SkillHub：https://www.skillhub.cn/plugins/zus12873/dsh-cinematic-wallpaper
- GitHub：https://github.com/zus12873/dsh-cinematic-wallpaper
