dsh-cyber-particle:爲 DSH Web 界面添加動態粒子網絡背景

前言

DeepSeek Harness(DSH)的 Web 界面默認背景較爲樸素。若想在不改界面配色、不干擾操作的前提下增加一點動態視覺,常見做法是改主題 CSS 或換皮膚,但這類改動往往牽涉全局樣式,維護和切換成本較高。

dsh-cyber-particle 走另一條路:在瀏覽器側用全屏覆蓋層繪製粒子網絡動畫,pointer-events 穿透,不註冊服務端路由,也不改動現有界面配色。下面介紹它的定位、能力與安裝方式。

這是什麼

cyber-particle(倉庫 AKS1st/dsh-cyber-particle)由維護者 AKS1st 發佈,歸類爲趣味換裝類 DSH 插件。它爲 DeepSeek Harness Web 界面提供動態粒子網絡背景:灰白散點從屏幕邊緣隨機飛入、直線穿過界面、離開後從新的邊緣再次進入;彼此距離小於閾值的粒子自動連線,形成不斷變化的網狀結構。

渲染在界面全屏覆蓋層上,不影響鼠標與鍵盤交互。所有邏輯在瀏覽器側完成,無 npm 運行時依賴;服務端不註冊任何 webServer 路由,可被 dshmarket 像皮膚一樣熱切換,不產生路由衝突。

核心功能

粒子動畫

粒子從屏幕邊緣隨機進入,直線移動後離開,再從新邊緣重新進入。距離小於閾值的粒子之間自動繪製連線,整體呈不斷變化的網狀結構。粒子與線條顏色可通過設置頁調色板調整。

設置頁與持久化

插件內置「設置 → 粒子背景」頁,可即時調節:

  • 粒子數量、半徑
  • 線條粗細、連線距離
  • 移動速度
  • 粒子顏色、線條顏色

支持一鍵重置爲默認值。調整即時生效,並持久化到瀏覽器 localStorage(鍵 cyber-particle:config),刷新頁面或重啓 dsh web 後自動恢復。設置頁文案跟隨 DSH 語言設置(中文 / English)。

分辨率自適應

效果以 2560×1440(27” 2K)爲參考視口,按設備像素比和視口面積自動歸一化。設置頁用「少/多、小/大、細/粗、近/遠、慢/快」等定性檔位展示,不顯示絕對數值,避免不同屏幕尺寸下的歧義。

內部參數默認值與範圍如下(繪製時按 scale 縮放,scale = √(視口面積 / 參考面積),限制在 0.55–1.5):

參數 默認值 範圍 含義
粒子數量 52 10–120 基準數量,按 scale² 縮放(8–240 截斷)
粒子半徑 2.2 0.5–6 半徑(px),按 scale 縮放
線條粗細 1.2 0.2–4 連線寬度(px),按 scale 縮放
連線距離 180 40–400 連線閾值(px),按 scale 縮放
移動速度 3.0 0.5–8 基準速度,實際在 2/3×1.4× 間隨機
粒子顏色 #7d8999 調色板 散點顏色(固定 0.9 透明度)
線條顏色 #6e7a8c 調色板 連線顏色(透明度隨距離衰減)

設備像素比上限爲 2,高分屏(如 4K@200%)按 DPR 渲染以保持線條清晰。

安裝與啓用

從 GitHub 倉庫安裝(純 JS,零構建,即裝即用):

dsh plugin --profile web add github:AKS1st/dsh-cyber-particle
dsh web   # 重啓 web 服務使 profile 生效

本地安裝(clone 後直接指向倉庫目錄):

git clone https://github.com/AKS1st/dsh-cyber-particle.git
dsh plugin --profile web add /path/to/dsh-cyber-particle
dsh web

當前版本爲 0.2.3,許可證 MIT。插件通過 Cordis patch(cordis.patch.yml)注入 Web 客戶端,僅面向 web profile。

典型用法

安裝並重啓 dsh web 後,打開 DSH Web 界面即可看到粒子背景。無需額外命令行操作。

若要調整效果,進入「設置 → 粒子背景」,按需修改各項參數;不滿意時可一鍵恢復默認。卸載時執行:

dsh plugin --profile web remove cyber-particle
dsh web

適用場景與注意

適合希望在 DSH Web 界面上增加輕量動態背景、又不想改主題配色的用戶。插件不佔用服務端資源,也不影響現有交互邏輯。

安裝前應注意:插件以當前 dsh 進程權限運行,雖 README 標明服務端無行爲,仍建議查看倉庫源碼並確認 MIT 許可證後再安裝。DSH 生態奉行「一切皆插件」;SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。

鏈接

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

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

小夜