前言¶
在 DSH Web 界面裏用 dsh-cool-theme 做圖片或視頻背景時，背景模糊往往是固定值：長時間看代碼或對話，背景一直糊着，既佔視覺又和「靜止閱讀」的節奏不太合拍。若手動去主題裏改模糊滑桿，又打斷操作。
下面介紹社區插件 dsh-mouse-blur（維護者 linhaiyutuo，分類「趣味換裝」）：指針靜默一段時間後把背景模糊歸零；移動、點擊或滾輪時再按你在設置裏定的百分比恢復模糊。體量很小，只動 Web 客戶端，和 cool-theme 的 --ct-bg-blur-* 變量對接。
這是什麼¶
dsh-mouse-blur 是 DeepSeek Harness（DSH）的 Web 客戶端插件，npm 包名 dsh-mouse-blur，當前版本 0.3.0（MIT）。它不改變 DSH 核心邏輯，而是在有 dsh-cool-theme 且當前主題配置了背景圖片或背景視頻時，用鼠標/觸控板活動狀態切換背景模糊度。
沒有 cool-theme 或沒有背景媒體時，插件仍會加載、設置頁也能打開，但畫面上看不到效果。
核心功能¶
默認行爲¶
| 狀態 | 背景模糊 |
|---|---|
| 指針靜默 1.2 秒 | 0 px（完全清晰） |
| 移動 / 按下 / 點擊 / 滾輪 | 9.6 px（cool-theme 模糊滿量程 24 px 的 40%） |
活動模糊度是相對 cool-theme 滑桿滿量程 24 px 的百分比，不是「當前主題模糊度 × 百分比」。主題若原本只設了 3 px，活動態按 40% 仍會明顯更糊，這是設計意圖。
可調設置¶
打開 更多 → 設置 → 主題 · 鼠標模糊（緊挨「主題」分區；本插件通過 DSH 官方的 settings.section 擴展點註冊，因 cool-theme 的「主題」頁本身沒有開放條目擴展）。
| 設置項 | 範圍 | 默認 | 說明 |
|---|---|---|---|
| 活動時模糊 | 0–100% | 40% | 40% = 9.6 px |
| 過渡時間 | 100–2000 ms | 320 ms | 清晰 ↔ 模糊切換時長 |
| 靜默歸零 | 100–3000 ms | 1200 ms | 停下多久後恢復清晰 |
拖動滑塊立即生效，無需保存或刷新。設置保存在當前瀏覽器（cookie 爲主、localStorage 兜底）；換瀏覽器各用各的。右下角有「恢復默認」。遵守 prefers-reduced-motion 時不做過渡動畫。
兼容範圍¶
- 僅 Web 界面（桌面版或
dsh web）；宿主半邊爲空實現。 - 適配 dsh-cool-theme 0.9.x（
.ct-bg-image）與 0.10.x（.ct-bg-side圖片/視頻、作曲家視頻等選擇器）。 - 資料記載已在 DSH NEXT 2.0.19-next（DSH 0.2.1-rc.2）+ dsh-cool-theme 0.10.0 上安裝並驗證。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議在 GitHub 查看源碼與 MIT 許可證，確認符合你的環境策略。
從 npm 安裝（推薦）¶
在 DSH 插件頁「添加插件」直接輸入包名 dsh-mouse-blur，或命令行：
dsh plugin --profile desktop add dsh-mouse-blur
--profile 需換成你實際使用的 profile（可能是 web、default 等）。
從插件市場安裝¶
在 DSH 插件市場搜索 dsh-mouse-blur 或 mouse-blur 安裝。市場索引每天抓取 GitHub 話題 dsh-plugin，新倉庫可能要等約一天同步；急用可走 npm 或 tgz。
tgz / 源碼（其他機器或開發）¶
另一臺機器可用 dsh-mouse-blur-0.3.0.tgz 的絕對路徑，在 插件 → 添加插件 → 安裝第三方插件 填寫，或：
dsh plugin --profile desktop add "file:C:/Users/you/Downloads/dsh-mouse-blur-0.3.0.tgz"
本地路徑必須是絕對路徑。開發時可 link: 指向源碼目錄，改代碼後刷新即可；tgz 安裝會把包複製進 profile，挪路徑需重裝。
典型用法¶
- 安裝並啓用 dsh-cool-theme，在主題裏配置背景圖或背景視頻。
- 安裝 dsh-mouse-blur，確認插件列表中爲啓用狀態。
- 打開 主題 · 鼠標模糊，按習慣調「活動時模糊」「過渡時間」「靜默歸零」。
- 在頁面上移動鼠標：背景應變糊；停下約默認 1.2 秒後應變清晰。
驗證是否生效（來自 README）：
- 設置裏三個滑塊範圍分別爲
0–100、100–2000、100–3000； - 鼠標移動時
<html>上出現data-dsh-mouse-blur-active； <head>中有<style data-plugin-css="dsh-mouse-blur/background.css">；- 靜默後背景從模糊變清晰。
若要改代碼裏的默認值，可編輯 lib/client.js 中的 SETTING_SPECS 後重新打包或安裝（link: 安裝可直接刷新）。
適用場景與注意¶
適合：長期開着 DSH Web、用 cool-theme 做動態或靜態背景，希望「操作時略糊背景、閱讀時背景清晰」的開發者。
注意：
- 無 cool-theme 背景媒體時無可見效果，但無副作用。
- 插件僅 Web 客戶端；Node 引擎要求
>=22.13.0（見 package.json）。 - 卸載可在插件頁操作，或從 profile 的
package.json與dsh.profile.bundles移除後pnpm install；瀏覽器裏設置可能留在 localStorage，重裝後會沿用，可在設置頁恢復默認或刪除dsh-mouse-blur/settings/v1。
結尾¶
dsh-mouse-blur 用指針靜默與活動態切換 cool-theme 背景模糊，三個滑塊即可調行爲，適合作爲「趣味換裝」類小插件掛在日常 DSH Web 工作流裏。
- 社區目錄頁：https://www.skillhub.cn/plugins/linhaiyutuo/dsh-mouse-blur
- 源碼與說明：https://github.com/linhaiyutuo/dsh-mouse-blur
社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態遵循「一切皆插件」，具體行爲以倉庫 README 與版本爲準。
