前言¶
DeepSeek Harness（DSH）提供了智能體開發環境，除了功能性的工具鏈，界面的個性化也是常見需求。dsh-whale-particles 是一個運行在瀏覽器端的 Web 插件，旨在爲 DSH Web 界面添加一個互動的點陣背景。該插件通過粒子系統模擬“鯨魚”或自定義照片的輪廓，並提供手動交互與自動屏保模式。
插件定位¶
- 名稱：dsh-whale-particles
- 作者：fewoot
- 分類：趣味換裝
- 許可證：MIT
安裝¶
安裝該插件需要 DSH Desktop 客戶端。安裝/更新後必須重啓 DSH Desktop 才能生效。
方式一：npm 安裝（推薦）
使用官方 CLI 安裝，插件會記錄在 profile 依賴中，後續可在插件市場檢測更新。
dsh plugin --profile desktop add dsh-whale-particles
方式二：本地目錄
dsh plugin --profile desktop add ./dsh-whale-particles
方式三：離線包
解壓 dsh-whale-particles-offline-*.zip 後，雙擊 install-whale.bat 腳本，腳本會自動處理備份和註冊。
方式四：手動安裝
1. 將 dsh-whale-particles 文件夾複製到 %USERPROFILE%\.dsh\profiles\<profile>\node_modules\dsh-whale-particles。
2. 在 …\profiles\<profile>\package.json 的 dsh.profile.bundles 中追加 "dsh-whale-particles"（改前備份）。
3. 重啓 DSH Desktop。
注意：手動拷貝的副本不會出現在插件市場的“已安裝”列表中，因此無法通過市場進行一鍵更新。
核心功能¶
插件的核心邏輯包含點陣引擎與界面適配兩部分。
1. 粒子物理與模式
* 獨立外力：每顆粒子擁有獨立、低頻且平滑的“外力”，模擬真實流體或官網鯨魚的柔和動作，而非統一流場。
* 手動模式：光標靠近時，圈內粒子會柔和躁動；光標移開後，粒子會平滑歸位。
* 自動模式（屏保）：支持 360° 任意方向掃波（自動避開上一道過近的方向，斜向減速）以及全屏呼吸效果（緩緩起、維持、緩緩落）。
2. 主體與外觀
* 主體切換：默認使用鯨魚剪影（路徑來自 dsh-homepage-skin）。支持導入透明 PNG 照片，引擎會按 alpha 通道提取主體，壓縮蒙版並保存在瀏覽器 localStorage 中，不上傳雲端。
* 參數面板：進入設置 → 插件 → 「鯨魚點陣背景」標籤頁。參數按“鼠標擾動/自動模式/外觀/主體來源/輪廓/模式”分組。所有設置即時生效並自動保存，支持恢復默認。
* 界面適配：主界面不佔位（無右下角懸浮條）。插件會自動將空會話（hero）的輸入欄整體下移，避免遮擋背景主體。
使用方法¶
1. 導入自定義照片
在設置頁的「主體來源」中選擇照片，上傳透明 PNG。插件會自動解析並生成點陣蒙版。
2. 切換交互模式
在參數面板的「模式」組中切換手動/自動模式。
3. 調整參數
根據喜好調整外力強度、呼吸速度等參數，或點擊「恢復默認」重置。
技術細節與注意事項¶
1. 界面適配依賴
界面的透明化與輸入欄下移功能依賴於 DSH Web 的 CSS Module 哈希類名（如 _frame, _composerSeat）。舊版本插件將類名寫死，因此每次 DSH Desktop 升級後這兩項功能可能會失效。0.3.1 版本起改爲運行時自發現，但仍建議在升級後檢查。
2. 故障排查
如果界面適配未生效，可在瀏覽器 DevTools 控制台執行以下命令：
* __dshWhale.selectors()：查看每個類名的值、來源（自發現/兜底）及當前點數。
* __dshWhale.rescan()：手動重新掃描樣式表並重建樣式。
* __dshWhale.apply()：按當前解析結果重建樣式。
3. 數據存儲
照片蒙版數據存儲在瀏覽器的 localStorage 中（鍵名如 dsh-whale:photo），參數配置存儲在 dsh-whale:cfg，每臺機器獨立保存。
4. 許可與更新
默認鯨魚輪廓路徑內聯自 MIT 許可的 dsh-homepage-skin 倉庫。如需商用或更換形狀，需自行修改源碼中的路徑數據。照片模式不受影響。
資源¶
- 目錄頁：dsh-whale-particles (SkillHub)
- GitHub 倉庫：fewoot/dsh-whale-particles
