前言¶

DeepSeek Harness（DSH）桌面版啓動後通常直接進入對話界面。若希望在首屏做一段可控的「開機儀式」——星塵、角色名、狀態卡、接入確認，再溶解進主界面——需要自己改前端或寫 bundle，成本和維護都不低。維護者 2524034412-boop 在 GitHub 倉庫 2524034412-boop/DSH 中提供了插件 dsh-star-boot（README 中亦稱「星圖開機」）：在 DSH 啓動時插入一整屏片頭，素材、配色、字體與位置可在設置或同源控制頁中調整。社區目錄 SkillHub 上的 DSH 條目 將其歸類爲「趣味換裝」。下文介紹其能力、安裝方式與典型改法；事實以倉庫 README 與 package.json 爲準。

這是什麼¶

dsh-star-boot 是 DSH 的 client bundle 插件：在 Harness 啓動時播放整屏片頭（星塵 → 名字 → 狀態卡 → 接入確認 → 兩段式溶解進對話界面），Esc 或點擊可隨時跳過。代碼許可證爲 MIT；隨包視頻與圖片素材另有說明，見倉庫 NOTICE-assets.md。

引擎要求（來自 package.json）：Node ≥ 20，DSH >=0.2.0-rc.1，可選 peer react ^18.2.0。當前資料中插件版本爲 1.8.0。

片頭節奏與交互¶

README 給出的時間線如下（節奏可在設置裏用「快 / 標準 / 慢」縮放等待，不改變交互邏輯）：

0.0s  黑場 + 星點浮現
0.5s  細線 + 眉標
0.8s  名字逐字點亮
1.0s  素材從 1.07 縮放到 1、浮起
1.2s  打字機一句 + 狀態卡（記憶 / 心情 / 壓力 / 最在意）
2.6s  過曝一閃 → 接入確認四條逐條點亮（01 身份 … 04 通道）
      停住等人：點擊或 Enter 進入（2.6 秒沒人動就自己進）
      素材跟播開着時，視頻播完才進場（最多 15 秒）
      → 兩段式溶解：內容先淡、背景後淡

「素材跟播」最長等待 15 秒；更長視頻會被切斷。瀏覽器自動播放策略可能導致音效不響，插件會安靜失敗、不報錯。

核心功能¶

模式與外觀¶

默認隨包背景爲 assets/default-bg.mp4，壓暗 85、遮罩 60、面板左下、玻璃字、跟播開；無自定義視頻時可用 assets/hero.webp 兜底。

素材與配置遷移¶

在「素材」組選擇或拖拽本機圖片/視頻後，插件會拷貝到 <DSH 數據目錄>\star-boot-assets 並使用該副本；舊拷貝會自動清理。控制頁比設置頁多 導出配置 / 導入配置（JSON，可分享或當皮膚）。

宿主側能力（文件結構）¶

• lib/index.js：首幀遮蓋、狀態卡代理、素材雙槽與上傳、同源控制頁
• lib/client.js：動畫、授權頁、外觀變量、設置頁
• 設置內或 http://127.0.0.1:<DSH 端口>/dsh-star-boot/panel 可改配置；設置 → 左側「星圖開機」分組爲開關 / 外觀 / 文案 / 素材

設置 → 星圖開機 → 開場底部提供 檢查更新 與 一鍵更新（下載 Release zip、校驗、備份舊目錄爲 dsh-star-boot.bak-<舊版本>）；更新後須重啓 DSH，宿主代碼僅在啓動時加載。

安裝與啓用¶

安裝前：README 寫明 Windows 有專用腳本；macOS / Linux 需按「手動安裝」三步操作。須已安裝 DSH 桌面版並至少啓動過一次（Windows 下 %USERPROFILE%\.dsh 須存在）。裝錯可能導致 DSH 下次無法打開窗口，建議先備份 profile 的 package.json（官方腳本也會自動備份）。

方式一：Release zip（README 推薦）¶

1. 到 GitHub Releases 下載 dsh-star-boot-<版本>.zip
2. 解壓後雙擊 安裝.cmd
3. 重啓 DSH

腳本會定位 DSH 數據目錄、拷貝到 plugins\dsh-star-boot、修改 profile package.json 的 dependency 與 bundle、建立 node_modules 鏈接並做孤兒校驗；失敗會回滾。

方式二：克隆後執行 install.ps1¶

git clone https://github.com/<你>/dsh-star-boot.git
cd dsh-star-boot
powershell -ExecutionPolicy Bypass -File install.ps1

（倉庫 README 示例佔位爲 <你>/dsh-star-boot；本插件源碼在 2524034412-boop/DSH，克隆時請以實際倉庫 URL 爲準。）

方式三：手動（含 macOS / Linux）¶

1. 將整個插件目錄放到 <DSH 數據目錄>\plugins\dsh-star-boot（非 Windows 路徑規則以本機 DSH 數據目錄爲準）
2. 編輯 <DSH 數據目錄>\profiles\<profile>\package.json，增加：

{ "dependencies": { "dsh-star-boot": "link:../../../plugins/dsh-star-boot" },
  "dsh": { "profile": { "bundles": ["dsh-star-boot"] } } }

3. 在 profile 的 node_modules 中建立指向插件目錄的 junction 或 symlink
4. 重啓 DSH

卸載可運行倉庫中的 卸載.cmd / uninstall.ps1（-Purge 可連同目錄刪除）。資料中未提供 dsh plugin add github:... 一類命令，請勿憑插件名拼接。

典型用法¶

1. 按上文任選一種方式安裝並完整重啓 DSH（僅刷新頁面不夠，宿主 bundle 只在啓動時加載）。
2. 打開 設置 → 星圖開機，將模式設爲「簡潔」或「狀態卡」；需要完整接入確認頁時保持授權頁開關打開。
3. 在「素材」中 選擇文件… 或向控制頁拖入文件，替換背景；留空則恢復隨包素材。
4. 調整配色、字體、面板位置與 7 條文案；滿意後在控制頁 導出配置 留檔。
5. 若片頭被跳過：檢查模式是否爲「關閉」、地址欄是否帶 ?star=0；若系統開啓「減少動畫」，1.7.2 起仍會停約 2 秒再繼續。

背景 mp4 不播時：宿主需支持 Range（README 稱 1.4.2 起已實現）；可暫時關閉「素材跟播」按固定節奏播放。

適用場景與注意¶

適合：希望在 DSH 啓動時統一展示角色名、狀態卡與接入確認、並願意通過 GUI 換皮的用戶；分類上偏「趣味換裝」與個性化首屏，而非對話能力擴展。

注意：

• 插件以當前 DSH 進程權限運行，安裝前應閱讀 lib/index.js、lib/client.js 與 LICENSE，並理解其對 profile package.json 的修改。
• 安裝腳本主要面向 Windows；其他系統依賴手動三步。
• 素材版權與 MIT 代碼分離，商用或再分發隨包素材需遵守 NOTICE-assets.md。
• 修改外觀與素材後刷新頁面即可；僅當宿主代碼變更時才需重啓 DSH。

結尾¶

dsh-star-boot 把 DSH 啓動首屏做成可配置的片頭流程，安裝以 Release zip + 安裝.cmd 或手動聲明 bundle 爲主，日常改外觀走設置或 /dsh-star-boot/panel。目錄頁：https://www.skillhub.cn/plugins/2524034412-boop/DSH；源碼與說明：https://github.com/2524034412-boop/DSH。