dsh-local-background:本地图片做 DSH 背景图

前言

DeepSeek Harness(DSH)桌面端没有背景图设置:@deepseek-ai/dsh-client-ui-theme 只提供「配色方案」和「正文字号」,官方把第三方主题定义为「扩展点,不是产品」。想换壁纸,要么自己改源码,要么等别人适配。

dsh-local-background 是一个给 DSH 桌面端换背景图并自动轮播的本地插件,走官方认可的扩展路径。它让宿主读本地图片文件夹,用同源 HTTP 提供给客户端,然后注入 CSS 把背景透出来。

这是什么

  • 名称:dsh-local-background
  • 维护者:yidao2000
  • 分类:趣味换装
  • 功能:从本地文件夹读取图片,做 DSH 背景图,支持自动轮播与透明度调节
  • 依赖:不依赖任何第三方皮肤/主题作者的版本适配

核心功能

  • 图片放在本地文件夹里,插件直接读 —— 不打包、不压缩、随便加减
  • 每 N 分钟自动换一张(默认 5 分钟)
  • 在插件「配置」页里调节:壁纸文件夹、背景图不透明度、背景压暗、面板不透明度、自动轮换间隔、弹窗是否用默认背景
  • 每次改动立刻生效,同时写进用户态目录持久保存
  • 支持的图片格式:.jpg .jpeg .png .webp .gif .avif .bmp
  • 不想要了,在桌面应用「插件」页卸载即可

安装与启用

命令行(推荐)

dsh plugin --profile web add dsh-local-background
  • --profile web 要带上:本插件是 web 平台客户端插件(dsh.client.platform = "web")。
  • 从 npm 装(上面的写法)需要包已发布。若 npm 上还取不到,用 GitHub 源装:
  dsh plugin --profile web add github:yidao2000/dsh-local-background
  • 也可以填绝对路径装本地目录(适合改源码调试):
  dsh plugin --profile web add D:\devinstall\IdeaProjects\dsh-local-background

GUI(桌面应用)

桌面应用 → 插件 → 添加插件 → 填仓库地址或本地绝对路径 → 启用 → 重启桌面应用。

  • 装别人的包:yidao2000/dsh-local-background
  • 装自己改的源码:本仓库的绝对路径

典型用法

装好插件后,在桌面应用左侧栏找到 dsh-local-background,点击行上的 配置 按钮。

配置页里有这些控件:

  • 壁纸文件夹:图片从哪个文件夹读。可以点击「选择文件夹…」弹 Windows 系统文件夹对话框,也可以直接在输入框填绝对路径。默认值由宿主在运行时算:Windows/macOS 取 <用户目录>/Pictures,Linux 取 $XDG_PICTURES_DIR(缺省 <用户目录>/Pictures)。
  • 背景图不透明度:背景图自身多透明(0% = 看不见图,100% = 原图)。这是最常用的那个。
  • 背景压暗:在图上盖一层黑,图太亮时压一压(默认 25%)。
  • 面板不透明度:界面面板多透明;越小背景越明显、字越难读(默认 15%)。
  • 自动轮换:每隔几分钟换一张(0 = 不轮换,最大 1440,默认 5)。
  • 弹窗用默认(不透明)背景:宿主「设置」等弹窗/对话框/菜单的背景:勾上就用宿主默认不透明底色(字更清楚),默认勾选。

换图仍然是把文件丢进那个文件夹就行,然后点「重新读取」(或刷新页面)。

配置文件 settings.json 写在用户态目录 ~/.dsh/dsh-local-background/,升级插件不会丢配置。

适用场景与注意

  • 适合想在 DSH 桌面端用自己图片做背景,并保持自动轮播的用户。
  • 插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。

短结尾

dsh-local-background 让 DSH 支持本地图片背景与自动轮播,配置在界面里直接调,不依赖第三方皮肤。目录页:https://www.skillhub.cn/plugins/yidao2000/dsh-local-background,GitHub:https://github.com/yidao2000/dsh-local-background

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

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

小夜