前言¶
DeepSeek Harness（DSH）每次冷启动时，界面往往是直接出现在眼前，缺少一段可预期的「进入」过程。若你已经在系统里放了壁纸或定帧图，更希望启动瞬间能和当前桌面视觉衔接，而不是黑屏一切就完。
下面介绍社区插件 dsh-startup-blade（维护者 2154036609-ux）：在 Web profile 下播放约 2.6 秒的拔刀过场，刀光划开黑幕后界面定格在你当前壁纸的那一帧；播完自动退场，不常驻、不额外占 CPU。插件不随包附带任何壁纸素材，运行时无第三方依赖。分类上落在 DSH 社区目录的「趣味换装」。
这是什么¶
dsh-startup-blade 是纯装饰型 DSH 客户端插件：通过 cordis.patch.yml 注入浏览器端逻辑，在应用启动时覆盖一层启动动画，结束后露出真实界面。默认是程序生成的刀光版；你也可以用本地视频、定帧图或分层素材换成自己的演出。
动画分镜（默认刀光版）¶
README 中给出了时间轴，便于你对照效果或调 speed：
| 时间 | 画面 |
|---|---|
| 0.00–0.20s | 黑幕落下，右缘一点刀鞘冷光 |
| 0.18–0.78s | 拔刀：刀身挥出，屏震，刀锋把黑幕真正「划开」，切口里是真实界面 |
| 0.78–1.10s | 白闪 + 残心长线过刀痕 |
| 1.10–1.40s | 黑幕整体消解，火星受重力沉降 |
| 2.40s 起 | 定格：默认停在真实界面上（壁纸此时已渲染）；若放了自定帧则停在图中 hold 毫秒再淡出 |
同一会话内刷新页面不重复播放（sessionStorage 记账）。enabled: false 时完全不播。点一下 / 或按任意键可跳过后半段。
安装与启用¶
插件面向 DSH 桌面版 / Web profile（platform: web）。官方 README 给出的安装方式如下。
从 DSH 插件源安装：
dsh plugin --profile web add dsh-startup-blade
装完后需要重启 DeepSeek Harness（客户端插件在启动时加载，仅刷新页面不够）。
从 GitHub 安装：
dsh plugin --profile web add github:2154036609-ux/dsh-startup-blade
卸载：
dsh plugin --profile web remove dsh-startup-blade
%DSH_HOME%\startup-blade\ 下的自定素材不会被自动删除，需自行保留或清理。
三种展示模式¶
mode 默认 auto，按优先级：片段 → 定帧图 → 刀光。也可强制 clip、freeze、reveal。
演示模式（默认）¶
刀光划开黑幕，露出的是你当下的界面与壁纸，结尾天然就是「现在这一帧」，不需要任何图片。
分层素材（进阶）¶
把一张壁纸拆成两层，可做「人物原地、刀身缓慢抽出」的 2.5D 启动动画。在 %DSH_HOME%\startup-blade\art\ 下放齐三件套：
%DSH_HOME%\startup-blade\art\
base.jpg 底图（刀身被压暗，看起来还插在鞘里）
blade.png 刀身层（透明底，发光的那一条）
meta.json 刀轴端点：{ "width", "height", "ax", "ay", "bx", "by" }（归一化坐标，a=刀尖、b=刀柄）
mode 为 auto 时会自动优先使用。素材需自行拆解（加图 + 定刀轴）；作者未随包发布个人壁纸，避免版权问题。
片段模式¶
若要让壁纸里角色真的拔刀，README 建议把 3–5 秒画面录成片段，放到：
%DSH_HOME%\startup-blade\splash.mp4（也接受splash.webm）
行为：整段播完 → 停在最后一帧 hold 毫秒（定格）→ 淡出露出真实界面；播放中点击/按键立即跳过；解码失败自动退回刀光版，不会留下黑屏。建议 1920×1080、H.264、无音轨、约 5 秒内，画面勿带 UI 叠层。
定帧模式¶
想「完全定格成一张画」：
- 截一张你壁纸的画面（建议 1920×1080 以上，PNG/JPG 均可）；
- 存成
%DSH_HOME%\startup-blade\frame.png（默认路径等同%USERPROFILE%\.dsh\startup-blade\frame.png，也接受frame.jpg/frame.jpeg/frame.webp）； - 刷新页面或重启；
mode: auto时有帧即走定帧。
仓库 assets/frame-sample.jpg 为占位样张，可复制试效果：
New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\startup-blade" | Out-Null
Copy-Item ".\assets\frame-sample.jpg" "$env:USERPROFILE\.dsh\startup-blade\frame.jpg"
说明：本插件不含任何壁纸美术资源；仓库 docs/preview.png 为自绘示意（程序生成的光带与暗色界面暗示），不是壁纸作品或他人界面截图。
配置¶
优先级：%DSH_HOME%\startup-blade\config.json > cordis.patch.yml 里本行的 config > 内置默认。
| 键 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关；false 时页面不播 |
speed |
1 |
播放倍率，0.5–2；2 ≈ 1.3 秒快速版 |
hold |
620 |
定格保持时长（ms），0–4000 |
accent |
#9fe8ff |
刀光主色（#rgb / #rrggbb） |
mode |
auto |
auto 依次优先 片段 → 定帧图 → 刀光；clip 只播片段；freeze 只定帧图；reveal 只刀光 |
改 config.json 后刷新页面即可（配置路由不缓存）；改 cordis.patch.yml 需重启。
临时关闭：
- 地址栏加
?nosplash（仅当次）； - 或控制台
localStorage.setItem('dsh-startup-blade:off','1')（直到删除该键）。
兼容性与可访问性¶
- 桌面走标机
dsh.bundle.patch+dsh.client；访客半边只依赖webServer服务。 - 无第三方运行时依赖、无构建步骤，装完即用。
- 尊重
prefers-reduced-motion：开启「减少动态效果」时退化为约 260ms 淡出。
适用场景与注意¶
适合：想在 DSH Web 端加一段短启动演出、又愿意自己准备定帧/片段/分层素材的开发者或桌面定制用户。
安装前请自行查看 GitHub 仓库 源码与 MIT 许可证；插件随 DSH 进程在本地 Web 环境运行，权限与当前 Harness 一致。DSH 社区目录（SkillHub 插件页）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-startup-blade 用一刀划开黑幕的方式，把冷启动和当前壁纸/visual 扣在一起；默认零素材即可用，进阶路径支持分层、视频与定帧。包版本 1.0.0，当前 GitHub 星标为 0。
