前言¶

用 DSH 做智能體開發時，dsh web 是最常開的界面之一，但默認的背景樣式比較樸素，長時間對着看容易乏味。想給 Web UI 加一些視覺上的個性化，通常需要自己改前端代碼，門檻和維護成本都不低。

dsh-aurora-bg 解決的就是這個問題：它把 DeepSeek 官網首頁那種「深藍流體底色 + 極光光斑 + 點陣鯨魚」的動態背景做成一個 DSH 插件，裝上、重啓，背景自動生效，不用改 DSH 本身的代碼。

這是什麼¶

dsh-aurora-bg 是一個 DeepSeek Harness（DSH）Web UI 背景插件，由 KUNTING0701 維護，當前版本 1.0.2，採用 MIT 許可證。它的定位一句話概括：DeepSeek 官網風格動態極光背景插件 for DSH Web UI。

實現上是純 CSS transform + SVG 粒子，無 WebGL、無持續 canvas 動畫、無 mask、無 blur，資源佔用低，兼容性穩。

從 package.json 可以看到，插件的客戶端平臺聲明爲 web（dsh.client.platform），主入口是 lib/index.js，客戶端文件是 lib/client.js，打包補丁爲 ./cordis.patch.yml。

核心功能¶

六層背景¶

背景由六個獨立動畫的層組成：遠/近雙層網格視差、藍紫光斑、金色反轉層、頂部暖光、細密快轉層。各層轉速與方向不同——金色層反轉、細密層快速公轉，製造「流體湧動」感，並帶有 scale 呼吸動畫。

其中雙層網格視差的設計是：遠層網格 92px、小視差，近層網格 46px、大視差，鼠標移動時兩層位移幅度不同，產生立體景深。

點陣鯨魚¶

這是插件的視覺重心，復刻了官網 hero-whale 的效果：由小點點組成的鯨魚圖案，粒子來自對官網原版 SVG path 的採樣，按 60×60 亮度圖取內部粒子。

鯨魚帶一組動態效果：

• 組裝動畫：粒子從散落點飛向鯨魚形狀，2.5s 緩動凝聚
• 尾部游泳擺動：朝向尾部傳播的波浪
• 環形波紋：從中心向外擴散
• 鼠標斥力：鼠標靠近時粒子被三次衰減力推開，並帶噪聲角旋轉繞行，官網參數爲 radius 4.9 / strength .8 / distort 5
• 3D 光照：亮度在 0.28x ~ 2.79x 之間隨粒子與光源的距離變化，光源跟隨鼠標，參數爲 range 14 / shadeMin .28 / shadeMax 2.79 / followX 1.05
• 粒子閃爍、整體慢旋 + 呼吸浮動

安裝與啓用¶

推薦直接從 GitHub 安裝，也可以用本地構建的 tarball：

# 從 GitHub 安裝（推薦）
dsh plugin --profile web add https://github.com/KUNTING0701/dsh-aurora-bg/archive/refs/tags/v1.0.2.tar.gz

# 或從本地構建的 tarball 安裝
dsh plugin --profile web add /path/to/dsh-aurora-bg-1.0.2.tgz

安裝後必須重啓 dsh web，背景纔會生效。重啓後可以在 設置 → 插件 → 插件列表 中看到 dsh-aurora-bg 條目，狀態爲已啓用 · 已掛載。

卸載¶

dsh plugin --profile web remove dsh-aurora-bg

卸載後同樣需要重啓 dsh web。

微調¶

插件沒有提供獨立配置項，微調方式是直接修改 lib/client.js 源碼，主要改三處：

1、頂部 CSS 常量：光斑顏色與濃度、網格密度，以及鯨魚位置（.dsh-whale 的 right/top/width）

2、背景層 anim 數組：每層各有一個參數對象，字段含義如下：

3、鯨魚動態參數：sampleWhale() 的採樣分辨率（S=60）、鼠標斥力（4.9 / .8 / 5）、光照（14 / .28 / 2.79）、loose 抖動幅度

改完保存後重啓 dsh web 即可看到效果。

適用場景與注意¶

這個插件適合兩類人：一是日常使用 dsh web、希望界面更接近 DeepSeek 官網觀感的開發者；二是想參考「純 CSS transform + SVG 粒子」實現複雜動態背景的同行——它沒有用 WebGL 和持續 canvas 動畫，實現思路本身有參考價值。

使用前注意兩點：

1、插件以當前 dsh 進程的權限運行，安裝前建議先瀏覽一遍源碼（核心邏輯集中在 lib/client.js），確認沒有問題再裝。許可證爲 MIT，README 與 package.json 均有標註。

2、無論安裝、卸載還是修改 lib/client.js 之後，都需要重啓 dsh web 纔會生效。

整體來看，dsh-aurora-bg 把一個純裝飾性需求做成了一個即裝即用、改動範圍可控的插件，符合 DSH「一切皆插件」的思路。如果你想要一個低資源佔用、視覺完成度高的 Web UI 背景，可以直接試試。

• 社區目錄頁：https://www.skillhub.cn/plugins/KUNTING0701/dsh-aurora-bg
• GitHub 倉庫：https://github.com/KUNTING0701/dsh-aurora-bg