前言¶
在 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 与版本为准。
