前言¶

DeepSeek Harness（DSH）启动时，默认界面往往直接进入工作区，缺少可配置的「开屏」体验。若你希望每次打开 DSH 有一段固定节奏的欢迎动画，又能换成自己的视频或社区作品，而不改 Host 源码，社区插件 dsh-awakening（鲸启）就是面向这一需求的方案：内置约 22 秒的鲸鱼主题「鲸启」，并提供导入、社区库与独立设置页。

这是什么¶

鲸启 · DSH Awakening 由维护者 MingoYung 发布，在 SkillHub 分类为「趣味换装」。它是社区兼容插件，不表示 DeepSeek 或幻方官方发布或背书。

插件在 DSH 启动流程中接管一段开机动画：默认作品包含文字组装、材质聚散、星点归流、连接光带及原声欢迎语，总长约 22 秒。也可导入本机 MP4 / WebM，或从插件内社区动画库下载其他创作者作品，在 设置 → 鲸启启动动画 中预览、选用。当前正式版为 v0.6.1，含动画切换、本地导入、社区库与三页设置界面。

素材方面：前段动效、排版、程序音效和播放器由本项目制作；约 13.6 秒起的角色影像及原声欢迎语引用自 lxj5820/dsh-boot-animation 的 assets/videos/1.mp4，完整来源见仓库 CREDITS.md。

核心功能¶

内置鲸启与窗口适配¶

内置鲸启根据窗口客户区宽高连续计算构图（自 v0.4.0 起），不依赖一组固定比例视频。拉动窗口、最大化或全屏不会重播或切换音轨。竖屏与横屏在光带与人物取景上各有对应布局；渲染失败时会回退到原视频，不阻塞 DSH。

更换动画与社区库¶

设置入口：设置 → 鲸启启动动画，分为「当前动画」「动画库」「播放设置」，颜色与字体跟随 DSH 主题。

1. 当前动画：展示正在使用的作品、预览与更换入口。
2. 动画库：封面卡片、分类搜索、作品详情；浏览、预览、下载、选用均在页内完成。社区目录来自 MingoYung/dsh-awakening-library，首次打开拉取目录，有缓存则先显示缓存；下载时核对声明大小与 SHA256。
3. 播放设置：声音、频率、取景；首屏工具与高级选项可折叠。

本地导入：在动画库点「导入动画」，选择 MP4 / WebM。视频需 1–45 秒、不超过 120 MiB；推荐 H.264/AAC MP4 或 VP9/Opus WebM。默认「仅供本机使用」，不会上传文件。普通视频可选「填满窗口」或「完整画面」；内置鲸启仍使用程序动态构图。

用户作品目录：DSH_HOME/awakening-library/（标准安装为 ~/.dsh/awakening-library/）。选择与显示方式由 DSH configForms 保存；插件更新不会覆盖用户视频。

播放与跳过¶

支持完整预览、Esc 与点击跳过。「重置播放设置」会切回内置鲸启并保留动画库中的导入项。

可选：从最早首屏播放¶

自 v0.5.0 起提供首屏兼容安装入口。普通插件在 Host 就绪后播放；安装兼容层后，同一播放器可从桌面初始页开始，动画与后台加载并行。目前仅支持已核验的 Windows DSH NEXT 2.0.19-next 特定构建。路径：播放设置 → 首屏播放，按页内检测结果选择「安装并重启」或恢复默认。兼容层会修改本机 DSH 的 resources/app.asar，原包备份于同目录 .dsh-awakening-backup/app.asar；DSH 升级后需重新检查支持情况。从 v0.5.0 或 v0.6.0 升到 v0.6.1 后，已装首屏层需在设置中「更新并重启」一次。

验证目标环境包括 Windows DSH NEXT 2.0.19-next / DSH 内核 0.2.1-rc.2；Stable 与 NEXT 的窗口创建顺序见仓库 COMPATIBILITY.md。

安装与启用¶

可下载预构建 安装包，解压后使用 DSH 原生插件管理器添加目录绝对路径，或在 DSH 终端执行：

dsh plugin add /absolute/path/to/dsh-awakening

首次安装后重启 DSH。仓库与 .tgz 已含客户端构建结果及媒体，正常安装无需执行 npm run build。插件未发布至 npm，请勿从同名 npm 包推断来源。

package.json 要求 Node >=22.12.0、DSH >=0.2.1-rc.2，peer 依赖 @deepseek-ai/schemastery ^3.18.5。

典型用法¶

1. 安装插件并重启 DSH，保持默认即可在下次启动看到内置鲸启。
2. 打开 DSH 设置 → 鲸启启动动画，在「动画库」预览社区作品，点「下载并使用」或「导入并使用」切换开屏。
3. 点「导入动画」上传本机短视频，填写名称与可选作者，选用后下次启动生效。
4. 若使用 Windows DSH NEXT 受支持构建且希望动画从最早加载页开始，在 播放设置 → 首屏播放 完成检测后按引导安装兼容层（安装前保存工作）。

包内 preview.html 可用同一播放器做独立预览，不代表已在实机 DSH 启动流程中验证。

适用场景与注意¶

适合希望在 DSH 启动阶段增加可更换、可静音、可跳过的开屏体验的用户，以及愿意维护本地动画库或向 dsh-awakening-library 投稿的创作者。

安装前应阅读 GitHub 源码、LICENSE 与 CREDITS.md。插件在 DSH 进程权限下运行，首屏兼容会改写本机 app.asar，仅在明确确认后操作。社区目录 SkillHub 与 GitHub 均为社区生态，与 DeepSeek / 幻方无官方从属关系。

插件原创代码为 MIT；第三方图形、影像与原声按各自许可分发。

链接¶

• SkillHub 目录页：https://www.skillhub.cn/plugins/MingoYung/dsh-awakening
• 项目仓库：https://github.com/MingoYung/dsh-awakening
• 当前正式版：https://github.com/MingoYung/dsh-awakening/releases/tag/v0.6.1