前言¶
DeepSeek Harness（DSH）桌面版启动时会先出现自带画面：HARNESS、转圈、Loading plugins。不少挂在客户端槽位上的开屏插件，README 里会直接说明压不住这张默认页，动画前仍会闪一下。Streamfish-lab 维护的 dsh-splash-fish 面向「每次打开 Harness 想先看一张插画、再进工作区」的场景：用 webserver/index-inject 在 index 解析阶段铺封面，客户端侧在 shell.overlay 槽位播完即卸，并支持点击、按键或滚轮跳过。下面介绍它是什么、能做什么，以及桌面版与 Web/CLI 各自的安装方式。
这是什么¶
dsh-splash-fish 是纯客户端 DSH 插件（当前版本 0.3.0，MIT 许可证）。仓库：https://github.com/Streamfish-lab/dsh-splash-fish；社区目录页：https://www.skillhub.cn/plugins/Streamfish-lab/dsh-splash-fish。分类为趣味换装；GitHub 星标数为 3。
一句话定位：把一张插画做成 DSH 开屏——从黑场显影、人物带深度驱动的 2.5D 位移，淡出后进入工作区，并尽量压住 DSH 自带启动页。
核心功能¶
开屏时间线与交互¶
插件挂在 shell.overlay 槽位，每次页面加载只播一次，播完自行卸载。完整启动动画约 5.07 秒（Release 附件 splash-25d-preview.mp4）。等不及时可点屏幕、按任意键或滚一下滚轮，立刻进入收尾；该次点击会被消费，不会漏到下层界面。
与常见开屏做法的差异¶
- 压自带启动页：通过
lib/index.js向webserver/index-inject推送样式与脚本，在 index.html 解析阶段铺同色封面，早于客户端插件实例化；客户端挂载后再摘封面，并设约 3.5 秒的兜底。 - 头发位移为离线渲染：单张图里头发与脸共用像素，CSS 平移会连带脸部。仓库用深度图、发根到发梢权重、空间相位与湍流离线渲染 108 帧，编码为带 alpha 的 VP9 WebM（约 1MB）；运行时只播视频，无逐帧 canvas 计算。
- 播完不挡操作：动画层挂到
body下，z-index为 2147483600；.sf-root等使用pointer-events: none，播完清理残留，避免挡住界面。
换图（可选）¶
默认插画为他人作品。仅换静态开屏、不要发丝飘动：Windows 可将图片拖到 换自己的图.bat；Mac 使用：
python3 tools/make_from_image.py 我的图.jpg
脚本会居中裁成 16:9、缩到 1600×900 并重新打包；显影、光晕、光扫、粒子、淡出仍保留，头发飘动层会消失（该层针对默认图单独计算）。若要新图的 2.5D 飘动，需按 README 中 hair/tools/ 流程离线渲染（Python、torch、SAM2 权重等），README 估计约一小时量级，视机器而定。
已知限制（仓库原文）¶
- 皮肤与纯色背景区域位移肉眼几乎不可见。
- Windows 标题栏三个系统按钮网页无法盖住；README 建议 advanced 窗口模式以透明标题栏规避。
- 只播一次，重播需刷新页面。
- DSH 仍为 developer preview，
shell.overlay等接口可能变更。
安装与启用¶
插件以当前 DSH 进程权限运行；安装前应自行查看仓库源码与 MIT 许可证。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
桌面版（Windows / Mac）¶
不要对桌面 profile 使用 dsh plugin add——desktop 为 Electron 独占，CLI 会直接拒绝。README 强调：不要手改 profiles\desktop\package.json，应走应用内路径。
自己安装：
- 将仓库放到本地长期目录（若按 Agent 说明克隆，路径示例为
%USERPROFILE%\.dsh\bundles\dsh-splash-fish，目录需保留，插件为 link 引用）。 - 打开 设置 → 插件 → 添加插件，填写指向含
package.json一层的绝对路径。 - 彻底退出 DSH 再打开。
交给 Agent 时，README 给出一句即可：
帮我安装这个 DeepSeek Harness 插件：https://github.com/Streamfish-lab/dsh-splash-fish
Agent 会读仓库内 AGENTS.md 完成步骤。若卡住，可附带 README 中的克隆路径、界面添加插件、重启三项说明。
Web 版或已安装 dsh CLI¶
dsh plugin --profile web add /你的绝对路径/dsh-splash-fish
路径需指向仓库根目录（含 package.json）。
典型用法¶
免安装预览¶
仓库提供 preview.html，浏览器直接打开即可；加查询参数 ?t=2600 可冻在某一帧。Release 另有预览视频与上一版头发层对照视频链接，见 README。
构建与检查（维护者 / 改资源后）¶
python3 build.py
node --check client.js
package.json 中 scripts.build 为 python3 build.py，check 为 node --check client.js。client.js 为构建产物，图与视频内联其中，README 建议不要手改。
更新¶
插件不会自动更新。git 方式安装时在仓库目录 git pull 后彻底重启 DSH；压缩包安装则重新下载覆盖，解压时不要清空目标文件夹中的 assets\。若曾用「换自己的图」，更新可能覆盖 client.js 回到默认画面，需重新拖图或跑 make_from_image.py。新版本见 GitHub Releases。
结尾¶
dsh-splash-fish 把 DSH 开屏从「默认 HARNESS 页 + 简单 overlay」做成可定制的显影与 2.5D 视频层，并在注入时机与层级上针对闪屏、缩放同步、资源内联等坑做了说明。适合愿意本地 link 插件、接受 MIT 条款、且使用桌面或 Web profile 的 Harness 用户。
