POI / The Machine 冷白啓動動畫插件:給 DeepSeek Harness 加一段可控的啓動演出

前言

DeepSeek Harness 的終端形象偏功能向:窗口打開就直接進入會話。想在啓動階段給使用者一段明確的“正在就緒”提示、而不是靠口頭約定,可以讓插件接管啓動畫面。toska1102/poi_theme-dsh-startup-screen 就是這個方向的實現,它在 DSH 啓動時播放一段仿《疑犯追蹤》The Machine 視覺風格的冷白終端動畫,並把播放頻率、總時長、音效、跳過行爲等全部做成可配置項。

下面介紹這個插件的來源、能力、安裝方式與設置項,並說明運行權限與素材授權方面需要注意的地方。

這是什麼

  • 插件名:poi-theme-dsh-startup-screen(倉庫名 poi_theme-dsh-startup-screen),版本 2.1.1。
  • 維護方:倉庫由 Toska1102 維護;項目核心基於 6shenhonghong9/dsh-startup-screen 二次開發,原作者爲沈宏宏,package.json 的 author 字段也保留爲沈宏宏。
  • 定位:macOS DeepSeek Harness 的啓動動畫插件。冷白終端、16 路攝像頭時間線、關鍵幀放大和雙實體鎖定組成十階段連續演出,默認約 9 秒。
  • 許可:MIT,沿用上游倉庫的許可證與版權聲明。

技術形態上,倉庫根目錄即完整插件,包含全部運行代碼、圖片、字體和可選人聲,不需要構建,也沒有額外運行依賴。入口在 lib/index.js,客戶端代碼在 lib/client.js;engines.node 要求 >=20。

核心功能

下面只列 README 中寫明的能力,未在資料中出現的行爲不在此說明。

1、十階段連續演出。冷白終端界面依次推進攝像頭時間線、關鍵幀放大、雙實體鎖定等階段,終幕顯示 DSH 標識。
2、一次確認即可放行。第 03 幀只需點擊一次 GRANT ACCESS,也可以按 Enter 或空格;之後自動播放到終幕。人工等待時間不計入默認約 9 秒的演出時長。終幕默認文案爲 what are your commands?,可在設置中修改。
3、播放頻率可控。默認在每次完全退出並重新啓動 DSH 時播放一次;刷新窗口、切換會話、打開設置都不會重複播放。也可以改成每天首次、僅手動預覽或完全關閉。
4、常用設置項:身份、播放頻率、6–15 秒總時長、終幕文案、人聲與短音效開關、各自音量、是否允許跳過。
5、高級設置項:各階段時長、鏡頭運動、掃描與鎖定速度、效果強度、減少動態效果策略。
6、總時長與階段時長聯動。調整總時長會按比例縮放各階段;調整某階段時長會自動更新總時長。每組設置都支持恢復默認,保存後可立即預覽。
7、跟隨系統減少動態效果。默認跟隨 macOS 的減少動態效果設置,並保持同樣的播放時長。
8、聲音行爲可預期。短音效默認開啓,人聲默認關閉。開啓人聲後,六段錄音按原速播放,對應階段會等待播放結束,實際時長可能超過 9 秒。允許跳過時,按 SKIP 或 Esc 會立即結束演出並停止聲音。
9、素材缺失時的降級。圖片或錄音加載失敗時省略對應素材,不會阻斷啓動。
10、加載兜底。自動啓動超過 1 秒仍無法顯示時直接放行;設置頁裏的主動預覽有獨立的加載窗口。

安裝與啓用

安裝方式不是命令行 dsh plugin add,而是在 DeepSeek Harness 的插件頁面通過 Git 鏈接添加。下面的地址來自 README 的安裝說明:

https://github.com/Toska1102/POI_theme-dsh-startup-screen

啓用插件名 poi-theme-dsh-startup-screen。如果同時安裝了原版啓動插件,需要先停用原版,避免兩個啓動流程互相干擾。按 DSH 的提示應用更改;需要重啓時,先把正在運行的任務結束掉再重啓。

典型用法

安裝啓用後,重新完全退出並啓動 DSH,默認會看到約 9 秒的冷白啓動演出:進入第 03 幀時點擊 GRANT ACCESS,之後自動播放至終幕。

設置入口在 DSH 設置頁的「POI 啓動動畫」。比如要做兩個常見調整:把總時長拉到 15 秒讓各階段更舒展,或者只保留每天首次啓動時播放,都可以在這裏完成;改完保存即可預覽。想臨時跳過演出,只需在允許跳過的前提下按 SKIP 或 Esc。

配置保存在固定路徑,便於備份或腳本化管理:

$DSH_HOME/dsh-startup.json
默認路徑:~/.dsh/dsh-startup.json

已有配置中受支持的設置會被保留,升級或重裝時不必重新手填。

適用場景與注意

適合這幾類使用者:希望在啓動階段給使用者一個明確就緒信號的 DSH 桌面用戶;想要自定義啓動文案與時長的玩家;以及想研究 DSH 插件接入方式(dsh.client.inject、dsh.bundle.patch 等字段)的開發者。

需要注意三點。

1、插件以當前 DSH 進程的權限運行。安裝前建議先打開倉庫檢查源碼與許可證,確認內容符合自己的使用環境。代碼部分爲 MIT 許可,但 MIT 不覆蓋第三方音視頻素材。
2、聲畫素材的授權需要單獨確認。六段人聲沿用上游素材,上游說明前五段錄音來自第三方視頻,歡迎錄音爲自制素材,相關授權範圍須單獨確認。POI 相關名稱與視覺風格不代表官方關聯或授權。視覺上參考了 rosehahah/the-machine 的 MPOV 規範,但本輪未複製該參考項目的代碼;四張背景爲生成圖片;Share Tech Mono 來自 Google Fonts,OFL 許可證保留在 lib/assets/sharetechmono-OFL.txt。
3、該插件定位爲啓動體驗層,不改變 DSH 的對話、會話與工具調用邏輯。如果組織內部對啓動畫面有合規要求(第三方音視頻素材、生成圖片的使用範圍),建議先在測試環境驗證,再決定是否推送。

小結

這個插件的價值在於把啓動動畫做成了配置完整的插件:播放時機、時長、音效、跳過行爲都有明確開關,素材缺失和加載超時也有降級路徑,不會因爲一個畫面卡住 DSH 啓動。目錄頁與倉庫地址如下,源碼與許可證請在安裝前自行覈對。

  • 目錄頁:https://www.skillhub.cn/plugins/Toska1102/POI_theme-dsh-startup-screen
  • GitHub:https://github.com/Toska1102/POI_theme-dsh-startup-screen
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜