前言¶
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。
