前言¶
DeepSeek Harness(DSH)在 web 或桌面端冷啓動時,默認往往只是一段很短的加載界面。對經常開閉 DSH 的開發者來說,這幾秒通常只能盯着空白或通用卡片。社區裏已有把啓動頁做成可交互序列的插件思路;dsh-umbrella-startup 在此基礎上,把視覺與文案統一成《生化危機》保護傘公司(Umbrella Corporation)風格的「企業檔案」訪問流程,並保留真聲臺詞與界面音效。下面介紹它是什麼、能做什麼,以及如何安裝與配置。
這是什麼¶
dsh-umbrella-startup 是 DSH 的啓動界面與開機動畫插件,維護者爲 Wang341223,在 SkillHub 插件目錄 中歸類爲「趣味換裝」。源碼託管於 GitHub,當前 package 版本爲 1.0.0,代碼許可爲 MIT。
插件不改動 DSH 核心邏輯,而是在 Host 側注入路由與頁面資源,在瀏覽器半側掛接設置頁「啓動動畫」入口。架構與運行邏輯移植自開源項目 6shenhonghong9/dsh-startup-screen(MIT),包名、路由 /dsh-umbrella、DOM 前綴 dub-、配置文件 dsh-umbrella.json 均獨立命名,可與原啓動屏插件並存。項目說明中明確:徽記與裝飾爲手寫 SVG/CSS,非官方素材;音頻來自第三方素材,未聲明商業授權,僅隨插件本地體驗分發。
核心功能¶
六幕連貫序列¶
冷啓動時播放固定流程,而非單純播片:
- 黑幕金屬傘徽
- 暗紅過曝
- 暗色「企業檔案」底板
- 五步訪問授權(其中前兩步可等待用戶操作)
- 紅藍 chromatic 故障揭幕
- 終幕
ACCESS GRANTED並進入主界面
中央有緩慢自轉的環形準星,缺口在正下方,不遮擋底部字幕。中文主標題配合英文等寬副標題逐字打出。
交互與安全兜底¶
- 第一、二幕會等待按鈕、
Enter或空格(可在設置中關閉requireInteraction)。 - 右上角
SKIP,Esc也可直接進入主界面(受allowSkip控制)。 - 瀏覽器需用戶手勢後才允許出聲;每一步停留時長取視覺基準與「實際音頻時長 + 240ms」的較大值,避免臺詞被點跳掐斷。
- 腳本未啓動 9 秒放行、時間線停滯 15 秒強制揭幕、音頻
onended缺失時按時長 +1.5 秒兜底,避免永久黑屏。 - Windows 桌面端播放期間可透明化
titleBarOverlay,揭幕或跳過後還原。
主題與設置¶
默認深色(黑底、暗紅徑向光、紅色電路與 CRT 掃描線);淺色「檔案白」可在 設置頁 → 啓動動畫 → 視覺 → 主題 切換,版式一致僅換底色與文字反相。主色保護傘紅 #d0021b,色散故障兩色可在配置中調整。
README 稱共有三十三項設置:身份名稱、編號、權限等級、配色、速度、音色、語速、文案等,可在 DSH 設置頁修改並即時生效。mode 三檔:session(每個瀏覽器會話一次)、daily(每天一次)、always(每次打開都播)。
六幕與音頻對應¶
| 幕 | 中文主字 | 英文副標題 | 交互 |
|---|---|---|---|
| 01 | 需要訪問許可 | ACCESS PERMISSION REQUIRED | 等待按鈕 / Enter |
| 02 | 身份資料確認 | IDENTITY VERIFICATION | 等待按鈕 / Enter |
| 03 | 接收訪問需求 | ACCESS REQUEST RECEIVED | 自動 |
| 04 | 開始讀取權限 | PERMISSION READ STARTED | 自動 |
| 05 | 讀取完畢 · 覈驗通過 | READ COMPLETE · VERIFIED | 自動 |
| 06 | 歡迎 <身份名稱> 訪問 |
ACCESS GRANTED | 自動 |
lib/assets/ 下 8 個 mp3 與參考項目逐字節一致,文案與素材一一對應,不宜隨意改主字以免聲畫不同步。
安裝與啓用¶
前置條件:Node.js ≥ 20,DSH 已安裝。插件零運行時依賴,安裝前不必在插件目錄執行 npm install。
先在插件源碼目錄打包,再按 profile 安裝(命令來自項目 README):
# 1) 在插件目錄打包
npm pack
# → dsh-umbrella-startup-1.0.0.tgz
# 2) web profile
dsh plugin --profile web add ./dsh-umbrella-startup-1.0.0.tgz
# 3) 重啓 dsh web(關掉啓動器窗口再重新打開)
桌面端(DeepSeek Harness Desktop)須完全退出(含托盤圖標)後執行:
dsh plugin --profile desktop add ./dsh-umbrella-startup-1.0.0.tgz
Windows 也可解壓 tgz 後雙擊 安裝.cmd,腳本會識別 web / desktop 兩個 profile。更細的驗證步驟見倉庫內 INSTALL.md;桌面標題欄行爲見 DESKTOP.md。
典型用法¶
配置文件¶
默認路徑爲 $DSH_HOME/dsh-umbrella.json(一般爲 ~/.dsh/dsh-umbrella.json),也可僅在設置頁修改:
{
"enabled": true,
"mode": "session",
"theme": "dark",
"speed": 1,
"requireInteraction": true,
"allowSkip": true,
"identity": "DR. M. HARTLEY",
"identityId": "0087",
"accessLevel": "3",
"accent": "#d0021b",
"glitchA": "#d0021b",
"glitchB": "#1b4f9c"
}
日常可把 mode 設爲 daily,避免每次會話都播完整六幕;需要演示時再改爲 always。
離線預覽¶
不依賴 DSH 時,可在倉庫根目錄用腳本打開預覽頁,或直接打開內聯單文件 preview/standalone.html 給他人看效果:
# macOS / Linux
./open-preview.sh
Windows 使用 打開預覽.cmd。
冒煙測試(維護者)¶
node test/smoke-host.mjs
node test/smoke-splash.mjs
node test/smoke-client.mjs
node test/smoke-desktop-boot.mjs
適用場景與注意¶
適合誰:希望在 DSH 冷啓動那幾秒看到完整主題體驗、且接受生化危機保護傘同人視覺與內置臺詞的用戶。若只追求最快進主界面,DSH 自帶加載卡片已足夠;本插件的價值在於「本來就要等的幾秒,換成有結構的交互與音效」。
權限與安全:DSH 插件以當前 dsh 進程權限運行。安裝前應自行閱讀 GitHub 倉庫 源碼、LICENSE 與 NOTICE.md,確認接受 MIT 代碼許可及音頻、商標免責聲明。SkillHub 等爲社區目錄,與 DeepSeek / 幻方無官方從屬關係。
並存:與 dsh-startup-screen 可同時安裝,配置與樣式不會互相覆蓋;實際啓用哪一套取決於各自 enabled 與 DSH 插件加載順序,安裝後應在目標 profile 上實測一次。
結尾¶
dsh-umbrella-startup 把 DSH 啓動頁做成可跳過、可配置的六幕保護傘主題序列,web 與 Desktop 共用同一套 Host/client 與 dsh-umbrella.json。目錄頁:https://www.skillhub.cn/plugins/Wang341223/dsh-umbrella-startup;源碼與安裝說明:https://github.com/Wang341223/dsh-umbrella-startup。