角色苏醒壁纸 zus12873/dsh-cinematic-wallpaper

dsh-cinematic-wallpaper

DeepSeek Harness（DSH）网页插件。每次打开页面，先播放一段 7 秒的角色苏醒片头；随后画面退到 DSH 界面后面，变成会话期间的动态壁纸，界面文字的颜色会随身后的画面自动调整。

会话壁纸

片头：光丝、线框、面部扫描、闭眼、睁眼

功能

- 片头（7 秒）：
- 前 2.7 秒直接播放原片的描线段：光丝、线框、面部扫描。这一段裁出人物所在区域，原片里烤进去的 HUD 已逐帧擦掉。
- 之后由代码驱动：睁眼、虹膜绿光、镜头推进。
- HUD 全部由代码绘制，包括 logo、字标、状态列表、终端和四角角标。
- 点一下或按任意键（包括输入法输入）可以跳过。片头期间的按键不会进入输入框。
- 交接（0.9 秒）：左侧 HUD 淡出，DSH 界面淡入。
- 会话壁纸：
- 人物留在界面后面，右侧保留角标。
- 人物上叠一段 AI 生成的待机循环：头发轻轻飘动，半速播放，正放接倒放，一个循环约 24 秒。
- 播放循环时画布最多每秒重绘 30 帧，没有循环时每秒 10 帧。
- 半透明界面：两种主题下都不加雾，壁纸完整透出。DSH 的界面表面跟随主题做成半透明，输入框尤其通透：浅色主题 28% 不透明，深色主题 30%。
- 字色自适应：
- 每段可见的文字（以及图标、输入框占位文字）都会取它身后的壁纸，叠上界面各层的半透明底色，算出实际背景。在浅字和深字里选对比度更高的那个，再加一层淡光晕。
- 不透明底色上的文字沿用 DSH 原本的颜色；本身有颜色的文字保留颜色，只加光晕。
- 窗口缩放、主题切换、界面变化、滚动时重新计算，播放循环期间每秒重算一次。
- 克制的默认行为：
- 系统开启"减少动态效果"时，跳过片头，壁纸为静态画面。
- 标签页隐藏时全部暂停。
- 资源 4 秒内没有加载完时，图层自行撤掉，DSH 照常使用。
- 缺少片段时只少描线段；缺少循环时壁纸为静态画面。

安装

需要 DSH >= 0.1.5-rc.1 的 web 配置。

从 Release 安装包安装（预构建，包含两段视频）：

dsh plugin --profile web add https://github.com/zus12873/dsh-cinematic-wallpaper/releases/latest/download/dsh-cinematic-wallpaper.tgz
dsh web

安装或更新后重启 dsh web。确认宿主半已挂载：

curl http://127.0.0.1:3080/dsh-cinematic-wallpaper/health

卸载：

dsh plugin --profile web remove dsh-cinematic-wallpaper

本插件与开机动画类、壁纸类插件作用重叠，同时启用会叠在一起。使用本插件时请先移除它们。

从源码构建

git clone https://github.com/zus12873/dsh-cinematic-wallpaper.git
cd dsh-cinematic-wallpaper
npm ci
npm run build
dsh plugin --profile web add link:"$PWD"

两段视频（assets/clip.mp4、assets/loop.mp4）不在 Git 里。没有它们插件照样能运行，只是没有描线段和待机循环。需要的话，从 Release 安装包里取出：

curl -L -o /tmp/dcw.tgz https://github.com/zus12873/dsh-cinematic-wallpaper/releases/latest/download/dsh-cinematic-wallpaper.tgz
tar -xzf /tmp/dcw.tgz -C assets --strip-components=2 package/assets/clip.mp4 package/assets/loop.mp4

调整 HUD 布局

所有 HUD 元素都是 src/client/layout.ts 里 LAYOUT 表的一行：

- anchor：锚定的窗口角，tl / tr / bl / br；
- x / y：设计坐标，基于 1920×1080；
- scale（可选）：在所属组的缩放之上再乘的系数；
- intro / hold：片头阶段、壁纸阶段各自是否显示；
- holdAt（可选）：壁纸阶段单独的 { anchor, x, y, scale }，交接时平滑移过去。

改完执行 npm run build，再重启 dsh web。

开发

npm run dev # http://127.0.0.1:5181

- /?mode=play&t=3.0：拖时间轴或播放片头。
- /?mode=compare&t=3.0：代码画面和原片左右并排对照。
- /?mode=mock：把真实运行时跑在一个模拟的 DSH 界面上，检查交接、主题变量、按键。

play 和 compare 叠加的原片来自 .cache/reference.mp4，由 authoring.measure --proxy 从原片生成。

重新生成资源

authoring/ 下的流水线（Python，用 uv 运行）做两件事：

- 把原片做成底图、闭眼补丁、manifest 和描线片段；
- 把 AI 生成的待机视频做成循环。

authoring/regions.py 里手工测量的值只适用于那一段原片，而原片和待机视频都不随仓库分发。所以只有拿着同样的素材时，这套流水线才用得上：

uv run --group authoring python -m authoring.build_assets --video <原片.mp4> --out assets --debug .cache/debug
uv run --group authoring python -m authoring.build_loop --source <待机视频.mp4> --out assets
uv run --group authoring python -m authoring.fonts --out assets/fonts

build_loop 的处理步骤：

1. 把待机视频的首帧和静帧做匹配，求出它覆盖的区域；
2. 把色调调回静帧的色调；
3. 正放接倒放，用运动补偿插帧放慢到半速；
4. 把左侧渐变在不压到头发的前提下最宽能有多宽，记进 manifest。

测试

npm test && npm run typecheck
INTRO_FILM=<原片.mp4> IDLE_CLIP=<待机视频.mp4> uv run --group authoring pytest authoring/tests -q

没设置这两个环境变量时，需要原片或待机视频的测试会自动跳过。

许可

MIT。assets/fonts/ 下的字体子集来自 Exo 2、Rajdhani 和 JetBrains Mono，使用 SIL Open Font License 1.1 许可（见 assets/fonts/OFL-*.txt）。

本插件是社区作品，与 DeepSeek 官方无关。"DeepSeek" 是其所有者的商标。