前言¶

DeepSeek Harness（DSH）桌面端冷启动时，宿主会先画一张「HARNESS / Loading plugins…」的加载卡片。若你希望在用户看到主界面之前，用一段与当前 profile 真实插件、工具数量呼应的片头过渡，而不是循环 GIF 或预录视频，社区插件 dsh-for-agi-splash（维护者 Minksgo）提供了一套可选方案：SVG 逐帧绘制、中文旁白与合成音效，并可跳过、可配置。下面介绍它做什么、怎么装、怎么用。

这是什么¶

dsh-for-agi-splash 是 DSH 的冷启动片头插件，在 SkillHub 目录中归类为「趣味换装」。它把 DSH 启动过程拆成多幕画面（插件装载、运行时连接、工具接入、上下文装配、智能体就位等），HUD 会渲染当前机器上该 profile 的 bundle 数与工具数，音轨为逐样本合成的全片音效加中文旁白；不是外挂网络视频，三条音轨以 data URI 内联在客户端 bundle 中（README 注明 bundle 约 3.4 MB）。

插件通过 Cordis patch 接入宿主，在 Web 与 Desktop 载体上均依赖 webserver/index-inject；许可为 MIT（npm 包名 dsh-for-agi-splash，当前资料中版本 0.4.0）。

三套片头与默认行为¶

README 说明共有三套时长不同的片头：

默认策略（安装说明原文）：装完或升级后第一次启动播 30 秒剧场版，之后每次启动播 9.9 秒精简版。若希望每次启动都播 120 秒电影版，可在 设置 → 开屏动画 → 播放模式 中选择「每次电影版」。播完后自动淡出；任意点击或按 Esc 可随时跳过。

在 prefers-reduced-motion 下，插件会自动走精简版、静音并缩短到约 1.2 秒。

核心能力（已文档说明部分）¶

1. 与宿主启动时序对齐：宿主半通过 index-inject 在 <head> 解析阶段刷成片头底色，避免露出默认加载卡；客户端半在模块求值时挂载 shadow root 舞台，禁用插件时通过清理回调卸掉 overlay。
2. 本机设置页：注册 settings.section（id agi-splash），提供总开关、播放模式、音量、跳过提示语、独立预览与重新播放。
3. 预览与定格：不重启即可重播；URL 加 ?t=秒数 可冻结在某一秒查看画面细节。
4. 关闭方式：设置总开关、URL 参数 ?agi=0、localStorage、或在插件列表关闭本插件（详见下文）。

安装与启用¶

桌面版可在 设置 → 插件 中安装，或使用官方命令行（须重启客户端后生效）：

npx @deepseek-ai/dsh plugin --profile desktop add dsh-for-agi-splash

从 GitHub 仓库安装：

npx @deepseek-ai/dsh plugin --profile desktop add github:Minksgo/dsh-for-agi-splash

npm 页面：https://www.npmjs.com/package/dsh-for-agi-splash。

兼容性（README）：DSH >= 0.2.0-rc.1；无外部依赖，片头播放过程无网络请求。Node 构建环境要求 >=20（仅在你从源码改画面/音轨并执行构建脚本时需要）。

典型用法¶

设置 → 开屏动画¶

装好并重启后，在 设置 → 开屏动画 中可配置：

配置保存在渲染进程 localStorage，键前缀 dsh-for-agi-splash:（enabled / volume / hint / mode / version），仅本机生效，不写进 profile。

预览地址¶

在客户端已加载插件的前提下，可直接访问：

• 精简版：/dsh-for-agi-splash/preview
• 剧场版：/dsh-for-agi-splash/preview/30
• 电影版：/dsh-for-agi-splash/preview/120

临时或永久关闭¶

旧键 dsh-for-agi-splash:off 值为 1 时仍视为关闭。

适用场景与注意¶

适合谁：希望在 DSH Desktop（或兼容的 Web 载体）冷启动时增加品牌化、与真实插件/工具状态一致的片头体验，且能接受约 3.4 MB 客户端 bundle 体积的开发者或团队。

安装前请自行核对：

• 插件以当前 DSH 进程权限运行，并申请 web:index-inject、dom:overlay、browser:local-storage 等能力（见 package 元数据）；安装前应阅读 GitHub 仓库 源码与 MIT 许可证。
• SkillHub 目录（https://www.skillhub.cn/plugins/Minksgo/dsh-for-agi-splash）为社区收录站点，与 DeepSeek / 幻方无官方从属关系；星标等元数据以各站点当时展示为准。
• 宿主未提供 React 时可能缺少设置页 slot，README 说明片头仍可播放。

若你 Fork 后修改旁白或画面，仓库提供 scripts/build-audio-30.mjs、build-audio-120.mjs 与 scripts/build.mjs 用于重新生成音轨与 lib/client.js、预览页；属二次开发路径，按需查阅 README。

结尾¶

dsh-for-agi-splash 把 DSH 冷启动做成可配置的三套 SVG 片头，默认在升级后首次用剧场版、日常用 9.9 秒精简版，并支持跳过、预览与本机音量/文案调节。进一步了解与安装：

• 目录页：https://www.skillhub.cn/plugins/Minksgo/dsh-for-agi-splash
• GitHub：https://github.com/Minksgo/dsh-for-agi-splash