dsh-dynamic-bg:给 DSH Web 铺整屏动态背景

前言

DeepSeek Harness(DSH)把能力拆成插件,界面默认是素灰底色。长时间对着同一套灰界面开发或对话,视觉疲劳很快;社区里也有换背景的插件,但资料里提到多数只支持静态图,另有方案只面向 Windows。若你希望 DSH Web 背后是一整张图、GIF 或循环视频,并能在不牺牲可读性的前提下调节蒙版、模糊和面板透明度,mengjiemy/dsh-dynamic-bg(npm 包名 dsh-dynamic-bg,当前版本 0.1.0)就是面向这一需求的「趣味换装」类插件。

下面介绍它做什么、怎么启用,以及安装前需要留意的边界。

这是什么

维护者 mengjiemy 在个人仓库 mengjiemy/dsh-dynamic-bg 发布该项目,许可证为 MIT。一句话定位:把 DSH 默认灰底换成整屏壁纸,支持静态图、动图与视频,并通过 CSS 变量(--dsw-*)改样式,不修改带哈希的类名(形如 .css-a1b2c3),以降低 DSH 前端升级后样式插件失效的风险。

package.json 中声明 DSH 引擎要求为 >=0.1.5-rc.1,客户端注入面向 web 平台。

核心功能

支持的媒体类型

类型 格式
静态图 jpg / png / webp / avif / bmp / svg
动图 gif
视频 mp4 / webm / mov / m4v

视频模式在 README 中说明为循环播放、静音,并支持倍速与进度条拖动。

可调视觉效果

效果 范围 说明
蒙版强度 0–100 背景上叠半透明层,深浅主题各一套配色,便于保证文字可读
背景模糊 0–40px 模糊后轻微放大,减少边缘露白
不透明度 0–100 背景本身浓淡
填充模式 铺满 / 完整显示 铺满可能裁边,完整显示可能留白
面板半透明 主区 / 侧边栏分别调节 内容区可透出背景
一键压暗 开关 临时压暗背景,不改变上述参数

实现思路(为何相对不易因升级失效)

DSH 界面样式里大量类名带哈希,版本更新时常变化。该插件只改写 DSH 自带的 CSS 变量,README 明确说明不碰哈希类名,意图是在 DSH 升级后仍可持续使用。

文档待补的扩展能力

README 注明除背景外,代码中还包含环境文字特效(诗词雨 / 二进制雨,7 条泳道防重叠)、8 套文字配色(如 hacker-green、amber、magenta、cyan、white 等)、输入框聚焦毛玻璃、按会话独立背景等;环境文字特效的详细用法文档仍在补充中,成稿仅以 README 已写明的背景能力为主。

Agent 工具

插件向 agent 暴露三个工具名:dynamic_bg_set、dynamic_bg_get、dynamic_bg_off,可在对话中由 agent 代为读取或关闭背景配置(具体参数以仓库源码为准)。

安装与启用

已抓取资料与 GitHub README 均未给出形如 dsh plugin add … 的固定安装命令,因此此处不拼接命令。DSH 生态按「一切皆插件」组织;社区目录 SkillHub 上的 dsh-dynamic-bg 页 与 GitHub 仓库为独立来源,与 DeepSeek / 幻方无官方从属关系。请在该目录页或你当前 DSH 版本的插件安装说明中,选择指向 mengjiemy/dsh-dynamic-bg 的安装方式。

安装完成后,按 README 启用流程操作:

  1. 重启 dsh web,并刷新浏览器页面。
  2. 在设置中找到背景相关项,填写本地媒体文件的绝对路径(示例:~/Movies/loop.mp4)。
  3. 打开背景开关,按需调节蒙版、模糊、不透明度等项。

典型用法

路径必须是绝对路径;相对路径会被拒绝(HTTP 400)。仅允许 README 列出的媒体扩展名,其它扩展名返回 403。敏感系统目录(如 /etc、/System、/dev 等)会被拒绝访问;单文件大小上限为 2GB。插件读取本地文件服务背景,README 说明不会改写用户业务文件,仅在系统临时目录 /tmp 写入诊断日志(可自行删除)。

若你通过 agent 操作,可调用上述 dynamic_bg_set / dynamic_bg_get / dynamic_bg_off,与在设置面板中手动配置互为补充。

适用场景与注意

适合谁: 长期在 DSH Web 上工作、希望用本地图 / GIF / 视频个性化界面,且需要蒙版与面板半透明来保证可读性的开发者或重度用户。

安装前建议: 插件以当前 dsh 进程权限读取本机路径,安装前应自行审阅 GitHub 源码 与 MIT 许可证,确认路径白名单与扩展名限制符合你的安全策略。

维护预期: README 标明这是个人业余项目,按现状(as-is)发布,不承诺 SLA;Issue / PR 欢迎但不保证及时回复。SkillHub 页显示星标为 0(以目录页展示为准),不影响功能描述,但意味着社区验证样本可能较少,需自行评估稳定性。

结尾

dsh-dynamic-bg 把 DSH Web 从默认灰底扩展为可配置的整屏壁纸(静图、GIF、视频),并用 CSS 变量而非哈希类名做主题层改造;配合蒙版、模糊与面板半透明,在「趣味换装」的同时尽量保留界面可用性。

羽毛球分组比赛记分
小程序二维码

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

Xiaoye